开源软件构建与测试

_service:tar_scm:python-sphinx.spec Changed

@@ -1,14 +1,12 @@
 Name:       python-sphinx
-Version:    4.4.0
-Release:    2
+Version:    7.0.1
+Release:    1
 Epoch:      1
 Summary:    Python documentation generator
 License:    BSD and MIT 
 URL:        http://sphinx-doc.org/
 Source0:    https://files.pythonhosted.org/packages/source/S/Sphinx/Sphinx-%{version}.tar.gz
 
-Patch6000:  backport-html-Updated-jQuery-version-from-3.5.1-to-3.6.0.patch
-
 BuildArch:     noarch
 
 BuildRequires: python3-devel
@@ -27,6 +25,8 @@
 BuildRequires: python3-sphinxcontrib-qthelp
 BuildRequires: python3-sphinxcontrib-serializinghtml
 BuildRequires: python3-sphinx-theme-alabaster
+BuildRequires:	python3-pip  python3-hatchling python3-hatch-vcs python3-wheel python3-pytest
+BuildRequires: python3-flit-core
 
 BuildRequires: dos2unix
 
@@ -134,10 +134,9 @@
 %prep
 %autosetup -n Sphinx-%{version} -p1
 
-dos2unix -k ./sphinx/themes/basic/static/jquery.js
 
 %build
-%py3_build
+%pyproject_build
 
 export PYTHONPATH=$PWD
 pushd doc
@@ -150,7 +149,7 @@
 
 
 %install
-%py3_install
+%pyproject_install sphinx==%{version}
 
 # For backwards compatibility. Remove around Fedora 33 (with care)
 install -d %{buildroot}%{_libexecdir}/python3-sphinx
@@ -216,9 +215,7 @@
 %license LICENSE
 %doc AUTHORS CHANGES EXAMPLES README.rst
 %{_bindir}/sphinx-*
-%{python3_sitelib}/sphinx/
-%dir %{python3_sitelib}/sphinxcontrib/
-%{python3_sitelib}/Sphinx-%{version}-py%{python3_version}.egg-info/
+%{python3_sitelib}/sphinx*
 %{_libexecdir}/python3-sphinx/
 
 %files help
@@ -226,6 +223,9 @@
 %{_mandir}/man1/*
 
 %changelog
+* Fri Jul 28 2023 xu_ping <707078654@qq.com> - 1:7.0.1-1
+- Upgrade version to 7.0.1
+
 * Thu Jul 20 2023 shixuantong <shixuantong1@huawei.com> - 1:4.4.0-2
 - html: Updated jQuery version from 3.5.1 to 3.6.0

_service:tar_scm:backport-html-Updated-jQuery-version-from-3.5.1-to-3.6.0.patch Deleted

@@ -1,588 +0,0 @@
-From 541fcfc557d488e3fd41b11aef4bb812b1b35688 Mon Sep 17 00:00:00 2001
-From: Takeshi KOMIYA <i.tkomiya@gmail.com>
-Date: Sat, 7 May 2022 22:18:00 +0900
-Subject: PATCH Close #9974: html: Updated jQuery version from 3.5.1 to 3.6.0
-
----
- .../{jquery-3.5.1.js => jquery-3.6.0.js}      | 227 +++++++++---------
- sphinx/themes/basic/static/jquery.js          |   4 +-
- tests/test_theming.py                         |   2 +-
- 3 files changed, 121 insertions(+), 112 deletions(-)
- rename sphinx/themes/basic/static/{jquery-3.5.1.js => jquery-3.6.0.js} (98%)
-
-diff --git a/sphinx/themes/basic/static/jquery-3.5.1.js b/sphinx/themes/basic/static/jquery-3.6.0.js
-similarity index 98%
-rename from sphinx/themes/basic/static/jquery-3.5.1.js
-rename to sphinx/themes/basic/static/jquery-3.6.0.js
-index 5093733..fc6c299 100644
---- a/sphinx/themes/basic/static/jquery-3.5.1.js
-+++ b/sphinx/themes/basic/static/jquery-3.6.0.js
-@@ -1,15 +1,15 @@
- /*!
-- * jQuery JavaScript Library v3.5.1
-+ * jQuery JavaScript Library v3.6.0
-  * https://jquery.com/
-  *
-  * Includes Sizzle.js
-  * https://sizzlejs.com/
-  *
-- * Copyright JS Foundation and other contributors
-+ * Copyright OpenJS Foundation and other contributors
-  * Released under the MIT license
-  * https://jquery.org/license
-  *
-- * Date: 2020-05-04T22:49Z
-+ * Date: 2021-03-02T17:08Z
-  */
- ( function( global, factory ) {
- 
-@@ -76,12 +76,16 @@ var support = {};
- 
- var isFunction = function isFunction( obj ) {
- 
--      // Support: Chrome <=57, Firefox <=52
--      // In some browsers, typeof returns "function" for HTML <object> elements
--      // (i.e., `typeof document.createElement( "object" ) === "function"`).
--      // We don't want to classify *any* DOM node as a function.
--      return typeof obj === "function" && typeof obj.nodeType !== "number";
--  };
-+		// Support: Chrome <=57, Firefox <=52
-+		// In some browsers, typeof returns "function" for HTML <object> elements
-+		// (i.e., `typeof document.createElement( "object" ) === "function"`).
-+		// We don't want to classify *any* DOM node as a function.
-+		// Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5
-+		// Plus for old WebKit, typeof returns "function" for HTML collections
-+		// (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756)
-+		return typeof obj === "function" && typeof obj.nodeType !== "number" &&
-+			typeof obj.item !== "function";
-+	};
- 
- 
- var isWindow = function isWindow( obj ) {
-@@ -147,7 +151,7 @@ function toType( obj ) {
- 
- 
- var
--	version = "3.5.1",
-+	version = "3.6.0",
- 
- 	// Define a local copy of jQuery
- 	jQuery = function( selector, context ) {
-@@ -401,7 +405,7 @@ jQuery.extend( {
- 			if ( isArrayLike( Object( arr ) ) ) {
- 				jQuery.merge( ret,
- 					typeof arr === "string" ?
--					 arr  : arr
-+						 arr  : arr
- 				);
- 			} else {
- 				push.call( ret, arr );
-@@ -496,9 +500,9 @@ if ( typeof Symbol === "function" ) {
- 
- // Populate the class2type map
- jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
--function( _i, name ) {
--	class2type "object " + name + ""  = name.toLowerCase();
--} );
-+	function( _i, name ) {
-+		class2type "object " + name + ""  = name.toLowerCase();
-+	} );
- 
- function isArrayLike( obj ) {
- 
-@@ -518,14 +522,14 @@ function isArrayLike( obj ) {
- }
- var Sizzle =
- /*!
-- * Sizzle CSS Selector Engine v2.3.5
-+ * Sizzle CSS Selector Engine v2.3.6
-  * https://sizzlejs.com/
-  *
-  * Copyright JS Foundation and other contributors
-  * Released under the MIT license
-  * https://js.foundation/
-  *
-- * Date: 2020-03-14
-+ * Date: 2021-02-16
-  */
- ( function( window ) {
- var i,
-@@ -1108,8 +1112,8 @@ support = Sizzle.support = {};
-  * @returns {Boolean} True iff elem is a non-HTML XML node
-  */
- isXML = Sizzle.isXML = function( elem ) {
--	var namespace = elem.namespaceURI,
--		docElem = ( elem.ownerDocument || elem ).documentElement;
-+	var namespace = elem && elem.namespaceURI,
-+		docElem = elem && ( elem.ownerDocument || elem ).documentElement;
- 
- 	// Support: IE <=8
- 	// Assume HTML when documentElement doesn't yet exist, such as inside loading iframes
-@@ -3024,9 +3028,9 @@ var rneedsContext = jQuery.expr.match.needsContext;
- 
- function nodeName( elem, name ) {
- 
--  return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
-+	return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
- 
--};
-+}
- var rsingleTag = ( /^<(a-z^\/\0>:\x20\t\r\n\f*)\x20\t\r\n\f*\/?>(?:<\/\1>|)$/i );
- 
- 
-@@ -3997,8 +4001,8 @@ jQuery.extend( {
- 			resolveContexts = Array( i ),
- 			resolveValues = slice.call( arguments ),
- 
--			// the master Deferred
--			master = jQuery.Deferred(),
-+			// the primary Deferred
-+			primary = jQuery.Deferred(),
- 
- 			// subordinate callback factory
- 			updateFunc = function( i ) {
-@@ -4006,30 +4010,30 @@ jQuery.extend( {
- 					resolveContexts i  = this;
- 					resolveValues i  = arguments.length > 1 ? slice.call( arguments ) : value;
- 					if ( !( --remaining ) ) {
--						master.resolveWith( resolveContexts, resolveValues );
-+						primary.resolveWith( resolveContexts, resolveValues );
- 					}
- 				};
- 			};
- 
- 		// Single- and empty arguments are adopted like Promise.resolve
- 		if ( remaining <= 1 ) {
--			adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject,
-+			adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject,
- 				!remaining );
- 
- 			// Use .then() to unwrap secondary thenables (cf. gh-3000)
--			if ( master.state() === "pending" ||
-+			if ( primary.state() === "pending" ||
- 				isFunction( resolveValues i  && resolveValues i .then ) ) {
- 
--				return master.then();
-+				return primary.then();
- 			}
- 		}
- 
- 		// Multiple arguments are aggregated like Promise.all array elements
- 		while ( i-- ) {
--			adoptValue( resolveValues i , updateFunc( i ), master.reject );
-+			adoptValue( resolveValues i , updateFunc( i ), primary.reject );
- 		}
- 
--		return master.promise();
-+		return primary.promise();
- 	}
- } );
- 
-@@ -4180,8 +4184,8 @@ var access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
- 			for ( ; i < len; i++ ) {
- 				fn(
- 					elems i , key, raw ?
--					value :
--					value.call( elems i , i, fn( elems i , key ) )
-+						value :
-+						value.call( elems i , i, fn( elems i , key ) )
- 				);
- 			}
- 		}
-@@ -5089,10 +5093,7 @@ function buildFragment( elems, context, scripts, selection, ignored ) {
- }
- 
- 
--var
--	rkeyEvent = /^key/,
--	rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/,
--	rtypenamespace = /^(^.*)(?:\.(.+)|)/;
-+var rtypenamespace = /^(^.*)(?:\.(.+)|)/;
- 
- function returnTrue() {
- 	return true;
-@@ -5387,8 +5388,8 @@ jQuery.event = {
- 			event = jQuery.event.fix( nativeEvent ),
- 
- 			handlers = (
--					dataPriv.get( this, "events" ) || Object.create( null )
--				) event.type  || ,
-+				dataPriv.get( this, "events" ) || Object.create( null )
-+			) event.type  || ,
- 			special = jQuery.event.special event.type  || {};
- 
- 		// Use the fix-ed jQuery.Event rather than the (read-only) native event
-@@ -5512,12 +5513,12 @@ jQuery.event = {
- 			get: isFunction( hook ) ?
- 				function() {
- 					if ( this.originalEvent ) {
--							return hook( this.originalEvent );
-+						return hook( this.originalEvent );
- 					}
- 				} :
- 				function() {
- 					if ( this.originalEvent ) {
--							return this.originalEvent name ;
-+						return this.originalEvent name ;
- 					}
- 				},
- 
-@@ -5656,7 +5657,13 @@ function leverageNative( el, type, expectSync ) {
- 						// Cancel the outer synthetic event
- 						event.stopImmediatePropagation();
- 						event.preventDefault();
--						return result.value;
-+
-+						// Support: Chrome 86+
-+						// In Chrome, if an element having a focusout handler is blurred by
-+						// clicking outside of it, it invokes the handler synchronously. If
-+						// that handler calls `.remove()` on the element, the data is cleared,
-+						// leaving `result` undefined. We need to guard against this.
-+						return result && result.value;
- 					}
- 
- 				// If this is an inner synthetic event for an event with a bubbling surrogate
-@@ -5821,34 +5828,7 @@ jQuery.each( {
- 	targetTouches: true,
- 	toElement: true,
- 	touches: true,
--
--	which: function( event ) {
--		var button = event.button;
--
--		// Add which for key events
--		if ( event.which == null && rkeyEvent.test( event.type ) ) {
--			return event.charCode != null ? event.charCode : event.keyCode;
--		}
--
--		// Add which for click: 1 === left; 2 === middle; 3 === right
--		if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) {
--			if ( button & 1 ) {
--				return 1;
--			}
--
--			if ( button & 2 ) {
--				return 3;
--			}
--
--			if ( button & 4 ) {
--				return 2;
--			}
--
--			return 0;
--		}
--
--		return event.which;
--	}
-+	which: true
- }, jQuery.event.addProp );
- 
- jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) {
-@@ -5874,6 +5854,12 @@ jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateTyp
- 			return true;
- 		},
- 
-+		// Suppress native focus or blur as it's already being fired
-+		// in leverageNative.
-+		_default: function() {
-+			return true;
-+		},
-+
- 		delegateType: delegateType
- 	};
- } );
-@@ -6541,6 +6527,10 @@ var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
- 		// set in CSS while `offset*` properties report correct values.
- 		// Behavior in IE 9 is more subtle than in newer versions & it passes
- 		// some versions of this test; make sure not to make it pass there!
-+		//
-+		// Support: Firefox 70+
-+		// Only Firefox includes border widths
-+		// in computed dimensions. (gh-4529)
- 		reliableTrDimensions: function() {
- 			var table, tr, trChild, trStyle;
- 			if ( reliableTrDimensionsVal == null ) {
-@@ -6548,17 +6538,32 @@ var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
- 				tr = document.createElement( "tr" );
- 				trChild = document.createElement( "div" );
- 
--				table.style.cssText = "position:absolute;left:-11111px";
-+				table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate";
-+				tr.style.cssText = "border:1px solid";
-+
-+				// Support: Chrome 86+
-+				// Height set through cssText does not get applied.
-+				// Computed height then comes back as 0.
- 				tr.style.height = "1px";
- 				trChild.style.height = "9px";
- 
-+				// Support: Android 8 Chrome 86+
-+				// In our bodyBackground.html iframe,
-+				// display for all div elements is set to "inline",
-+				// which causes a problem only in Android 8 Chrome 86.
-+				// Ensuring the div is display: block
-+				// gets around this issue.
-+				trChild.style.display = "block";
-+
- 				documentElement
- 					.appendChild( table )
- 					.appendChild( tr )
- 					.appendChild( trChild );
- 
- 				trStyle = window.getComputedStyle( tr );
--				reliableTrDimensionsVal = parseInt( trStyle.height ) > 3;
-+				reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) +
-+					parseInt( trStyle.borderTopWidth, 10 ) +
-+					parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight;
- 
- 				documentElement.removeChild( table );
- 			}
-@@ -7022,10 +7027,10 @@ jQuery.each(  "height", "width" , function( _i, dimension ) {
- 					// Running getBoundingClientRect on a disconnected node
- 					// in IE throws an error.
- 					( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?
--						swap( elem, cssShow, function() {
--							return getWidthOrHeight( elem, dimension, extra );
--						} ) :
--						getWidthOrHeight( elem, dimension, extra );
-+					swap( elem, cssShow, function() {
-+						return getWidthOrHeight( elem, dimension, extra );
-+					} ) :
-+					getWidthOrHeight( elem, dimension, extra );
- 			}
- 		},
- 
-@@ -7084,7 +7089,7 @@ jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,
- 					swap( elem, { marginLeft: 0 }, function() {
- 						return elem.getBoundingClientRect().left;
- 					} )
--				) + "px";
-+			) + "px";
- 		}
- 	}
- );
-@@ -7223,7 +7228,7 @@ Tween.propHooks = {
- 			if ( jQuery.fx.step tween.prop  ) {
- 				jQuery.fx.step tween.prop ( tween );
- 			} else if ( tween.elem.nodeType === 1 && (
--					jQuery.cssHooks tween.prop  ||
-+				jQuery.cssHooks tween.prop  ||
- 					tween.elem.style finalPropName( tween.prop )  != null ) ) {
- 				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
- 			} else {
-@@ -7468,7 +7473,7 @@ function defaultPrefilter( elem, props, opts ) {
- 
- 			anim.done( function() {
- 
--			/* eslint-enable no-loop-func */
-+				/* eslint-enable no-loop-func */
- 
- 				// The final step of a "hide" animation is actually hiding the element
- 				if ( !hidden ) {
-@@ -7588,7 +7593,7 @@ function Animation( elem, properties, options ) {
- 			tweens: ,
- 			createTween: function( prop, end ) {
- 				var tween = jQuery.Tween( elem, animation.opts, prop, end,
--						animation.opts.specialEasing prop  || animation.opts.easing );
-+					animation.opts.specialEasing prop  || animation.opts.easing );
- 				animation.tweens.push( tween );
- 				return tween;
- 			},
-@@ -7761,7 +7766,8 @@ jQuery.fn.extend( {
- 					anim.stop( true );
- 				}
- 			};
--			doAnimation.finish = doAnimation;
-+
-+		doAnimation.finish = doAnimation;
- 
- 		return empty || optall.queue === false ?
- 			this.each( doAnimation ) :
-@@ -8401,8 +8407,8 @@ jQuery.fn.extend( {
- 				if ( this.setAttribute ) {
- 					this.setAttribute( "class",
- 						className || value === false ?
--						"" :
--						dataPriv.get( this, "__className__" ) || ""
-+							"" :
-+							dataPriv.get( this, "__className__" ) || ""
- 					);
- 				}
- 			}
-@@ -8417,7 +8423,7 @@ jQuery.fn.extend( {
- 		while ( ( elem = this i++  ) ) {
- 			if ( elem.nodeType === 1 &&
- 				( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) {
--					return true;
-+				return true;
- 			}
- 		}
- 
-@@ -8707,9 +8713,7 @@ jQuery.extend( jQuery.event, {
- 				special.bindType || type;
- 
- 			// jQuery handler
--			handle = (
--					dataPriv.get( cur, "events" ) || Object.create( null )
--				) event.type  &&
-+			handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) ) event.type  &&
- 				dataPriv.get( cur, "handle" );
- 			if ( handle ) {
- 				handle.apply( cur, data );
-@@ -8856,7 +8860,7 @@ var rquery = ( /\?/ );
- 
- // Cross-browser xml parsing
- jQuery.parseXML = function( data ) {
--	var xml;
-+	var xml, parserErrorElem;
- 	if ( !data || typeof data !== "string" ) {
- 		return null;
- 	}
-@@ -8865,12 +8869,17 @@ jQuery.parseXML = function( data ) {
- 	// IE throws on parseFromString with invalid input.
- 	try {
- 		xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" );
--	} catch ( e ) {
--		xml = undefined;
--	}
-+	} catch ( e ) {}
- 
--	if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) {
--		jQuery.error( "Invalid XML: " + data );
-+	parserErrorElem = xml && xml.getElementsByTagName( "parsererror" ) 0 ;
-+	if ( !xml || parserErrorElem ) {
-+		jQuery.error( "Invalid XML: " + (
-+			parserErrorElem ?
-+				jQuery.map( parserErrorElem.childNodes, function( el ) {
-+					return el.textContent;
-+				} ).join( "\n" ) :
-+				data
-+		) );
- 	}
- 	return xml;
- };
-@@ -8971,16 +8980,14 @@ jQuery.fn.extend( {
- 			// Can add propHook for "elements" to filter or add form elements
- 			var elements = jQuery.prop( this, "elements" );
- 			return elements ? jQuery.makeArray( elements ) : this;
--		} )
--		.filter( function() {
-+		} ).filter( function() {
- 			var type = this.type;
- 
- 			// Use .is( ":disabled" ) so that fieldsetdisabled works
- 			return this.name && !jQuery( this ).is( ":disabled" ) &&
- 				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
- 				( this.checked || !rcheckableType.test( type ) );
--		} )
--		.map( function( _i, elem ) {
-+		} ).map( function( _i, elem ) {
- 			var val = jQuery( this ).val();
- 
- 			if ( val == null ) {
-@@ -9033,7 +9040,8 @@ var
- 
- 	// Anchor tag for parsing the document origin
- 	originAnchor = document.createElement( "a" );
--	originAnchor.href = location.href;
-+
-+originAnchor.href = location.href;
- 
- // Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
- function addToPrefiltersOrTransports( structure ) {
-@@ -9414,8 +9422,8 @@ jQuery.extend( {
- 			// Context for global events is callbackContext if it is a DOM node or jQuery collection
- 			globalEventContext = s.context &&
- 				( callbackContext.nodeType || callbackContext.jquery ) ?
--					jQuery( callbackContext ) :
--					jQuery.event,
-+				jQuery( callbackContext ) :
-+				jQuery.event,
- 
- 			// Deferreds
- 			deferred = jQuery.Deferred(),
-@@ -9727,8 +9735,10 @@ jQuery.extend( {
- 				response = ajaxHandleResponses( s, jqXHR, responses );
- 			}
- 
--			// Use a noop converter for missing script
--			if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) {
-+			// Use a noop converter for missing script but not if jsonp
-+			if ( !isSuccess &&
-+				jQuery.inArray( "script", s.dataTypes ) > -1 &&
-+				jQuery.inArray( "json", s.dataTypes ) < 0 ) {
- 				s.converters "text script"  = function() {};
- 			}
- 
-@@ -10466,12 +10476,6 @@ jQuery.offset = {
- 			options.using.call( elem, props );
- 
- 		} else {
--			if ( typeof props.top === "number" ) {
--				props.top += "px";
--			}
--			if ( typeof props.left === "number" ) {
--				props.left += "px";
--			}
- 			curElem.css( props );
- 		}
- 	}
-@@ -10640,8 +10644,11 @@ jQuery.each(  "top", "left" , function( _i, prop ) {
- 
- // Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods
- jQuery.each( { Height: "height", Width: "width" }, function( name, type ) {
--	jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name },
--		function( defaultExtra, funcName ) {
-+	jQuery.each( {
-+		padding: "inner" + name,
-+		content: type,
-+		"": "outer" + name
-+	}, function( defaultExtra, funcName ) {
- 
- 		// Margin is only for outerHeight, outerWidth
- 		jQuery.fn funcName  = function( margin, value ) {
-@@ -10726,7 +10733,8 @@ jQuery.fn.extend( {
- 	}
- } );
- 
--jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
-+jQuery.each(
-+	( "blur focus focusin focusout resize scroll click dblclick " +
- 	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
- 	"change select submit keydown keypress keyup contextmenu" ).split( " " ),
- 	function( _i, name ) {
-@@ -10737,7 +10745,8 @@ jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
- 				this.on( name, null, data, fn ) :
- 				this.trigger( name );
- 		};
--	} );
-+	}
-+);
- 
- 
- 
-diff --git a/sphinx/themes/basic/static/jquery.js b/sphinx/themes/basic/static/jquery.js
-index b061403..c4c6022 100644
---- a/sphinx/themes/basic/static/jquery.js
-+++ b/sphinx/themes/basic/static/jquery.js
-@@ -1,2 +1,2 @@
--/*! jQuery v3.5.1 | (c) JS Foundation and other contributors | jquery.org/license */
--!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=,r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply(,e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=tr||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?no.call(e)||"object":typeof e}var f="3.5.1",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0<t&&t-1 in e)}S.fn=S.prototype={jquery:f,constructor:S,length:0,toArray:function(){return s.call(this)},get:function(e){return null==e?s.call(this):e<0?thise+this.length:thise},pushStack:function(e){var t=S.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return S.each(this,e)},map:function(n){return this.pushStack(S.map(this,function(e,t){return n.call(e,t,e)}))},slice:function(){return this.pushStack(s.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},even:function(){return this.pushStack(S.grep(this,function(e,t){return(t+1)%2}))},odd:function(){return this.pushStack(S.grep(this,function(e,t){return t%2}))},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(0<=n&&n<t?thisn:)},end:function(){return this.prevObject||this.constructor()},push:u,sort:t.sort,splice:t.splice},S.extend=S.fn.extend=function(){var e,t,n,r,i,o,a=arguments0||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=argumentss||{},s++),"object"==typeof a||m(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=argumentss))for(t in e)r=et,"__proto__"!==t&&a!==r&&(l&&r&&(S.isPlainObject(r)||(i=Array.isArray(r)))?(n=at,o=i&&!Array.isArray(n)?:i||S.isPlainObject(n)?n:{},i=!1,at=S.extend(l,o,r)):void 0!==r&&(at=r));return a},S.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"object Object"!==o.call(e))&&(!(t=r(e))||"function"==typeof(n=v.call(t,"constructor")&&t.constructor)&&a.call(n)===l)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e,t,n){b(e,{nonce:t&&t.nonce},n)},each:function(e,t){var n,r=0;if(p(e)){for(n=e.length;r<n;r++)if(!1===t.call(er,r,er))break}else for(r in e)if(!1===t.call(er,r,er))break;return e},makeArray:function(e,t){var n=t||;return null!=e&&(p(Object(e))?S.merge(n,"string"==typeof e?e:e):u.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:i.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)ei++=tr;return e.length=i,e},grep:function(e,t,n){for(var r=,i=0,o=e.length,a=!n;i<o;i++)!t(ei,i)!==a&&r.push(ei);return r},map:function(e,t,n){var r,i,o=0,a=;if(p(e))for(r=e.length;o<r;o++)null!=(i=t(eo,o,n))&&a.push(i);else for(o in e)null!=(i=t(eo,o,n))&&a.push(i);return g(a)},guid:1,support:y}),"function"==typeof Symbol&&(S.fnSymbol.iterator=tSymbol.iterator),S.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){n"object "+t+""=t.toLowerCase()});var d=function(n){var e,d,b,o,i,h,f,g,w,u,l,T,C,a,E,v,s,c,y,S="sizzle"+1*new Date,p=n.document,k=0,r=0,m=ue(),x=ue(),A=ue(),N=ue(),D=function(e,t){return e===t&&(l=!0),0},j={}.hasOwnProperty,t=,q=t.pop,L=t.push,H=t.push,O=t.slice,P=function(e,t){for(var n=0,r=e.length;n<r;n++)if(en===t)return n;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="\\x20\\t\\r\\n\\f",I="(?:\\\\\\da-fA-F{1,6}"+M+"?|\\\\^\\r\\n\\f|\\w-|^\0-\\x7f)+",W="\\"+M+"*("+I+")(?:"+M+"*(*^$|!~?=)"+M+"*(?:'((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\"|("+I+"))|)"+M+"*\\",F=":("+I+")(?:\$(('((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\")|((?:\\\\.|^\\\\()\\|"+W+")*)|.*)\$|)",B=new RegExp(M+"+","g"),$=new RegExp("^"+M+"+|((?:^|^\\\\)(?:\\\\.)*)"+M+"+$","g"),_=new RegExp("^"+M+"*,"+M+"*"),z=new RegExp("^"+M+"*(>+~|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|*)"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\$"+M+"*(even|odd|((+-|)(\\d*)n|)"+M+"*(?:(+-|)"+M+"*(\\d+)|))"+M+"*\$|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*>+~|:(even|odd|eq|gt|lt|nth|first|last)(?:\$"+M+"*((?:-\\d)?\\d*)"+M+"*\$|)(?=^-|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^^{+\{\s*\native \w/,Z=/^(?:#(\w-+)|(\w+)|\.(\w-+))$/,ee=/+~/,te=new RegExp("\\\\\\da-fA-F{1,6}"+M+"?|\\\\(^\\r\\n\\f)","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/(\0-\x1f\x7f|^-?\d)|^-$|^\0-\x1f\x7f-\uFFFF\w-/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),tp.childNodes.length.nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(en++=tr++);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||,"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u1){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u2)return H.apply(n,e.getElementsByTagName(t)),n;if((i=u3)&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!Nt+" "&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)lo=(s?"#"+s:":scope")+" "+xe(lo);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=;return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete er.shift(),et+" "=n}}function le(e){return eS=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandlenr=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a(,e.length,o),i=r.length;while(i--)en=ri&&(en=!(tn=en))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e.namespaceURI,n=(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?n:}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)returno;i=t.getElementsByName(e),r=0;while(o=ir++)if((n=o.getAttributeNode("id"))&&n.value===e)returno}return}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=,i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=oi++)1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=,v=,(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="<a id='"+S+"'></a><select id='"+S+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("msallowcapture^=''").length&&v.push("*^$="+M+"*(?:''|\"\")"),e.querySelectorAll("selected").length||v.push("\\"+M+"*(?:value|"+R+")"),e.querySelectorAll("id~="+S+"-").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("name=''").length||v.push("\\"+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.++~"),e.querySelectorAll("\\\f"),v.push("\\r\\n\\f")}),ce(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("name=d").length&&v.push("name"+M+"**^$|!~?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"s!='':x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},D=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=e,s=t;if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(ar===sr)r++;return r?pe(ar,sr):ar==p?-1:sr==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!Nt+" "&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0<se(t,C,null,e).length},se.contains=function(e,t){return(e.ownerDocument||e)!=C&&T(e),y(e,t)},se.attr=function(e,t){(e.ownerDocument||e)!=C&&T(e);var n=b.attrHandlet.toLowerCase(),r=n&&j.call(b.attrHandle,t.toLowerCase())?n(e,t,!E):void 0;return void 0!==r?r:d.attributes||!E?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},se.escape=function(e){return(e+"").replace(re,ie)},se.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},se.uniqueSort=function(e){var t,n=,r=0,i=0;if(l=!d.detectDuplicates,u=!d.sortStable&&e.slice(0),e.sort(D),l){while(t=ei++)t===ei&&(r=n.push(i));while(r--)e.splice(nr,1)}return u=null,e},o=se.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else while(t=er++)n+=o(t);return n},(b=se.selectors={cacheLength:50,createPseudo:le,match:G,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e1=e1.replace(te,ne),e3=(e3||e4||e5||"").replace(te,ne),"~="===e2&&(e3=" "+e3+" "),e.slice(0,4)},CHILD:function(e){return e1=e1.toLowerCase(),"nth"===e1.slice(0,3)?(e3||se.error(e0),e4=+(e4?e5+(e6||1):2*("even"===e3||"odd"===e3)),e5=+(e7+e8||"odd"===e3)):e3&&se.error(e0),e},PSEUDO:function(e){var t,n=!e6&&e2;return G.CHILD.test(e0)?null:(e3?e2=e4||e5||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e0=e0.slice(0,t),e2=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=me+" ";return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1<t.indexOf(i):"$="===r?i&&t.slice(-i.length)===i:"~="===r?-1<(" "+t.replace(B," ")+" ").indexOf(i):"|="===r&&(t===i||t.slice(0,i.length+1)===i+"-"))}},CHILD:function(h,e,t,g,v){var y="nth"!==h.slice(0,3),m="last"!==h.slice(-4),x="of-type"===e;return 1===g&&0===v?function(e){return!!e.parentNode}:function(e,t,n){var r,i,o,a,s,u,l=y!==m?"nextSibling":"previousSibling",c=e.parentNode,f=x&&e.nodeName.toLowerCase(),p=!n&&!x,d=!1;if(c){if(y){while(l){a=e;while(a=al)if(x?a.nodeName.toLowerCase()===f:1===a.nodeType)return!1;u=l="only"===h&&!u&&"nextSibling"}return!0}if(u=m?c.firstChild:c.lastChild,m&&p){d=(s=(r=(i=(o=(a=c)S||(aS={}))a.uniqueID||(oa.uniqueID={}))h||)0===k&&r1)&&r2,a=s&&c.childNodess;while(a=++s&&a&&al||(d=s=0)||u.pop())if(1===a.nodeType&&++d&&a===e){ih=k,s,d;break}}else if(p&&(d=s=(r=(i=(o=(a=e)S||(aS={}))a.uniqueID||(oa.uniqueID={}))h||)0===k&&r1),!1===d)while(a=++s&&a&&al||(d=s=0)||u.pop())if((x?a.nodeName.toLowerCase()===f:1===a.nodeType)&&++d&&(p&&((i=(o=aS||(aS={}))a.uniqueID||(oa.uniqueID={}))h=k,d),a===e))break;return(d-=v)===g||d%g==0&&0<=d/g}}},PSEUDO:function(e,o){var t,a=b.pseudose||b.setFilterse.toLowerCase()||se.error("unsupported pseudo: "+e);return aS?a(o):1<a.length?(t=e,e,"",o,b.setFilters.hasOwnProperty(e.toLowerCase())?le(function(e,t){var n,r=a(e,o),i=r.length;while(i--)en=P(e,ri)=!(tn=ri)}):function(e){return a(e,0,t)}):a}},pseudos:{not:le(function(e){var r=,i=,s=f(e.replace($,"$1"));return sS?le(function(e,t,n,r){var i,o=s(e,null,r,),a=e.length;while(a--)(i=oa)&&(ea=!(ta=i))}):function(e,t,n){return r0=e,s(r,null,n,i),r0=null,!i.pop()}}),has:le(function(t){return function(e){return 0<se(t,e).length}}),contains:le(function(t){return t=t.replace(te,ne),function(e){return-1<(e.textContent||o(e)).indexOf(t)}}),lang:le(function(n){return V.test(n||"")||se.error("unsupported lang: "+n),n=n.replace(te,ne).toLowerCase(),function(e){var t;do{if(t=E?e.lang:e.getAttribute("xml:lang")||e.getAttribute("lang"))return(t=t.toLowerCase())===n||0===t.indexOf(n+"-")}while((e=e.parentNode)&&1===e.nodeType);return!1}}),target:function(e){var t=n.location&&n.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===a},focus:function(e){return e===C.activeElement&&(!C.hasFocus||C.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:ge(!1),disabled:ge(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!b.pseudos.empty(e)},header:function(e){return J.test(e.nodeName)},input:function(e){return Q.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:ve(function(){return0}),last:ve(function(e,t){returnt-1}),eq:ve(function(e,t,n){returnn<0?n+t:n}),even:ve(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:ve(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:ve(function(e,t,n){for(var r=n<0?n+t:t<n?t:n;0<=--r;)e.push(r);return e}),gt:ve(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=b.pseudos.eq,{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})b.pseudose=de(e);for(e in{submit:!0,reset:!0})b.pseudose=he(e);function me(){}function xe(e){for(var t=0,n=e.length,r="";t<n;t++)r+=et.value;return r}function be(s,e,t){var u=e.dir,l=e.next,c=l||u,f=t&&"parentNode"===c,p=r++;return e.first?function(e,t,n){while(e=eu)if(1===e.nodeType||f)return s(e,t,n);return!1}:function(e,t,n){var r,i,o,a=k,p;if(n){while(e=eu)if((1===e.nodeType||f)&&s(e,t,n))return!0}else while(e=eu)if(1===e.nodeType||f)if(i=(o=eS||(eS={}))e.uniqueID||(oe.uniqueID={}),l&&l===e.nodeName.toLowerCase())e=eu||e;else{if((r=ic)&&r0===k&&r1===p)return a2=r2;if((ic=a)2=s(e,t,n))return!0}return!1}}function we(i){return 1<i.length?function(e,t,n){var r=i.length;while(r--)if(!ir(e,t,n))return!1;return!0}:i0}function Te(e,t,n,r,i){for(var o,a=,s=0,u=e.length,l=null!=t;s<u;s++)(o=es)&&(n&&!n(o,r,i)||(a.push(o),l&&t.push(s)));return a}function Ce(d,h,g,v,y,e){return v&&!vS&&(v=Ce(v)),y&&!yS&&(y=Ce(y,e)),le(function(e,t,n,r){var i,o,a,s=,u=,l=t.length,c=e||function(e,t,n){for(var r=0,i=t.length;r<i;r++)se(e,tr,n);return n}(h||"*",n.nodeType?n:n,),f=!d||!e&&h?c:Te(c,s,d,n,r),p=g?y||(e?d:l||v)?:t:f;if(g&&g(f,p,n,r),v){i=Te(p,u),v(i,,n,r),o=i.length;while(o--)(a=io)&&(puo=!(fuo=a))}if(e){if(y||d){if(y){i=,o=p.length;while(o--)(a=po)&&i.push(fo=a);y(null,p=,i,r)}o=p.length;while(o--)(a=po)&&-1<(i=y?P(e,a):so)&&(ei=!(ti=a))}}else p=Te(p===t?p.splice(l,p.length):p),y?y(null,t,p,r):H.apply(t,p)})}function Ee(e){for(var i,t,n,r=e.length,o=b.relativee0.type,a=o||b.relative" ",s=o?1:0,u=be(function(e){return e===i},a,!0),l=be(function(e){return-1<P(i,e)},a,!0),c=function(e,t,n){var r=!o&&(n||t!==w)||((i=t).nodeType?u(e,t,n):l(e,t,n));return i=null,r};s<r;s++)if(t=b.relativees.type)c=be(we(c),t);else{if((t=b.filteres.type.apply(null,es.matches))S){for(n=++s;n<r;n++)if(b.relativeen.type)break;return Ce(1<s&&we(c),1<s&&xe(e.slice(0,s-1).concat({value:" "===es-2.type?"*":""})).replace($,"$1"),t,s<n&&Ee(e.slice(s,n)),n<r&&Ee(e=e.slice(n)),n<r&&xe(e))}c.push(t)}return we(c)}return me.prototype=b.filters=b.pseudos,b.setFilters=new me,h=se.tokenize=function(e,t){var n,r,i,o,a,s,u,l=xe+" ";if(l)return t?0:l.slice(0);a=e,s=,u=b.preFilter;while(a){for(o in n&&!(r=_.exec(a))||(r&&(a=a.slice(r0.length)||a),s.push(i=)),n=!1,(r=z.exec(a))&&(n=r.shift(),i.push({value:n,type:r0.replace($," ")}),a=a.slice(n.length)),b.filter)!(r=Go.exec(a))||uo&&!(r=uo(r))||(n=r.shift(),i.push({value:n,type:o,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?se.error(e):x(e,s).slice(0)},f=se.compile=function(e,t){var n,v,y,m,x,r,i=,o=,a=Ae+" ";if(!a){t||(t=h(e)),n=t.length;while(n--)(a=Ee(tn))S?i.push(a):o.push(a);(a=A(e,(v=o,m=0<(y=i).length,x=0<v.length,r=function(e,t,n,r,i){var o,a,s,u=0,l="0",c=e&&,f=,p=w,d=e||x&&b.find.TAG("*",i),h=k+=null==p?1:Math.random()||.1,g=d.length;for(i&&(w=t==C||t||i);l!==g&&null!=(o=dl);l++){if(x&&o){a=0,t||o.ownerDocument==C||(T(o),n=!E);while(s=va++)if(s(o,t||C,n)){r.push(o);break}i&&(k=h)}m&&((o=!s&&o)&&u--,e&&c.push(o))}if(u+=l,m&&l!==u){a=0;while(s=ya++)s(c,f,t,n);if(e){if(0<u)while(l--)cl||fl||(fl=q.call(r));f=Te(f)}H.apply(r,f),i&&!e&&0<f.length&&1<u+y.length&&se.uniqueSort(r)}return i&&(k=h,w=p),c},m?le(r):r))).selector=e}return a},g=se.select=function(e,t,n,r){var i,o,a,s,u,l="function"==typeof e&&e,c=!r&&h(e=l.selector||e);if(n=n||,1===c.length){if(2<(o=c0=c0.slice(0)).length&&"ID"===(a=o0).type&&9===t.nodeType&&E&&b.relativeo1.type){if(!(t=(b.find.ID(a.matches0.replace(te,ne),t)||)0))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}i=G.needsContext.test(e)?0:o.length;while(i--){if(a=oi,b.relatives=a.type)break;if((u=b.finds)&&(r=u(a.matches0.replace(te,ne),ee.test(o0.type)&&ye(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&xe(o)))return H.apply(n,r),n;break}}}return(l||f(e,c))(r,t,!E,n,!t||ee.test(e)&&ye(t.parentNode)||t),n},d.sortStable=S.split("").sort(D).join("")===S,d.detectDuplicates=!!l,T(),d.sortDetached=ce(function(e){return 1&e.compareDocumentPosition(C.createElement("fieldset"))}),ce(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||fe("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),d.attributes&&ce(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||fe("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ce(function(e){return null==e.getAttribute("disabled")})||fe(R,function(e,t,n){var r;if(!n)return!0===et?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),se}(C);S.find=d,S.expr=d.selectors,S.expr":"=S.expr.pseudos,S.uniqueSort=S.unique=d.uniqueSort,S.text=d.getText,S.isXMLDoc=d.isXML,S.contains=d.contains,S.escapeSelector=d.escape;var h=function(e,t,n){var r=,i=void 0!==n;while((e=et)&&9!==e.nodeType)if(1===e.nodeType){if(i&&S(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=;e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},k=S.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var N=/^<(a-z^\/\0>:\x20\t\r\n\f*)\x20\t\r\n\f*\/?>(?:<\/\1>|)$/i;function D(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1<i.call(n,e)!==r}):S.filter(n,e,r)}S.filter=function(e,t,n){var r=t0;return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?S.find.matchesSelector(r,e)?r::S.find.matches(e,S.grep(t,function(e){return 1===e.nodeType}))},S.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(S(e).filter(function(){for(t=0;t<r;t++)if(S.contains(it,this))return!0}));for(n=this.pushStack(),t=0;t<r;t++)S.find(e,it,n);return 1<r?S.uniqueSort(n):n},filter:function(e){return this.pushStack(D(this,e||,!1))},not:function(e){return this.pushStack(D(this,e||,!0))},is:function(e){return!!D(this,"string"==typeof e&&k.test(e)?S(e):e||,!1).length}});var j,q=/^(?:\s*(<\w\W+>)^>*|#(\w-+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||j,"string"==typeof e){if(!(r="<"===e0&&">"===ee.length-1&&3<=e.length?null,e,null:q.exec(e))||!r1&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r1){if(t=t instanceof S?t0:t,S.merge(this,S.parseHTML(r1,t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r1)&&S.isPlainObject(t))for(r in t)m(thisr)?thisr(tr):this.attr(r,tr);return this}return(i=E.getElementById(r2))&&(this0=i,this.length=1),this}return e.nodeType?(this0=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,j=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=et)&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(S.contains(this,te))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=,a="string"!=typeof e&&S(e);if(!k.test(e))for(;r<i;r++)for(n=thisr;n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?-1<a.index(n):1===n.nodeType&&S.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(1<o.length?S.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?i.call(S(e),this0):i.call(this,e.jquery?e0:e):this0&&this0.parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(S.uniqueSort(S.merge(this.get(),S(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),S.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return h(e,"parentNode")},parentsUntil:function(e,t,n){return h(e,"parentNode",n)},next:function(e){return O(e,"nextSibling")},prev:function(e){return O(e,"previousSibling")},nextAll:function(e){return h(e,"nextSibling")},prevAll:function(e){return h(e,"previousSibling")},nextUntil:function(e,t,n){return h(e,"nextSibling",n)},prevUntil:function(e,t,n){return h(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return null!=e.contentDocument&&r(e.contentDocument)?e.contentDocument:(A(e,"template")&&(e=e.content||e),S.merge(,e.childNodes))}},function(r,i){S.fnr=function(e,t){var n=S.map(this,i,e);return"Until"!==r.slice(-5)&&(t=e),t&&"string"==typeof t&&(n=S.filter(t,n)),1<this.length&&(Hr||S.uniqueSort(n),L.test(r)&&n.reverse()),this.pushStack(n)}});var P=/^\x20\t\r\n\f+/g;function R(e){return e}function M(e){throw e}function I(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,e.slice(r))}catch(e){n.apply(void 0,e)}}S.Callbacks=function(r){var e,n;r="string"==typeof r?(e=r,n={},S.each(e.match(P)||,function(e,t){nt=!0}),n):S.extend({},r);var i,t,o,a,s=,u=,l=-1,c=function(){for(a=a||r.once,o=i=!0;u.length;l=-1){t=u.shift();while(++l<s.length)!1===sl.apply(t0,t1)&&r.stopOnFalse&&(l=s.length,t=!1)}r.memory||(t=!1),i=!1,a&&(s=t?:"")},f={add:function(){return s&&(t&&!i&&(l=s.length-1,u.push(t)),function n(e){S.each(e,function(e,t){m(t)?r.unique&&f.has(t)||s.push(t):t&&t.length&&"string"!==w(t)&&n(t)})}(arguments),t&&!i&&c()),this},remove:function(){return S.each(arguments,function(e,t){var n;while(-1<(n=S.inArray(t,s,n)))s.splice(n,1),n<=l&&l--}),this},has:function(e){return e?-1<S.inArray(e,s):0<s.length},empty:function(){return s&&(s=),this},disable:function(){return a=u=,s=t="",this},disabled:function(){return!s},lock:function(){return a=u=,t||i||(s=t=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=e,(t=t||).slice?t.slice():t,u.push(t),i||c()),this},fire:function(){return f.fireWith(this,arguments),this},fired:function(){return!!o}};return f},S.extend({Deferred:function(e){var o="notify","progress",S.Callbacks("memory"),S.Callbacks("memory"),2,"resolve","done",S.Callbacks("once memory"),S.Callbacks("once memory"),0,"resolved","reject","fail",S.Callbacks("once memory"),S.Callbacks("once memory"),1,"rejected",i="pending",a={state:function(){return i},always:function(){return s.done(arguments).fail(arguments),this},"catch":function(e){return a.then(null,e)},pipe:function(){var i=arguments;return S.Deferred(function(r){S.each(o,function(e,t){var n=m(it4)&&it4;st1(function(){var e=n&&n.apply(this,arguments);e&&m(e.promise)?e.promise().progress(r.notify).done(r.resolve).fail(r.reject):rt0+"With"(this,n?e:arguments)})}),i=null}).promise()},then:function(t,n,r){var u=0;function l(i,o,a,s){return function(){var n=this,r=arguments,e=function(){var e,t;if(!(i<u)){if((e=a.apply(n,r))===o.promise())throw new TypeError("Thenable self-resolution");t=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(t)?s?t.call(e,l(u,o,R,s),l(u,o,M,s)):(u++,t.call(e,l(u,o,R,s),l(u,o,M,s),l(u,o,R,o.notifyWith))):(a!==R&&(n=void 0,r=e),(s||o.resolveWith)(n,r))}},t=s?e:function(){try{e()}catch(e){S.Deferred.exceptionHook&&S.Deferred.exceptionHook(e,t.stackTrace),u<=i+1&&(a!==M&&(n=void 0,r=e),o.rejectWith(n,r))}};i?t():(S.Deferred.getStackHook&&(t.stackTrace=S.Deferred.getStackHook()),C.setTimeout(t))}}return S.Deferred(function(e){o03.add(l(0,e,m(r)?r:R,e.notifyWith)),o13.add(l(0,e,m(t)?t:R)),o23.add(l(0,e,m(n)?n:M))}).promise()},promise:function(e){return null!=e?S.extend(e,a):a}},s={};return S.each(o,function(e,t){var n=t2,r=t5;at1=n.add,r&&n.add(function(){i=r},o3-e2.disable,o3-e3.disable,o02.lock,o03.lock),n.add(t3.fire),st0=function(){return st0+"With"(this===s?void 0:this,arguments),this},st0+"With"=n.fireWith}),a.promise(s),e&&e.call(s,s),s},when:function(e){var n=arguments.length,t=n,r=Array(t),i=s.call(arguments),o=S.Deferred(),a=function(t){return function(e){rt=this,it=1<arguments.length?s.call(arguments):e,--n||o.resolveWith(r,i)}};if(n<=1&&(I(e,o.done(a(t)).resolve,o.reject,!n),"pending"===o.state()||m(it&&it.then)))return o.then();while(t--)I(it,a(t),o.reject);return o.promise()}});var W=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;S.Deferred.exceptionHook=function(e,t){C.console&&C.console.warn&&e&&W.test(e.name)&&C.console.warn("jQuery.Deferred exception: "+e.message,e.stack,t)},S.readyException=function(e){C.setTimeout(function(){throw e})};var F=S.Deferred();function B(){E.removeEventListener("DOMContentLoaded",B),C.removeEventListener("load",B),S.ready()}S.fn.ready=function(e){return F.then(e)"catch"(function(e){S.readyException(e)}),this},S.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--S.readyWait:S.isReady)||(S.isReady=!0)!==e&&0<--S.readyWait||F.resolveWith(E,S)}}),S.ready.then=F.then,"complete"===E.readyState||"loading"!==E.readyState&&!E.documentElement.doScroll?C.setTimeout(S.ready):(E.addEventListener("DOMContentLoaded",B),C.addEventListener("load",B));var $=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===w(n))for(s in i=!0,n)$(e,t,s,ns,!0,o,a);else if(void 0!==r&&(i=!0,m(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(S(e),n)})),t))for(;s<u;s++)t(es,n,a?r:r.call(es,s,t(es,n)));return i?e:l?t.call(e):u?t(e0,n):o},_=/^-ms-/,z=/-(a-z)/g;function U(e,t){return t.toUpperCase()}function X(e){return e.replace(_,"ms-").replace(z,U)}var V=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function G(){this.expando=S.expando+G.uid++}G.uid=1,G.prototype={cache:function(e){var t=ethis.expando;return t||(t={},V(e)&&(e.nodeType?ethis.expando=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)iX(t)=n;else for(r in t)iX(r)=tr;return i},get:function(e,t){return void 0===t?this.cache(e):ethis.expando&&ethis.expandoX(t)},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=ethis.expando;if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(X):(t=X(t))in r?t:t.match(P)||).length;while(n--)delete rtn}(void 0===t||S.isEmptyObject(r))&&(e.nodeType?ethis.expando=void 0:delete ethis.expando)}},hasData:function(e){var t=ethis.expando;return void 0!==t&&!S.isEmptyObject(t)}};var Y=new G,Q=new G,J=/^(?:\{\w\W*\}|\\w\W*\)$/,K=/A-Z/g;function Z(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}S.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),S.fn.extend({data:function(n,e){var t,r,i,o=this0,a=o&&o.attributes;if(void 0===n){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){t=a.length;while(t--)at&&0===(r=at.name).indexOf("data-")&&(r=X(r.slice(5)),Z(o,r,ir));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof n?this.each(function(){Q.set(this,n)}):$(this,function(e){var t;if(o&&void 0===e)return void 0!==(t=Q.get(o,n))?t:void 0!==(t=Z(o,n))?t:void 0;this.each(function(){Q.set(this,n,e)})},null,e,1<arguments.length,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),S.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,S.makeArray(n)):r.push(n)),r||},dequeue:function(e,t){t=t||"fx";var n=S.queue(e,t),r=n.length,i=n.shift(),o=S._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){S.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:S.Callbacks("once memory").add(function(){Y.remove(e,t+"queue",n)})})}}),S.fn.extend({queue:function(t,n){var e=2;return"string"!=typeof t&&(n=t,t="fx",e--),arguments.length<e?S.queue(this0,t):void 0===n?this:this.each(function(){var e=S.queue(this,t,n);S._queueHooks(this,t),"fx"===t&&"inprogress"!==e0&&S.dequeue(this,t)})},dequeue:function(e){return this.each(function(){S.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",)},promise:function(e,t){var n,r=1,i=S.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,o)};"string"!=typeof e&&(t=e,e=void 0),e=e||"fx";while(a--)(n=Y.get(oa,e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var ee=/+-?(?:\d*\.|)\d+(?:eE+-?\d+|)/.source,te=new RegExp("^(?:(+-)=|)("+ee+")(a-z%*)$","i"),ne="Top","Right","Bottom","Left",re=E.documentElement,ie=function(e){return S.contains(e.ownerDocument,e)},oe={composed:!0};re.getRootNode&&(ie=function(e){return S.contains(e.ownerDocument,e)||e.getRootNode(oe)===e.ownerDocument});var ae=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&ie(e)&&"none"===S.css(e,"display")};function se(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return S.css(e,t,"")},u=s(),l=n&&n3||(S.cssNumbert?"":"px"),c=e.nodeType&&(S.cssNumbert||"px"!==l&&+u)&&te.exec(S.css(e,t));if(c&&c3!==l){u/=2,l=l||c3,c=+u||1;while(a--)S.style(e,t,c+l),(1-o)*(1-(o=s()/u||.5))<=0&&(a=0),c/=o;c*=2,S.style(e,t,c+l),n=n||}return n&&(c=+c||+u||0,i=n1?c+(n1+1)*n2:+n2,r&&(r.unit=l,r.start=c,r.end=i)),i}var ue={};function le(e,t){for(var n,r,i,o,a,s,u,l=,c=0,f=e.length;c<f;c++)(r=ec).style&&(n=r.style.display,t?("none"===n&&(lc=Y.get(r,"display")||null,lc||(r.style.display="")),""===r.style.display&&ae(r)&&(lc=(u=a=o=void 0,a=(i=r).ownerDocument,s=i.nodeName,(u=ues)||(o=a.body.appendChild(a.createElement(s)),u=S.css(o,"display"),o.parentNode.removeChild(o),"none"===u&&(u="block"),ues=u)))):"none"!==n&&(lc="none",Y.set(r,"display",n)));for(c=0;c<f;c++)null!=lc&&(ec.style.display=lc);return e}S.fn.extend({show:function(){return le(this,!0)},hide:function(){return le(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ae(this)?S(this).show():S(this).hide()})}});var ce,fe,pe=/^(?:checkbox|radio)$/i,de=/<(a-z^\/\0>\x20\t\r\n\f*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="<textarea>x</textarea>",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="<option></option>",y.option=!!ce.lastChild;var ge={thead:1,"<table>","</table>",col:2,"<table><colgroup>","</colgroup></table>",tr:2,"<table><tbody>","</tbody></table>",td:3,"<table><tbody><tr>","</tr></tbody></table>",_default:0,"",""};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):,void 0===t||t&&A(e,t)?S.merge(e,n):n}function ye(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(en,"globalEval",!t||Y.get(tn,"globalEval"))}ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td,y.option||(ge.optgroup=ge.option=1,"<select multiple='multiple'>","</select>");var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=,d=0,h=e.length;d<h;d++)if((o=ed)||0===o)if("object"===w(o))S.merge(p,o.nodeType?o:o);else if(me.test(o)){a=a||f.appendChild(t.createElement("div")),s=(de.exec(o)||"","")1.toLowerCase(),u=ges||ge._default,a.innerHTML=u1+S.htmlPrefilter(o)+u2,c=u0;while(c--)a=a.lastChild;S.merge(p,a.childNodes),(a=f.firstChild).textContent=""}else p.push(t.createTextNode(o));f.textContent="",d=0;while(o=pd++)if(r&&-1<S.inArray(o,r))i&&i.push(o);else if(l=ie(o),a=ve(f.appendChild(o),"script"),l&&ye(a),n){c=0;while(o=ac++)he.test(o.type||"")&&n.push(o)}return f}var be=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,Te=/^(^.*)(?:\.(.+)|)/;function Ce(){return!0}function Ee(){return!1}function Se(e,t){return e===function(){try{return E.activeElement}catch(e){}}()==("focus"===t)}function ke(e,t,n,r,i,o){var a,s;if("object"==typeof t){for(s in"string"!=typeof n&&(r=r||n,n=void 0),t)ke(e,s,n,r,ts,o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ee;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return S().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=S.guid++)),e.each(function(){S.event.add(this,t,i,r,n)})}function Ae(e,i,o){o?(Y.set(e,i,!1),S.event.add(e,i,{namespace:!1,handler:function(e){var t,n,r=Y.get(this,i);if(1&e.isTrigger&&thisi){if(r.length)(S.event.speciali||{}).delegateType&&e.stopPropagation();else if(r=s.call(arguments),Y.set(this,i,r),t=o(this,i),thisi(),r!==(n=Y.get(this,i))||t?Y.set(this,i,!1):n={},r!==n)return e.stopImmediatePropagation(),e.preventDefault(),n.value}else r.length&&(Y.set(this,i,{value:S.event.trigger(S.extend(r0,S.Event.prototype),r.slice(1),this)}),e.stopImmediatePropagation())}})):void 0===Y.get(e,i)&&S.event.add(e,i,Ce)}S.event={global:{},add:function(t,e,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.get(t);if(V(t)){n.handler&&(n=(o=n).handler,i=o.selector),i&&S.find.matchesSelector(re,i),n.guid||(n.guid=S.guid++),(u=v.events)||(u=v.events=Object.create(null)),(a=v.handle)||(a=v.handle=function(e){return"undefined"!=typeof S&&S.event.triggered!==e.type?S.event.dispatch.apply(t,arguments):void 0}),l=(e=(e||"").match(P)||"").length;while(l--)d=g=(s=Te.exec(el)||)1,h=(s2||"").split(".").sort(),d&&(f=S.event.speciald||{},d=(i?f.delegateType:f.bindType)||d,f=S.event.speciald||{},c=S.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&S.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=ud)||((p=ud=).delegateCount=0,f.setup&&!1!==f.setup.call(t,r,h,a)||t.addEventListener&&t.addEventListener(d,a)),f.add&&(f.add.call(t,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),S.event.globald=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.hasData(e)&&Y.get(e);if(v&&(u=v.events)){l=(t=(t||"").match(P)||"").length;while(l--)if(d=g=(s=Te.exec(tl)||)1,h=(s2||"").split(".").sort(),d){f=S.event.speciald||{},p=ud=(r?f.delegateType:f.bindType)||d||,s=s2&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=po,!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,v.handle)||S.removeEvent(e,d,v.handle),delete ud)}else for(d in u)S.event.remove(e,d+tl,n,r,!0);S.isEmptyObject(u)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=new Array(arguments.length),u=S.event.fix(e),l=(Y.get(this,"events")||Object.create(null))u.type||,c=S.event.specialu.type||{};for(s0=u,t=1;t<arguments.length;t++)st=argumentst;if(u.delegateTarget=this,!c.preDispatch||!1!==c.preDispatch.call(this,u)){a=S.event.handlers.call(this,u,l),t=0;while((i=at++)&&!u.isPropagationStopped()){u.currentTarget=i.elem,n=0;while((o=i.handlersn++)&&!u.isImmediatePropagationStopped())u.rnamespace&&!1!==o.namespace&&!u.rnamespace.test(o.namespace)||(u.handleObj=o,u.data=o.data,void 0!==(r=((S.event.specialo.origType||{}).handle||o.handler).apply(i.elem,s))&&!1===(u.result=r)&&(u.preventDefault(),u.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,u),u.result}},handlers:function(e,t){var n,r,i,o,a,s=,u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&1<=e.button))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=,a={},n=0;n<u;n++)void 0===ai=(r=tn).selector+" "&&(ai=r.needsContext?-1<S(i,this).index(l):S.find(i,this,null,l).length),ai&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(t,e){Object.defineProperty(S.Event.prototype,t,{enumerable:!0,configurable:!0,get:m(e)?function(){if(this.originalEvent)return e(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEventt},set:function(e){Object.defineProperty(this,t,{enumerable:!0,configurable:!0,writable:!0,value:e})}})},fix:function(e){return eS.expando?e:new S.Event(e)},special:{load:{noBubble:!0},click:{setup:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Ae(t,"click",Ce),!1},trigger:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Ae(t,"click"),!0},_default:function(e){var t=e.target;return pe.test(t.type)&&t.click&&A(t,"input")&&Y.get(t,"click")||A(t,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},S.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},S.Event=function(e,t){if(!(this instanceof S.Event))return new S.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?Ce:Ee,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&S.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),thisS.expando=!0},S.Event.prototype={constructor:S.Event,isDefaultPrevented:Ee,isPropagationStopped:Ee,isImmediatePropagationStopped:Ee,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=Ce,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=Ce,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=Ce,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},S.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,"char":!0,code:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:function(e){var t=e.button;return null==e.which&&be.test(e.type)?null!=e.charCode?e.charCode:e.keyCode:!e.which&&void 0!==t&&we.test(e.type)?1&t?1:2&t?3:4&t?2:0:e.which}},S.event.addProp),S.each({focus:"focusin",blur:"focusout"},function(e,t){S.event.speciale={setup:function(){return Ae(this,e,Se),!1},trigger:function(){return Ae(this,e),!0},delegateType:t}}),S.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,i){S.event.speciale={delegateType:i,bindType:i,handle:function(e){var t,n=e.relatedTarget,r=e.handleObj;return n&&(n===this||S.contains(this,n))||(e.type=r.origType,t=r.handler.apply(this,arguments),e.type=i),t}}}),S.fn.extend({on:function(e,t,n,r){return ke(this,e,t,n,r)},one:function(e,t,n,r){return ke(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,S(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,ei);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Ee),this.each(function(){S.event.remove(this,e,n,t)})}});var Ne=/<script|<style|<link/i,De=/checked\s*(?:^=|=\s*.checked.)/i,je=/^\s*<!(?:\CDATA\|--)|(?:\\|--)>\s*$/g;function qe(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")0||e}function Le(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function He(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Oe(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=si.length;n<r;n++)S.event.add(t,i,sin);Q.hasData(e)&&(o=Q.access(e),a=S.extend({},o),Q.set(t,a))}}function Pe(n,r,i,o){r=g(r);var e,t,a,s,u,l,c=0,f=n.length,p=f-1,d=r0,h=m(d);if(h||1<f&&"string"==typeof d&&!y.checkClone&&De.test(d))return n.each(function(e){var t=n.eq(e);h&&(r0=d.call(this,e,t.html())),Pe(t,r,i,o)});if(f&&(t=(e=xe(r,n0.ownerDocument,!1,n,o)).firstChild,1===e.childNodes.length&&(e=t),t||o)){for(s=(a=S.map(ve(e,"script"),Le)).length;c<f;c++)u=e,c!==p&&(u=S.clone(u,!0,!0),s&&S.merge(a,ve(u,"script"))),i.call(nc,u,c);if(s)for(l=aa.length-1.ownerDocument,S.map(a,He),c=0;c<s;c++)u=ac,he.test(u.type||"")&&!Y.access(u,"globalEval")&&S.contains(l,u)&&(u.src&&"module"!==(u.type||"").toLowerCase()?S._evalUrl&&!u.noModule&&S._evalUrl(u.src,{nonce:u.nonce||u.getAttribute("nonce")},l):b(u.textContent.replace(je,""),u,l))}return n}function Re(e,t,n){for(var r,i=t?S.filter(t,e):e,o=0;null!=(r=io);o++)n||1!==r.nodeType||S.cleanData(ve(r)),r.parentNode&&(n&&ie(r)&&ye(ve(r,"script")),r.parentNode.removeChild(r));return e}S.extend({htmlPrefilter:function(e){return e},clone:function(e,t,n){var r,i,o,a,s,u,l,c=e.cloneNode(!0),f=ie(e);if(!(y.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||S.isXMLDoc(e)))for(a=ve(c),r=0,i=(o=ve(e)).length;r<i;r++)s=or,u=ar,void 0,"input"===(l=u.nodeName.toLowerCase())&&pe.test(s.type)?u.checked=s.checked:"input"!==l&&"textarea"!==l||(u.defaultValue=s.defaultValue);if(t)if(n)for(o=o||ve(e),a=a||ve(c),r=0,i=o.length;r<i;r++)Oe(or,ar);else Oe(e,c);return 0<(a=ve(c,"script")).length&&ye(a,!f&&ve(e,"script")),c},cleanData:function(e){for(var t,n,r,i=S.event.special,o=0;void 0!==(n=eo);o++)if(V(n)){if(t=nY.expando){if(t.events)for(r in t.events)ir?S.event.remove(n,r):S.removeEvent(n,r,t.handle);nY.expando=void 0}nQ.expando&&(nQ.expando=void 0)}}}),S.fn.extend({detach:function(e){return Re(this,e,!0)},remove:function(e){return Re(this,e)},text:function(e){return $(this,function(e){return void 0===e?S.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Pe(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||qe(this,e).appendChild(e)})},prepend:function(){return Pe(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=qe(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Pe(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Pe(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=thist);t++)1===e.nodeType&&(S.cleanData(ve(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return S.clone(this,e,t)})},html:function(e){return $(this,function(e){var t=this0||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Ne.test(e)&&!ge(de.exec(e)||"","")1.toLowerCase()){e=S.htmlPrefilter(e);try{for(;n<r;n++)1===(t=thisn||{}).nodeType&&(S.cleanData(ve(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var n=;return Pe(this,arguments,function(e){var t=this.parentNode;S.inArray(this,n)<0&&(S.cleanData(ve(this)),t&&t.replaceChild(e,this))},n)}}),S.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,a){S.fne=function(e){for(var t,n=,r=S(e),i=r.length-1,o=0;o<=i;o++)t=o===i?this:this.clone(!0),S(ro)a(t),u.apply(n,t.get());return this.pushStack(n)}});var Me=new RegExp("^("+ee+")(?!px)a-z%+$","i"),Ie=function(e){var t=e.ownerDocument.defaultView;return t&&t.opener||(t=C),t.getComputedStyle(e)},We=function(e,t,n){var r,i,o={};for(i in t)oi=e.stylei,e.stylei=ti;for(i in r=n.call(e),t)e.stylei=oi;return r},Fe=new RegExp(ne.join("|"),"i");function Be(e,t,n){var r,i,o,a,s=e.style;return(n=n||Ie(e))&&(""!==(a=n.getPropertyValue(t)||nt)||ie(e)||(a=S.style(e,t)),!y.pixelBoxStyles()&&Me.test(a)&&Fe.test(t)&&(r=s.width,i=s.minWidth,o=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=i,s.maxWidth=o)),void 0!==a?a+"":a}function $e(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function e(){if(l){u.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",l.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",re.appendChild(u).appendChild(l);var e=C.getComputedStyle(l);n="1%"!==e.top,s=12===t(e.marginLeft),l.style.right="60%",o=36===t(e.right),r=36===t(e.width),l.style.position="absolute",i=12===t(l.offsetWidth/3),re.removeChild(u),l=null}}function t(e){return Math.round(parseFloat(e))}var n,r,i,o,a,s,u=E.createElement("div"),l=E.createElement("div");l.style&&(l.style.backgroundClip="content-box",l.cloneNode(!0).style.backgroundClip="",y.clearCloneStyle="content-box"===l.style.backgroundClip,S.extend(y,{boxSizingReliable:function(){return e(),r},pixelBoxStyles:function(){return e(),o},pixelPosition:function(){return e(),n},reliableMarginLeft:function(){return e(),s},scrollboxSize:function(){return e(),i},reliableTrDimensions:function(){var e,t,n,r;return null==a&&(e=E.createElement("table"),t=E.createElement("tr"),n=E.createElement("div"),e.style.cssText="position:absolute;left:-11111px",t.style.height="1px",n.style.height="9px",re.appendChild(e).appendChild(t).appendChild(n),r=C.getComputedStyle(t),a=3<parseInt(r.height),re.removeChild(e)),a}}))}();var _e="Webkit","Moz","ms",ze=E.createElement("div").style,Ue={};function Xe(e){var t=S.cssPropse||Uee;return t||(e in ze?e:Uee=function(e){var t=e0.toUpperCase()+e.slice(1),n=_e.length;while(n--)if((e=_en+t)in ze)return e}(e)||e)}var Ve=/^(none|table(?!-cea).+)/,Ge=/^--/,Ye={position:"absolute",visibility:"hidden",display:"block"},Qe={letterSpacing:"0",fontWeight:"400"};function Je(e,t,n){var r=te.exec(t);return r?Math.max(0,r2-(n||0))+(r3||"px"):t}function Ke(e,t,n,r,i,o){var a="width"===t?1:0,s=0,u=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(u+=S.css(e,n+nea,!0,i)),r?("content"===n&&(u-=S.css(e,"padding"+nea,!0,i)),"margin"!==n&&(u-=S.css(e,"border"+nea+"Width",!0,i))):(u+=S.css(e,"padding"+nea,!0,i),"padding"!==n?u+=S.css(e,"border"+nea+"Width",!0,i):s+=S.css(e,"border"+nea+"Width",!0,i));return!r&&0<=o&&(u+=Math.max(0,Math.ceil(e"offset"+t0.toUpperCase()+t.slice(1)-o-u-s-.5))||0),u}function Ze(e,t,n){var r=Ie(e),i=(!y.boxSizingReliable()||n)&&"border-box"===S.css(e,"boxSizing",!1,r),o=i,a=Be(e,t,r),s="offset"+t0.toUpperCase()+t.slice(1);if(Me.test(a)){if(!n)return a;a="auto"}return(!y.boxSizingReliable()&&i||!y.reliableTrDimensions()&&A(e,"tr")||"auto"===a||!parseFloat(a)&&"inline"===S.css(e,"display",!1,r))&&e.getClientRects().length&&(i="border-box"===S.css(e,"boxSizing",!1,r),(o=s in e)&&(a=es)),(a=parseFloat(a)||0)+Ke(e,t,n||(i?"border":"content"),o,r,a)+"px"}function et(e,t,n,r,i){return new et.prototype.init(e,t,n,r,i)}S.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Be(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,gridArea:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnStart:!0,gridRow:!0,gridRowEnd:!0,gridRowStart:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=X(t),u=Ge.test(t),l=e.style;if(u||(t=Xe(s)),a=S.cssHookst||S.cssHookss,void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:lt;"string"===(o=typeof n)&&(i=te.exec(n))&&i1&&(n=se(e,t,i),o="number"),null!=n&&n==n&&("number"!==o||u||(n+=i&&i3||(S.cssNumbers?"":"px")),y.clearCloneStyle||""!==n||0!==t.indexOf("background")||(lt="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):lt=n))}},css:function(e,t,n,r){var i,o,a,s=X(t);return Ge.test(t)||(t=Xe(s)),(a=S.cssHookst||S.cssHookss)&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=Be(e,t,r)),"normal"===i&&t in Qe&&(i=Qet),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),S.each("height","width",function(e,u){S.cssHooksu={get:function(e,t,n){if(t)return!Ve.test(S.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Ze(e,u,n):We(e,Ye,function(){return Ze(e,u,n)})},set:function(e,t,n){var r,i=Ie(e),o=!y.scrollboxSize()&&"absolute"===i.position,a=(o||n)&&"border-box"===S.css(e,"boxSizing",!1,i),s=n?Ke(e,u,n,a,i):0;return a&&o&&(s-=Math.ceil(e"offset"+u0.toUpperCase()+u.slice(1)-parseFloat(iu)-Ke(e,u,"border",!1,i)-.5)),s&&(r=te.exec(t))&&"px"!==(r3||"px")&&(e.styleu=t,t=S.css(e,u)),Je(0,t,s)}}}),S.cssHooks.marginLeft=$e(y.reliableMarginLeft,function(e,t){if(t)return(parseFloat(Be(e,"marginLeft"))||e.getBoundingClientRect().left-We(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),S.each({margin:"",padding:"",border:"Width"},function(i,o){S.cssHooksi+o={expand:function(e){for(var t=0,n={},r="string"==typeof e?e.split(" "):e;t<4;t++)ni+net+o=rt||rt-2||r0;return n}},"margin"!==i&&(S.cssHooksi+o.set=Je)}),S.fn.extend({css:function(e,t){return $(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Ie(e),i=t.length;a<i;a++)ota=S.css(e,ta,!1,r);return o}return void 0!==n?S.style(e,t,n):S.css(e,t)},e,t,1<arguments.length)}}),((S.Tween=et).prototype={constructor:et,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||S.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(S.cssNumbern?"":"px")},cur:function(){var e=et.propHooksthis.prop;return e&&e.get?e.get(this):et.propHooks._default.get(this)},run:function(e){var t,n=et.propHooksthis.prop;return this.options.duration?this.pos=t=S.easingthis.easing(e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):et.propHooks._default.set(this),this}}).init.prototype=et.prototype,(et.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.eleme.prop&&null==e.elem.stylee.prop?e.eleme.prop:(t=S.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){S.fx.stepe.prop?S.fx.stepe.prop(e):1!==e.elem.nodeType||!S.cssHookse.prop&&null==e.elem.styleXe(e.prop)?e.eleme.prop=e.now:S.style(e.elem,e.prop,e.now+e.unit)}}}).scrollTop=et.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.eleme.prop=e.now)}},S.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},S.fx=et.prototype.init,S.fx.step={};var tt,nt,rt,it,ot=/^(?:toggle|show|hide)$/,at=/queueHooks$/;function st(){nt&&(!1===E.hidden&&C.requestAnimationFrame?C.requestAnimationFrame(st):C.setTimeout(st,S.fx.interval),S.fx.tick())}function ut(){return C.setTimeout(function(){tt=void 0}),tt=Date.now()}function lt(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i"margin"+(n=ner)=i"padding"+n=e;return t&&(i.opacity=i.width=e),i}function ct(e,t,n){for(var r,i=(ft.tweenerst||).concat(ft.tweeners"*"),o=0,a=i.length;o<a;o++)if(r=io.call(n,t,e))return r}function ft(o,e,t){var n,a,r=0,i=ft.prefilters.length,s=S.Deferred().always(function(){delete u.elem}),u=function(){if(a)return!1;for(var e=tt||ut(),t=Math.max(0,l.startTime+l.duration-e),n=1-(t/l.duration||0),r=0,i=l.tweens.length;r<i;r++)l.tweensr.run(n);return s.notifyWith(o,l,n,t),n<1&&i?t:(i||s.notifyWith(o,l,1,0),s.resolveWith(o,l),!1)},l=s.promise({elem:o,props:S.extend({},e),opts:S.extend(!0,{specialEasing:{},easing:S.easing._default},t),originalProperties:e,originalOptions:t,startTime:tt||ut(),duration:t.duration,tweens:,createTween:function(e,t){var n=S.Tween(o,l.opts,e,t,l.opts.specialEasinge||l.opts.easing);return l.tweens.push(n),n},stop:function(e){var t=0,n=e?l.tweens.length:0;if(a)return this;for(a=!0;t<n;t++)l.tweenst.run(1);return e?(s.notifyWith(o,l,1,0),s.resolveWith(o,l,e)):s.rejectWith(o,l,e),this}}),c=l.props;for(!function(e,t){var n,r,i,o,a;for(n in e)if(i=tr=X(n),o=en,Array.isArray(o)&&(i=o1,o=en=o0),n!==r&&(er=o,delete en),(a=S.cssHooksr)&&"expand"in a)for(n in o=a.expand(o),delete er,o)n in e||(en=on,tn=i);else tr=i}(c,l.opts.specialEasing);r<i;r++)if(n=ft.prefiltersr.call(l,o,c,l.opts))return m(n.stop)&&(S._queueHooks(l.elem,l.opts.queue).stop=n.stop.bind(n)),n;return S.map(c,ct,l),m(l.opts.start)&&l.opts.start.call(o,l),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always),S.fx.timer(S.extend(u,{elem:o,anim:l,queue:l.opts.queue})),l}S.Animation=S.extend(ft,{tweeners:{"*":function(e,t){var n=this.createTween(e,t);return se(n.elem,e,te.exec(t),n),n}},tweener:function(e,t){m(e)?(t=e,e="*"):e=e.match(P);for(var n,r=0,i=e.length;r<i;r++)n=er,ft.tweenersn=ft.tweenersn||,ft.tweenersn.unshift(t)},prefilters:function(e,t,n){var r,i,o,a,s,u,l,c,f="width"in t||"height"in t,p=this,d={},h=e.style,g=e.nodeType&&ae(e),v=Y.get(e,"fxshow");for(r in n.queue||(null==(a=S._queueHooks(e,"fx")).unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,S.queue(e,"fx").length||a.empty.fire()})})),t)if(i=tr,ot.test(i)){if(delete tr,o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!v||void 0===vr)continue;g=!0}dr=v&&vr||S.style(e,r)}if((u=!S.isEmptyObject(t))||!S.isEmptyObject(d))for(r in f&&1===e.nodeType&&(n.overflow=h.overflow,h.overflowX,h.overflowY,null==(l=v&&v.display)&&(l=Y.get(e,"display")),"none"===(c=S.css(e,"display"))&&(l?c=l:(le(e,!0),l=e.style.display||l,c=S.css(e,"display"),le(e))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===S.css(e,"float")&&(u||(p.done(function(){h.display=l}),null==l&&(c=h.display,l="none"===c?"":c)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",p.always(function(){h.overflow=n.overflow0,h.overflowX=n.overflow1,h.overflowY=n.overflow2})),u=!1,d)u||(v?"hidden"in v&&(g=v.hidden):v=Y.access(e,"fxshow",{display:l}),o&&(v.hidden=!g),g&&le(e,!0),p.done(function(){for(r in g||le(e),Y.remove(e,"fxshow"),d)S.style(e,r,dr)})),u=ct(g?vr:0,r,p),r in v||(vr=u.start,g&&(u.end=u.start,u.start=0))},prefilter:function(e,t){t?ft.prefilters.unshift(e):ft.prefilters.push(e)}}),S.speed=function(e,t,n){var r=e&&"object"==typeof e?S.extend({},e):{complete:n||!n&&t||m(e)&&e,duration:e,easing:n&&t||t&&!m(t)&&t};return S.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in S.fx.speeds?r.duration=S.fx.speedsr.duration:r.duration=S.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){m(r.old)&&r.old.call(this),r.queue&&S.dequeue(this,r.queue)},r},S.fn.extend({fadeTo:function(e,t,n,r){return this.filter(ae).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(t,e,n,r){var i=S.isEmptyObject(t),o=S.speed(e,n,r),a=function(){var e=ft(this,S.extend({},t),o);(i||Y.get(this,"finish"))&&e.stop(!0)};return a.finish=a,i||!1===o.queue?this.each(a):this.queue(o.queue,a)},stop:function(i,e,o){var a=function(e){var t=e.stop;delete e.stop,t(o)};return"string"!=typeof i&&(o=e,e=i,i=void 0),e&&this.queue(i||"fx",),this.each(function(){var e=!0,t=null!=i&&i+"queueHooks",n=S.timers,r=Y.get(this);if(t)rt&&rt.stop&&a(rt);else for(t in r)rt&&rt.stop&&at.test(t)&&a(rt);for(t=n.length;t--;)nt.elem!==this||null!=i&&nt.queue!==i||(nt.anim.stop(o),e=!1,n.splice(t,1));!e&&o||S.dequeue(this,i)})},finish:function(a){return!1!==a&&(a=a||"fx"),this.each(function(){var e,t=Y.get(this),n=ta+"queue",r=ta+"queueHooks",i=S.timers,o=n?n.length:0;for(t.finish=!0,S.queue(this,a,),r&&r.stop&&r.stop.call(this,!0),e=i.length;e--;)ie.elem===this&&ie.queue===a&&(ie.anim.stop(!0),i.splice(e,1));for(e=0;e<o;e++)ne&&ne.finish&&ne.finish.call(this);delete t.finish})}}),S.each("toggle","show","hide",function(e,r){var i=S.fnr;S.fnr=function(e,t,n){return null==e||"boolean"==typeof e?i.apply(this,arguments):this.animate(lt(r,!0),e,t,n)}}),S.each({slideDown:lt("show"),slideUp:lt("hide"),slideToggle:lt("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,r){S.fne=function(e,t,n){return this.animate(r,e,t,n)}}),S.timers=,S.fx.tick=function(){var e,t=0,n=S.timers;for(tt=Date.now();t<n.length;t++)(e=nt)()||nt!==e||n.splice(t--,1);n.length||S.fx.stop(),tt=void 0},S.fx.timer=function(e){S.timers.push(e),S.fx.start()},S.fx.interval=13,S.fx.start=function(){nt||(nt=!0,st())},S.fx.stop=function(){nt=null},S.fx.speeds={slow:600,fast:200,_default:400},S.fn.delay=function(r,e){return r=S.fx&&S.fx.speedsr||r,e=e||"fx",this.queue(e,function(e,t){var n=C.setTimeout(e,r);t.stop=function(){C.clearTimeout(n)}})},rt=E.createElement("input"),it=E.createElement("select").appendChild(E.createElement("option")),rt.type="checkbox",y.checkOn=""!==rt.value,y.optSelected=it.selected,(rt=E.createElement("input")).value="t",rt.type="radio",y.radioValue="t"===rt.value;var pt,dt=S.expr.attrHandle;S.fn.extend({attr:function(e,t){return $(this,S.attr,e,t,1<arguments.length)},removeAttr:function(e){return this.each(function(){S.removeAttr(this,e)})}}),S.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?S.prop(e,t,n):(1===o&&S.isXMLDoc(e)||(i=S.attrHookst.toLowerCase()||(S.expr.match.bool.test(t)?pt:void 0)),void 0!==n?null===n?void S.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=S.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!y.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(P);if(i&&1===e.nodeType)while(n=ir++)e.removeAttribute(n)}}),pt={set:function(e,t,n){return!1===t?S.removeAttr(e,n):e.setAttribute(n,n),n}},S.each(S.expr.match.bool.source.match(/\w+/g),function(e,t){var a=dtt||S.find.attr;dtt=function(e,t,n){var r,i,o=t.toLowerCase();return n||(i=dto,dto=r,r=null!=a(e,t,n)?o:null,dto=i),r}});var ht=/^(?:input|select|textarea|button)$/i,gt=/^(?:a|area)$/i;function vt(e){return(e.match(P)||).join(" ")}function yt(e){return e.getAttribute&&e.getAttribute("class")||""}function mt(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(P)||}S.fn.extend({prop:function(e,t){return $(this,S.prop,e,t,1<arguments.length)},removeProp:function(e){return this.each(function(){delete thisS.propFixe||e})}}),S.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&S.isXMLDoc(e)||(t=S.propFixt||t,i=S.propHookst),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:et=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:et},propHooks:{tabIndex:{get:function(e){var t=S.find.attr(e,"tabindex");return t?parseInt(t,10):ht.test(e.nodeName)||gt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),y.optSelected||(S.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),S.each("tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable",function(){S.propFixthis.toLowerCase()=this}),S.fn.extend({addClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).addClass(t.call(this,e,yt(this)))});if((e=mt(t)).length)while(n=thisu++)if(i=yt(n),r=1===n.nodeType&&" "+vt(i)+" "){a=0;while(o=ea++)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=vt(r))&&n.setAttribute("class",s)}return this},removeClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).removeClass(t.call(this,e,yt(this)))});if(!arguments.length)return this.attr("class","");if((e=mt(t)).length)while(n=thisu++)if(i=yt(n),r=1===n.nodeType&&" "+vt(i)+" "){a=0;while(o=ea++)while(-1<r.indexOf(" "+o+" "))r=r.replace(" "+o+" "," ");i!==(s=vt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(i,t){var o=typeof i,a="string"===o||Array.isArray(i);return"boolean"==typeof t&&a?t?this.addClass(i):this.removeClass(i):m(i)?this.each(function(e){S(this).toggleClass(i.call(this,e,yt(this),t),t)}):this.each(function(){var e,t,n,r;if(a){t=0,n=S(this),r=mt(i);while(e=rt++)n.hasClass(e)?n.removeClass(e):n.addClass(e)}else void 0!==i&&"boolean"!==o||((e=yt(this))&&Y.set(this,"__className__",e),this.setAttribute&&this.setAttribute("class",e||!1===i?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=thisr++)if(1===n.nodeType&&-1<(" "+vt(yt(n))+" ").indexOf(t))return!0;return!1}});var xt=/\r/g;S.fn.extend({val:function(n){var r,e,i,t=this0;return arguments.length?(i=m(n),this.each(function(e){var t;1===this.nodeType&&(null==(t=i?n.call(this,e,S(this).val()):n)?t="":"number"==typeof t?t+="":Array.isArray(t)&&(t=S.map(t,function(e){return null==e?"":e+""})),(r=S.valHooksthis.type||S.valHooksthis.nodeName.toLowerCase())&&"set"in r&&void 0!==r.set(this,t,"value")||(this.value=t))})):t?(r=S.valHookst.type||S.valHookst.nodeName.toLowerCase())&&"get"in r&&void 0!==(e=r.get(t,"value"))?e:"string"==typeof(e=t.value)?e.replace(xt,""):null==e?"":e:void 0}}),S.extend({valHooks:{option:{get:function(e){var t=S.find.attr(e,"value");return null!=t?t:vt(S.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:,u=a?o+1:i.length;for(r=o<0?u:a?o:0;r<u;r++)if(((n=ir).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=S(n).val(),a)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=S.makeArray(t),a=i.length;while(a--)((r=ia).selected=-1<S.inArray(S.valHooks.option.get(r),o))&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),S.each("radio","checkbox",function(){S.valHooksthis={set:function(e,t){if(Array.isArray(t))return e.checked=-1<S.inArray(S(e).val(),t)}},y.checkOn||(S.valHooksthis.get=function(e){return null===e.getAttribute("value")?"on":e.value})}),y.focusin="onfocusin"in C;var bt=/^(?:focusinfocus|focusoutblur)$/,wt=function(e){e.stopPropagation()};S.extend(S.event,{trigger:function(e,t,n,r){var i,o,a,s,u,l,c,f,p=n||E,d=v.call(e,"type")?e.type:e,h=v.call(e,"namespace")?e.namespace.split("."):;if(o=f=a=n=n||E,3!==n.nodeType&&8!==n.nodeType&&!bt.test(d+S.event.triggered)&&(-1<d.indexOf(".")&&(d=(h=d.split(".")).shift(),h.sort()),u=d.indexOf(":")<0&&"on"+d,(e=eS.expando?e:new S.Event(d,"object"==typeof e&&e)).isTrigger=r?2:3,e.namespace=h.join("."),e.rnamespace=e.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,e.result=void 0,e.target||(e.target=n),t=null==t?e:S.makeArray(t,e),c=S.event.speciald||{},r||!c.trigger||!1!==c.trigger.apply(n,t))){if(!r&&!c.noBubble&&!x(n)){for(s=c.delegateType||d,bt.test(s+d)||(o=o.parentNode);o;o=o.parentNode)p.push(o),a=o;a===(n.ownerDocument||E)&&p.push(a.defaultView||a.parentWindow||C)}i=0;while((o=pi++)&&!e.isPropagationStopped())f=o,e.type=1<i?s:c.bindType||d,(l=(Y.get(o,"events")||Object.create(null))e.type&&Y.get(o,"handle"))&&l.apply(o,t),(l=u&&ou)&&l.apply&&V(o)&&(e.result=l.apply(o,t),!1===e.result&&e.preventDefault());return e.type=d,r||e.isDefaultPrevented()||c._default&&!1!==c._default.apply(p.pop(),t)||!V(n)||u&&m(nd)&&!x(n)&&((a=nu)&&(nu=null),S.event.triggered=d,e.isPropagationStopped()&&f.addEventListener(d,wt),nd(),e.isPropagationStopped()&&f.removeEventListener(d,wt),S.event.triggered=void 0,a&&(nu=a)),e.result}},simulate:function(e,t,n){var r=S.extend(new S.Event,n,{type:e,isSimulated:!0});S.event.trigger(r,null,t)}}),S.fn.extend({trigger:function(e,t){return this.each(function(){S.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this0;if(n)return S.event.trigger(e,t,n,!0)}}),y.focusin||S.each({focus:"focusin",blur:"focusout"},function(n,r){var i=function(e){S.event.simulate(r,e.target,S.event.fix(e))};S.event.specialr={setup:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r);t||e.addEventListener(n,i,!0),Y.access(e,r,(t||0)+1)},teardown:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r)-1;t?Y.access(e,r,t):(e.removeEventListener(n,i,!0),Y.remove(e,r))}}});var Tt=C.location,Ct={guid:Date.now()},Et=/\?/;S.parseXML=function(e){var t;if(!e||"string"!=typeof e)return null;try{t=(new C.DOMParser).parseFromString(e,"text/xml")}catch(e){t=void 0}return t&&!t.getElementsByTagName("parsererror").length||S.error("Invalid XML: "+e),t};var St=/\\$/,kt=/\r?\n/g,At=/^(?:submit|button|image|reset|file)$/i,Nt=/^(?:input|select|textarea|keygen)/i;function Dt(n,e,r,i){var t;if(Array.isArray(e))S.each(e,function(e,t){r||St.test(n)?i(n,t):Dt(n+""+("object"==typeof t&&null!=t?e:"")+"",t,r,i)});else if(r||"object"!==w(e))i(n,e);else for(t in e)Dt(n+""+t+"",et,r,i)}S.param=function(e,t){var n,r=,i=function(e,t){var n=m(t)?t():t;rr.length=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(null==e)return"";if(Array.isArray(e)||e.jquery&&!S.isPlainObject(e))S.each(e,function(){i(this.name,this.value)});else for(n in e)Dt(n,en,t,i);return r.join("&")},S.fn.extend({serialize:function(){return S.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=S.prop(this,"elements");return e?S.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!S(this).is(":disabled")&&Nt.test(this.nodeName)&&!At.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=S(this).val();return null==n?null:Array.isArray(n)?S.map(n,function(e){return{name:t.name,value:e.replace(kt,"\r\n")}}):{name:t.name,value:n.replace(kt,"\r\n")}}).get()}});var jt=/%20/g,qt=/#.*$/,Lt=/(?&)_=^&*/,Ht=/^(.*?): \t*(^\r\n*)$/gm,Ot=/^(?:GET|HEAD)$/,Pt=/^\/\//,Rt={},Mt={},It="*/".concat("*"),Wt=E.createElement("a");function Ft(o){return function(e,t){"string"!=typeof e&&(t=e,e="*");var n,r=0,i=e.toLowerCase().match(P)||;if(m(t))while(n=ir++)"+"===n0?(n=n.slice(1)||"*",(on=on||).unshift(t)):(on=on||).push(t)}}function Bt(t,i,o,a){var s={},u=t===Mt;function l(e){var r;return se=!0,S.each(te||,function(e,t){var n=t(i,o,a);return"string"!=typeof n||u||sn?u?!(r=n):void 0:(i.dataTypes.unshift(n),l(n),!1)}),r}return l(i.dataTypes0)||!s"*"&&l("*")}function $t(e,t){var n,r,i=S.ajaxSettings.flatOptions||{};for(n in t)void 0!==tn&&((in?e:r||(r={}))n=tn);return r&&S.extend(!0,e,r),e}Wt.href=Tt.href,S.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Tt.href,type:"GET",isLocal:/^(?:about|app|app-storage|.+-extension|file|res|widget):$/.test(Tt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":It,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":S.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?$t($t(e,S.ajaxSettings),t):$t(S.ajaxSettings,e)},ajaxPrefilter:Ft(Rt),ajaxTransport:Ft(Mt),ajax:function(e,t){"object"==typeof e&&(t=e,e=void 0),t=t||{};var c,f,p,n,d,r,h,g,i,o,v=S.ajaxSetup({},t),y=v.context||v,m=v.context&&(y.nodeType||y.jquery)?S(y):S.event,x=S.Deferred(),b=S.Callbacks("once memory"),w=v.statusCode||{},a={},s={},u="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(h){if(!n){n={};while(t=Ht.exec(p))nt1.toLowerCase()+" "=(nt1.toLowerCase()+" "||).concat(t2)}t=ne.toLowerCase()+" "}return null==t?null:t.join(", ")},getAllResponseHeaders:function(){return h?p:null},setRequestHeader:function(e,t){return null==h&&(e=se.toLowerCase()=se.toLowerCase()||e,ae=t),this},overrideMimeType:function(e){return null==h&&(v.mimeType=e),this},statusCode:function(e){var t;if(e)if(h)T.always(eT.status);else for(t in e)wt=wt,et;return this},abort:function(e){var t=e||u;return c&&c.abort(t),l(0,t),this}};if(x.promise(T),v.url=((e||v.url||Tt.href)+"").replace(Pt,Tt.protocol+"//"),v.type=t.method||t.type||v.method||v.type,v.dataTypes=(v.dataType||"*").toLowerCase().match(P)||"",null==v.crossDomain){r=E.createElement("a");try{r.href=v.url,r.href=r.href,v.crossDomain=Wt.protocol+"//"+Wt.host!=r.protocol+"//"+r.host}catch(e){v.crossDomain=!0}}if(v.data&&v.processData&&"string"!=typeof v.data&&(v.data=S.param(v.data,v.traditional)),Bt(Rt,v,t,T),h)return T;for(i in(g=S.event&&v.global)&&0==S.active++&&S.event.trigger("ajaxStart"),v.type=v.type.toUpperCase(),v.hasContent=!Ot.test(v.type),f=v.url.replace(qt,""),v.hasContent?v.data&&v.processData&&0===(v.contentType||"").indexOf("application/x-www-form-urlencoded")&&(v.data=v.data.replace(jt,"+")):(o=v.url.slice(f.length),v.data&&(v.processData||"string"==typeof v.data)&&(f+=(Et.test(f)?"&":"?")+v.data,delete v.data),!1===v.cache&&(f=f.replace(Lt,"$1"),o=(Et.test(f)?"&":"?")+"_="+Ct.guid+++o),v.url=f+o),v.ifModified&&(S.lastModifiedf&&T.setRequestHeader("If-Modified-Since",S.lastModifiedf),S.etagf&&T.setRequestHeader("If-None-Match",S.etagf)),(v.data&&v.hasContent&&!1!==v.contentType||t.contentType)&&T.setRequestHeader("Content-Type",v.contentType),T.setRequestHeader("Accept",v.dataTypes0&&v.acceptsv.dataTypes0?v.acceptsv.dataTypes0+("*"!==v.dataTypes0?", "+It+"; q=0.01":""):v.accepts"*"),v.headers)T.setRequestHeader(i,v.headersi);if(v.beforeSend&&(!1===v.beforeSend.call(y,T,v)||h))return T.abort();if(u="abort",b.add(v.complete),T.done(v.success),T.fail(v.error),c=Bt(Mt,v,t,T)){if(T.readyState=1,g&&m.trigger("ajaxSend",T,v),h)return T;v.async&&0<v.timeout&&(d=C.setTimeout(function(){T.abort("timeout")},v.timeout));try{h=!1,c.send(a,l)}catch(e){if(h)throw e;l(-1,e)}}else l(-1,"No Transport");function l(e,t,n,r){var i,o,a,s,u,l=t;h||(h=!0,d&&C.clearTimeout(d),c=void 0,p=r||"",T.readyState=0<e?4:0,i=200<=e&&e<300||304===e,n&&(s=function(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u0)u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(si&&si.test(r)){u.unshift(i);break}if(u0in n)o=u0;else{for(i in n){if(!u0||e.convertersi+" "+u0){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u0&&u.unshift(o),no}(v,T,n)),!i&&-1<S.inArray("script",v.dataTypes)&&(v.converters"text script"=function(){}),s=function(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c1)for(a in e.converters)la.toLowerCase()=e.convertersa;o=c.shift();while(o)if(e.responseFieldso&&(ne.responseFieldso=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=lu+" "+o||l"* "+o))for(i in l)if((s=i.split(" "))1===o&&(a=lu+" "+s0||l"* "+s0)){!0===a?a=li:!0!==li&&(o=s0,c.unshift(s1));break}if(!0!==a)if(a&&e"throws")t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}(v,s,T,i),i?(v.ifModified&&((u=T.getResponseHeader("Last-Modified"))&&(S.lastModifiedf=u),(u=T.getResponseHeader("etag"))&&(S.etagf=u)),204===e||"HEAD"===v.type?l="nocontent":304===e?l="notmodified":(l=s.state,o=s.data,i=!(a=s.error))):(a=l,!e&&l||(l="error",e<0&&(e=0))),T.status=e,T.statusText=(t||l)+"",i?x.resolveWith(y,o,l,T):x.rejectWith(y,T,l,a),T.statusCode(w),w=void 0,g&&m.trigger(i?"ajaxSuccess":"ajaxError",T,v,i?o:a),b.fireWith(y,T,l),g&&(m.trigger("ajaxComplete",T,v),--S.active||S.event.trigger("ajaxStop")))}return T},getJSON:function(e,t,n){return S.get(e,t,n,"json")},getScript:function(e,t){return S.get(e,void 0,t,"script")}}),S.each("get","post",function(e,i){Si=function(e,t,n,r){return m(t)&&(r=r||n,n=t,t=void 0),S.ajax(S.extend({url:e,type:i,dataType:r,data:t,success:n},S.isPlainObject(e)&&e))}}),S.ajaxPrefilter(function(e){var t;for(t in e.headers)"content-type"===t.toLowerCase()&&(e.contentType=e.headerst||"")}),S._evalUrl=function(e,t,n){return S.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,converters:{"text script":function(){}},dataFilter:function(e){S.globalEval(e,t,n)}})},S.fn.extend({wrapAll:function(e){var t;return this0&&(m(e)&&(e=e.call(this0)),t=S(e,this0.ownerDocument).eq(0).clone(!0),this0.parentNode&&t.insertBefore(this0),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(n){return m(n)?this.each(function(e){S(this).wrapInner(n.call(this,e))}):this.each(function(){var e=S(this),t=e.contents();t.length?t.wrapAll(n):e.append(n)})},wrap:function(t){var n=m(t);return this.each(function(e){S(this).wrapAll(n?t.call(this,e):t)})},unwrap:function(e){return this.parent(e).not("body").each(function(){S(this).replaceWith(this.childNodes)}),this}}),S.expr.pseudos.hidden=function(e){return!S.expr.pseudos.visible(e)},S.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},S.ajaxSettings.xhr=function(){try{return new C.XMLHttpRequest}catch(e){}};var _t={0:200,1223:204},zt=S.ajaxSettings.xhr();y.cors=!!zt&&"withCredentials"in zt,y.ajax=zt=!!zt,S.ajaxTransport(function(i){var o,a;if(y.cors||zt&&!i.crossDomain)return{send:function(e,t){var n,r=i.xhr();if(r.open(i.type,i.url,i.async,i.username,i.password),i.xhrFields)for(n in i.xhrFields)rn=i.xhrFieldsn;for(n in i.mimeType&&r.overrideMimeType&&r.overrideMimeType(i.mimeType),i.crossDomain||e"X-Requested-With"||(e"X-Requested-With"="XMLHttpRequest"),e)r.setRequestHeader(n,en);o=function(e){return function(){o&&(o=a=r.onload=r.onerror=r.onabort=r.ontimeout=r.onreadystatechange=null,"abort"===e?r.abort():"error"===e?"number"!=typeof r.status?t(0,"error"):t(r.status,r.statusText):t(_tr.status||r.status,r.statusText,"text"!==(r.responseType||"text")||"string"!=typeof r.responseText?{binary:r.response}:{text:r.responseText},r.getAllResponseHeaders()))}},r.onload=o(),a=r.onerror=r.ontimeout=o("error"),void 0!==r.onabort?r.onabort=a:r.onreadystatechange=function(){4===r.readyState&&C.setTimeout(function(){o&&a()})},o=o("abort");try{r.send(i.hasContent&&i.data||null)}catch(e){if(o)throw e}},abort:function(){o&&o()}}}),S.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),S.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return S.globalEval(e),e}}}),S.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),S.ajaxTransport("script",function(n){var r,i;if(n.crossDomain||n.scriptAttrs)return{send:function(e,t){r=S("<script>").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r0)},abort:function(){i&&i()}}});var Ut,Xt=,Vt=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Xt.pop()||S.expando+"_"+Ct.guid++;return thise=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Vt.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Vt.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes0)return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?ea=ea.replace(Vt,"$1"+r):!1!==e.jsonp&&(e.url+=(Et.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters"script json"=function(){return o||S.error(r+" was not called"),o0},e.dataTypes0="json",i=Cr,Cr=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):Cr=i,er&&(e.jsonpCallback=t.jsonpCallback,Xt.push(r)),o&&m(i)&&i(o0),o=i=void 0}),"script"}),y.createHTMLDocument=((Ut=E.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===Ut.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&,(i=N.exec(e))?t.createElement(i1):(i=xe(e,t,o),o&&o.length&&S(o).remove(),S.merge(,i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1<s&&(r=vt(e.slice(s)),e=e.slice(0,s)),m(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),0<a.length&&S.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,a.html(r?S("<div>").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||e.responseText,t,e)})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):("number"==typeof f.top&&(f.top+="px"),"number"==typeof f.left&&(f.left+="px"),c.css(f))}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this0;return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this0){var e,t,n,r=this0,i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fnt=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?ri:et;r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):et=n},t,e,arguments.length)}}),S.each("top","left",function(e,n){S.cssHooksn=$e(y.pixelPosition,function(e,t){if(t)return t=Be(e,n),Me.test(t)?S(e).position()n+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fno=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e"inner"+a:e.document.documentElement"client"+a:9===e.nodeType?(r=e.documentElement,Math.max(e.body"scroll"+a,r"scroll"+a,e.body"offset"+a,r"offset"+a,r"client"+a)):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each("ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend",function(e,t){S.fnt=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fnn=function(e,t){return 0<arguments.length?this.on(n,null,e,t):this.trigger(n)}});var Gt=/^\s\uFEFF\xA0+|\s\uFEFF\xA0+$/g;S.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=et,t=e,e=n),m(e))return r=s.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(s.call(arguments)))}).guid=e.guid=e.guid||S.guid++,i},S.holdReady=function(e){e?S.readyWait++:S.ready(!0)},S.isArray=Array.isArray,S.parseJSON=JSON.parse,S.nodeName=A,S.isFunction=m,S.isWindow=x,S.camelCase=X,S.type=w,S.now=Date.now,S.isNumeric=function(e){var t=S.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},S.trim=function(e){return null==e?"":(e+"").replace(Gt,"")},"function"==typeof define&&define.amd&&define("jquery",,function(){return S});var Yt=C.jQuery,Qt=C.$;return S.noConflict=function(e){return C.$===S&&(C.$=Qt),e&&C.jQuery===S&&(C.jQuery=Yt),S},"undefined"==typeof e&&(C.jQuery=C.$=S),S});
-+/*! jQuery v3.6.0 | (c) OpenJS Foundation and other contributors | jquery.org/license */
-+!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=,r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply(,e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=tr||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?no.call(e)||"object":typeof e}var f="3.6.0",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0<t&&t-1 in e)}S.fn=S.prototype={jquery:f,constructor:S,length:0,toArray:function(){return s.call(this)},get:function(e){return null==e?s.call(this):e<0?thise+this.length:thise},pushStack:function(e){var t=S.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return S.each(this,e)},map:function(n){return this.pushStack(S.map(this,function(e,t){return n.call(e,t,e)}))},slice:function(){return this.pushStack(s.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},even:function(){return this.pushStack(S.grep(this,function(e,t){return(t+1)%2}))},odd:function(){return this.pushStack(S.grep(this,function(e,t){return t%2}))},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(0<=n&&n<t?thisn:)},end:function(){return this.prevObject||this.constructor()},push:u,sort:t.sort,splice:t.splice},S.extend=S.fn.extend=function(){var e,t,n,r,i,o,a=arguments0||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=argumentss||{},s++),"object"==typeof a||m(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=argumentss))for(t in e)r=et,"__proto__"!==t&&a!==r&&(l&&r&&(S.isPlainObject(r)||(i=Array.isArray(r)))?(n=at,o=i&&!Array.isArray(n)?:i||S.isPlainObject(n)?n:{},i=!1,at=S.extend(l,o,r)):void 0!==r&&(at=r));return a},S.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"object Object"!==o.call(e))&&(!(t=r(e))||"function"==typeof(n=v.call(t,"constructor")&&t.constructor)&&a.call(n)===l)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e,t,n){b(e,{nonce:t&&t.nonce},n)},each:function(e,t){var n,r=0;if(p(e)){for(n=e.length;r<n;r++)if(!1===t.call(er,r,er))break}else for(r in e)if(!1===t.call(er,r,er))break;return e},makeArray:function(e,t){var n=t||;return null!=e&&(p(Object(e))?S.merge(n,"string"==typeof e?e:e):u.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:i.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)ei++=tr;return e.length=i,e},grep:function(e,t,n){for(var r=,i=0,o=e.length,a=!n;i<o;i++)!t(ei,i)!==a&&r.push(ei);return r},map:function(e,t,n){var r,i,o=0,a=;if(p(e))for(r=e.length;o<r;o++)null!=(i=t(eo,o,n))&&a.push(i);else for(o in e)null!=(i=t(eo,o,n))&&a.push(i);return g(a)},guid:1,support:y}),"function"==typeof Symbol&&(S.fnSymbol.iterator=tSymbol.iterator),S.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){n"object "+t+""=t.toLowerCase()});var d=function(n){var e,d,b,o,i,h,f,g,w,u,l,T,C,a,E,v,s,c,y,S="sizzle"+1*new Date,p=n.document,k=0,r=0,m=ue(),x=ue(),A=ue(),N=ue(),j=function(e,t){return e===t&&(l=!0),0},D={}.hasOwnProperty,t=,q=t.pop,L=t.push,H=t.push,O=t.slice,P=function(e,t){for(var n=0,r=e.length;n<r;n++)if(en===t)return n;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="\\x20\\t\\r\\n\\f",I="(?:\\\\\\da-fA-F{1,6}"+M+"?|\\\\^\\r\\n\\f|\\w-|^\0-\\x7f)+",W="\\"+M+"*("+I+")(?:"+M+"*(*^$|!~?=)"+M+"*(?:'((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\"|("+I+"))|)"+M+"*\\",F=":("+I+")(?:\$(('((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\")|((?:\\\\.|^\\\\()\\|"+W+")*)|.*)\$|)",B=new RegExp(M+"+","g"),$=new RegExp("^"+M+"+|((?:^|^\\\\)(?:\\\\.)*)"+M+"+$","g"),_=new RegExp("^"+M+"*,"+M+"*"),z=new RegExp("^"+M+"*(>+~|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|*)"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\$"+M+"*(even|odd|((+-|)(\\d*)n|)"+M+"*(?:(+-|)"+M+"*(\\d+)|))"+M+"*\$|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*>+~|:(even|odd|eq|gt|lt|nth|first|last)(?:\$"+M+"*((?:-\\d)?\\d*)"+M+"*\$|)(?=^-|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^^{+\{\s*\native \w/,Z=/^(?:#(\w-+)|(\w+)|\.(\w-+))$/,ee=/+~/,te=new RegExp("\\\\\\da-fA-F{1,6}"+M+"?|\\\\(^\\r\\n\\f)","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/(\0-\x1f\x7f|^-?\d)|^-$|^\0-\x1f\x7f-\uFFFF\w-/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),tp.childNodes.length.nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(en++=tr++);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||,"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u1){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u2)return H.apply(n,e.getElementsByTagName(t)),n;if((i=u3)&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!Nt+" "&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)lo=(s?"#"+s:":scope")+" "+xe(lo);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=;return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete er.shift(),et+" "=n}}function le(e){return eS=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandlenr=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a(,e.length,o),i=r.length;while(i--)en=ri&&(en=!(tn=en))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?n:}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)returno;i=t.getElementsByName(e),r=0;while(o=ir++)if((n=o.getAttributeNode("id"))&&n.value===e)returno}return}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=,i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=oi++)1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=,v=,(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="<a id='"+S+"'></a><select id='"+S+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("msallowcapture^=''").length&&v.push("*^$="+M+"*(?:''|\"\")"),e.querySelectorAll("selected").length||v.push("\\"+M+"*(?:value|"+R+")"),e.querySelectorAll("id~="+S+"-").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("name=''").length||v.push("\\"+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.++~"),e.querySelectorAll("\\\f"),v.push("\\r\\n\\f")}),ce(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("name=d").length&&v.push("name"+M+"**^$|!~?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"s!='':x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=e,s=t;if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(ar===sr)r++;return r?pe(ar,sr):ar==p?-1:sr==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!Nt+" "&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0<se(t,C,null,e).length},se.contains=function(e,t){return(e.ownerDocument||e)!=C&&T(e),y(e,t)},se.attr=function(e,t){(e.ownerDocument||e)!=C&&T(e);var n=b.attrHandlet.toLowerCase(),r=n&&D.call(b.attrHandle,t.toLowerCase())?n(e,t,!E):void 0;return void 0!==r?r:d.attributes||!E?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},se.escape=function(e){return(e+"").replace(re,ie)},se.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},se.uniqueSort=function(e){var t,n=,r=0,i=0;if(l=!d.detectDuplicates,u=!d.sortStable&&e.slice(0),e.sort(j),l){while(t=ei++)t===ei&&(r=n.push(i));while(r--)e.splice(nr,1)}return u=null,e},o=se.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else while(t=er++)n+=o(t);return n},(b=se.selectors={cacheLength:50,createPseudo:le,match:G,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e1=e1.replace(te,ne),e3=(e3||e4||e5||"").replace(te,ne),"~="===e2&&(e3=" "+e3+" "),e.slice(0,4)},CHILD:function(e){return e1=e1.toLowerCase(),"nth"===e1.slice(0,3)?(e3||se.error(e0),e4=+(e4?e5+(e6||1):2*("even"===e3||"odd"===e3)),e5=+(e7+e8||"odd"===e3)):e3&&se.error(e0),e},PSEUDO:function(e){var t,n=!e6&&e2;return G.CHILD.test(e0)?null:(e3?e2=e4||e5||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e0=e0.slice(0,t),e2=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=me+" ";return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1<t.indexOf(i):"$="===r?i&&t.slice(-i.length)===i:"~="===r?-1<(" "+t.replace(B," ")+" ").indexOf(i):"|="===r&&(t===i||t.slice(0,i.length+1)===i+"-"))}},CHILD:function(h,e,t,g,v){var y="nth"!==h.slice(0,3),m="last"!==h.slice(-4),x="of-type"===e;return 1===g&&0===v?function(e){return!!e.parentNode}:function(e,t,n){var r,i,o,a,s,u,l=y!==m?"nextSibling":"previousSibling",c=e.parentNode,f=x&&e.nodeName.toLowerCase(),p=!n&&!x,d=!1;if(c){if(y){while(l){a=e;while(a=al)if(x?a.nodeName.toLowerCase()===f:1===a.nodeType)return!1;u=l="only"===h&&!u&&"nextSibling"}return!0}if(u=m?c.firstChild:c.lastChild,m&&p){d=(s=(r=(i=(o=(a=c)S||(aS={}))a.uniqueID||(oa.uniqueID={}))h||)0===k&&r1)&&r2,a=s&&c.childNodess;while(a=++s&&a&&al||(d=s=0)||u.pop())if(1===a.nodeType&&++d&&a===e){ih=k,s,d;break}}else if(p&&(d=s=(r=(i=(o=(a=e)S||(aS={}))a.uniqueID||(oa.uniqueID={}))h||)0===k&&r1),!1===d)while(a=++s&&a&&al||(d=s=0)||u.pop())if((x?a.nodeName.toLowerCase()===f:1===a.nodeType)&&++d&&(p&&((i=(o=aS||(aS={}))a.uniqueID||(oa.uniqueID={}))h=k,d),a===e))break;return(d-=v)===g||d%g==0&&0<=d/g}}},PSEUDO:function(e,o){var t,a=b.pseudose||b.setFilterse.toLowerCase()||se.error("unsupported pseudo: "+e);return aS?a(o):1<a.length?(t=e,e,"",o,b.setFilters.hasOwnProperty(e.toLowerCase())?le(function(e,t){var n,r=a(e,o),i=r.length;while(i--)en=P(e,ri)=!(tn=ri)}):function(e){return a(e,0,t)}):a}},pseudos:{not:le(function(e){var r=,i=,s=f(e.replace($,"$1"));return sS?le(function(e,t,n,r){var i,o=s(e,null,r,),a=e.length;while(a--)(i=oa)&&(ea=!(ta=i))}):function(e,t,n){return r0=e,s(r,null,n,i),r0=null,!i.pop()}}),has:le(function(t){return function(e){return 0<se(t,e).length}}),contains:le(function(t){return t=t.replace(te,ne),function(e){return-1<(e.textContent||o(e)).indexOf(t)}}),lang:le(function(n){return V.test(n||"")||se.error("unsupported lang: "+n),n=n.replace(te,ne).toLowerCase(),function(e){var t;do{if(t=E?e.lang:e.getAttribute("xml:lang")||e.getAttribute("lang"))return(t=t.toLowerCase())===n||0===t.indexOf(n+"-")}while((e=e.parentNode)&&1===e.nodeType);return!1}}),target:function(e){var t=n.location&&n.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===a},focus:function(e){return e===C.activeElement&&(!C.hasFocus||C.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:ge(!1),disabled:ge(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!b.pseudos.empty(e)},header:function(e){return J.test(e.nodeName)},input:function(e){return Q.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:ve(function(){return0}),last:ve(function(e,t){returnt-1}),eq:ve(function(e,t,n){returnn<0?n+t:n}),even:ve(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:ve(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:ve(function(e,t,n){for(var r=n<0?n+t:t<n?t:n;0<=--r;)e.push(r);return e}),gt:ve(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=b.pseudos.eq,{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})b.pseudose=de(e);for(e in{submit:!0,reset:!0})b.pseudose=he(e);function me(){}function xe(e){for(var t=0,n=e.length,r="";t<n;t++)r+=et.value;return r}function be(s,e,t){var u=e.dir,l=e.next,c=l||u,f=t&&"parentNode"===c,p=r++;return e.first?function(e,t,n){while(e=eu)if(1===e.nodeType||f)return s(e,t,n);return!1}:function(e,t,n){var r,i,o,a=k,p;if(n){while(e=eu)if((1===e.nodeType||f)&&s(e,t,n))return!0}else while(e=eu)if(1===e.nodeType||f)if(i=(o=eS||(eS={}))e.uniqueID||(oe.uniqueID={}),l&&l===e.nodeName.toLowerCase())e=eu||e;else{if((r=ic)&&r0===k&&r1===p)return a2=r2;if((ic=a)2=s(e,t,n))return!0}return!1}}function we(i){return 1<i.length?function(e,t,n){var r=i.length;while(r--)if(!ir(e,t,n))return!1;return!0}:i0}function Te(e,t,n,r,i){for(var o,a=,s=0,u=e.length,l=null!=t;s<u;s++)(o=es)&&(n&&!n(o,r,i)||(a.push(o),l&&t.push(s)));return a}function Ce(d,h,g,v,y,e){return v&&!vS&&(v=Ce(v)),y&&!yS&&(y=Ce(y,e)),le(function(e,t,n,r){var i,o,a,s=,u=,l=t.length,c=e||function(e,t,n){for(var r=0,i=t.length;r<i;r++)se(e,tr,n);return n}(h||"*",n.nodeType?n:n,),f=!d||!e&&h?c:Te(c,s,d,n,r),p=g?y||(e?d:l||v)?:t:f;if(g&&g(f,p,n,r),v){i=Te(p,u),v(i,,n,r),o=i.length;while(o--)(a=io)&&(puo=!(fuo=a))}if(e){if(y||d){if(y){i=,o=p.length;while(o--)(a=po)&&i.push(fo=a);y(null,p=,i,r)}o=p.length;while(o--)(a=po)&&-1<(i=y?P(e,a):so)&&(ei=!(ti=a))}}else p=Te(p===t?p.splice(l,p.length):p),y?y(null,t,p,r):H.apply(t,p)})}function Ee(e){for(var i,t,n,r=e.length,o=b.relativee0.type,a=o||b.relative" ",s=o?1:0,u=be(function(e){return e===i},a,!0),l=be(function(e){return-1<P(i,e)},a,!0),c=function(e,t,n){var r=!o&&(n||t!==w)||((i=t).nodeType?u(e,t,n):l(e,t,n));return i=null,r};s<r;s++)if(t=b.relativees.type)c=be(we(c),t);else{if((t=b.filteres.type.apply(null,es.matches))S){for(n=++s;n<r;n++)if(b.relativeen.type)break;return Ce(1<s&&we(c),1<s&&xe(e.slice(0,s-1).concat({value:" "===es-2.type?"*":""})).replace($,"$1"),t,s<n&&Ee(e.slice(s,n)),n<r&&Ee(e=e.slice(n)),n<r&&xe(e))}c.push(t)}return we(c)}return me.prototype=b.filters=b.pseudos,b.setFilters=new me,h=se.tokenize=function(e,t){var n,r,i,o,a,s,u,l=xe+" ";if(l)return t?0:l.slice(0);a=e,s=,u=b.preFilter;while(a){for(o in n&&!(r=_.exec(a))||(r&&(a=a.slice(r0.length)||a),s.push(i=)),n=!1,(r=z.exec(a))&&(n=r.shift(),i.push({value:n,type:r0.replace($," ")}),a=a.slice(n.length)),b.filter)!(r=Go.exec(a))||uo&&!(r=uo(r))||(n=r.shift(),i.push({value:n,type:o,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?se.error(e):x(e,s).slice(0)},f=se.compile=function(e,t){var n,v,y,m,x,r,i=,o=,a=Ae+" ";if(!a){t||(t=h(e)),n=t.length;while(n--)(a=Ee(tn))S?i.push(a):o.push(a);(a=A(e,(v=o,m=0<(y=i).length,x=0<v.length,r=function(e,t,n,r,i){var o,a,s,u=0,l="0",c=e&&,f=,p=w,d=e||x&&b.find.TAG("*",i),h=k+=null==p?1:Math.random()||.1,g=d.length;for(i&&(w=t==C||t||i);l!==g&&null!=(o=dl);l++){if(x&&o){a=0,t||o.ownerDocument==C||(T(o),n=!E);while(s=va++)if(s(o,t||C,n)){r.push(o);break}i&&(k=h)}m&&((o=!s&&o)&&u--,e&&c.push(o))}if(u+=l,m&&l!==u){a=0;while(s=ya++)s(c,f,t,n);if(e){if(0<u)while(l--)cl||fl||(fl=q.call(r));f=Te(f)}H.apply(r,f),i&&!e&&0<f.length&&1<u+y.length&&se.uniqueSort(r)}return i&&(k=h,w=p),c},m?le(r):r))).selector=e}return a},g=se.select=function(e,t,n,r){var i,o,a,s,u,l="function"==typeof e&&e,c=!r&&h(e=l.selector||e);if(n=n||,1===c.length){if(2<(o=c0=c0.slice(0)).length&&"ID"===(a=o0).type&&9===t.nodeType&&E&&b.relativeo1.type){if(!(t=(b.find.ID(a.matches0.replace(te,ne),t)||)0))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}i=G.needsContext.test(e)?0:o.length;while(i--){if(a=oi,b.relatives=a.type)break;if((u=b.finds)&&(r=u(a.matches0.replace(te,ne),ee.test(o0.type)&&ye(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&xe(o)))return H.apply(n,r),n;break}}}return(l||f(e,c))(r,t,!E,n,!t||ee.test(e)&&ye(t.parentNode)||t),n},d.sortStable=S.split("").sort(j).join("")===S,d.detectDuplicates=!!l,T(),d.sortDetached=ce(function(e){return 1&e.compareDocumentPosition(C.createElement("fieldset"))}),ce(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||fe("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),d.attributes&&ce(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||fe("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ce(function(e){return null==e.getAttribute("disabled")})||fe(R,function(e,t,n){var r;if(!n)return!0===et?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),se}(C);S.find=d,S.expr=d.selectors,S.expr":"=S.expr.pseudos,S.uniqueSort=S.unique=d.uniqueSort,S.text=d.getText,S.isXMLDoc=d.isXML,S.contains=d.contains,S.escapeSelector=d.escape;var h=function(e,t,n){var r=,i=void 0!==n;while((e=et)&&9!==e.nodeType)if(1===e.nodeType){if(i&&S(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=;e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},k=S.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var N=/^<(a-z^\/\0>:\x20\t\r\n\f*)\x20\t\r\n\f*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1<i.call(n,e)!==r}):S.filter(n,e,r)}S.filter=function(e,t,n){var r=t0;return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?S.find.matchesSelector(r,e)?r::S.find.matches(e,S.grep(t,function(e){return 1===e.nodeType}))},S.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(S(e).filter(function(){for(t=0;t<r;t++)if(S.contains(it,this))return!0}));for(n=this.pushStack(),t=0;t<r;t++)S.find(e,it,n);return 1<r?S.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||,!1))},not:function(e){return this.pushStack(j(this,e||,!0))},is:function(e){return!!j(this,"string"==typeof e&&k.test(e)?S(e):e||,!1).length}});var D,q=/^(?:\s*(<\w\W+>)^>*|#(\w-+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e0&&">"===ee.length-1&&3<=e.length?null,e,null:q.exec(e))||!r1&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r1){if(t=t instanceof S?t0:t,S.merge(this,S.parseHTML(r1,t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r1)&&S.isPlainObject(t))for(r in t)m(thisr)?thisr(tr):this.attr(r,tr);return this}return(i=E.getElementById(r2))&&(this0=i,this.length=1),this}return e.nodeType?(this0=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=et)&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(S.contains(this,te))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=,a="string"!=typeof e&&S(e);if(!k.test(e))for(;r<i;r++)for(n=thisr;n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?-1<a.index(n):1===n.nodeType&&S.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(1<o.length?S.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?i.call(S(e),this0):i.call(this,e.jquery?e0:e):this0&&this0.parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(S.uniqueSort(S.merge(this.get(),S(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),S.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return h(e,"parentNode")},parentsUntil:function(e,t,n){return h(e,"parentNode",n)},next:function(e){return O(e,"nextSibling")},prev:function(e){return O(e,"previousSibling")},nextAll:function(e){return h(e,"nextSibling")},prevAll:function(e){return h(e,"previousSibling")},nextUntil:function(e,t,n){return h(e,"nextSibling",n)},prevUntil:function(e,t,n){return h(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return null!=e.contentDocument&&r(e.contentDocument)?e.contentDocument:(A(e,"template")&&(e=e.content||e),S.merge(,e.childNodes))}},function(r,i){S.fnr=function(e,t){var n=S.map(this,i,e);return"Until"!==r.slice(-5)&&(t=e),t&&"string"==typeof t&&(n=S.filter(t,n)),1<this.length&&(Hr||S.uniqueSort(n),L.test(r)&&n.reverse()),this.pushStack(n)}});var P=/^\x20\t\r\n\f+/g;function R(e){return e}function M(e){throw e}function I(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,e.slice(r))}catch(e){n.apply(void 0,e)}}S.Callbacks=function(r){var e,n;r="string"==typeof r?(e=r,n={},S.each(e.match(P)||,function(e,t){nt=!0}),n):S.extend({},r);var i,t,o,a,s=,u=,l=-1,c=function(){for(a=a||r.once,o=i=!0;u.length;l=-1){t=u.shift();while(++l<s.length)!1===sl.apply(t0,t1)&&r.stopOnFalse&&(l=s.length,t=!1)}r.memory||(t=!1),i=!1,a&&(s=t?:"")},f={add:function(){return s&&(t&&!i&&(l=s.length-1,u.push(t)),function n(e){S.each(e,function(e,t){m(t)?r.unique&&f.has(t)||s.push(t):t&&t.length&&"string"!==w(t)&&n(t)})}(arguments),t&&!i&&c()),this},remove:function(){return S.each(arguments,function(e,t){var n;while(-1<(n=S.inArray(t,s,n)))s.splice(n,1),n<=l&&l--}),this},has:function(e){return e?-1<S.inArray(e,s):0<s.length},empty:function(){return s&&(s=),this},disable:function(){return a=u=,s=t="",this},disabled:function(){return!s},lock:function(){return a=u=,t||i||(s=t=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=e,(t=t||).slice?t.slice():t,u.push(t),i||c()),this},fire:function(){return f.fireWith(this,arguments),this},fired:function(){return!!o}};return f},S.extend({Deferred:function(e){var o="notify","progress",S.Callbacks("memory"),S.Callbacks("memory"),2,"resolve","done",S.Callbacks("once memory"),S.Callbacks("once memory"),0,"resolved","reject","fail",S.Callbacks("once memory"),S.Callbacks("once memory"),1,"rejected",i="pending",a={state:function(){return i},always:function(){return s.done(arguments).fail(arguments),this},"catch":function(e){return a.then(null,e)},pipe:function(){var i=arguments;return S.Deferred(function(r){S.each(o,function(e,t){var n=m(it4)&&it4;st1(function(){var e=n&&n.apply(this,arguments);e&&m(e.promise)?e.promise().progress(r.notify).done(r.resolve).fail(r.reject):rt0+"With"(this,n?e:arguments)})}),i=null}).promise()},then:function(t,n,r){var u=0;function l(i,o,a,s){return function(){var n=this,r=arguments,e=function(){var e,t;if(!(i<u)){if((e=a.apply(n,r))===o.promise())throw new TypeError("Thenable self-resolution");t=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(t)?s?t.call(e,l(u,o,R,s),l(u,o,M,s)):(u++,t.call(e,l(u,o,R,s),l(u,o,M,s),l(u,o,R,o.notifyWith))):(a!==R&&(n=void 0,r=e),(s||o.resolveWith)(n,r))}},t=s?e:function(){try{e()}catch(e){S.Deferred.exceptionHook&&S.Deferred.exceptionHook(e,t.stackTrace),u<=i+1&&(a!==M&&(n=void 0,r=e),o.rejectWith(n,r))}};i?t():(S.Deferred.getStackHook&&(t.stackTrace=S.Deferred.getStackHook()),C.setTimeout(t))}}return S.Deferred(function(e){o03.add(l(0,e,m(r)?r:R,e.notifyWith)),o13.add(l(0,e,m(t)?t:R)),o23.add(l(0,e,m(n)?n:M))}).promise()},promise:function(e){return null!=e?S.extend(e,a):a}},s={};return S.each(o,function(e,t){var n=t2,r=t5;at1=n.add,r&&n.add(function(){i=r},o3-e2.disable,o3-e3.disable,o02.lock,o03.lock),n.add(t3.fire),st0=function(){return st0+"With"(this===s?void 0:this,arguments),this},st0+"With"=n.fireWith}),a.promise(s),e&&e.call(s,s),s},when:function(e){var n=arguments.length,t=n,r=Array(t),i=s.call(arguments),o=S.Deferred(),a=function(t){return function(e){rt=this,it=1<arguments.length?s.call(arguments):e,--n||o.resolveWith(r,i)}};if(n<=1&&(I(e,o.done(a(t)).resolve,o.reject,!n),"pending"===o.state()||m(it&&it.then)))return o.then();while(t--)I(it,a(t),o.reject);return o.promise()}});var W=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;S.Deferred.exceptionHook=function(e,t){C.console&&C.console.warn&&e&&W.test(e.name)&&C.console.warn("jQuery.Deferred exception: "+e.message,e.stack,t)},S.readyException=function(e){C.setTimeout(function(){throw e})};var F=S.Deferred();function B(){E.removeEventListener("DOMContentLoaded",B),C.removeEventListener("load",B),S.ready()}S.fn.ready=function(e){return F.then(e)"catch"(function(e){S.readyException(e)}),this},S.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--S.readyWait:S.isReady)||(S.isReady=!0)!==e&&0<--S.readyWait||F.resolveWith(E,S)}}),S.ready.then=F.then,"complete"===E.readyState||"loading"!==E.readyState&&!E.documentElement.doScroll?C.setTimeout(S.ready):(E.addEventListener("DOMContentLoaded",B),C.addEventListener("load",B));var $=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===w(n))for(s in i=!0,n)$(e,t,s,ns,!0,o,a);else if(void 0!==r&&(i=!0,m(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(S(e),n)})),t))for(;s<u;s++)t(es,n,a?r:r.call(es,s,t(es,n)));return i?e:l?t.call(e):u?t(e0,n):o},_=/^-ms-/,z=/-(a-z)/g;function U(e,t){return t.toUpperCase()}function X(e){return e.replace(_,"ms-").replace(z,U)}var V=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function G(){this.expando=S.expando+G.uid++}G.uid=1,G.prototype={cache:function(e){var t=ethis.expando;return t||(t={},V(e)&&(e.nodeType?ethis.expando=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)iX(t)=n;else for(r in t)iX(r)=tr;return i},get:function(e,t){return void 0===t?this.cache(e):ethis.expando&&ethis.expandoX(t)},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=ethis.expando;if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(X):(t=X(t))in r?t:t.match(P)||).length;while(n--)delete rtn}(void 0===t||S.isEmptyObject(r))&&(e.nodeType?ethis.expando=void 0:delete ethis.expando)}},hasData:function(e){var t=ethis.expando;return void 0!==t&&!S.isEmptyObject(t)}};var Y=new G,Q=new G,J=/^(?:\{\w\W*\}|\\w\W*\)$/,K=/A-Z/g;function Z(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}S.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),S.fn.extend({data:function(n,e){var t,r,i,o=this0,a=o&&o.attributes;if(void 0===n){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){t=a.length;while(t--)at&&0===(r=at.name).indexOf("data-")&&(r=X(r.slice(5)),Z(o,r,ir));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof n?this.each(function(){Q.set(this,n)}):$(this,function(e){var t;if(o&&void 0===e)return void 0!==(t=Q.get(o,n))?t:void 0!==(t=Z(o,n))?t:void 0;this.each(function(){Q.set(this,n,e)})},null,e,1<arguments.length,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),S.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,S.makeArray(n)):r.push(n)),r||},dequeue:function(e,t){t=t||"fx";var n=S.queue(e,t),r=n.length,i=n.shift(),o=S._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){S.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:S.Callbacks("once memory").add(function(){Y.remove(e,t+"queue",n)})})}}),S.fn.extend({queue:function(t,n){var e=2;return"string"!=typeof t&&(n=t,t="fx",e--),arguments.length<e?S.queue(this0,t):void 0===n?this:this.each(function(){var e=S.queue(this,t,n);S._queueHooks(this,t),"fx"===t&&"inprogress"!==e0&&S.dequeue(this,t)})},dequeue:function(e){return this.each(function(){S.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",)},promise:function(e,t){var n,r=1,i=S.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,o)};"string"!=typeof e&&(t=e,e=void 0),e=e||"fx";while(a--)(n=Y.get(oa,e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var ee=/+-?(?:\d*\.|)\d+(?:eE+-?\d+|)/.source,te=new RegExp("^(?:(+-)=|)("+ee+")(a-z%*)$","i"),ne="Top","Right","Bottom","Left",re=E.documentElement,ie=function(e){return S.contains(e.ownerDocument,e)},oe={composed:!0};re.getRootNode&&(ie=function(e){return S.contains(e.ownerDocument,e)||e.getRootNode(oe)===e.ownerDocument});var ae=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&ie(e)&&"none"===S.css(e,"display")};function se(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return S.css(e,t,"")},u=s(),l=n&&n3||(S.cssNumbert?"":"px"),c=e.nodeType&&(S.cssNumbert||"px"!==l&&+u)&&te.exec(S.css(e,t));if(c&&c3!==l){u/=2,l=l||c3,c=+u||1;while(a--)S.style(e,t,c+l),(1-o)*(1-(o=s()/u||.5))<=0&&(a=0),c/=o;c*=2,S.style(e,t,c+l),n=n||}return n&&(c=+c||+u||0,i=n1?c+(n1+1)*n2:+n2,r&&(r.unit=l,r.start=c,r.end=i)),i}var ue={};function le(e,t){for(var n,r,i,o,a,s,u,l=,c=0,f=e.length;c<f;c++)(r=ec).style&&(n=r.style.display,t?("none"===n&&(lc=Y.get(r,"display")||null,lc||(r.style.display="")),""===r.style.display&&ae(r)&&(lc=(u=a=o=void 0,a=(i=r).ownerDocument,s=i.nodeName,(u=ues)||(o=a.body.appendChild(a.createElement(s)),u=S.css(o,"display"),o.parentNode.removeChild(o),"none"===u&&(u="block"),ues=u)))):"none"!==n&&(lc="none",Y.set(r,"display",n)));for(c=0;c<f;c++)null!=lc&&(ec.style.display=lc);return e}S.fn.extend({show:function(){return le(this,!0)},hide:function(){return le(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ae(this)?S(this).show():S(this).hide()})}});var ce,fe,pe=/^(?:checkbox|radio)$/i,de=/<(a-z^\/\0>\x20\t\r\n\f*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="<textarea>x</textarea>",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="<option></option>",y.option=!!ce.lastChild;var ge={thead:1,"<table>","</table>",col:2,"<table><colgroup>","</colgroup></table>",tr:2,"<table><tbody>","</tbody></table>",td:3,"<table><tbody><tr>","</tr></tbody></table>",_default:0,"",""};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):,void 0===t||t&&A(e,t)?S.merge(e,n):n}function ye(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(en,"globalEval",!t||Y.get(tn,"globalEval"))}ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td,y.option||(ge.optgroup=ge.option=1,"<select multiple='multiple'>","</select>");var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=,d=0,h=e.length;d<h;d++)if((o=ed)||0===o)if("object"===w(o))S.merge(p,o.nodeType?o:o);else if(me.test(o)){a=a||f.appendChild(t.createElement("div")),s=(de.exec(o)||"","")1.toLowerCase(),u=ges||ge._default,a.innerHTML=u1+S.htmlPrefilter(o)+u2,c=u0;while(c--)a=a.lastChild;S.merge(p,a.childNodes),(a=f.firstChild).textContent=""}else p.push(t.createTextNode(o));f.textContent="",d=0;while(o=pd++)if(r&&-1<S.inArray(o,r))i&&i.push(o);else if(l=ie(o),a=ve(f.appendChild(o),"script"),l&&ye(a),n){c=0;while(o=ac++)he.test(o.type||"")&&n.push(o)}return f}var be=/^(^.*)(?:\.(.+)|)/;function we(){return!0}function Te(){return!1}function Ce(e,t){return e===function(){try{return E.activeElement}catch(e){}}()==("focus"===t)}function Ee(e,t,n,r,i,o){var a,s;if("object"==typeof t){for(s in"string"!=typeof n&&(r=r||n,n=void 0),t)Ee(e,s,n,r,ts,o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Te;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return S().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=S.guid++)),e.each(function(){S.event.add(this,t,i,r,n)})}function Se(e,i,o){o?(Y.set(e,i,!1),S.event.add(e,i,{namespace:!1,handler:function(e){var t,n,r=Y.get(this,i);if(1&e.isTrigger&&thisi){if(r.length)(S.event.speciali||{}).delegateType&&e.stopPropagation();else if(r=s.call(arguments),Y.set(this,i,r),t=o(this,i),thisi(),r!==(n=Y.get(this,i))||t?Y.set(this,i,!1):n={},r!==n)return e.stopImmediatePropagation(),e.preventDefault(),n&&n.value}else r.length&&(Y.set(this,i,{value:S.event.trigger(S.extend(r0,S.Event.prototype),r.slice(1),this)}),e.stopImmediatePropagation())}})):void 0===Y.get(e,i)&&S.event.add(e,i,we)}S.event={global:{},add:function(t,e,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.get(t);if(V(t)){n.handler&&(n=(o=n).handler,i=o.selector),i&&S.find.matchesSelector(re,i),n.guid||(n.guid=S.guid++),(u=v.events)||(u=v.events=Object.create(null)),(a=v.handle)||(a=v.handle=function(e){return"undefined"!=typeof S&&S.event.triggered!==e.type?S.event.dispatch.apply(t,arguments):void 0}),l=(e=(e||"").match(P)||"").length;while(l--)d=g=(s=be.exec(el)||)1,h=(s2||"").split(".").sort(),d&&(f=S.event.speciald||{},d=(i?f.delegateType:f.bindType)||d,f=S.event.speciald||{},c=S.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&S.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=ud)||((p=ud=).delegateCount=0,f.setup&&!1!==f.setup.call(t,r,h,a)||t.addEventListener&&t.addEventListener(d,a)),f.add&&(f.add.call(t,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),S.event.globald=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.hasData(e)&&Y.get(e);if(v&&(u=v.events)){l=(t=(t||"").match(P)||"").length;while(l--)if(d=g=(s=be.exec(tl)||)1,h=(s2||"").split(".").sort(),d){f=S.event.speciald||{},p=ud=(r?f.delegateType:f.bindType)||d||,s=s2&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=po,!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,v.handle)||S.removeEvent(e,d,v.handle),delete ud)}else for(d in u)S.event.remove(e,d+tl,n,r,!0);S.isEmptyObject(u)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=new Array(arguments.length),u=S.event.fix(e),l=(Y.get(this,"events")||Object.create(null))u.type||,c=S.event.specialu.type||{};for(s0=u,t=1;t<arguments.length;t++)st=argumentst;if(u.delegateTarget=this,!c.preDispatch||!1!==c.preDispatch.call(this,u)){a=S.event.handlers.call(this,u,l),t=0;while((i=at++)&&!u.isPropagationStopped()){u.currentTarget=i.elem,n=0;while((o=i.handlersn++)&&!u.isImmediatePropagationStopped())u.rnamespace&&!1!==o.namespace&&!u.rnamespace.test(o.namespace)||(u.handleObj=o,u.data=o.data,void 0!==(r=((S.event.specialo.origType||{}).handle||o.handler).apply(i.elem,s))&&!1===(u.result=r)&&(u.preventDefault(),u.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,u),u.result}},handlers:function(e,t){var n,r,i,o,a,s=,u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&1<=e.button))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=,a={},n=0;n<u;n++)void 0===ai=(r=tn).selector+" "&&(ai=r.needsContext?-1<S(i,this).index(l):S.find(i,this,null,l).length),ai&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(t,e){Object.defineProperty(S.Event.prototype,t,{enumerable:!0,configurable:!0,get:m(e)?function(){if(this.originalEvent)return e(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEventt},set:function(e){Object.defineProperty(this,t,{enumerable:!0,configurable:!0,writable:!0,value:e})}})},fix:function(e){return eS.expando?e:new S.Event(e)},special:{load:{noBubble:!0},click:{setup:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click",we),!1},trigger:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click"),!0},_default:function(e){var t=e.target;return pe.test(t.type)&&t.click&&A(t,"input")&&Y.get(t,"click")||A(t,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},S.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},S.Event=function(e,t){if(!(this instanceof S.Event))return new S.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?we:Te,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&S.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),thisS.expando=!0},S.Event.prototype={constructor:S.Event,isDefaultPrevented:Te,isPropagationStopped:Te,isImmediatePropagationStopped:Te,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=we,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=we,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=we,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},S.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,"char":!0,code:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:!0},S.event.addProp),S.each({focus:"focusin",blur:"focusout"},function(e,t){S.event.speciale={setup:function(){return Se(this,e,Ce),!1},trigger:function(){return Se(this,e),!0},_default:function(){return!0},delegateType:t}}),S.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,i){S.event.speciale={delegateType:i,bindType:i,handle:function(e){var t,n=e.relatedTarget,r=e.handleObj;return n&&(n===this||S.contains(this,n))||(e.type=r.origType,t=r.handler.apply(this,arguments),e.type=i),t}}}),S.fn.extend({on:function(e,t,n,r){return Ee(this,e,t,n,r)},one:function(e,t,n,r){return Ee(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,S(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,ei);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Te),this.each(function(){S.event.remove(this,e,n,t)})}});var ke=/<script|<style|<link/i,Ae=/checked\s*(?:^=|=\s*.checked.)/i,Ne=/^\s*<!(?:\CDATA\|--)|(?:\\|--)>\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")0||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=si.length;n<r;n++)S.event.add(t,i,sin);Q.hasData(e)&&(o=Q.access(e),a=S.extend({},o),Q.set(t,a))}}function He(n,r,i,o){r=g(r);var e,t,a,s,u,l,c=0,f=n.length,p=f-1,d=r0,h=m(d);if(h||1<f&&"string"==typeof d&&!y.checkClone&&Ae.test(d))return n.each(function(e){var t=n.eq(e);h&&(r0=d.call(this,e,t.html())),He(t,r,i,o)});if(f&&(t=(e=xe(r,n0.ownerDocument,!1,n,o)).firstChild,1===e.childNodes.length&&(e=t),t||o)){for(s=(a=S.map(ve(e,"script"),De)).length;c<f;c++)u=e,c!==p&&(u=S.clone(u,!0,!0),s&&S.merge(a,ve(u,"script"))),i.call(nc,u,c);if(s)for(l=aa.length-1.ownerDocument,S.map(a,qe),c=0;c<s;c++)u=ac,he.test(u.type||"")&&!Y.access(u,"globalEval")&&S.contains(l,u)&&(u.src&&"module"!==(u.type||"").toLowerCase()?S._evalUrl&&!u.noModule&&S._evalUrl(u.src,{nonce:u.nonce||u.getAttribute("nonce")},l):b(u.textContent.replace(Ne,""),u,l))}return n}function Oe(e,t,n){for(var r,i=t?S.filter(t,e):e,o=0;null!=(r=io);o++)n||1!==r.nodeType||S.cleanData(ve(r)),r.parentNode&&(n&&ie(r)&&ye(ve(r,"script")),r.parentNode.removeChild(r));return e}S.extend({htmlPrefilter:function(e){return e},clone:function(e,t,n){var r,i,o,a,s,u,l,c=e.cloneNode(!0),f=ie(e);if(!(y.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||S.isXMLDoc(e)))for(a=ve(c),r=0,i=(o=ve(e)).length;r<i;r++)s=or,u=ar,void 0,"input"===(l=u.nodeName.toLowerCase())&&pe.test(s.type)?u.checked=s.checked:"input"!==l&&"textarea"!==l||(u.defaultValue=s.defaultValue);if(t)if(n)for(o=o||ve(e),a=a||ve(c),r=0,i=o.length;r<i;r++)Le(or,ar);else Le(e,c);return 0<(a=ve(c,"script")).length&&ye(a,!f&&ve(e,"script")),c},cleanData:function(e){for(var t,n,r,i=S.event.special,o=0;void 0!==(n=eo);o++)if(V(n)){if(t=nY.expando){if(t.events)for(r in t.events)ir?S.event.remove(n,r):S.removeEvent(n,r,t.handle);nY.expando=void 0}nQ.expando&&(nQ.expando=void 0)}}}),S.fn.extend({detach:function(e){return Oe(this,e,!0)},remove:function(e){return Oe(this,e)},text:function(e){return $(this,function(e){return void 0===e?S.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return He(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return He(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=thist);t++)1===e.nodeType&&(S.cleanData(ve(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return S.clone(this,e,t)})},html:function(e){return $(this,function(e){var t=this0||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!ke.test(e)&&!ge(de.exec(e)||"","")1.toLowerCase()){e=S.htmlPrefilter(e);try{for(;n<r;n++)1===(t=thisn||{}).nodeType&&(S.cleanData(ve(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var n=;return He(this,arguments,function(e){var t=this.parentNode;S.inArray(this,n)<0&&(S.cleanData(ve(this)),t&&t.replaceChild(e,this))},n)}}),S.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,a){S.fne=function(e){for(var t,n=,r=S(e),i=r.length-1,o=0;o<=i;o++)t=o===i?this:this.clone(!0),S(ro)a(t),u.apply(n,t.get());return this.pushStack(n)}});var Pe=new RegExp("^("+ee+")(?!px)a-z%+$","i"),Re=function(e){var t=e.ownerDocument.defaultView;return t&&t.opener||(t=C),t.getComputedStyle(e)},Me=function(e,t,n){var r,i,o={};for(i in t)oi=e.stylei,e.stylei=ti;for(i in r=n.call(e),t)e.stylei=oi;return r},Ie=new RegExp(ne.join("|"),"i");function We(e,t,n){var r,i,o,a,s=e.style;return(n=n||Re(e))&&(""!==(a=n.getPropertyValue(t)||nt)||ie(e)||(a=S.style(e,t)),!y.pixelBoxStyles()&&Pe.test(a)&&Ie.test(t)&&(r=s.width,i=s.minWidth,o=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=i,s.maxWidth=o)),void 0!==a?a+"":a}function Fe(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function e(){if(l){u.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",l.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",re.appendChild(u).appendChild(l);var e=C.getComputedStyle(l);n="1%"!==e.top,s=12===t(e.marginLeft),l.style.right="60%",o=36===t(e.right),r=36===t(e.width),l.style.position="absolute",i=12===t(l.offsetWidth/3),re.removeChild(u),l=null}}function t(e){return Math.round(parseFloat(e))}var n,r,i,o,a,s,u=E.createElement("div"),l=E.createElement("div");l.style&&(l.style.backgroundClip="content-box",l.cloneNode(!0).style.backgroundClip="",y.clearCloneStyle="content-box"===l.style.backgroundClip,S.extend(y,{boxSizingReliable:function(){return e(),r},pixelBoxStyles:function(){return e(),o},pixelPosition:function(){return e(),n},reliableMarginLeft:function(){return e(),s},scrollboxSize:function(){return e(),i},reliableTrDimensions:function(){var e,t,n,r;return null==a&&(e=E.createElement("table"),t=E.createElement("tr"),n=E.createElement("div"),e.style.cssText="position:absolute;left:-11111px;border-collapse:separate",t.style.cssText="border:1px solid",t.style.height="1px",n.style.height="9px",n.style.display="block",re.appendChild(e).appendChild(t).appendChild(n),r=C.getComputedStyle(t),a=parseInt(r.height,10)+parseInt(r.borderTopWidth,10)+parseInt(r.borderBottomWidth,10)===t.offsetHeight,re.removeChild(e)),a}}))}();var Be="Webkit","Moz","ms",$e=E.createElement("div").style,_e={};function ze(e){var t=S.cssPropse||_ee;return t||(e in $e?e:_ee=function(e){var t=e0.toUpperCase()+e.slice(1),n=Be.length;while(n--)if((e=Ben+t)in $e)return e}(e)||e)}var Ue=/^(none|table(?!-cea).+)/,Xe=/^--/,Ve={position:"absolute",visibility:"hidden",display:"block"},Ge={letterSpacing:"0",fontWeight:"400"};function Ye(e,t,n){var r=te.exec(t);return r?Math.max(0,r2-(n||0))+(r3||"px"):t}function Qe(e,t,n,r,i,o){var a="width"===t?1:0,s=0,u=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(u+=S.css(e,n+nea,!0,i)),r?("content"===n&&(u-=S.css(e,"padding"+nea,!0,i)),"margin"!==n&&(u-=S.css(e,"border"+nea+"Width",!0,i))):(u+=S.css(e,"padding"+nea,!0,i),"padding"!==n?u+=S.css(e,"border"+nea+"Width",!0,i):s+=S.css(e,"border"+nea+"Width",!0,i));return!r&&0<=o&&(u+=Math.max(0,Math.ceil(e"offset"+t0.toUpperCase()+t.slice(1)-o-u-s-.5))||0),u}function Je(e,t,n){var r=Re(e),i=(!y.boxSizingReliable()||n)&&"border-box"===S.css(e,"boxSizing",!1,r),o=i,a=We(e,t,r),s="offset"+t0.toUpperCase()+t.slice(1);if(Pe.test(a)){if(!n)return a;a="auto"}return(!y.boxSizingReliable()&&i||!y.reliableTrDimensions()&&A(e,"tr")||"auto"===a||!parseFloat(a)&&"inline"===S.css(e,"display",!1,r))&&e.getClientRects().length&&(i="border-box"===S.css(e,"boxSizing",!1,r),(o=s in e)&&(a=es)),(a=parseFloat(a)||0)+Qe(e,t,n||(i?"border":"content"),o,r,a)+"px"}function Ke(e,t,n,r,i){return new Ke.prototype.init(e,t,n,r,i)}S.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=We(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,gridArea:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnStart:!0,gridRow:!0,gridRowEnd:!0,gridRowStart:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=X(t),u=Xe.test(t),l=e.style;if(u||(t=ze(s)),a=S.cssHookst||S.cssHookss,void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:lt;"string"===(o=typeof n)&&(i=te.exec(n))&&i1&&(n=se(e,t,i),o="number"),null!=n&&n==n&&("number"!==o||u||(n+=i&&i3||(S.cssNumbers?"":"px")),y.clearCloneStyle||""!==n||0!==t.indexOf("background")||(lt="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):lt=n))}},css:function(e,t,n,r){var i,o,a,s=X(t);return Xe.test(t)||(t=ze(s)),(a=S.cssHookst||S.cssHookss)&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=We(e,t,r)),"normal"===i&&t in Ge&&(i=Get),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),S.each("height","width",function(e,u){S.cssHooksu={get:function(e,t,n){if(t)return!Ue.test(S.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,u,n):Me(e,Ve,function(){return Je(e,u,n)})},set:function(e,t,n){var r,i=Re(e),o=!y.scrollboxSize()&&"absolute"===i.position,a=(o||n)&&"border-box"===S.css(e,"boxSizing",!1,i),s=n?Qe(e,u,n,a,i):0;return a&&o&&(s-=Math.ceil(e"offset"+u0.toUpperCase()+u.slice(1)-parseFloat(iu)-Qe(e,u,"border",!1,i)-.5)),s&&(r=te.exec(t))&&"px"!==(r3||"px")&&(e.styleu=t,t=S.css(e,u)),Ye(0,t,s)}}}),S.cssHooks.marginLeft=Fe(y.reliableMarginLeft,function(e,t){if(t)return(parseFloat(We(e,"marginLeft"))||e.getBoundingClientRect().left-Me(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),S.each({margin:"",padding:"",border:"Width"},function(i,o){S.cssHooksi+o={expand:function(e){for(var t=0,n={},r="string"==typeof e?e.split(" "):e;t<4;t++)ni+net+o=rt||rt-2||r0;return n}},"margin"!==i&&(S.cssHooksi+o.set=Ye)}),S.fn.extend({css:function(e,t){return $(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Re(e),i=t.length;a<i;a++)ota=S.css(e,ta,!1,r);return o}return void 0!==n?S.style(e,t,n):S.css(e,t)},e,t,1<arguments.length)}}),((S.Tween=Ke).prototype={constructor:Ke,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||S.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(S.cssNumbern?"":"px")},cur:function(){var e=Ke.propHooksthis.prop;return e&&e.get?e.get(this):Ke.propHooks._default.get(this)},run:function(e){var t,n=Ke.propHooksthis.prop;return this.options.duration?this.pos=t=S.easingthis.easing(e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):Ke.propHooks._default.set(this),this}}).init.prototype=Ke.prototype,(Ke.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.eleme.prop&&null==e.elem.stylee.prop?e.eleme.prop:(t=S.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){S.fx.stepe.prop?S.fx.stepe.prop(e):1!==e.elem.nodeType||!S.cssHookse.prop&&null==e.elem.styleze(e.prop)?e.eleme.prop=e.now:S.style(e.elem,e.prop,e.now+e.unit)}}}).scrollTop=Ke.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.eleme.prop=e.now)}},S.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},S.fx=Ke.prototype.init,S.fx.step={};var Ze,et,tt,nt,rt=/^(?:toggle|show|hide)$/,it=/queueHooks$/;function ot(){et&&(!1===E.hidden&&C.requestAnimationFrame?C.requestAnimationFrame(ot):C.setTimeout(ot,S.fx.interval),S.fx.tick())}function at(){return C.setTimeout(function(){Ze=void 0}),Ze=Date.now()}function st(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i"margin"+(n=ner)=i"padding"+n=e;return t&&(i.opacity=i.width=e),i}function ut(e,t,n){for(var r,i=(lt.tweenerst||).concat(lt.tweeners"*"),o=0,a=i.length;o<a;o++)if(r=io.call(n,t,e))return r}function lt(o,e,t){var n,a,r=0,i=lt.prefilters.length,s=S.Deferred().always(function(){delete u.elem}),u=function(){if(a)return!1;for(var e=Ze||at(),t=Math.max(0,l.startTime+l.duration-e),n=1-(t/l.duration||0),r=0,i=l.tweens.length;r<i;r++)l.tweensr.run(n);return s.notifyWith(o,l,n,t),n<1&&i?t:(i||s.notifyWith(o,l,1,0),s.resolveWith(o,l),!1)},l=s.promise({elem:o,props:S.extend({},e),opts:S.extend(!0,{specialEasing:{},easing:S.easing._default},t),originalProperties:e,originalOptions:t,startTime:Ze||at(),duration:t.duration,tweens:,createTween:function(e,t){var n=S.Tween(o,l.opts,e,t,l.opts.specialEasinge||l.opts.easing);return l.tweens.push(n),n},stop:function(e){var t=0,n=e?l.tweens.length:0;if(a)return this;for(a=!0;t<n;t++)l.tweenst.run(1);return e?(s.notifyWith(o,l,1,0),s.resolveWith(o,l,e)):s.rejectWith(o,l,e),this}}),c=l.props;for(!function(e,t){var n,r,i,o,a;for(n in e)if(i=tr=X(n),o=en,Array.isArray(o)&&(i=o1,o=en=o0),n!==r&&(er=o,delete en),(a=S.cssHooksr)&&"expand"in a)for(n in o=a.expand(o),delete er,o)n in e||(en=on,tn=i);else tr=i}(c,l.opts.specialEasing);r<i;r++)if(n=lt.prefiltersr.call(l,o,c,l.opts))return m(n.stop)&&(S._queueHooks(l.elem,l.opts.queue).stop=n.stop.bind(n)),n;return S.map(c,ut,l),m(l.opts.start)&&l.opts.start.call(o,l),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always),S.fx.timer(S.extend(u,{elem:o,anim:l,queue:l.opts.queue})),l}S.Animation=S.extend(lt,{tweeners:{"*":function(e,t){var n=this.createTween(e,t);return se(n.elem,e,te.exec(t),n),n}},tweener:function(e,t){m(e)?(t=e,e="*"):e=e.match(P);for(var n,r=0,i=e.length;r<i;r++)n=er,lt.tweenersn=lt.tweenersn||,lt.tweenersn.unshift(t)},prefilters:function(e,t,n){var r,i,o,a,s,u,l,c,f="width"in t||"height"in t,p=this,d={},h=e.style,g=e.nodeType&&ae(e),v=Y.get(e,"fxshow");for(r in n.queue||(null==(a=S._queueHooks(e,"fx")).unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,S.queue(e,"fx").length||a.empty.fire()})})),t)if(i=tr,rt.test(i)){if(delete tr,o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!v||void 0===vr)continue;g=!0}dr=v&&vr||S.style(e,r)}if((u=!S.isEmptyObject(t))||!S.isEmptyObject(d))for(r in f&&1===e.nodeType&&(n.overflow=h.overflow,h.overflowX,h.overflowY,null==(l=v&&v.display)&&(l=Y.get(e,"display")),"none"===(c=S.css(e,"display"))&&(l?c=l:(le(e,!0),l=e.style.display||l,c=S.css(e,"display"),le(e))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===S.css(e,"float")&&(u||(p.done(function(){h.display=l}),null==l&&(c=h.display,l="none"===c?"":c)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",p.always(function(){h.overflow=n.overflow0,h.overflowX=n.overflow1,h.overflowY=n.overflow2})),u=!1,d)u||(v?"hidden"in v&&(g=v.hidden):v=Y.access(e,"fxshow",{display:l}),o&&(v.hidden=!g),g&&le(e,!0),p.done(function(){for(r in g||le(e),Y.remove(e,"fxshow"),d)S.style(e,r,dr)})),u=ut(g?vr:0,r,p),r in v||(vr=u.start,g&&(u.end=u.start,u.start=0))},prefilter:function(e,t){t?lt.prefilters.unshift(e):lt.prefilters.push(e)}}),S.speed=function(e,t,n){var r=e&&"object"==typeof e?S.extend({},e):{complete:n||!n&&t||m(e)&&e,duration:e,easing:n&&t||t&&!m(t)&&t};return S.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in S.fx.speeds?r.duration=S.fx.speedsr.duration:r.duration=S.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){m(r.old)&&r.old.call(this),r.queue&&S.dequeue(this,r.queue)},r},S.fn.extend({fadeTo:function(e,t,n,r){return this.filter(ae).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(t,e,n,r){var i=S.isEmptyObject(t),o=S.speed(e,n,r),a=function(){var e=lt(this,S.extend({},t),o);(i||Y.get(this,"finish"))&&e.stop(!0)};return a.finish=a,i||!1===o.queue?this.each(a):this.queue(o.queue,a)},stop:function(i,e,o){var a=function(e){var t=e.stop;delete e.stop,t(o)};return"string"!=typeof i&&(o=e,e=i,i=void 0),e&&this.queue(i||"fx",),this.each(function(){var e=!0,t=null!=i&&i+"queueHooks",n=S.timers,r=Y.get(this);if(t)rt&&rt.stop&&a(rt);else for(t in r)rt&&rt.stop&&it.test(t)&&a(rt);for(t=n.length;t--;)nt.elem!==this||null!=i&&nt.queue!==i||(nt.anim.stop(o),e=!1,n.splice(t,1));!e&&o||S.dequeue(this,i)})},finish:function(a){return!1!==a&&(a=a||"fx"),this.each(function(){var e,t=Y.get(this),n=ta+"queue",r=ta+"queueHooks",i=S.timers,o=n?n.length:0;for(t.finish=!0,S.queue(this,a,),r&&r.stop&&r.stop.call(this,!0),e=i.length;e--;)ie.elem===this&&ie.queue===a&&(ie.anim.stop(!0),i.splice(e,1));for(e=0;e<o;e++)ne&&ne.finish&&ne.finish.call(this);delete t.finish})}}),S.each("toggle","show","hide",function(e,r){var i=S.fnr;S.fnr=function(e,t,n){return null==e||"boolean"==typeof e?i.apply(this,arguments):this.animate(st(r,!0),e,t,n)}}),S.each({slideDown:st("show"),slideUp:st("hide"),slideToggle:st("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,r){S.fne=function(e,t,n){return this.animate(r,e,t,n)}}),S.timers=,S.fx.tick=function(){var e,t=0,n=S.timers;for(Ze=Date.now();t<n.length;t++)(e=nt)()||nt!==e||n.splice(t--,1);n.length||S.fx.stop(),Ze=void 0},S.fx.timer=function(e){S.timers.push(e),S.fx.start()},S.fx.interval=13,S.fx.start=function(){et||(et=!0,ot())},S.fx.stop=function(){et=null},S.fx.speeds={slow:600,fast:200,_default:400},S.fn.delay=function(r,e){return r=S.fx&&S.fx.speedsr||r,e=e||"fx",this.queue(e,function(e,t){var n=C.setTimeout(e,r);t.stop=function(){C.clearTimeout(n)}})},tt=E.createElement("input"),nt=E.createElement("select").appendChild(E.createElement("option")),tt.type="checkbox",y.checkOn=""!==tt.value,y.optSelected=nt.selected,(tt=E.createElement("input")).value="t",tt.type="radio",y.radioValue="t"===tt.value;var ct,ft=S.expr.attrHandle;S.fn.extend({attr:function(e,t){return $(this,S.attr,e,t,1<arguments.length)},removeAttr:function(e){return this.each(function(){S.removeAttr(this,e)})}}),S.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?S.prop(e,t,n):(1===o&&S.isXMLDoc(e)||(i=S.attrHookst.toLowerCase()||(S.expr.match.bool.test(t)?ct:void 0)),void 0!==n?null===n?void S.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=S.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!y.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(P);if(i&&1===e.nodeType)while(n=ir++)e.removeAttribute(n)}}),ct={set:function(e,t,n){return!1===t?S.removeAttr(e,n):e.setAttribute(n,n),n}},S.each(S.expr.match.bool.source.match(/\w+/g),function(e,t){var a=ftt||S.find.attr;ftt=function(e,t,n){var r,i,o=t.toLowerCase();return n||(i=fto,fto=r,r=null!=a(e,t,n)?o:null,fto=i),r}});var pt=/^(?:input|select|textarea|button)$/i,dt=/^(?:a|area)$/i;function ht(e){return(e.match(P)||).join(" ")}function gt(e){return e.getAttribute&&e.getAttribute("class")||""}function vt(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(P)||}S.fn.extend({prop:function(e,t){return $(this,S.prop,e,t,1<arguments.length)},removeProp:function(e){return this.each(function(){delete thisS.propFixe||e})}}),S.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&S.isXMLDoc(e)||(t=S.propFixt||t,i=S.propHookst),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:et=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:et},propHooks:{tabIndex:{get:function(e){var t=S.find.attr(e,"tabindex");return t?parseInt(t,10):pt.test(e.nodeName)||dt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),y.optSelected||(S.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),S.each("tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable",function(){S.propFixthis.toLowerCase()=this}),S.fn.extend({addClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).addClass(t.call(this,e,gt(this)))});if((e=vt(t)).length)while(n=thisu++)if(i=gt(n),r=1===n.nodeType&&" "+ht(i)+" "){a=0;while(o=ea++)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=ht(r))&&n.setAttribute("class",s)}return this},removeClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).removeClass(t.call(this,e,gt(this)))});if(!arguments.length)return this.attr("class","");if((e=vt(t)).length)while(n=thisu++)if(i=gt(n),r=1===n.nodeType&&" "+ht(i)+" "){a=0;while(o=ea++)while(-1<r.indexOf(" "+o+" "))r=r.replace(" "+o+" "," ");i!==(s=ht(r))&&n.setAttribute("class",s)}return this},toggleClass:function(i,t){var o=typeof i,a="string"===o||Array.isArray(i);return"boolean"==typeof t&&a?t?this.addClass(i):this.removeClass(i):m(i)?this.each(function(e){S(this).toggleClass(i.call(this,e,gt(this),t),t)}):this.each(function(){var e,t,n,r;if(a){t=0,n=S(this),r=vt(i);while(e=rt++)n.hasClass(e)?n.removeClass(e):n.addClass(e)}else void 0!==i&&"boolean"!==o||((e=gt(this))&&Y.set(this,"__className__",e),this.setAttribute&&this.setAttribute("class",e||!1===i?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=thisr++)if(1===n.nodeType&&-1<(" "+ht(gt(n))+" ").indexOf(t))return!0;return!1}});var yt=/\r/g;S.fn.extend({val:function(n){var r,e,i,t=this0;return arguments.length?(i=m(n),this.each(function(e){var t;1===this.nodeType&&(null==(t=i?n.call(this,e,S(this).val()):n)?t="":"number"==typeof t?t+="":Array.isArray(t)&&(t=S.map(t,function(e){return null==e?"":e+""})),(r=S.valHooksthis.type||S.valHooksthis.nodeName.toLowerCase())&&"set"in r&&void 0!==r.set(this,t,"value")||(this.value=t))})):t?(r=S.valHookst.type||S.valHookst.nodeName.toLowerCase())&&"get"in r&&void 0!==(e=r.get(t,"value"))?e:"string"==typeof(e=t.value)?e.replace(yt,""):null==e?"":e:void 0}}),S.extend({valHooks:{option:{get:function(e){var t=S.find.attr(e,"value");return null!=t?t:ht(S.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:,u=a?o+1:i.length;for(r=o<0?u:a?o:0;r<u;r++)if(((n=ir).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=S(n).val(),a)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=S.makeArray(t),a=i.length;while(a--)((r=ia).selected=-1<S.inArray(S.valHooks.option.get(r),o))&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),S.each("radio","checkbox",function(){S.valHooksthis={set:function(e,t){if(Array.isArray(t))return e.checked=-1<S.inArray(S(e).val(),t)}},y.checkOn||(S.valHooksthis.get=function(e){return null===e.getAttribute("value")?"on":e.value})}),y.focusin="onfocusin"in C;var mt=/^(?:focusinfocus|focusoutblur)$/,xt=function(e){e.stopPropagation()};S.extend(S.event,{trigger:function(e,t,n,r){var i,o,a,s,u,l,c,f,p=n||E,d=v.call(e,"type")?e.type:e,h=v.call(e,"namespace")?e.namespace.split("."):;if(o=f=a=n=n||E,3!==n.nodeType&&8!==n.nodeType&&!mt.test(d+S.event.triggered)&&(-1<d.indexOf(".")&&(d=(h=d.split(".")).shift(),h.sort()),u=d.indexOf(":")<0&&"on"+d,(e=eS.expando?e:new S.Event(d,"object"==typeof e&&e)).isTrigger=r?2:3,e.namespace=h.join("."),e.rnamespace=e.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,e.result=void 0,e.target||(e.target=n),t=null==t?e:S.makeArray(t,e),c=S.event.speciald||{},r||!c.trigger||!1!==c.trigger.apply(n,t))){if(!r&&!c.noBubble&&!x(n)){for(s=c.delegateType||d,mt.test(s+d)||(o=o.parentNode);o;o=o.parentNode)p.push(o),a=o;a===(n.ownerDocument||E)&&p.push(a.defaultView||a.parentWindow||C)}i=0;while((o=pi++)&&!e.isPropagationStopped())f=o,e.type=1<i?s:c.bindType||d,(l=(Y.get(o,"events")||Object.create(null))e.type&&Y.get(o,"handle"))&&l.apply(o,t),(l=u&&ou)&&l.apply&&V(o)&&(e.result=l.apply(o,t),!1===e.result&&e.preventDefault());return e.type=d,r||e.isDefaultPrevented()||c._default&&!1!==c._default.apply(p.pop(),t)||!V(n)||u&&m(nd)&&!x(n)&&((a=nu)&&(nu=null),S.event.triggered=d,e.isPropagationStopped()&&f.addEventListener(d,xt),nd(),e.isPropagationStopped()&&f.removeEventListener(d,xt),S.event.triggered=void 0,a&&(nu=a)),e.result}},simulate:function(e,t,n){var r=S.extend(new S.Event,n,{type:e,isSimulated:!0});S.event.trigger(r,null,t)}}),S.fn.extend({trigger:function(e,t){return this.each(function(){S.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this0;if(n)return S.event.trigger(e,t,n,!0)}}),y.focusin||S.each({focus:"focusin",blur:"focusout"},function(n,r){var i=function(e){S.event.simulate(r,e.target,S.event.fix(e))};S.event.specialr={setup:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r);t||e.addEventListener(n,i,!0),Y.access(e,r,(t||0)+1)},teardown:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r)-1;t?Y.access(e,r,t):(e.removeEventListener(n,i,!0),Y.remove(e,r))}}});var bt=C.location,wt={guid:Date.now()},Tt=/\?/;S.parseXML=function(e){var t,n;if(!e||"string"!=typeof e)return null;try{t=(new C.DOMParser).parseFromString(e,"text/xml")}catch(e){}return n=t&&t.getElementsByTagName("parsererror")0,t&&!n||S.error("Invalid XML: "+(n?S.map(n.childNodes,function(e){return e.textContent}).join("\n"):e)),t};var Ct=/\\$/,Et=/\r?\n/g,St=/^(?:submit|button|image|reset|file)$/i,kt=/^(?:input|select|textarea|keygen)/i;function At(n,e,r,i){var t;if(Array.isArray(e))S.each(e,function(e,t){r||Ct.test(n)?i(n,t):At(n+""+("object"==typeof t&&null!=t?e:"")+"",t,r,i)});else if(r||"object"!==w(e))i(n,e);else for(t in e)At(n+""+t+"",et,r,i)}S.param=function(e,t){var n,r=,i=function(e,t){var n=m(t)?t():t;rr.length=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(null==e)return"";if(Array.isArray(e)||e.jquery&&!S.isPlainObject(e))S.each(e,function(){i(this.name,this.value)});else for(n in e)At(n,en,t,i);return r.join("&")},S.fn.extend({serialize:function(){return S.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=S.prop(this,"elements");return e?S.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!S(this).is(":disabled")&&kt.test(this.nodeName)&&!St.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=S(this).val();return null==n?null:Array.isArray(n)?S.map(n,function(e){return{name:t.name,value:e.replace(Et,"\r\n")}}):{name:t.name,value:n.replace(Et,"\r\n")}}).get()}});var Nt=/%20/g,jt=/#.*$/,Dt=/(?&)_=^&*/,qt=/^(.*?): \t*(^\r\n*)$/gm,Lt=/^(?:GET|HEAD)$/,Ht=/^\/\//,Ot={},Pt={},Rt="*/".concat("*"),Mt=E.createElement("a");function It(o){return function(e,t){"string"!=typeof e&&(t=e,e="*");var n,r=0,i=e.toLowerCase().match(P)||;if(m(t))while(n=ir++)"+"===n0?(n=n.slice(1)||"*",(on=on||).unshift(t)):(on=on||).push(t)}}function Wt(t,i,o,a){var s={},u=t===Pt;function l(e){var r;return se=!0,S.each(te||,function(e,t){var n=t(i,o,a);return"string"!=typeof n||u||sn?u?!(r=n):void 0:(i.dataTypes.unshift(n),l(n),!1)}),r}return l(i.dataTypes0)||!s"*"&&l("*")}function Ft(e,t){var n,r,i=S.ajaxSettings.flatOptions||{};for(n in t)void 0!==tn&&((in?e:r||(r={}))n=tn);return r&&S.extend(!0,e,r),e}Mt.href=bt.href,S.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:bt.href,type:"GET",isLocal:/^(?:about|app|app-storage|.+-extension|file|res|widget):$/.test(bt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Rt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":S.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?Ft(Ft(e,S.ajaxSettings),t):Ft(S.ajaxSettings,e)},ajaxPrefilter:It(Ot),ajaxTransport:It(Pt),ajax:function(e,t){"object"==typeof e&&(t=e,e=void 0),t=t||{};var c,f,p,n,d,r,h,g,i,o,v=S.ajaxSetup({},t),y=v.context||v,m=v.context&&(y.nodeType||y.jquery)?S(y):S.event,x=S.Deferred(),b=S.Callbacks("once memory"),w=v.statusCode||{},a={},s={},u="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(h){if(!n){n={};while(t=qt.exec(p))nt1.toLowerCase()+" "=(nt1.toLowerCase()+" "||).concat(t2)}t=ne.toLowerCase()+" "}return null==t?null:t.join(", ")},getAllResponseHeaders:function(){return h?p:null},setRequestHeader:function(e,t){return null==h&&(e=se.toLowerCase()=se.toLowerCase()||e,ae=t),this},overrideMimeType:function(e){return null==h&&(v.mimeType=e),this},statusCode:function(e){var t;if(e)if(h)T.always(eT.status);else for(t in e)wt=wt,et;return this},abort:function(e){var t=e||u;return c&&c.abort(t),l(0,t),this}};if(x.promise(T),v.url=((e||v.url||bt.href)+"").replace(Ht,bt.protocol+"//"),v.type=t.method||t.type||v.method||v.type,v.dataTypes=(v.dataType||"*").toLowerCase().match(P)||"",null==v.crossDomain){r=E.createElement("a");try{r.href=v.url,r.href=r.href,v.crossDomain=Mt.protocol+"//"+Mt.host!=r.protocol+"//"+r.host}catch(e){v.crossDomain=!0}}if(v.data&&v.processData&&"string"!=typeof v.data&&(v.data=S.param(v.data,v.traditional)),Wt(Ot,v,t,T),h)return T;for(i in(g=S.event&&v.global)&&0==S.active++&&S.event.trigger("ajaxStart"),v.type=v.type.toUpperCase(),v.hasContent=!Lt.test(v.type),f=v.url.replace(jt,""),v.hasContent?v.data&&v.processData&&0===(v.contentType||"").indexOf("application/x-www-form-urlencoded")&&(v.data=v.data.replace(Nt,"+")):(o=v.url.slice(f.length),v.data&&(v.processData||"string"==typeof v.data)&&(f+=(Tt.test(f)?"&":"?")+v.data,delete v.data),!1===v.cache&&(f=f.replace(Dt,"$1"),o=(Tt.test(f)?"&":"?")+"_="+wt.guid+++o),v.url=f+o),v.ifModified&&(S.lastModifiedf&&T.setRequestHeader("If-Modified-Since",S.lastModifiedf),S.etagf&&T.setRequestHeader("If-None-Match",S.etagf)),(v.data&&v.hasContent&&!1!==v.contentType||t.contentType)&&T.setRequestHeader("Content-Type",v.contentType),T.setRequestHeader("Accept",v.dataTypes0&&v.acceptsv.dataTypes0?v.acceptsv.dataTypes0+("*"!==v.dataTypes0?", "+Rt+"; q=0.01":""):v.accepts"*"),v.headers)T.setRequestHeader(i,v.headersi);if(v.beforeSend&&(!1===v.beforeSend.call(y,T,v)||h))return T.abort();if(u="abort",b.add(v.complete),T.done(v.success),T.fail(v.error),c=Wt(Pt,v,t,T)){if(T.readyState=1,g&&m.trigger("ajaxSend",T,v),h)return T;v.async&&0<v.timeout&&(d=C.setTimeout(function(){T.abort("timeout")},v.timeout));try{h=!1,c.send(a,l)}catch(e){if(h)throw e;l(-1,e)}}else l(-1,"No Transport");function l(e,t,n,r){var i,o,a,s,u,l=t;h||(h=!0,d&&C.clearTimeout(d),c=void 0,p=r||"",T.readyState=0<e?4:0,i=200<=e&&e<300||304===e,n&&(s=function(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u0)u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(si&&si.test(r)){u.unshift(i);break}if(u0in n)o=u0;else{for(i in n){if(!u0||e.convertersi+" "+u0){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u0&&u.unshift(o),no}(v,T,n)),!i&&-1<S.inArray("script",v.dataTypes)&&S.inArray("json",v.dataTypes)<0&&(v.converters"text script"=function(){}),s=function(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c1)for(a in e.converters)la.toLowerCase()=e.convertersa;o=c.shift();while(o)if(e.responseFieldso&&(ne.responseFieldso=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=lu+" "+o||l"* "+o))for(i in l)if((s=i.split(" "))1===o&&(a=lu+" "+s0||l"* "+s0)){!0===a?a=li:!0!==li&&(o=s0,c.unshift(s1));break}if(!0!==a)if(a&&e"throws")t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}(v,s,T,i),i?(v.ifModified&&((u=T.getResponseHeader("Last-Modified"))&&(S.lastModifiedf=u),(u=T.getResponseHeader("etag"))&&(S.etagf=u)),204===e||"HEAD"===v.type?l="nocontent":304===e?l="notmodified":(l=s.state,o=s.data,i=!(a=s.error))):(a=l,!e&&l||(l="error",e<0&&(e=0))),T.status=e,T.statusText=(t||l)+"",i?x.resolveWith(y,o,l,T):x.rejectWith(y,T,l,a),T.statusCode(w),w=void 0,g&&m.trigger(i?"ajaxSuccess":"ajaxError",T,v,i?o:a),b.fireWith(y,T,l),g&&(m.trigger("ajaxComplete",T,v),--S.active||S.event.trigger("ajaxStop")))}return T},getJSON:function(e,t,n){return S.get(e,t,n,"json")},getScript:function(e,t){return S.get(e,void 0,t,"script")}}),S.each("get","post",function(e,i){Si=function(e,t,n,r){return m(t)&&(r=r||n,n=t,t=void 0),S.ajax(S.extend({url:e,type:i,dataType:r,data:t,success:n},S.isPlainObject(e)&&e))}}),S.ajaxPrefilter(function(e){var t;for(t in e.headers)"content-type"===t.toLowerCase()&&(e.contentType=e.headerst||"")}),S._evalUrl=function(e,t,n){return S.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,converters:{"text script":function(){}},dataFilter:function(e){S.globalEval(e,t,n)}})},S.fn.extend({wrapAll:function(e){var t;return this0&&(m(e)&&(e=e.call(this0)),t=S(e,this0.ownerDocument).eq(0).clone(!0),this0.parentNode&&t.insertBefore(this0),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(n){return m(n)?this.each(function(e){S(this).wrapInner(n.call(this,e))}):this.each(function(){var e=S(this),t=e.contents();t.length?t.wrapAll(n):e.append(n)})},wrap:function(t){var n=m(t);return this.each(function(e){S(this).wrapAll(n?t.call(this,e):t)})},unwrap:function(e){return this.parent(e).not("body").each(function(){S(this).replaceWith(this.childNodes)}),this}}),S.expr.pseudos.hidden=function(e){return!S.expr.pseudos.visible(e)},S.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},S.ajaxSettings.xhr=function(){try{return new C.XMLHttpRequest}catch(e){}};var Bt={0:200,1223:204},$t=S.ajaxSettings.xhr();y.cors=!!$t&&"withCredentials"in $t,y.ajax=$t=!!$t,S.ajaxTransport(function(i){var o,a;if(y.cors||$t&&!i.crossDomain)return{send:function(e,t){var n,r=i.xhr();if(r.open(i.type,i.url,i.async,i.username,i.password),i.xhrFields)for(n in i.xhrFields)rn=i.xhrFieldsn;for(n in i.mimeType&&r.overrideMimeType&&r.overrideMimeType(i.mimeType),i.crossDomain||e"X-Requested-With"||(e"X-Requested-With"="XMLHttpRequest"),e)r.setRequestHeader(n,en);o=function(e){return function(){o&&(o=a=r.onload=r.onerror=r.onabort=r.ontimeout=r.onreadystatechange=null,"abort"===e?r.abort():"error"===e?"number"!=typeof r.status?t(0,"error"):t(r.status,r.statusText):t(Btr.status||r.status,r.statusText,"text"!==(r.responseType||"text")||"string"!=typeof r.responseText?{binary:r.response}:{text:r.responseText},r.getAllResponseHeaders()))}},r.onload=o(),a=r.onerror=r.ontimeout=o("error"),void 0!==r.onabort?r.onabort=a:r.onreadystatechange=function(){4===r.readyState&&C.setTimeout(function(){o&&a()})},o=o("abort");try{r.send(i.hasContent&&i.data||null)}catch(e){if(o)throw e}},abort:function(){o&&o()}}}),S.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),S.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return S.globalEval(e),e}}}),S.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),S.ajaxTransport("script",function(n){var r,i;if(n.crossDomain||n.scriptAttrs)return{send:function(e,t){r=S("<script>").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r0)},abort:function(){i&&i()}}});var _t,zt=,Ut=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=zt.pop()||S.expando+"_"+wt.guid++;return thise=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Ut.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes0)return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?ea=ea.replace(Ut,"$1"+r):!1!==e.jsonp&&(e.url+=(Tt.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters"script json"=function(){return o||S.error(r+" was not called"),o0},e.dataTypes0="json",i=Cr,Cr=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):Cr=i,er&&(e.jsonpCallback=t.jsonpCallback,zt.push(r)),o&&m(i)&&i(o0),o=i=void 0}),"script"}),y.createHTMLDocument=((_t=E.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===_t.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&,(i=N.exec(e))?t.createElement(i1):(i=xe(e,t,o),o&&o.length&&S(o).remove(),S.merge(,i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1<s&&(r=ht(e.slice(s)),e=e.slice(0,s)),m(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),0<a.length&&S.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,a.html(r?S("<div>").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||e.responseText,t,e)})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this0;return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this0){var e,t,n,r=this0,i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fnt=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?ri:et;r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):et=n},t,e,arguments.length)}}),S.each("top","left",function(e,n){S.cssHooksn=Fe(y.pixelPosition,function(e,t){if(t)return t=We(e,n),Pe.test(t)?S(e).position()n+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fno=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e"inner"+a:e.document.documentElement"client"+a:9===e.nodeType?(r=e.documentElement,Math.max(e.body"scroll"+a,r"scroll"+a,e.body"offset"+a,r"offset"+a,r"client"+a)):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each("ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend",function(e,t){S.fnt=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fnn=function(e,t){return 0<arguments.length?this.on(n,null,e,t):this.trigger(n)}});var Xt=/^\s\uFEFF\xA0+|\s\uFEFF\xA0+$/g;S.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=et,t=e,e=n),m(e))return r=s.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(s.call(arguments)))}).guid=e.guid=e.guid||S.guid++,i},S.holdReady=function(e){e?S.readyWait++:S.ready(!0)},S.isArray=Array.isArray,S.parseJSON=JSON.parse,S.nodeName=A,S.isFunction=m,S.isWindow=x,S.camelCase=X,S.type=w,S.now=Date.now,S.isNumeric=function(e){var t=S.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},S.trim=function(e){return null==e?"":(e+"").replace(Xt,"")},"function"==typeof define&&define.amd&&define("jquery",,function(){return S});var Vt=C.jQuery,Gt=C.$;return S.noConflict=function(e){return C.$===S&&(C.$=Gt),e&&C.jQuery===S&&(C.jQuery=Vt),S},"undefined"==typeof e&&(C.jQuery=C.$=S),S});
-diff --git a/tests/test_theming.py b/tests/test_theming.py
-index 60dd72c..e9ed43c 100644
---- a/tests/test_theming.py
-+++ b/tests/test_theming.py
-@@ -74,7 +74,7 @@ def test_js_source(app, status, warning):
- 
-     app.builder.build('contents')
- 
--    v = '3.5.1'
-+    v = '3.6.0'
-     msg = 'jquery.js version does not match to {v}'.format(v=v)
-     jquery_min = (app.outdir / '_static' / 'jquery.js').read_text()
-     assert 'jQuery v{v}'.format(v=v) in jquery_min, msg
--- 
-2.27.0
-

_service:tar_scm:Sphinx-4.4.0.tar.gz/. Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/CHANGES.old Deleted

@@ -1,1249 +0,0 @@
-For the changelog from version 1.0, look at the file CHANGES.
-
-Release 0.6.7 (Jun 05, 2010)
-============================
-
-* #440: Remove usage of a Python >= 2.5 API in the ``literalinclude``
-  directive.
-
-* Fix a bug that prevented some references being generated in the
-  LaTeX builder.
-
-* #428: Add some missing CSS styles for standard docutils classes.
-
-* #432: Fix UnicodeErrors while building LaTeX in translated locale.
-
-
-Release 0.6.6 (May 25, 2010)
-============================
-
-* Handle raw nodes in the ``text`` writer.
-
-* Fix a problem the Qt help project generated by the ``qthelp``
-  builder that would lead to no content being displayed in the Qt
-  Assistant.
-
-* #393: Fix the usage of Unicode characters in mathematic formulas
-  when using the ``pngmath`` extension.
-
-* #404: Make ``\and`` work properly in the author field of the
-  ``latex_documents`` setting.
-
-* #409: Make the ``highlight_language`` config value work properly
-  in the LaTeX builder.
-
-* #418: Allow relocation of the translation JavaScript files to
-  the system directory on Unix systems.
-
-* #414: Fix handling of Windows newlines in files included with
-  the ``literalinclude`` directive.
-
-* #377: Fix crash in linkcheck builder.
-
-* #387: Fix the display of search results in ``dirhtml`` output.
-
-* #376: In autodoc, fix display of parameter defaults containing
-  backslashes.
-
-* #370: Fix handling of complex list item labels in LaTeX output.
-
-* #374: Make the ``doctest_path`` config value of the doctest
-  extension actually work.
-
-* Fix the handling of multiple toctrees when creating the global
-  TOC for the ``toctree()`` template function.
-
-* Fix the handling of hidden toctrees when creating the global TOC
-  for the ``toctree()`` template function.
-
-* Fix the handling of nested lists in the text writer.
-
-* #362: In autodoc, check for the existence of ``__self__`` on
-  function objects before accessing it.
-
-* #353: Strip leading and trailing whitespace when extracting
-  search words in the search function.
-
-
-Release 0.6.5 (Mar 01, 2010)
-============================
-
-* In autodoc, fix the omission of some module members explicitly
-  documented using documentation comments.
-
-* #345: Fix cropping of sidebar scroll bar with ``stickysidebar``
-  option of the default theme.
-
-* #341: Always generate UNIX newlines in the quickstart Makefile.
-
-* #338: Fix running with ``-C`` under Windows.
-
-* In autodoc, allow customizing the signature of an object where
-  the built-in mechanism fails.
-
-* #331: Fix output for enumerated lists with start values in LaTeX.
-
-* Make the ``start-after`` and ``end-before`` options to the
-  ``literalinclude`` directive work correctly if not used together.
-
-* #321: Fix link generation in the LaTeX builder.
-
-
-Release 0.6.4 (Jan 12, 2010)
-============================
-
-* Improve the handling of non-Unicode strings in the configuration.
-
-* #316: Catch OSErrors occurring when calling graphviz with
-  arguments it doesn't understand.
-
-* Restore compatibility with Pygments >= 1.2.
-
-* #295: Fix escaping of hyperref targets in LaTeX output.
-
-* #302: Fix links generated by the ``:doc:`` role for LaTeX output.
-
-* #286: collect todo nodes after the whole document has been read;
-  this allows placing substitution references in todo items.
-
-* #294: do not ignore an explicit ``today`` config value in a
-  LaTeX build.
-
-* The ``alt`` text of inheritance diagrams is now much cleaner.
-
-* Ignore images in section titles when generating link captions.
-
-* #310: support exception messages in the ``testoutput`` blocks of
-  the ``doctest`` extension.
-
-* #293: line blocks are styled properly in HTML output.
-
-* #285: make the ``locale_dirs`` config value work again.
-
-* #303: ``html_context`` values given on the command line via ``-A``
-  should not override other values given in conf.py.
-
-* Fix a bug preventing incremental rebuilds for the ``dirhtml``
-  builder.
-
-* #299: Fix the mangling of quotes in some literal blocks.
-
-* #292: Fix path to the search index for the ``dirhtml`` builder.
-
-* Fix a Jython compatibility issue: make the dependence on the
-  ``parser`` module optional.
-
-* #238: In autodoc, catch all errors that occur on module import,
-  not just ``ImportError``.
-
-* Fix the handling of non-data, but non-method descriptors in autodoc.
-
-* When copying file times, ignore OSErrors raised by ``os.utime()``.
-
-
-Release 0.6.3 (Sep 03, 2009)
-============================
-
-* Properly add C module filenames as dependencies in autodoc.
-
-* #253: Ignore graphviz directives without content instead of
-  raising an unhandled exception.
-
-* #241: Fix a crash building LaTeX output for documents that contain
-  a todolist directive.
-
-* #252: Make it easier to change the build dir in the Makefiles
-  generated by quickstart.
-
-* #220: Fix CSS so that displaymath really is centered.
-
-* #222: Allow the "Footnotes" header to be translated.
-
-* #225: Don't add whitespace in generated HTML after inline tags.
-
-* #227: Make ``literalinclude`` work when the document's path
-  name contains non-ASCII characters.
-
-* #229: Fix autodoc failures with members that raise errors
-  on ``getattr()``.
-
-* #205: When copying files, don't copy full stat info, only
-  modification times.
-
-* #232: Support non-ASCII metadata in Qt help builder.
-
-* Properly format bullet lists nested in definition lists for LaTeX.
-
-* Section titles are now allowed inside ``only`` directives.
-
-* #201: Make ``centered`` directive work in LaTeX output.
-
-* #206: Refuse to overwrite an existing master document in
-  sphinx-quickstart.
-
-* #208: Use MS-sanctioned locale settings, determined by the
-  ``language`` config option, in the HTML help builder.
-
-* #210: Fix nesting of HTML tags for displayed math from pngmath
-  extension.
-
-* #213: Fix centering of images in LaTeX output.
-
-* #211: Fix compatibility with docutils 0.5.
-
-
-Release 0.6.2 (Jun 16, 2009)
-============================
-
-* #130: Fix obscure IndexError in doctest extension.
-
-* #167: Make glossary sorting case-independent.
-
-* #196: Add a warning if an extension module doesn't have a
-  ``setup()`` function.
-
-* #158: Allow '..' in template names, and absolute template paths;
-  Jinja 2 by default disables both.
-
-* When highlighting Python code, ignore extra indentation before
-  trying to parse it as Python.
-
-* #191: Don't escape the tilde in URIs in LaTeX.
-
-* Don't consider contents of source comments for the search index.
-
-* Set the default encoding to ``utf-8-sig`` to handle files with a
-  UTF-8 BOM correctly.
-
-* #178: apply ``add_function_parentheses`` config value to C
-  functions as promised.
-
-* #173: Respect the docutils ``title`` directive.
-
-* #172: The ``obj`` role now links to modules as promised.
-
-* #19: Tables now can have a "longtable" class, in order to get
-  correctly broken into pages in LaTeX output.
-
-* Look for Sphinx message catalogs in the system default path before
-  trying ``sphinx/locale``.
-
-* Fix the search for methods via "classname.methodname".
-
-* #155: Fix Python 2.4 compatibility: exceptions are old-style
-  classes there.
-
-* #150: Fix display of the "sphinxdoc" theme on Internet Explorer
-  versions 6 and 7.
-
-* #146: Don't fail to generate LaTeX when the user has an active
-  ``.docutils`` configuration.
-
-* #29: Don't generate visible "-{-}" in option lists in LaTeX.
-
-* Fix cross-reference roles when put into substitutions.
-
-* Don't put image "alt" text into table-of-contents entries.
-
-* In the LaTeX writer, do not raise an exception on too many section
-  levels, just use the "subparagraph" level for all of them.
-
-* #145: Fix autodoc problem with automatic members that refuse to be
-  getattr()'d from their parent.
-
-* If specific filenames to build are given on the command line,
-  check that they are within the source directory.
-
-* Fix autodoc crash for objects without a ``__name__``.
-
-* Fix intersphinx for installations without urllib2.HTTPSHandler.
-
-* #134: Fix pending_xref leftover nodes when using the todolist
-  directive from the todo extension.
-
-
-Release 0.6.1 (Mar 26, 2009)
-============================
-
-* #135: Fix problems with LaTeX output and the graphviz extension.
-
-* #132: Include the autosummary "module" template in the distribution.
-
-
-Release 0.6 (Mar 24, 2009)
-==========================
-
-New features added
-------------------
-
-* Incompatible changes:
-
-  - Templating now requires the Jinja2 library, which is an enhanced
-    version of the old Jinja1 engine.  Since the syntax and semantic
-    is largely the same, very few fixes should be necessary in
-    custom templates.
-
-  - The "document" div tag has been moved out of the ``layout.html``
-    template's "document" block, because the closing tag was already
-    outside.  If you overwrite this block, you need to remove your
-    "document" div tag as well.
-
-  - The ``autodoc_skip_member`` event now also gets to decide
-    whether to skip members whose name starts with underscores.
-    Previously, these members were always automatically skipped.
-    Therefore, if you handle this event, add something like this
-    to your event handler to restore the old behavior::
-
-       if name.startswith('_'):
-           return True
-
-* Theming support, see the new section in the documentation.
-
-* Markup:
-
-  - Due to popular demand, added a ``:doc:`` role which directly
-    links to another document without the need of creating a
-    label to which a ``:ref:`` could link to.
-
-  - #4: Added a ``:download:`` role that marks a non-document file
-    for inclusion into the HTML output and links to it.
-
-  - Added an ``only`` directive that can selectively include text
-    based on enabled "tags".  Tags can be given on the command
-    line.  Also, the current builder output format (e.g. "html" or
-    "latex") is always a defined tag.
-
-  - #10: Added HTML section numbers, enabled by giving a
-    ``:numbered:`` flag to the ``toctree`` directive.
-
-  - #114: Added an ``abbr`` role to markup abbreviations and
-    acronyms.
-
-  - The ``literalinclude`` directive now supports several more
-    options, to include only parts of a file.
-
-  - The ``toctree`` directive now supports a ``:hidden:`` flag,
-    which will prevent links from being generated in place of
-    the directive -- this allows you to define your document
-    structure, but place the links yourself.
-
-  - #123: The ``glossary`` directive now supports a ``:sorted:``
-    flag that sorts glossary entries alphabetically.
-
-  - Paths to images, literal include files and download files
-    can now be absolute (like ``/images/foo.png``).  They are
-    treated as relative to the top source directory.
-
-  - #52: There is now a ``hlist`` directive, creating a compact
-    list by placing distributing items into multiple columns.
-
-  - #77: If a description environment with info field list only
-    contains one ``:param:`` entry, no bullet list is generated.
-
-  - #6: Don't generate redundant ``<ul>`` for top-level TOC tree
-    items, which leads to a visual separation of TOC entries.
-
-  - #23: Added a ``classmethod`` directive along with ``method``
-    and ``staticmethod``.
-
-  - Scaled images now get a link to the unscaled version.
-
-  - SVG images are now supported in HTML (via ``<object>`` and
-    ``<embed>`` tags).
-
-  - Added a ``toctree`` callable to the templates, and the ability
-    to include external links in toctrees. The 'collapse' keyword
-    argument indicates whether or not to only display subitems of
-    the current page.  (Defaults to True.)
-
-* Configuration:
-
-  - The new config value ``rst_epilog`` can contain reST that is
-    appended to each source file that is read.  This is the right
-    place for global substitutions.
-
-  - The new ``html_add_permalinks`` config value can be used to
-    switch off the generated "paragraph sign" permalinks for each
-    heading and definition environment.
-
-  - The new ``html_show_sourcelink`` config value can be used to
-    switch off the links to the reST sources in the sidebar.
-
-  - The default value for ``htmlhelp_basename`` is now the project
-    title, cleaned up as a filename.
-
-  - The new ``modindex_common_prefix`` config value can be used to
-    ignore certain package names for module index sorting.
-
-  - The new ``trim_footnote_reference_space`` config value mirrors
-    the docutils config value of the same name and removes the
-    space before a footnote reference that is necessary for reST
-    to recognize the reference.
-
-  - The new ``latex_additional_files`` config value can be used to
-    copy files (that Sphinx doesn't copy automatically, e.g. if they
-    are referenced in custom LaTeX added in ``latex_elements``) to
-    the build directory.
-
-* Builders:
-
-  - The HTML builder now stores a small file named ``.buildinfo`` in
-    its output directory.  It stores a hash of config values that
-    can be used to determine if a full rebuild needs to be done (e.g.
-    after changing ``html_theme``).
-
-  - New builder for Qt help collections, by Antonio Valentino.
-
-  - The new ``DirectoryHTMLBuilder`` (short name ``dirhtml``) creates
-    a separate directory for every page, and places the page there
-    in a file called ``index.html``.  Therefore, page URLs and links
-    don't need to contain ``.html``.
-
-  - The new ``html_link_suffix`` config value can be used to select
-    the suffix of generated links between HTML files.
-
-  - #96: The LaTeX builder now supports figures wrapped by text, when
-    using the ``figwidth`` option and right/left alignment.
-
-* New translations:
-
-  - Italian by Sandro Dentella.
-  - Ukrainian by Petro Sasnyk.
-  - Finnish by Jukka Inkeri.
-  - Russian by Alexander Smishlajev.
-
-* Extensions and API:
-
-  - New ``graphviz`` extension to embed graphviz graphs.
-
-  - New ``inheritance_diagram`` extension to embed... inheritance
-    diagrams!
-
-  - New ``autosummary`` extension that generates summaries of
-    modules and automatic documentation of modules.
-
-  - Autodoc now has a reusable Python API, which can be used to
-    create custom types of objects to auto-document (e.g. Zope
-    interfaces).  See also ``Sphinx.add_autodocumenter()``.
-
-  - Autodoc now handles documented attributes.
-
-  - Autodoc now handles inner classes and their methods.
-
-  - Autodoc can document classes as functions now if explicitly
-    marked with `autofunction`.
-
-  - Autodoc can now exclude single members from documentation
-    via the ``exclude-members`` option.
-
-  - Autodoc can now order members either alphabetically (like
-    previously) or by member type; configurable either with the
-    config value ``autodoc_member_order`` or a ``member-order``
-    option per directive.
-
-  - The function ``Sphinx.add_directive()`` now also supports
-    docutils 0.5-style directive classes.  If they inherit from
-    ``sphinx.util.compat.Directive``, they also work with
-    docutils 0.4.
-
-  - There is now a ``Sphinx.add_lexer()`` method to be able to use
-    custom Pygments lexers easily.
-
-  - There is now ``Sphinx.add_generic_role()`` to mirror the
-    docutils' own function.
-
-* Other changes:
-
-  - Config overrides for single dict keys can now be given on the
-    command line.
-
-  - There is now a ``doctest_global_setup`` config value that can
-    be used to give setup code for all doctests in the documentation.
-
-  - Source links in HTML are now generated with ``rel="nofollow"``.
-
-  - Quickstart can now generate a Windows ``make.bat`` file.
-
-  - #62: There is now a ``-w`` option for sphinx-build that writes
-    warnings to a file, in addition to stderr.
-
-  - There is now a ``-W`` option for sphinx-build that turns warnings
-    into errors.
-
-
-Release 0.5.2 (Mar 24, 2009)
-============================
-
-* Properly escape ``|`` in LaTeX output.
-
-* #71: If a decoding error occurs in source files, print a
-  warning and replace the characters by "?".
-
-* Fix a problem in the HTML search if the index takes too long
-  to load.
-
-* Don't output system messages while resolving, because they
-  would stay in the doctrees even if keep_warnings is false.
-
-* #82: Determine the correct path for dependencies noted by
-  docutils.  This fixes behavior where a source with dependent
-  files was always reported as changed.
-
-* Recognize toctree directives that are not on section toplevel,
-  but within block items, such as tables.
-
-* Use a new RFC base URL, since rfc.org seems down.
-
-* Fix a crash in the todolist directive when no todo items are
-  defined.
-
-* Don't call LaTeX or dvipng over and over again if it was not
-  found once, and use text-only latex as a substitute in that case.
-
-* Fix problems with footnotes in the LaTeX output.
-
-* Prevent double hyphens becoming en-dashes in literal code in
-  the LaTeX output.
-
-* Open literalinclude files in universal newline mode to allow
-  arbitrary newline conventions.
-
-* Actually make the ``-Q`` option work.
-
-* #86: Fix explicit document titles in toctrees.
-
-* #81: Write environment and search index in a manner that is safe
-  from exceptions that occur during dumping.
-
-* #80: Fix UnicodeErrors when a locale is set with setlocale().
-
-
-Release 0.5.1 (Dec 15, 2008)
-============================
-
-* #67: Output warnings about failed doctests in the doctest extension
-  even when running in quiet mode.
-
-* #72: In pngmath, make it possible to give a full path to LaTeX and
-  dvipng on Windows.  For that to work, the ``pngmath_latex`` and
-  ``pngmath_dvipng`` options are no longer split into command and
-  additional arguments; use ``pngmath_latex_args`` and
-  ``pngmath_dvipng_args`` to give additional arguments.
-
-* Don't crash on failing doctests with non-ASCII characters.
-
-* Don't crash on writing status messages and warnings containing
-  unencodable characters.
-
-* Warn if a doctest extension block doesn't contain any code.
-
-* Fix the handling of ``:param:`` and ``:type:`` doc fields when
-  they contain markup (especially cross-referencing roles).
-
-* #65: Fix storage of depth information for PNGs generated by the
-  pngmath extension.
-
-* Fix autodoc crash when automethod is used outside a class context.
-
-* #68: Fix LaTeX writer output for images with specified height.
-
-* #60: Fix wrong generated image path when including images in sources
-  in subdirectories.
-
-* Fix the JavaScript search when html_copy_source is off.
-
-* Fix an indentation problem in autodoc when documenting classes
-  with the option ``autoclass_content = "both"`` set.
-
-* Don't crash on empty index entries, only emit a warning.
-
-* Fix a typo in the search JavaScript code, leading to unusable
-  search function in some setups.
-
-
-Release 0.5 (Nov 23, 2008) -- Birthday release!
-===============================================
-
-New features added
-------------------
-
-* Markup features:
-
-  - Citations are now global: all citation defined in any file can be
-    referenced from any file.  Citations are collected in a bibliography
-    for LaTeX output.
-
-  - Footnotes are now properly handled in the LaTeX builder: they appear
-    at the location of the footnote reference in text, not at the end of
-    a section.  Thanks to Andrew McNamara for the initial patch.
-
-  - "System Message" warnings are now automatically removed from the
-    built documentation, and only written to stderr.  If you want the
-    old behavior, set the new config value ``keep_warnings`` to True.
-
-  - Glossary entries are now automatically added to the index.
-
-  - Figures with captions can now be referred to like section titles,
-    using the ``:ref:`` role without an explicit link text.
-
-  - Added ``cmember`` role for consistency.
-
-  - Lists enumerated by letters or roman numerals are now handled like in
-    standard reST.
-
-  - The ``seealso`` directive can now also be given arguments, as a short
-    form.
-
-  - You can now document several programs and their options with the
-    new ``program`` directive.
-
-* HTML output and templates:
-
-  - Incompatible change: The "root" relation link (top left in the
-    relbar) now points to the ``master_doc`` by default, no longer to a
-    document called "index".  The old behavior, while useful in some
-    situations, was somewhat unexpected.  Override the "rootrellink"
-    block in the template to customize where it refers to.
-
-  - The JavaScript search now searches for objects before searching in
-    the full text.
-
-  - TOC tree entries now have CSS classes that make it possible to
-    style them depending on their depth.
-
-  - Highlighted code blocks now have CSS classes that make it possible
-    to style them depending on their language.
-
-  - HTML ``<meta>`` tags via the docutils ``meta`` directive are now
-    supported.
-
-  - ``SerializingHTMLBuilder`` was added as new abstract builder that
-    can be subclassed to serialize build HTML in a specific format.  The
-    ``PickleHTMLBuilder`` is a concrete subclass of it that uses pickle
-    as serialization implementation.
-
-  - ``JSONHTMLBuilder`` was added as another ``SerializingHTMLBuilder``
-    subclass that dumps the generated HTML into JSON files for further
-    processing.
-
-  - The ``rellinks`` block in the layout template is now called
-    ``linktags`` to avoid confusion with the relbar links.
-
-  - The HTML builders have two additional attributes now that can be
-    used to disable the anchor-link creation after headlines and
-    definition links.
-
-  - Only generate a module index if there are some modules in the
-    documentation.
-
-* New and changed config values:
-
-  - Added support for internationalization in generated text with the
-    ``language`` and ``locale_dirs`` config values.  Many thanks to
-    language contributors:
-
-    * Horst Gutmann -- German
-    * Pavel Kosina -- Czech
-    * David Larlet -- French
-    * Michał Kandulski -- Polish
-    * Yasushi Masuda -- Japanese
-    * Guillem Borrell -- Spanish
-    * Luc Saffre and Peter Bertels -- Dutch
-    * Fred Lin -- Traditional Chinese
-    * Roger Demetrescu -- Brazilian Portuguese
-    * Rok Garbas -- Slovenian
-
-  - The new config value ``highlight_language`` set a global default for
-    highlighting.  When ``'python3'`` is selected, console output blocks
-    are recognized like for ``'python'``.
-
-  - Exposed Pygments' lexer guessing as a highlight "language" ``guess``.
-
-  - The new config value ``latex_elements`` allows to override all LaTeX
-    snippets that Sphinx puts into the generated .tex file by default.
-
-  - Added ``exclude_dirnames`` config value that can be used to exclude
-    e.g. CVS directories from source file search.
-
-  - Added ``source_encoding`` config value to select input encoding.
-
-* Extensions:
-
-  - The new extensions ``sphinx.ext.jsmath`` and ``sphinx.ext.pngmath``
-    provide math support for both HTML and LaTeX builders.
-
-  - The new extension ``sphinx.ext.intersphinx`` half-automatically
-    creates links to Sphinx documentation of Python objects in other
-    projects.
-
-  - The new extension ``sphinx.ext.todo`` allows the insertion of
-    "To do" directives whose visibility in the output can be toggled.
-    It also adds a directive to compile a list of all todo items.
-
-  - sphinx.ext.autodoc has a new event ``autodoc-process-signature``
-    that allows tuning function signature introspection.
-
-  - sphinx.ext.autodoc has a new event ``autodoc-skip-member`` that allows
-    tuning which members are included in the generated content.
-
-  - Respect __all__ when autodocumenting module members.
-
-  - The `automodule` directive now supports the ``synopsis``,
-    ``deprecated`` and ``platform`` options.
-
-* Extension API:
-
-  - ``Sphinx.add_node()`` now takes optional visitor methods for the
-    HTML, LaTeX and text translators; this prevents having to manually
-    patch the classes.
-
-  - Added ``Sphinx.add_javascript()`` that adds scripts to load in the
-    default HTML template.
-
-  - Added new events: ``source-read``, ``env-updated``,
-    ``env-purge-doc``, ``missing-reference``, ``build-finished``.
-
-* Other changes:
-
-  - Added a command-line switch ``-Q``: it will suppress warnings.
-
-  - Added a command-line switch ``-A``: it can be used to supply
-    additional values into the HTML templates.
-
-  - Added a command-line switch ``-C``: if it is given, no configuration
-    file ``conf.py`` is required.
-
-  - Added a distutils command `build_sphinx`: When Sphinx is installed,
-    you can call ``python setup.py build_sphinx`` for projects that have
-    Sphinx documentation, which will build the docs and place them in
-    the standard distutils build directory.
-
-  - In quickstart, if the selected root path already contains a Sphinx
-    project, complain and abort.
-
-Bugs fixed
-----------
-
-* #51: Escape configuration values placed in HTML templates.
-
-* #44: Fix small problems in HTML help index generation.
-
-* Fix LaTeX output for line blocks in tables.
-
-* #38: Fix "illegal unit" error when using pixel image widths/heights.
-
-* Support table captions in LaTeX output.
-
-* #39: Work around a bug in Jinja that caused "<generator ...>" to be
-  emitted in HTML output.
-
-* Fix a problem with module links not being generated in LaTeX output.
-
-* Fix the handling of images in different directories.
-
-* #29: Support option lists in the text writer.  Make sure that dashes
-  introducing long option names are not contracted to en-dashes.
-
-* Support the "scale" option for images in HTML output.
-
-* #25: Properly escape quotes in HTML help attribute values.
-
-* Fix LaTeX build for some description environments with ``:noindex:``.
-
-* #24: Don't crash on uncommon casing of role names (like ``:Class:``).
-
-* Only output ANSI colors on color terminals.
-
-* Update to newest fncychap.sty, to fix problems with non-ASCII
-  characters at the start of chapter titles.
-
-* Fix a problem with index generation in LaTeX output, caused by
-  hyperref not being included last.
-
-* Don't disregard return annotations for functions without any parameters.
-
-* Don't throw away labels for code blocks.
-
-
-Release 0.4.3 (Oct 8, 2008)
-===========================
-
-* Fix a bug in autodoc with directly given autodoc members.
-
-* Fix a bug in autodoc that would import a module twice, once as
-  "module", once as "module.".
-
-* Fix a bug in the HTML writer that created duplicate ``id``
-  attributes for section titles with docutils 0.5.
-
-* Properly call ``super()`` in overridden blocks in templates.
-
-* Add a fix when using XeTeX.
-
-* Unify handling of LaTeX escaping.
-
-* Rebuild everything when the ``extensions`` config value changes.
-
-* Don't try to remove a nonexisting static directory.
-
-* Fix an indentation problem in production lists.
-
-* Fix encoding handling for literal include files: ``literalinclude``
-  now has an ``encoding`` option that defaults to UTF-8.
-
-* Fix the handling of non-ASCII characters entered in quickstart.
-
-* Fix a crash with nonexisting image URIs.
-
-
-Release 0.4.2 (Jul 29, 2008)
-============================
-
-* Fix rendering of the ``samp`` role in HTML.
-
-* Fix a bug with LaTeX links to headings leading to a wrong page.
-
-* Reread documents with globbed toctrees when source files are
-  added or removed.
-
-* Add a missing parameter to PickleHTMLBuilder.handle_page().
-
-* Put inheritance info always on its own line.
-
-* Don't automatically enclose code with whitespace in it in quotes;
-  only do this for the ``samp`` role.
-
-* autodoc now emits a more precise error message when a module
-  can't be imported or an attribute can't be found.
-
-* The JavaScript search now uses the correct file name suffix when
-  referring to found items.
-
-* The automodule directive now accepts the ``inherited-members``
-  and ``show-inheritance`` options again.
-
-* You can now rebuild the docs normally after relocating the source
-  and/or doctree directory.
-
-
-Release 0.4.1 (Jul 5, 2008)
-===========================
-
-* Added sub-/superscript node handling to TextBuilder.
-
-* Label names in references are now case-insensitive, since reST
-  label names are always lowercased.
-
-* Fix linkcheck builder crash for malformed URLs.
-
-* Add compatibility for admonitions and docutils 0.5.
-
-* Remove the silly restriction on "rubric" in the LaTeX writer: you
-  can now write arbitrary "rubric" directives, and only those with
-  a title of "Footnotes" will be ignored.
-
-* Copy the HTML logo to the output ``_static`` directory.
-
-* Fix LaTeX code for modules with underscores in names and platforms.
-
-* Fix a crash with nonlocal image URIs.
-
-* Allow the usage of :noindex: in ``automodule`` directives, as
-  documented.
-
-* Fix the ``delete()`` docstring processor function in autodoc.
-
-* Fix warning message for nonexisting images.
-
-* Fix JavaScript search in Internet Explorer.
-
-
-Release 0.4 (Jun 23, 2008)
-==========================
-
-New features added
-------------------
-
-* ``tocdepth`` can be given as a file-wide metadata entry, and
-  specifies the maximum depth of a TOC of this file.
-
-* The new config value `default_role` can be used to select the
-  default role for all documents.
-
-* Sphinx now interprets field lists with fields like ``:param foo:``
-  in description units.
-
-* The new `staticmethod` directive can be used to mark methods as
-  static methods.
-
-* HTML output:
-
-  - The "previous" and "next" links have a more logical structure, so
-    that by following "next" links you can traverse the entire TOC
-    tree.
-
-  - The new event `html-page-context` can be used to include custom
-    values into the context used when rendering an HTML template.
-
-  - Document metadata is now in the default template context, under
-    the name `metadata`.
-
-  - The new config value `html_favicon` can be used to set a favicon
-    for the HTML output.  Thanks to Sebastian Wiesner.
-
-  - The new config value `html_use_index` can be used to switch index
-    generation in HTML documents off.
-
-  - The new config value `html_split_index` can be used to create
-    separate index pages for each letter, to be used when the complete
-    index is too large for one page.
-
-  - The new config value `html_short_title` can be used to set a
-    shorter title for the documentation which is then used in the
-    navigation bar.
-
-  - The new config value `html_show_sphinx` can be used to control
-    whether a link to Sphinx is added to the HTML footer.
-
-  - The new config value `html_file_suffix` can be used to set the
-    HTML file suffix to e.g. ``.xhtml``.
-
-  - The directories in the `html_static_path` can now contain
-    subdirectories.
-
-  - The module index now isn't collapsed if the number of submodules
-    is larger than the number of toplevel modules.
-
-* The image directive now supports specifying the extension as ``.*``,
-  which makes the builder select the one that matches best.  Thanks to
-  Sebastian Wiesner.
-
-* The new config value `exclude_trees` can be used to exclude whole
-  subtrees from the search for source files.
-
-* Defaults for configuration values can now be callables, which allows
-  dynamic defaults.
-
-* The new TextBuilder creates plain-text output.
-
-* Python 3-style signatures, giving a return annotation via ``->``,
-  are now supported.
-
-* Extensions:
-
-  - The autodoc extension now offers a much more flexible way to
-    manipulate docstrings before including them into the output, via
-    the new `autodoc-process-docstring` event.
-
-  - The `autodoc` extension accepts signatures for functions, methods
-    and classes now that override the signature got via introspection
-    from Python code.
-
-  - The `autodoc` extension now offers a ``show-inheritance`` option
-    for autoclass that inserts a list of bases after the signature.
-
-  - The autodoc directives now support the ``noindex`` flag option.
-
-
-Bugs fixed
-----------
-
-* Correctly report the source location for docstrings included with
-  autodoc.
-
-* Fix the LaTeX output of description units with multiple signatures.
-
-* Handle the figure directive in LaTeX output.
-
-* Handle raw admonitions in LaTeX output.
-
-* Fix determination of the title in HTML help output.
-
-* Handle project names containing spaces.
-
-* Don't write SSI-like comments in HTML output.
-
-* Rename the "sidebar" class to "sphinxsidebar" in order to stay different
-  from reST sidebars.
-
-* Use a binary TOC in HTML help generation to fix issues links without
-  explicit anchors.
-
-* Fix behavior of references to functions/methods with an explicit title.
-
-* Support citation, subscript and superscript nodes in LaTeX writer.
-
-* Provide the standard "class" directive as "cssclass"; else it is
-  shadowed by the Sphinx-defined directive.
-
-* Fix the handling of explicit module names given to autoclass directives.
-  They now show up with the correct module name in the generated docs.
-
-* Enable autodoc to process Unicode docstrings.
-
-* The LaTeX writer now translates line blocks with ``\raggedright``,
-  which plays nicer with tables.
-
-* Fix bug with directories in the HTML builder static path.
-
-
-Release 0.3 (May 6, 2008)
-=========================
-
-New features added
-------------------
-
-* The ``toctree`` directive now supports a ``glob`` option that allows
-  glob-style entries in the content.
-
-* If the `pygments_style` config value contains a dot it's treated as the
-  import path of a custom Pygments style class.
-
-* A new config value, `exclude_dirs`, can be used to exclude whole
-  directories from the search for source files.
-
-* The configuration directory (containing ``conf.py``) can now be set
-  independently from the source directory.  For that, a new command-line
-  option ``-c`` has been added.
-
-* A new directive ``tabularcolumns`` can be used to give a tabular column
-  specification for LaTeX output.  Tables now use the ``tabulary`` package.
-  Literal blocks can now be placed in tables, with several caveats.
-
-* A new config value, `latex_use_parts`, can be used to enable parts in LaTeX
-  documents.
-
-* Autodoc now skips inherited members for classes, unless you give the
-  new ``inherited-members`` option.
-
-* A new config value, `autoclass_content`, selects if the docstring of the
-  class' ``__init__`` method is added to the directive's body.
-
-* Support for C++ class names (in the style ``Class::Function``) in C function
-  descriptions.
-
-* Support for a ``toctree_only`` item in items for the ``latex_documents``
-  config value.  This only includes the documents referenced by TOC trees in the
-  output, not the rest of the file containing the directive.
-
-Bugs fixed
-----------
-
-* sphinx.htmlwriter: Correctly write the TOC file for any structure of the
-  master document.  Also encode non-ASCII characters as entities in TOC
-  and index file.  Remove two remaining instances of hard-coded
-  "documentation".
-
-* sphinx.ext.autodoc: descriptors are detected properly now.
-
-* sphinx.latexwriter: implement all reST admonitions, not just ``note``
-  and ``warning``.
-
-* Lots of little fixes to the LaTeX output and style.
-
-* Fix OpenSearch template and make template URL absolute.  The
-  `html_use_opensearch` config value now must give the base URL.
-
-* Some unused files are now stripped from the HTML help file build.
-
-
-Release 0.2 (Apr 27, 2008)
-==========================
-
-Incompatible changes
---------------------
-
-* Jinja, the template engine used for the default HTML templates, is now
-  no longer shipped with Sphinx.  If it is not installed automatically for
-  you (it is now listed as a dependency in ``setup.py``), install it manually
-  from PyPI.  This will also be needed if you're using Sphinx from a SVN
-  checkout; in that case please also remove the ``sphinx/jinja`` directory
-  that may be left over from old revisions.
-
-* The clumsy handling of the ``index.html`` template was removed.  The config
-  value ``html_index`` is gone, and ``html_additional_pages`` should be used
-  instead.  If you need it, the old ``index.html`` template is still there,
-  called ``defindex.html``, and you can port your html_index template, using
-  Jinja inheritance, by changing your template::
-
-     {% extends "defindex.html" %}
-     {% block tables %}
-     ... old html_index template content ...
-     {% endblock %}
-
-  and putting ``'index': name of your template`` in ``html_additional_pages``.
-
-* In the layout template, redundant ``block``\s were removed; you should use
-  Jinja's standard ``{{ super() }}`` mechanism instead, as explained in the
-  (newly written) templating docs.
-
-New features added
-------------------
-
-* Extension API (Application object):
-
-  - Support a new method, ``add_crossref_type``.  It works like
-    ``add_description_unit`` but the directive will only create a target
-    and no output.
-  - Support a new method, ``add_transform``.  It takes a standard docutils
-    ``Transform`` subclass which is then applied by Sphinx' reader on
-    parsing reST document trees.
-  - Add support for other template engines than Jinja, by adding an
-    abstraction called a "template bridge".  This class handles rendering
-    of templates and can be changed using the new configuration value
-    "template_bridge".
-  - The config file itself can be an extension (if it provides a ``setup()``
-    function).
-
-* Markup:
-
-  - New directive, ``currentmodule``.  It can be used to indicate the module
-    name of the following documented things without creating index entries.
-  - Allow giving a different title to documents in the toctree.
-  - Allow giving multiple options in a ``cmdoption`` directive.
-  - Fix display of class members without explicit class name given.
-
-* Templates (HTML output):
-
-  - ``index.html`` renamed to ``defindex.html``, see above.
-  - There's a new config value, ``html_title``, that controls the overall
-    "title" of the set of Sphinx docs.  It is used instead everywhere instead of
-    "Projectname vX.Y documentation" now.
-  - All references to "documentation" in the templates have been removed, so
-    that it is now easier to use Sphinx for non-documentation documents with
-    the default templates.
-  - Templates now have an XHTML doctype, to be consistent with docutils'
-    HTML output.
-  - You can now create an OpenSearch description file with the
-    ``html_use_opensearch`` config value.
-  - You can now quickly include a logo in the sidebar, using the ``html_logo``
-    config value.
-  - There are new blocks in the sidebar, so that you can easily insert content
-    into the sidebar.
-
-* LaTeX output:
-
-  - The ``sphinx.sty`` package was cleaned of unused stuff.
-  - You can include a logo in the title page with the ``latex_logo`` config
-    value.
-  - You can define the link colors and a border and background color for
-    verbatim environments.
-
-Thanks to Jacob Kaplan-Moss, Talin, Jeroen Ruigrok van der Werven and Sebastian
-Wiesner for suggestions.
-
-Bugs fixed
-----------
-
-* sphinx.ext.autodoc: Don't check ``__module__`` for explicitly given
-  members.  Remove "self" in class constructor argument list.
-
-* sphinx.htmlwriter: Don't use os.path for joining image HREFs.
-
-* sphinx.htmlwriter: Don't use SmartyPants for HTML attribute values.
-
-* sphinx.latexwriter: Implement option lists.  Also, some other changes
-  were made to ``sphinx.sty`` in order to enhance compatibility and
-  remove old unused stuff.  Thanks to Gael Varoquaux for that!
-
-* sphinx.roles: Fix referencing glossary terms with explicit targets.
-
-* sphinx.environment: Don't swallow TOC entries when resolving subtrees.
-
-* sphinx.quickstart: Create a sensible default latex_documents setting.
-
-* sphinx.builder, sphinx.environment: Gracefully handle some user error
-  cases.
-
-* sphinx.util: Follow symbolic links when searching for documents.
-
-
-Release 0.1.61950 (Mar 26, 2008)
-================================
-
-* sphinx.quickstart: Fix format string for Makefile.
-
-
-Release 0.1.61945 (Mar 26, 2008)
-================================
-
-* sphinx.htmlwriter, sphinx.latexwriter: Support the ``.. image::``
-  directive by copying image files to the output directory.
-
-* sphinx.builder: Consistently name "special" HTML output directories
-  with a leading underscore; this means ``_sources`` and ``_static``.
-
-* sphinx.environment: Take dependent files into account when collecting
-  the set of outdated sources.
-
-* sphinx.directives: Record files included with ``.. literalinclude::``
-  as dependencies.
-
-* sphinx.ext.autodoc: Record files from which docstrings are included
-  as dependencies.
-
-* sphinx.builder: Rebuild all HTML files in case of a template change.
-
-* sphinx.builder: Handle unavailability of TOC relations (previous/
-  next chapter) more gracefully in the HTML builder.
-
-* sphinx.latexwriter: Include fncychap.sty which doesn't seem to be
-  very common in TeX distributions.  Add a ``clean`` target in the
-  latex Makefile.  Really pass the correct paper and size options
-  to the LaTeX document class.
-
-* setup: On Python 2.4, don't egg-depend on docutils if a docutils is
-  already installed -- else it will be overwritten.
-
-
-Release 0.1.61843 (Mar 24, 2008)
-================================
-
-* sphinx.quickstart: Really don't create a makefile if the user
-  doesn't want one.
-
-* setup: Don't install scripts twice, via setuptools entry points
-  and distutils scripts.  Only install via entry points.
-
-* sphinx.builder: Don't recognize the HTML builder's copied source
-  files (under ``_sources``) as input files if the source suffix is
-  ``.txt``.
-
-* sphinx.highlighting: Generate correct markup for LaTeX Verbatim
-  environment escapes even if Pygments is not installed.
-
-* sphinx.builder: The WebHTMLBuilder is now called PickleHTMLBuilder.
-
-* sphinx.htmlwriter: Make parsed-literal blocks work as expected,
-  not highlighting them via Pygments.
-
-* sphinx.environment: Don't error out on reading an empty source file.
-
-
-Release 0.1.61798 (Mar 23, 2008)
-================================
-
-* sphinx: Work with docutils SVN snapshots as well as 0.4.
-
-* sphinx.ext.doctest: Make the group in which doctest blocks are
-  placed selectable, and default to ``'default'``.
-
-* sphinx.ext.doctest: Replace ``<BLANKLINE>`` in doctest blocks by
-  real blank lines for presentation output, and remove doctest
-  options given inline.
-
-* sphinx.environment: Move doctest_blocks out of block_quotes to
-  support indented doctest blocks.
-
-* sphinx.ext.autodoc: Render ``.. automodule::`` docstrings in a
-  section node, so that module docstrings can contain proper
-  sectioning.
-
-* sphinx.ext.autodoc: Use the module's encoding for decoding
-  docstrings, rather than requiring ASCII.
-
-
-Release 0.1.61611 (Mar 21, 2008)
-================================
-
-* First public release.

_service:tar_scm:Sphinx-4.4.0.tar.gz/CONTRIBUTING.rst Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/MANIFEST.in Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/Makefile Deleted

@@ -1,84 +0,0 @@
-PYTHON ?= python3
-
-.PHONY: all
-all: clean-pyc clean-backupfiles style-check type-check test
-
-.PHONY: clean
-clean: clean-pyc clean-pycache clean-patchfiles clean-backupfiles clean-generated clean-testfiles clean-buildfiles clean-mypyfiles
-
-.PHONY: clean-pyc
-clean-pyc:
-	find . -name '*.pyc' -exec rm -f {} +
-	find . -name '*.pyo' -exec rm -f {} +
-
-.PHONY: clean-pycache
-clean-pycache:
-	find . -name __pycache__ -exec rm -rf {} +
-
-.PHONY: clean-patchfiles
-clean-patchfiles:
-	find . -name '*.orig' -exec rm -f {} +
-	find . -name '*.rej' -exec rm -f {} +
-
-.PHONY: clean-backupfiles
-clean-backupfiles:
-	find . -name '*~' -exec rm -f {} +
-	find . -name '*.bak' -exec rm -f {} +
-	find . -name '*.swp' -exec rm -f {} +
-	find . -name '*.swo' -exec rm -f {} +
-
-.PHONY: clean-generated
-clean-generated:
-	find . -name '.DS_Store' -exec rm -f {} +
-	rm -rf Sphinx.egg-info/
-	rm -rf dist/
-	rm -rf doc/_build/
-	rm -f sphinx/pycode/*.pickle
-	rm -f utils/*3.py*
-	rm -f utils/regression_test.js
-
-.PHONY: clean-testfiles
-clean-testfiles:
-	rm -rf tests/.coverage
-	rm -rf tests/build
-	rm -rf .tox/
-	rm -rf .cache/
-
-.PHONY: clean-buildfiles
-clean-buildfiles:
-	rm -rf build
-
-.PHONY: clean-mypyfiles
-clean-mypyfiles:
-	find . -name '.mypy_cache' -exec rm -rf {} +
-
-.PHONY: style-check
-style-check:
-	@flake8
-
-.PHONY: type-check
-type-check:
-	mypy sphinx
-
-.PHONY: doclinter
-doclinter:
-	python utils/doclinter.py CHANGES *.rst doc/
-
-.PHONY: test
-test:
-	@$(PYTHON) -X dev -m pytest -v $(TEST)
-
-.PHONY: covertest
-covertest:
-	@$(PYTHON) -X dev -m pytest -v --cov=sphinx --junitxml=.junit.xml $(TEST)
-
-.PHONY: build
-build:
-	@$(PYTHON) setup.py build
-
-.PHONY: docs
-docs:
-ifndef target
-	$(info You need to provide a target variable, e.g. `make docs target=html`.)
-endif
-	$(MAKE) -C doc $(target)

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/PKG-INFO Deleted

@@ -1,186 +0,0 @@
-Metadata-Version: 2.1
-Name: Sphinx
-Version: 4.4.0
-Summary: Python documentation generator
-Home-page: https://www.sphinx-doc.org/
-Author: Georg Brandl
-Author-email: georg@python.org
-License: BSD
-Download-URL: https://pypi.org/project/Sphinx/
-Project-URL: Code, https://github.com/sphinx-doc/sphinx
-Project-URL: Issue tracker, https://github.com/sphinx-doc/sphinx/issues
-Platform: any
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Education
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Science/Research
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Framework :: Setuptools Plugin
-Classifier: Framework :: Sphinx
-Classifier: Framework :: Sphinx :: Extension
-Classifier: Framework :: Sphinx :: Theme
-Classifier: Topic :: Documentation
-Classifier: Topic :: Documentation :: Sphinx
-Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
-Classifier: Topic :: Printing
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Documentation
-Classifier: Topic :: Text Processing
-Classifier: Topic :: Text Processing :: General
-Classifier: Topic :: Text Processing :: Indexing
-Classifier: Topic :: Text Processing :: Markup
-Classifier: Topic :: Text Processing :: Markup :: HTML
-Classifier: Topic :: Text Processing :: Markup :: LaTeX
-Classifier: Topic :: Utilities
-Requires-Python: >=3.6
-Description-Content-Type: text/x-rst
-Provides-Extra: docs
-Provides-Extra: lint
-Provides-Extra: test
-License-File: LICENSE
-
-========
- Sphinx
-========
-
-.. image:: https://img.shields.io/pypi/v/sphinx.svg
-   :target: https://pypi.org/project/Sphinx/
-   :alt: Package on PyPI
-
-.. image:: https://readthedocs.org/projects/sphinx/badge/?version=master
-   :target: http://www.sphinx-doc.org/
-   :alt: Documentation Status
-
-.. image:: https://ci.appveyor.com/api/projects/status/github/sphinx-doc/sphinx?branch=master&svg=true
-   :target: https://ci.appveyor.com/project/sphinxdoc/sphinx
-   :alt: Build Status (AppVeyor)
-
-.. image:: https://circleci.com/gh/sphinx-doc/sphinx.svg?style=shield
-   :target: https://circleci.com/gh/sphinx-doc/sphinx
-   :alt: Build Status (CircleCI)
-
-.. image:: https://codecov.io/gh/sphinx-doc/sphinx/branch/master/graph/badge.svg
-   :target: https://codecov.io/gh/sphinx-doc/sphinx
-   :alt: Code Coverage Status (Codecov)
-
-.. image:: https://img.shields.io/badge/License-BSD%203--Clause-blue.svg
-   :target: https://opensource.org/licenses/BSD-3-Clause
-   :alt: BSD 3 Clause
-
-.. image:: https://codetriage.com/sphinx-doc/sphinx/badges/users.svg
-   :target: https://codetriage.com/sphinx-doc/sphinx
-   :alt: Open Source Helpers badge
-
-Sphinx is a tool that makes it easy to create intelligent and beautiful
-documentation for Python projects (or other documents consisting of multiple
-reStructuredText sources), written by Georg Brandl.  It was originally created
-for the new Python documentation, and has excellent facilities for Python
-project documentation, but C/C++ is supported as well, and more languages are
-planned.
-
-Sphinx uses reStructuredText as its markup language, and many of its strengths
-come from the power and straightforwardness of reStructuredText and its parsing
-and translating suite, the Docutils.
-
-Among its features are the following:
-
-* Output formats: HTML (including derivative formats such as HTML Help, Epub
-  and Qt Help), plain text, manual pages and LaTeX or direct PDF output
-  using rst2pdf
-* Extensive cross-references: semantic markup and automatic links
-  for functions, classes, glossary terms and similar pieces of information
-* Hierarchical structure: easy definition of a document tree, with automatic
-  links to siblings, parents and children
-* Automatic indices: general index as well as a module index
-* Code handling: automatic highlighting using the Pygments highlighter
-* Flexible HTML output using the Jinja 2 templating engine
-* Various extensions are available, e.g. for automatic testing of snippets
-  and inclusion of appropriately formatted docstrings
-* Setuptools integration
-
-For more information, refer to the `the documentation`__.
-
-.. __: http://www.sphinx-doc.org/
-
-Installation
-============
-
-Sphinx is published on `PyPI`__ and can be installed from there::
-
-   pip install -U sphinx
-
-We also publish beta releases::
-
-   pip install -U --pre sphinx
-
-If you wish to install `Sphinx` for development purposes, refer to `the
-contributors guide`__.
-
-__ https://pypi.org/project/Sphinx/
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
-
-Documentation
-=============
-
-Documentation is available from `sphinx-doc.org`__.
-
-__ http://www.sphinx-doc.org/
-
-Get in touch
-============
-
-- Report bugs, suggest features or view the source code `on GitHub`_.
-- For less well defined questions or ideas, use the `mailing list`_.
-
-.. _on GitHub: https://github.com/sphinx-doc/sphinx
-.. _mailing list: https://groups.google.com/forum/#!forum/sphinx-users
-
-Please adhere to our `code of conduct`__.
-
-__ http://www.sphinx-doc.org/en/master/code_of_conduct.html
-
-Testing
-=======
-
-Continuous testing is provided by `Travis`__ (for unit tests and style checks
-on Linux), `AppVeyor`__ (for unit tests on Windows), and `CircleCI`__ (for
-large processes like TeX compilation).
-
-For information on running tests locally, refer to `the contributors guide`__.
-
-__ https://travis-ci.org/sphinx-doc/sphinx
-__ https://ci.appveyor.com/project/sphinxdoc/sphinx
-__ https://circleci.com/gh/sphinx-doc/sphinx
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
-
-Contributing
-============
-
-Refer to `the contributors guide`__.
-
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
-
-Release signatures
-==================
-
-Releases are signed with following keys:
-
-* `498D6B9E <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x102C2C17498D6B9E>`_
-* `5EBA0E07 <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x1425F8CE5EBA0E07>`_
-
-

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/SOURCES.txt Deleted

@@ -1,1577 +0,0 @@
-AUTHORS
-CHANGES
-CHANGES.old
-CODE_OF_CONDUCT
-CONTRIBUTING.rst
-EXAMPLES
-LICENSE
-MANIFEST.in
-Makefile
-README.rst
-babel.cfg
-setup.cfg
-setup.py
-tox.ini
-Sphinx.egg-info/PKG-INFO
-Sphinx.egg-info/SOURCES.txt
-Sphinx.egg-info/dependency_links.txt
-Sphinx.egg-info/entry_points.txt
-Sphinx.egg-info/not-zip-safe
-Sphinx.egg-info/requires.txt
-Sphinx.egg-info/top_level.txt
-doc/Makefile
-doc/changes.rst
-doc/conf.py
-doc/contents.rst
-doc/examples.rst
-doc/faq.rst
-doc/glossary.rst
-doc/latex.rst
-doc/make.bat
-doc/templating.rst
-doc/_static/Makefile
-doc/_static/bookcover.png
-doc/_static/conf.py.txt
-doc/_static/favicon.svg
-doc/_static/more.png
-doc/_static/pocoo.png
-doc/_static/sphinx.png
-doc/_static/translation.png
-doc/_static/translation.puml
-doc/_static/translation.svg
-doc/_static/themes/agogo.png
-doc/_static/themes/alabaster.png
-doc/_static/themes/bizstyle.png
-doc/_static/themes/classic.png
-doc/_static/themes/haiku.png
-doc/_static/themes/nature.png
-doc/_static/themes/pyramid.png
-doc/_static/themes/scrolls.png
-doc/_static/themes/sphinx_rtd_theme.png
-doc/_static/themes/sphinxdoc.png
-doc/_static/themes/traditional.png
-doc/_static/themes/fullsize/agogo.png
-doc/_static/themes/fullsize/alabaster.png
-doc/_static/themes/fullsize/bizstyle.png
-doc/_static/themes/fullsize/classic.png
-doc/_static/themes/fullsize/haiku.png
-doc/_static/themes/fullsize/nature.png
-doc/_static/themes/fullsize/pyramid.png
-doc/_static/themes/fullsize/scrolls.png
-doc/_static/themes/fullsize/sphinx_rtd_theme.png
-doc/_static/themes/fullsize/sphinxdoc.png
-doc/_static/themes/fullsize/traditional.png
-doc/_static/tutorial/lumache-autosummary.png
-doc/_static/tutorial/lumache-first-light.png
-doc/_static/tutorial/lumache-furo.png
-doc/_static/tutorial/lumache-py-function-full.png
-doc/_static/tutorial/lumache-py-function.png
-doc/_templates/index.html
-doc/_templates/indexsidebar.html
-doc/_themes/sphinx13/layout.html
-doc/_themes/sphinx13/theme.conf
-doc/_themes/sphinx13/static/bodybg.png
-doc/_themes/sphinx13/static/footerbg.png
-doc/_themes/sphinx13/static/headerbg.png
-doc/_themes/sphinx13/static/listitem.png
-doc/_themes/sphinx13/static/relbg.png
-doc/_themes/sphinx13/static/sphinx13.css
-doc/_themes/sphinx13/static/sphinxheader.png
-doc/development/builders.rst
-doc/development/index.rst
-doc/development/overview.rst
-doc/development/theming.rst
-doc/development/tutorials/autodoc_ext.rst
-doc/development/tutorials/helloworld.rst
-doc/development/tutorials/index.rst
-doc/development/tutorials/recipe.rst
-doc/development/tutorials/todo.rst
-doc/development/tutorials/examples/README.rst
-doc/development/tutorials/examples/autodoc_intenum.py
-doc/development/tutorials/examples/helloworld.py
-doc/development/tutorials/examples/recipe.py
-doc/development/tutorials/examples/todo.py
-doc/extdev/appapi.rst
-doc/extdev/builderapi.rst
-doc/extdev/collectorapi.rst
-doc/extdev/deprecated.rst
-doc/extdev/domainapi.rst
-doc/extdev/envapi.rst
-doc/extdev/i18n.rst
-doc/extdev/index.rst
-doc/extdev/logging.rst
-doc/extdev/markupapi.rst
-doc/extdev/nodes.rst
-doc/extdev/parserapi.rst
-doc/extdev/projectapi.rst
-doc/extdev/utils.rst
-doc/internals/authors.rst
-doc/internals/code-of-conduct.rst
-doc/internals/contributing.rst
-doc/internals/index.rst
-doc/internals/organization.rst
-doc/internals/release-process.rst
-doc/man/index.rst
-doc/man/sphinx-apidoc.rst
-doc/man/sphinx-autogen.rst
-doc/man/sphinx-build.rst
-doc/man/sphinx-quickstart.rst
-doc/tutorial/automatic-doc-generation.rst
-doc/tutorial/deploying.rst
-doc/tutorial/describing-code.rst
-doc/tutorial/end.rst
-doc/tutorial/first-steps.rst
-doc/tutorial/getting-started.rst
-doc/tutorial/index.rst
-doc/tutorial/more-sphinx-customization.rst
-doc/tutorial/narrative-documentation.rst
-doc/usage/configuration.rst
-doc/usage/index.rst
-doc/usage/installation.rst
-doc/usage/markdown.rst
-doc/usage/quickstart.rst
-doc/usage/theming.rst
-doc/usage/advanced/intl.rst
-doc/usage/advanced/setuptools.rst
-doc/usage/advanced/websupport/api.rst
-doc/usage/advanced/websupport/index.rst
-doc/usage/advanced/websupport/quickstart.rst
-doc/usage/advanced/websupport/searchadapters.rst
-doc/usage/advanced/websupport/storagebackends.rst
-doc/usage/builders/index.rst
-doc/usage/extensions/autodoc.rst
-doc/usage/extensions/autosectionlabel.rst
-doc/usage/extensions/autosummary.rst
-doc/usage/extensions/coverage.rst
-doc/usage/extensions/doctest.rst
-doc/usage/extensions/duration.rst
-doc/usage/extensions/example_google.py
-doc/usage/extensions/example_google.rst
-doc/usage/extensions/example_numpy.py
-doc/usage/extensions/example_numpy.rst
-doc/usage/extensions/extlinks.rst
-doc/usage/extensions/githubpages.rst
-doc/usage/extensions/graphviz.rst
-doc/usage/extensions/ifconfig.rst
-doc/usage/extensions/imgconverter.rst
-doc/usage/extensions/index.rst
-doc/usage/extensions/inheritance.rst
-doc/usage/extensions/intersphinx.rst
-doc/usage/extensions/linkcode.rst
-doc/usage/extensions/math.rst
-doc/usage/extensions/napoleon.rst
-doc/usage/extensions/todo.rst
-doc/usage/extensions/viewcode.rst
-doc/usage/restructuredtext/basics.rst
-doc/usage/restructuredtext/directives.rst
-doc/usage/restructuredtext/domains.rst
-doc/usage/restructuredtext/field-lists.rst
-doc/usage/restructuredtext/index.rst
-doc/usage/restructuredtext/roles.rst
-sphinx/__init__.py
-sphinx/__main__.py
-sphinx/addnodes.py
-sphinx/application.py
-sphinx/config.py
-sphinx/deprecation.py
-sphinx/errors.py
-sphinx/events.py
-sphinx/extension.py
-sphinx/highlighting.py
-sphinx/io.py
-sphinx/jinja2glue.py
-sphinx/parsers.py
-sphinx/project.py
-sphinx/py.typed
-sphinx/pygments_styles.py
-sphinx/registry.py
-sphinx/roles.py
-sphinx/setup_command.py
-sphinx/theming.py
-sphinx/versioning.py
-sphinx/builders/__init__.py
-sphinx/builders/_epub_base.py
-sphinx/builders/changes.py
-sphinx/builders/dirhtml.py
-sphinx/builders/dummy.py
-sphinx/builders/epub3.py
-sphinx/builders/gettext.py
-sphinx/builders/linkcheck.py
-sphinx/builders/manpage.py
-sphinx/builders/singlehtml.py
-sphinx/builders/texinfo.py
-sphinx/builders/text.py
-sphinx/builders/xml.py
-sphinx/builders/html/__init__.py
-sphinx/builders/html/transforms.py
-sphinx/builders/latex/__init__.py
-sphinx/builders/latex/constants.py
-sphinx/builders/latex/nodes.py
-sphinx/builders/latex/theming.py
-sphinx/builders/latex/transforms.py
-sphinx/builders/latex/util.py
-sphinx/cmd/__init__.py
-sphinx/cmd/build.py
-sphinx/cmd/make_mode.py
-sphinx/cmd/quickstart.py
-sphinx/directives/__init__.py
-sphinx/directives/code.py
-sphinx/directives/other.py
-sphinx/directives/patches.py
-sphinx/domains/__init__.py
-sphinx/domains/c.py
-sphinx/domains/changeset.py
-sphinx/domains/citation.py
-sphinx/domains/cpp.py
-sphinx/domains/index.py
-sphinx/domains/javascript.py
-sphinx/domains/math.py
-sphinx/domains/python.py
-sphinx/domains/rst.py
-sphinx/domains/std.py
-sphinx/environment/__init__.py
-sphinx/environment/adapters/__init__.py
-sphinx/environment/adapters/asset.py
-sphinx/environment/adapters/indexentries.py
-sphinx/environment/adapters/toctree.py
-sphinx/environment/collectors/__init__.py
-sphinx/environment/collectors/asset.py
-sphinx/environment/collectors/dependencies.py
-sphinx/environment/collectors/metadata.py
-sphinx/environment/collectors/title.py
-sphinx/environment/collectors/toctree.py
-sphinx/ext/__init__.py
-sphinx/ext/apidoc.py
-sphinx/ext/autosectionlabel.py
-sphinx/ext/coverage.py
-sphinx/ext/doctest.py
-sphinx/ext/duration.py
-sphinx/ext/extlinks.py
-sphinx/ext/githubpages.py
-sphinx/ext/graphviz.py
-sphinx/ext/ifconfig.py
-sphinx/ext/imgconverter.py
-sphinx/ext/imgmath.py
-sphinx/ext/inheritance_diagram.py
-sphinx/ext/intersphinx.py
-sphinx/ext/linkcode.py
-sphinx/ext/mathjax.py
-sphinx/ext/todo.py
-sphinx/ext/viewcode.py
-sphinx/ext/autodoc/__init__.py
-sphinx/ext/autodoc/deprecated.py
-sphinx/ext/autodoc/directive.py
-sphinx/ext/autodoc/importer.py
-sphinx/ext/autodoc/mock.py
-sphinx/ext/autodoc/preserve_defaults.py
-sphinx/ext/autodoc/type_comment.py
-sphinx/ext/autodoc/typehints.py
-sphinx/ext/autosummary/__init__.py
-sphinx/ext/autosummary/generate.py
-sphinx/ext/autosummary/templates/autosummary/base.rst
-sphinx/ext/autosummary/templates/autosummary/class.rst
-sphinx/ext/autosummary/templates/autosummary/module.rst
-sphinx/ext/napoleon/__init__.py
-sphinx/ext/napoleon/docstring.py
-sphinx/ext/napoleon/iterators.py
-sphinx/locale/__init__.py
-sphinx/locale/sphinx.pot
-sphinx/locale/ar/LC_MESSAGES/sphinx.js
-sphinx/locale/ar/LC_MESSAGES/sphinx.mo
-sphinx/locale/ar/LC_MESSAGES/sphinx.po
-sphinx/locale/bg/LC_MESSAGES/sphinx.js
-sphinx/locale/bg/LC_MESSAGES/sphinx.mo
-sphinx/locale/bg/LC_MESSAGES/sphinx.po
-sphinx/locale/bn/LC_MESSAGES/sphinx.js
-sphinx/locale/bn/LC_MESSAGES/sphinx.mo
-sphinx/locale/bn/LC_MESSAGES/sphinx.po
-sphinx/locale/ca/LC_MESSAGES/sphinx.js
-sphinx/locale/ca/LC_MESSAGES/sphinx.mo
-sphinx/locale/ca/LC_MESSAGES/sphinx.po
-sphinx/locale/cak/LC_MESSAGES/sphinx.js
-sphinx/locale/cak/LC_MESSAGES/sphinx.mo
-sphinx/locale/cak/LC_MESSAGES/sphinx.po
-sphinx/locale/cs/LC_MESSAGES/sphinx.js
-sphinx/locale/cs/LC_MESSAGES/sphinx.mo
-sphinx/locale/cs/LC_MESSAGES/sphinx.po
-sphinx/locale/cy/LC_MESSAGES/sphinx.js
-sphinx/locale/cy/LC_MESSAGES/sphinx.mo
-sphinx/locale/cy/LC_MESSAGES/sphinx.po
-sphinx/locale/da/LC_MESSAGES/sphinx.js
-sphinx/locale/da/LC_MESSAGES/sphinx.mo
-sphinx/locale/da/LC_MESSAGES/sphinx.po
-sphinx/locale/de/LC_MESSAGES/sphinx.js
-sphinx/locale/de/LC_MESSAGES/sphinx.mo
-sphinx/locale/de/LC_MESSAGES/sphinx.po
-sphinx/locale/el/LC_MESSAGES/sphinx.js
-sphinx/locale/el/LC_MESSAGES/sphinx.mo
-sphinx/locale/el/LC_MESSAGES/sphinx.po
-sphinx/locale/en_FR/LC_MESSAGES/sphinx.js
-sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo
-sphinx/locale/en_FR/LC_MESSAGES/sphinx.po
-sphinx/locale/en_GB/LC_MESSAGES/sphinx.js
-sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo
-sphinx/locale/en_GB/LC_MESSAGES/sphinx.po
-sphinx/locale/en_HK/LC_MESSAGES/sphinx.js
-sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo
-sphinx/locale/en_HK/LC_MESSAGES/sphinx.po
-sphinx/locale/eo/LC_MESSAGES/sphinx.js
-sphinx/locale/eo/LC_MESSAGES/sphinx.mo
-sphinx/locale/eo/LC_MESSAGES/sphinx.po
-sphinx/locale/es/LC_MESSAGES/sphinx.js
-sphinx/locale/es/LC_MESSAGES/sphinx.mo
-sphinx/locale/es/LC_MESSAGES/sphinx.po
-sphinx/locale/et/LC_MESSAGES/sphinx.js
-sphinx/locale/et/LC_MESSAGES/sphinx.mo
-sphinx/locale/et/LC_MESSAGES/sphinx.po
-sphinx/locale/eu/LC_MESSAGES/sphinx.js
-sphinx/locale/eu/LC_MESSAGES/sphinx.mo
-sphinx/locale/eu/LC_MESSAGES/sphinx.po
-sphinx/locale/fa/LC_MESSAGES/sphinx.js
-sphinx/locale/fa/LC_MESSAGES/sphinx.mo
-sphinx/locale/fa/LC_MESSAGES/sphinx.po
-sphinx/locale/fi/LC_MESSAGES/sphinx.js
-sphinx/locale/fi/LC_MESSAGES/sphinx.mo
-sphinx/locale/fi/LC_MESSAGES/sphinx.po
-sphinx/locale/fr/LC_MESSAGES/sphinx.js
-sphinx/locale/fr/LC_MESSAGES/sphinx.mo
-sphinx/locale/fr/LC_MESSAGES/sphinx.po
-sphinx/locale/fr_FR/LC_MESSAGES/sphinx.js
-sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo
-sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po
-sphinx/locale/he/LC_MESSAGES/sphinx.js
-sphinx/locale/he/LC_MESSAGES/sphinx.mo
-sphinx/locale/he/LC_MESSAGES/sphinx.po
-sphinx/locale/hi/LC_MESSAGES/sphinx.js
-sphinx/locale/hi/LC_MESSAGES/sphinx.mo
-sphinx/locale/hi/LC_MESSAGES/sphinx.po
-sphinx/locale/hi_IN/LC_MESSAGES/sphinx.js
-sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo
-sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po
-sphinx/locale/hr/LC_MESSAGES/sphinx.js
-sphinx/locale/hr/LC_MESSAGES/sphinx.mo
-sphinx/locale/hr/LC_MESSAGES/sphinx.po
-sphinx/locale/hu/LC_MESSAGES/sphinx.js
-sphinx/locale/hu/LC_MESSAGES/sphinx.mo
-sphinx/locale/hu/LC_MESSAGES/sphinx.po
-sphinx/locale/id/LC_MESSAGES/sphinx.js
-sphinx/locale/id/LC_MESSAGES/sphinx.mo
-sphinx/locale/id/LC_MESSAGES/sphinx.po
-sphinx/locale/is/LC_MESSAGES/sphinx.js
-sphinx/locale/is/LC_MESSAGES/sphinx.mo
-sphinx/locale/is/LC_MESSAGES/sphinx.po
-sphinx/locale/it/LC_MESSAGES/sphinx.js
-sphinx/locale/it/LC_MESSAGES/sphinx.mo
-sphinx/locale/it/LC_MESSAGES/sphinx.po
-sphinx/locale/ja/LC_MESSAGES/sphinx.js
-sphinx/locale/ja/LC_MESSAGES/sphinx.mo
-sphinx/locale/ja/LC_MESSAGES/sphinx.po
-sphinx/locale/ko/LC_MESSAGES/sphinx.js
-sphinx/locale/ko/LC_MESSAGES/sphinx.mo
-sphinx/locale/ko/LC_MESSAGES/sphinx.po
-sphinx/locale/lt/LC_MESSAGES/sphinx.js
-sphinx/locale/lt/LC_MESSAGES/sphinx.mo
-sphinx/locale/lt/LC_MESSAGES/sphinx.po
-sphinx/locale/lv/LC_MESSAGES/sphinx.js
-sphinx/locale/lv/LC_MESSAGES/sphinx.mo
-sphinx/locale/lv/LC_MESSAGES/sphinx.po
-sphinx/locale/mk/LC_MESSAGES/sphinx.js
-sphinx/locale/mk/LC_MESSAGES/sphinx.mo
-sphinx/locale/mk/LC_MESSAGES/sphinx.po
-sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js
-sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo
-sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po
-sphinx/locale/ne/LC_MESSAGES/sphinx.js
-sphinx/locale/ne/LC_MESSAGES/sphinx.mo
-sphinx/locale/ne/LC_MESSAGES/sphinx.po
-sphinx/locale/nl/LC_MESSAGES/sphinx.js
-sphinx/locale/nl/LC_MESSAGES/sphinx.mo
-sphinx/locale/nl/LC_MESSAGES/sphinx.po
-sphinx/locale/pl/LC_MESSAGES/sphinx.js
-sphinx/locale/pl/LC_MESSAGES/sphinx.mo
-sphinx/locale/pl/LC_MESSAGES/sphinx.po
-sphinx/locale/pt/LC_MESSAGES/sphinx.js
-sphinx/locale/pt/LC_MESSAGES/sphinx.mo
-sphinx/locale/pt/LC_MESSAGES/sphinx.po
-sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js
-sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo
-sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po
-sphinx/locale/pt_PT/LC_MESSAGES/sphinx.js
-sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo
-sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po
-sphinx/locale/ro/LC_MESSAGES/sphinx.js
-sphinx/locale/ro/LC_MESSAGES/sphinx.mo
-sphinx/locale/ro/LC_MESSAGES/sphinx.po
-sphinx/locale/ru/LC_MESSAGES/sphinx.js
-sphinx/locale/ru/LC_MESSAGES/sphinx.mo
-sphinx/locale/ru/LC_MESSAGES/sphinx.po
-sphinx/locale/si/LC_MESSAGES/sphinx.js
-sphinx/locale/si/LC_MESSAGES/sphinx.mo
-sphinx/locale/si/LC_MESSAGES/sphinx.po
-sphinx/locale/sk/LC_MESSAGES/sphinx.js
-sphinx/locale/sk/LC_MESSAGES/sphinx.mo
-sphinx/locale/sk/LC_MESSAGES/sphinx.po
-sphinx/locale/sl/LC_MESSAGES/sphinx.js
-sphinx/locale/sl/LC_MESSAGES/sphinx.mo
-sphinx/locale/sl/LC_MESSAGES/sphinx.po
-sphinx/locale/sq/LC_MESSAGES/sphinx.js
-sphinx/locale/sq/LC_MESSAGES/sphinx.mo
-sphinx/locale/sq/LC_MESSAGES/sphinx.po
-sphinx/locale/sr/LC_MESSAGES/sphinx.js
-sphinx/locale/sr/LC_MESSAGES/sphinx.mo
-sphinx/locale/sr/LC_MESSAGES/sphinx.po
-sphinx/locale/sr@latin/LC_MESSAGES/sphinx.js
-sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo
-sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po
-sphinx/locale/sr_RS/LC_MESSAGES/sphinx.js
-sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo
-sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po
-sphinx/locale/sv/LC_MESSAGES/sphinx.js
-sphinx/locale/sv/LC_MESSAGES/sphinx.mo
-sphinx/locale/sv/LC_MESSAGES/sphinx.po
-sphinx/locale/ta/LC_MESSAGES/sphinx.js
-sphinx/locale/ta/LC_MESSAGES/sphinx.mo
-sphinx/locale/ta/LC_MESSAGES/sphinx.po
-sphinx/locale/te/LC_MESSAGES/sphinx.js
-sphinx/locale/te/LC_MESSAGES/sphinx.mo
-sphinx/locale/te/LC_MESSAGES/sphinx.po
-sphinx/locale/tr/LC_MESSAGES/sphinx.js
-sphinx/locale/tr/LC_MESSAGES/sphinx.mo
-sphinx/locale/tr/LC_MESSAGES/sphinx.po
-sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js
-sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo
-sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po
-sphinx/locale/ur/LC_MESSAGES/sphinx.js
-sphinx/locale/ur/LC_MESSAGES/sphinx.mo
-sphinx/locale/ur/LC_MESSAGES/sphinx.po
-sphinx/locale/vi/LC_MESSAGES/sphinx.js
-sphinx/locale/vi/LC_MESSAGES/sphinx.mo
-sphinx/locale/vi/LC_MESSAGES/sphinx.po
-sphinx/locale/yue/LC_MESSAGES/sphinx.js
-sphinx/locale/yue/LC_MESSAGES/sphinx.mo
-sphinx/locale/yue/LC_MESSAGES/sphinx.po
-sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js
-sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo
-sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po
-sphinx/locale/zh_HK/LC_MESSAGES/sphinx.js
-sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo
-sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po
-sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.js
-sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo
-sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po
-sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js
-sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo
-sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po
-sphinx/pycode/__init__.py
-sphinx/pycode/ast.py
-sphinx/pycode/parser.py
-sphinx/search/__init__.py
-sphinx/search/da.py
-sphinx/search/de.py
-sphinx/search/en.py
-sphinx/search/es.py
-sphinx/search/fi.py
-sphinx/search/fr.py
-sphinx/search/hu.py
-sphinx/search/it.py
-sphinx/search/ja.py
-sphinx/search/jssplitter.py
-sphinx/search/nl.py
-sphinx/search/no.py
-sphinx/search/pt.py
-sphinx/search/ro.py
-sphinx/search/ru.py
-sphinx/search/sv.py
-sphinx/search/tr.py
-sphinx/search/zh.py
-sphinx/search/minified-js/base-stemmer.js
-sphinx/search/minified-js/danish-stemmer.js
-sphinx/search/minified-js/dutch-stemmer.js
-sphinx/search/minified-js/finnish-stemmer.js
-sphinx/search/minified-js/french-stemmer.js
-sphinx/search/minified-js/german-stemmer.js
-sphinx/search/minified-js/hungarian-stemmer.js
-sphinx/search/minified-js/italian-stemmer.js
-sphinx/search/minified-js/norwegian-stemmer.js
-sphinx/search/minified-js/porter-stemmer.js
-sphinx/search/minified-js/portuguese-stemmer.js
-sphinx/search/minified-js/romanian-stemmer.js
-sphinx/search/minified-js/russian-stemmer.js
-sphinx/search/minified-js/spanish-stemmer.js
-sphinx/search/minified-js/swedish-stemmer.js
-sphinx/search/minified-js/turkish-stemmer.js
-sphinx/search/non-minified-js/base-stemmer.js
-sphinx/search/non-minified-js/danish-stemmer.js
-sphinx/search/non-minified-js/dutch-stemmer.js
-sphinx/search/non-minified-js/finnish-stemmer.js
-sphinx/search/non-minified-js/french-stemmer.js
-sphinx/search/non-minified-js/german-stemmer.js
-sphinx/search/non-minified-js/hungarian-stemmer.js
-sphinx/search/non-minified-js/italian-stemmer.js
-sphinx/search/non-minified-js/norwegian-stemmer.js
-sphinx/search/non-minified-js/porter-stemmer.js
-sphinx/search/non-minified-js/portuguese-stemmer.js
-sphinx/search/non-minified-js/romanian-stemmer.js
-sphinx/search/non-minified-js/russian-stemmer.js
-sphinx/search/non-minified-js/spanish-stemmer.js
-sphinx/search/non-minified-js/swedish-stemmer.js
-sphinx/search/non-minified-js/turkish-stemmer.js
-sphinx/templates/apidoc/module.rst_t
-sphinx/templates/apidoc/package.rst_t
-sphinx/templates/apidoc/toc.rst_t
-sphinx/templates/epub3/container.xml
-sphinx/templates/epub3/content.opf_t
-sphinx/templates/epub3/mimetype
-sphinx/templates/epub3/nav.xhtml_t
-sphinx/templates/epub3/toc.ncx_t
-sphinx/templates/gettext/message.pot_t
-sphinx/templates/graphviz/graphviz.css
-sphinx/templates/htmlhelp/project.hhc
-sphinx/templates/htmlhelp/project.hhp
-sphinx/templates/htmlhelp/project.stp
-sphinx/templates/imgmath/preview.tex_t
-sphinx/templates/imgmath/template.tex_t
-sphinx/templates/latex/latex.tex_t
-sphinx/templates/latex/longtable.tex_t
-sphinx/templates/latex/sphinxmessages.sty_t
-sphinx/templates/latex/tabular.tex_t
-sphinx/templates/latex/tabulary.tex_t
-sphinx/templates/quickstart/Makefile.new_t
-sphinx/templates/quickstart/Makefile_t
-sphinx/templates/quickstart/conf.py_t
-sphinx/templates/quickstart/make.bat.new_t
-sphinx/templates/quickstart/make.bat_t
-sphinx/templates/quickstart/root_doc.rst_t
-sphinx/templates/texinfo/Makefile
-sphinx/testing/__init__.py
-sphinx/testing/comparer.py
-sphinx/testing/fixtures.py
-sphinx/testing/path.py
-sphinx/testing/restructuredtext.py
-sphinx/testing/util.py
-sphinx/texinputs/LICRcyr2utf8.xdy
-sphinx/texinputs/LICRlatin2utf8.xdy
-sphinx/texinputs/LatinRules.xdy
-sphinx/texinputs/Makefile_t
-sphinx/texinputs/latexmkjarc_t
-sphinx/texinputs/latexmkrc_t
-sphinx/texinputs/make.bat_t
-sphinx/texinputs/python.ist
-sphinx/texinputs/sphinx.sty
-sphinx/texinputs/sphinx.xdy
-sphinx/texinputs/sphinxhowto.cls
-sphinx/texinputs/sphinxlatexadmonitions.sty
-sphinx/texinputs/sphinxlatexcontainers.sty
-sphinx/texinputs/sphinxlatexgraphics.sty
-sphinx/texinputs/sphinxlatexindbibtoc.sty
-sphinx/texinputs/sphinxlatexlists.sty
-sphinx/texinputs/sphinxlatexliterals.sty
-sphinx/texinputs/sphinxlatexnumfig.sty
-sphinx/texinputs/sphinxlatexobjects.sty
-sphinx/texinputs/sphinxlatexshadowbox.sty
-sphinx/texinputs/sphinxlatexstyleheadings.sty
-sphinx/texinputs/sphinxlatexstylepage.sty
-sphinx/texinputs/sphinxlatexstyletext.sty
-sphinx/texinputs/sphinxlatextables.sty
-sphinx/texinputs/sphinxmanual.cls
-sphinx/texinputs/sphinxoptionsgeometry.sty
-sphinx/texinputs/sphinxoptionshyperref.sty
-sphinx/texinputs/sphinxpackagecyrillic.sty
-sphinx/texinputs/sphinxpackagefootnote.sty
-sphinx/texinputs_win/Makefile_t
-sphinx/themes/agogo/layout.html
-sphinx/themes/agogo/theme.conf
-sphinx/themes/agogo/static/agogo.css_t
-sphinx/themes/agogo/static/bgfooter.png
-sphinx/themes/agogo/static/bgtop.png
-sphinx/themes/basic/defindex.html
-sphinx/themes/basic/domainindex.html
-sphinx/themes/basic/genindex-single.html
-sphinx/themes/basic/genindex-split.html
-sphinx/themes/basic/genindex.html
-sphinx/themes/basic/globaltoc.html
-sphinx/themes/basic/layout.html
-sphinx/themes/basic/localtoc.html
-sphinx/themes/basic/opensearch.xml
-sphinx/themes/basic/page.html
-sphinx/themes/basic/relations.html
-sphinx/themes/basic/search.html
-sphinx/themes/basic/searchbox.html
-sphinx/themes/basic/sourcelink.html
-sphinx/themes/basic/theme.conf
-sphinx/themes/basic/changes/frameset.html
-sphinx/themes/basic/changes/rstsource.html
-sphinx/themes/basic/changes/versionchanges.html
-sphinx/themes/basic/static/basic.css_t
-sphinx/themes/basic/static/doctools.js
-sphinx/themes/basic/static/documentation_options.js_t
-sphinx/themes/basic/static/file.png
-sphinx/themes/basic/static/jquery-3.5.1.js
-sphinx/themes/basic/static/jquery.js
-sphinx/themes/basic/static/language_data.js_t
-sphinx/themes/basic/static/minus.png
-sphinx/themes/basic/static/plus.png
-sphinx/themes/basic/static/searchtools.js
-sphinx/themes/basic/static/underscore-1.13.1.js
-sphinx/themes/basic/static/underscore.js
-sphinx/themes/bizstyle/layout.html
-sphinx/themes/bizstyle/theme.conf
-sphinx/themes/bizstyle/static/background_b01.png
-sphinx/themes/bizstyle/static/bizstyle.css_t
-sphinx/themes/bizstyle/static/bizstyle.js_t
-sphinx/themes/bizstyle/static/css3-mediaqueries.js
-sphinx/themes/bizstyle/static/css3-mediaqueries_src.js
-sphinx/themes/classic/layout.html
-sphinx/themes/classic/theme.conf
-sphinx/themes/classic/static/classic.css_t
-sphinx/themes/classic/static/sidebar.js_t
-sphinx/themes/default/theme.conf
-sphinx/themes/default/static/default.css
-sphinx/themes/epub/epub-cover.html
-sphinx/themes/epub/layout.html
-sphinx/themes/epub/theme.conf
-sphinx/themes/epub/static/epub.css_t
-sphinx/themes/haiku/layout.html
-sphinx/themes/haiku/theme.conf
-sphinx/themes/haiku/static/alert_info_32.png
-sphinx/themes/haiku/static/alert_warning_32.png
-sphinx/themes/haiku/static/bg-page.png
-sphinx/themes/haiku/static/bullet_orange.png
-sphinx/themes/haiku/static/haiku.css_t
-sphinx/themes/nature/theme.conf
-sphinx/themes/nature/static/nature.css_t
-sphinx/themes/nonav/layout.html
-sphinx/themes/nonav/theme.conf
-sphinx/themes/nonav/static/nonav.css
-sphinx/themes/pyramid/layout.html
-sphinx/themes/pyramid/theme.conf
-sphinx/themes/pyramid/static/dialog-note.png
-sphinx/themes/pyramid/static/dialog-seealso.png
-sphinx/themes/pyramid/static/dialog-todo.png
-sphinx/themes/pyramid/static/dialog-topic.png
-sphinx/themes/pyramid/static/dialog-warning.png
-sphinx/themes/pyramid/static/epub.css
-sphinx/themes/pyramid/static/footerbg.png
-sphinx/themes/pyramid/static/headerbg.png
-sphinx/themes/pyramid/static/ie6.css
-sphinx/themes/pyramid/static/middlebg.png
-sphinx/themes/pyramid/static/pyramid.css_t
-sphinx/themes/pyramid/static/transparent.gif
-sphinx/themes/scrolls/layout.html
-sphinx/themes/scrolls/theme.conf
-sphinx/themes/scrolls/artwork/logo.svg
-sphinx/themes/scrolls/static/darkmetal.png
-sphinx/themes/scrolls/static/headerbg.png
-sphinx/themes/scrolls/static/logo.png
-sphinx/themes/scrolls/static/metal.png
-sphinx/themes/scrolls/static/navigation.png
-sphinx/themes/scrolls/static/print.css
-sphinx/themes/scrolls/static/scrolls.css_t
-sphinx/themes/scrolls/static/theme_extras.js
-sphinx/themes/scrolls/static/watermark.png
-sphinx/themes/scrolls/static/watermark_blur.png
-sphinx/themes/sphinxdoc/theme.conf
-sphinx/themes/sphinxdoc/static/contents.png
-sphinx/themes/sphinxdoc/static/navigation.png
-sphinx/themes/sphinxdoc/static/sphinxdoc.css_t
-sphinx/themes/traditional/theme.conf
-sphinx/themes/traditional/static/traditional.css_t
-sphinx/transforms/__init__.py
-sphinx/transforms/compact_bullet_list.py
-sphinx/transforms/i18n.py
-sphinx/transforms/references.py
-sphinx/transforms/post_transforms/__init__.py
-sphinx/transforms/post_transforms/code.py
-sphinx/transforms/post_transforms/images.py
-sphinx/util/__init__.py
-sphinx/util/build_phase.py
-sphinx/util/cfamily.py
-sphinx/util/compat.py
-sphinx/util/console.py
-sphinx/util/docfields.py
-sphinx/util/docstrings.py
-sphinx/util/docutils.py
-sphinx/util/fileutil.py
-sphinx/util/i18n.py
-sphinx/util/images.py
-sphinx/util/inspect.py
-sphinx/util/inventory.py
-sphinx/util/jsdump.py
-sphinx/util/logging.py
-sphinx/util/matching.py
-sphinx/util/math.py
-sphinx/util/nodes.py
-sphinx/util/osutil.py
-sphinx/util/parallel.py
-sphinx/util/png.py
-sphinx/util/pycompat.py
-sphinx/util/requests.py
-sphinx/util/rst.py
-sphinx/util/smartypants.py
-sphinx/util/tags.py
-sphinx/util/template.py
-sphinx/util/texescape.py
-sphinx/util/typing.py
-sphinx/util/stemmer/__init__.py
-sphinx/util/stemmer/porter.py
-sphinx/writers/__init__.py
-sphinx/writers/html.py
-sphinx/writers/html5.py
-sphinx/writers/latex.py
-sphinx/writers/manpage.py
-sphinx/writers/texinfo.py
-sphinx/writers/text.py
-sphinx/writers/xml.py
-tests/__init__.py
-tests/conftest.py
-tests/ext_napoleon_pep526_data_google.py
-tests/ext_napoleon_pep526_data_numpy.py
-tests/test_api_translator.py
-tests/test_application.py
-tests/test_build.py
-tests/test_build_changes.py
-tests/test_build_dirhtml.py
-tests/test_build_epub.py
-tests/test_build_gettext.py
-tests/test_build_html.py
-tests/test_build_latex.py
-tests/test_build_linkcheck.py
-tests/test_build_manpage.py
-tests/test_build_texinfo.py
-tests/test_build_text.py
-tests/test_builder.py
-tests/test_catalogs.py
-tests/test_config.py
-tests/test_correct_year.py
-tests/test_directive_code.py
-tests/test_directive_only.py
-tests/test_directive_other.py
-tests/test_directive_patch.py
-tests/test_docutilsconf.py
-tests/test_domain_c.py
-tests/test_domain_cpp.py
-tests/test_domain_js.py
-tests/test_domain_py.py
-tests/test_domain_rst.py
-tests/test_domain_std.py
-tests/test_environment.py
-tests/test_environment_indexentries.py
-tests/test_environment_toctree.py
-tests/test_errors.py
-tests/test_events.py
-tests/test_ext_apidoc.py
-tests/test_ext_autodoc.py
-tests/test_ext_autodoc_autoattribute.py
-tests/test_ext_autodoc_autoclass.py
-tests/test_ext_autodoc_autodata.py
-tests/test_ext_autodoc_autofunction.py
-tests/test_ext_autodoc_automodule.py
-tests/test_ext_autodoc_autoproperty.py
-tests/test_ext_autodoc_configs.py
-tests/test_ext_autodoc_events.py
-tests/test_ext_autodoc_mock.py
-tests/test_ext_autodoc_preserve_defaults.py
-tests/test_ext_autodoc_private_members.py
-tests/test_ext_autosectionlabel.py
-tests/test_ext_autosummary.py
-tests/test_ext_coverage.py
-tests/test_ext_doctest.py
-tests/test_ext_duration.py
-tests/test_ext_extlinks.py
-tests/test_ext_githubpages.py
-tests/test_ext_graphviz.py
-tests/test_ext_ifconfig.py
-tests/test_ext_imgconverter.py
-tests/test_ext_inheritance_diagram.py
-tests/test_ext_intersphinx.py
-tests/test_ext_math.py
-tests/test_ext_napoleon.py
-tests/test_ext_napoleon_docstring.py
-tests/test_ext_napoleon_iterators.py
-tests/test_ext_todo.py
-tests/test_ext_viewcode.py
-tests/test_extension.py
-tests/test_highlighting.py
-tests/test_intl.py
-tests/test_locale.py
-tests/test_markup.py
-tests/test_metadata.py
-tests/test_parser.py
-tests/test_project.py
-tests/test_pycode.py
-tests/test_pycode_ast.py
-tests/test_pycode_parser.py
-tests/test_quickstart.py
-tests/test_roles.py
-tests/test_search.py
-tests/test_setup_command.py
-tests/test_smartquotes.py
-tests/test_templating.py
-tests/test_theming.py
-tests/test_toctree.py
-tests/test_transforms_post_transforms.py
-tests/test_transforms_post_transforms_code.py
-tests/test_util.py
-tests/test_util_docstrings.py
-tests/test_util_docutils.py
-tests/test_util_fileutil.py
-tests/test_util_i18n.py
-tests/test_util_images.py
-tests/test_util_inspect.py
-tests/test_util_inventory.py
-tests/test_util_jsdump.py
-tests/test_util_logging.py
-tests/test_util_matching.py
-tests/test_util_nodes.py
-tests/test_util_rst.py
-tests/test_util_template.py
-tests/test_util_typing.py
-tests/test_versioning.py
-tests/test_writer_latex.py
-tests/typing_test_data.py
-tests/utils.py
-tests/certs/cert.pem
-tests/js/doctools.js
-tests/js/searchtools.js
-tests/roots/test-add_enumerable_node/conf.py
-tests/roots/test-add_enumerable_node/enumerable_node.py
-tests/roots/test-add_enumerable_node/index.rst
-tests/roots/test-add_enumerable_node/rimg.png
-tests/roots/test-add_source_parser/conf.py
-tests/roots/test-add_source_parser/source_parser.py
-tests/roots/test-add_source_parser-conflicts-with-users-setting/conf.py
-tests/roots/test-add_source_parser-conflicts-with-users-setting/source_parser.py
-tests/roots/test-api-set-translator/conf.py
-tests/roots/test-api-set-translator/index.rst
-tests/roots/test-api-set-translator/translator.py
-tests/roots/test-api-set-translator/nonext/conf.py
-tests/roots/test-apidoc-pep420/a/b/c/__init__.py
-tests/roots/test-apidoc-pep420/a/b/c/d.py
-tests/roots/test-apidoc-pep420/a/b/e/__init__.py
-tests/roots/test-apidoc-pep420/a/b/e/f.py
-tests/roots/test-apidoc-pep420/a/b/x/y.py
-tests/roots/test-apidoc-subpackage-in-toc/parent/__init__.py
-tests/roots/test-apidoc-subpackage-in-toc/parent/child/__init__.py
-tests/roots/test-apidoc-subpackage-in-toc/parent/child/foo.py
-tests/roots/test-apidoc-toc/mypackage/__init__.py
-tests/roots/test-apidoc-toc/mypackage/main.py
-tests/roots/test-apidoc-toc/mypackage/no_init/foo.py
-tests/roots/test-apidoc-toc/mypackage/resource/__init__.py
-tests/roots/test-apidoc-toc/mypackage/resource/resource.txt
-tests/roots/test-apidoc-toc/mypackage/something/__init__.py
-tests/roots/test-apidoc-trailing-underscore/package_/__init__.py
-tests/roots/test-apidoc-trailing-underscore/package_/module_.py
-tests/roots/test-autosummary/conf.py
-tests/roots/test-autosummary/dummy_module.py
-tests/roots/test-autosummary/index.rst
-tests/roots/test-autosummary/sphinx.rst
-tests/roots/test-autosummary/underscore_module_.py
-tests/roots/test-basic/conf.py
-tests/roots/test-basic/index.rst
-tests/roots/test-build-html-translator/conf.py
-tests/roots/test-build-html-translator/index.rst
-tests/roots/test-build-text/conf.py
-tests/roots/test-build-text/doc1.txt
-tests/roots/test-build-text/doc2.txt
-tests/roots/test-build-text/index.txt
-tests/roots/test-build-text/lineblock.txt
-tests/roots/test-build-text/listitems.txt
-tests/roots/test-build-text/maxwidth.txt
-tests/roots/test-build-text/nonascii_maxwidth.txt
-tests/roots/test-build-text/nonascii_table.txt
-tests/roots/test-build-text/nonascii_title.txt
-tests/roots/test-build-text/table.txt
-tests/roots/test-build-text/table_colspan.txt
-tests/roots/test-build-text/table_colspan_and_rowspan.txt
-tests/roots/test-build-text/table_colspan_left.txt
-tests/roots/test-build-text/table_rowspan.txt
-tests/roots/test-builder-dirhtml/bar.rst
-tests/roots/test-builder-dirhtml/conf.py
-tests/roots/test-builder-dirhtml/index.rst
-tests/roots/test-builder-dirhtml/foo/foo_1.rst
-tests/roots/test-builder-dirhtml/foo/foo_2.rst
-tests/roots/test-builder-dirhtml/foo/index.rst
-tests/roots/test-builder-gettext-dont-rebuild-mo/bom.rst
-tests/roots/test-builder-gettext-dont-rebuild-mo/conf.py
-tests/roots/test-builder-gettext-dont-rebuild-mo/index.rst
-tests/roots/test-builder-gettext-dont-rebuild-mo/xx/LC_MESSAGES/bom.po
-tests/roots/test-changes/base.rst
-tests/roots/test-changes/c-api.rst
-tests/roots/test-changes/conf.py
-tests/roots/test-changes/contents.rst
-tests/roots/test-changes/library/utils.rst
-tests/roots/test-circular/conf.py
-tests/roots/test-circular/index.rst
-tests/roots/test-circular/sub.rst
-tests/roots/test-config/conf.py
-tests/roots/test-correct-year/conf.py
-tests/roots/test-correct-year/index.rst
-tests/roots/test-default_role/conf.py
-tests/roots/test-default_role/foo.rst
-tests/roots/test-default_role/index.rst
-tests/roots/test-directive-code/caption.rst
-tests/roots/test-directive-code/classes.rst
-tests/roots/test-directive-code/conf.py
-tests/roots/test-directive-code/dedent.rst
-tests/roots/test-directive-code/emphasize.rst
-tests/roots/test-directive-code/empty.inc
-tests/roots/test-directive-code/error.inc
-tests/roots/test-directive-code/force.rst
-tests/roots/test-directive-code/highlight.rst
-tests/roots/test-directive-code/index.rst
-tests/roots/test-directive-code/linenos.rst
-tests/roots/test-directive-code/linenothreshold.rst
-tests/roots/test-directive-code/literal-diff.inc
-tests/roots/test-directive-code/literal-short.inc
-tests/roots/test-directive-code/literal.inc
-tests/roots/test-directive-code/namedblocks.rst
-tests/roots/test-directive-code/py-decorators.inc
-tests/roots/test-directive-code/py-decorators.rst
-tests/roots/test-directive-code/python.rst
-tests/roots/test-directive-code/target.py
-tests/roots/test-directive-csv-table/conf.py
-tests/roots/test-directive-csv-table/example.csv
-tests/roots/test-directive-csv-table/subdir/example.csv
-tests/roots/test-directive-only/conf.py
-tests/roots/test-directive-only/index.rst
-tests/roots/test-directive-only/only.rst
-tests/roots/test-directives-raw/conf.py
-tests/roots/test-directives-raw/index.rst
-tests/roots/test-docutilsconf/conf.py
-tests/roots/test-docutilsconf/docutils.conf
-tests/roots/test-docutilsconf/index.rst
-tests/roots/test-domain-c/anon-dup-decl.rst
-tests/roots/test-domain-c/conf.py
-tests/roots/test-domain-c/field-role.rst
-tests/roots/test-domain-c/function_param_target.rst
-tests/roots/test-domain-c/index.rst
-tests/roots/test-domain-c/namespace.rst
-tests/roots/test-domain-c/ns_lookup.rst
-tests/roots/test-domain-c-intersphinx/conf.py
-tests/roots/test-domain-c-intersphinx/index.rst
-tests/roots/test-domain-cpp/anon-dup-decl.rst
-tests/roots/test-domain-cpp/any-role.rst
-tests/roots/test-domain-cpp/backslash.rst
-tests/roots/test-domain-cpp/conf.py
-tests/roots/test-domain-cpp/field-role.rst
-tests/roots/test-domain-cpp/index.rst
-tests/roots/test-domain-cpp/lookup-key-overload.rst
-tests/roots/test-domain-cpp/multi-decl-lookup.rst
-tests/roots/test-domain-cpp/roles-targets-ok.rst
-tests/roots/test-domain-cpp/roles-targets-warn.rst
-tests/roots/test-domain-cpp/roles.rst
-tests/roots/test-domain-cpp/roles2.rst
-tests/roots/test-domain-cpp/semicolon.rst
-tests/roots/test-domain-cpp/warn-template-param-qualified-name.rst
-tests/roots/test-domain-cpp/xref_consistency.rst
-tests/roots/test-domain-cpp-intersphinx/conf.py
-tests/roots/test-domain-cpp-intersphinx/index.rst
-tests/roots/test-domain-js/conf.py
-tests/roots/test-domain-js/index.rst
-tests/roots/test-domain-js/module.rst
-tests/roots/test-domain-js/roles.rst
-tests/roots/test-domain-py/abbr.rst
-tests/roots/test-domain-py/canonical.rst
-tests/roots/test-domain-py/conf.py
-tests/roots/test-domain-py/index.rst
-tests/roots/test-domain-py/module.rst
-tests/roots/test-domain-py/module_option.rst
-tests/roots/test-domain-py/roles.rst
-tests/roots/test-domain-py-python_use_unqualified_type_names/conf.py
-tests/roots/test-domain-py-python_use_unqualified_type_names/index.rst
-tests/roots/test-domain-py-xref-warning/conf.py
-tests/roots/test-domain-py-xref-warning/index.rst
-tests/roots/test-double-inheriting-theme/conf.py
-tests/roots/test-double-inheriting-theme/index.rst
-tests/roots/test-double-inheriting-theme/base_themes_dir/base_theme1/theme.conf
-tests/roots/test-double-inheriting-theme/base_themes_dir/base_theme2/theme.conf
-tests/roots/test-epub-anchor-id/conf.py
-tests/roots/test-epub-anchor-id/index.rst
-tests/roots/test-ext-autodoc/autodoc_dummy_bar.py
-tests/roots/test-ext-autodoc/autodoc_dummy_module.py
-tests/roots/test-ext-autodoc/conf.py
-tests/roots/test-ext-autodoc/index.rst
-tests/roots/test-ext-autodoc/bug2437/__init__.py
-tests/roots/test-ext-autodoc/bug2437/autodoc_dummy_foo.py
-tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py
-tests/roots/test-ext-autodoc/target/__init__.py
-tests/roots/test-ext-autodoc/target/abstractmethods.py
-tests/roots/test-ext-autodoc/target/annotated.py
-tests/roots/test-ext-autodoc/target/autoclass_content.py
-tests/roots/test-ext-autodoc/target/autodoc_type_aliases.py
-tests/roots/test-ext-autodoc/target/bound_method.py
-tests/roots/test-ext-autodoc/target/cached_property.py
-tests/roots/test-ext-autodoc/target/callable.py
-tests/roots/test-ext-autodoc/target/classes.py
-tests/roots/test-ext-autodoc/target/coroutine.py
-tests/roots/test-ext-autodoc/target/cython.pyx
-tests/roots/test-ext-autodoc/target/decorator.py
-tests/roots/test-ext-autodoc/target/descriptor.py
-tests/roots/test-ext-autodoc/target/docstring_signature.py
-tests/roots/test-ext-autodoc/target/empty_all.py
-tests/roots/test-ext-autodoc/target/enums.py
-tests/roots/test-ext-autodoc/target/final.py
-tests/roots/test-ext-autodoc/target/functions.py
-tests/roots/test-ext-autodoc/target/generic_class.py
-tests/roots/test-ext-autodoc/target/genericalias.py
-tests/roots/test-ext-autodoc/target/hide_value.py
-tests/roots/test-ext-autodoc/target/imported_members.py
-tests/roots/test-ext-autodoc/target/inheritance.py
-tests/roots/test-ext-autodoc/target/instance_variable.py
-tests/roots/test-ext-autodoc/target/metadata.py
-tests/roots/test-ext-autodoc/target/methods.py
-tests/roots/test-ext-autodoc/target/module.py
-tests/roots/test-ext-autodoc/target/name_mangling.py
-tests/roots/test-ext-autodoc/target/need_mocks.py
-tests/roots/test-ext-autodoc/target/overload.py
-tests/roots/test-ext-autodoc/target/overload2.py
-tests/roots/test-ext-autodoc/target/partialfunction.py
-tests/roots/test-ext-autodoc/target/partialmethod.py
-tests/roots/test-ext-autodoc/target/pep570.py
-tests/roots/test-ext-autodoc/target/pep604.py
-tests/roots/test-ext-autodoc/target/preserve_defaults.py
-tests/roots/test-ext-autodoc/target/private.py
-tests/roots/test-ext-autodoc/target/process_docstring.py
-tests/roots/test-ext-autodoc/target/properties.py
-tests/roots/test-ext-autodoc/target/singledispatch.py
-tests/roots/test-ext-autodoc/target/singledispatchmethod.py
-tests/roots/test-ext-autodoc/target/slots.py
-tests/roots/test-ext-autodoc/target/sort_by_all.py
-tests/roots/test-ext-autodoc/target/typed_vars.py
-tests/roots/test-ext-autodoc/target/typehints.py
-tests/roots/test-ext-autodoc/target/typevar.py
-tests/roots/test-ext-autodoc/target/uninitialized_attributes.py
-tests/roots/test-ext-autodoc/target/wrappedfunction.py
-tests/roots/test-ext-autodoc/target/canonical/__init__.py
-tests/roots/test-ext-autodoc/target/canonical/original.py
-tests/roots/test-ext-autodoc/target/name_conflict/__init__.py
-tests/roots/test-ext-autodoc/target/name_conflict/foo.py
-tests/roots/test-ext-autosectionlabel/conf.py
-tests/roots/test-ext-autosectionlabel/index.rst
-tests/roots/test-ext-autosectionlabel-prefix-document/conf.py
-tests/roots/test-ext-autosectionlabel-prefix-document/index.rst
-tests/roots/test-ext-autosummary/autosummary_dummy_module.py
-tests/roots/test-ext-autosummary/autosummary_importfail.py
-tests/roots/test-ext-autosummary/conf.py
-tests/roots/test-ext-autosummary/index.rst
-tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py
-tests/roots/test-ext-autosummary-filename-map/conf.py
-tests/roots/test-ext-autosummary-filename-map/index.rst
-tests/roots/test-ext-autosummary-imported_members/conf.py
-tests/roots/test-ext-autosummary-imported_members/index.rst
-tests/roots/test-ext-autosummary-imported_members/autosummary_dummy_package/__init__.py
-tests/roots/test-ext-autosummary-imported_members/autosummary_dummy_package/autosummary_dummy_module.py
-tests/roots/test-ext-autosummary-mock_imports/conf.py
-tests/roots/test-ext-autosummary-mock_imports/foo.py
-tests/roots/test-ext-autosummary-mock_imports/index.rst
-tests/roots/test-ext-autosummary-recursive/conf.py
-tests/roots/test-ext-autosummary-recursive/index.rst
-tests/roots/test-ext-autosummary-recursive/package/__init__.py
-tests/roots/test-ext-autosummary-recursive/package/module.py
-tests/roots/test-ext-autosummary-recursive/package/module_importfail.py
-tests/roots/test-ext-autosummary-recursive/package/package/__init__.py
-tests/roots/test-ext-autosummary-recursive/package/package/module.py
-tests/roots/test-ext-autosummary-recursive/package2/__init__.py
-tests/roots/test-ext-autosummary-recursive/package2/module.py
-tests/roots/test-ext-autosummary-skip-member/conf.py
-tests/roots/test-ext-autosummary-skip-member/index.rst
-tests/roots/test-ext-autosummary-skip-member/target.py
-tests/roots/test-ext-autosummary-template/conf.py
-tests/roots/test-ext-autosummary-template/index.rst
-tests/roots/test-ext-autosummary-template/target.py
-tests/roots/test-ext-autosummary-template/_templates/empty.rst
-tests/roots/test-ext-coverage/conf.py
-tests/roots/test-ext-coverage/coverage_ignored.py
-tests/roots/test-ext-coverage/coverage_not_ignored.py
-tests/roots/test-ext-coverage/index.rst
-tests/roots/test-ext-doctest/conf.py
-tests/roots/test-ext-doctest/doctest.txt
-tests/roots/test-ext-doctest-skipif/conf.py
-tests/roots/test-ext-doctest-skipif/skipif.txt
-tests/roots/test-ext-doctest-with-autodoc/conf.py
-tests/roots/test-ext-doctest-with-autodoc/foo.py
-tests/roots/test-ext-doctest-with-autodoc/index.rst
-tests/roots/test-ext-doctest-with-autodoc/dir/__init__.py
-tests/roots/test-ext-doctest-with-autodoc/dir/bar.py
-tests/roots/test-ext-doctest-with-autodoc/dir/inner.rst
-tests/roots/test-ext-extlinks-hardcoded-urls/conf.py
-tests/roots/test-ext-extlinks-hardcoded-urls/index.rst
-tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements/conf.py
-tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements/index.rst
-tests/roots/test-ext-githubpages/conf.py
-tests/roots/test-ext-githubpages/index.rst
-tests/roots/test-ext-graphviz/conf.py
-tests/roots/test-ext-graphviz/graph.dot
-tests/roots/test-ext-graphviz/graph.xx.dot
-tests/roots/test-ext-graphviz/index.rst
-tests/roots/test-ext-ifconfig/conf.py
-tests/roots/test-ext-ifconfig/index.rst
-tests/roots/test-ext-imgconverter/conf.py
-tests/roots/test-ext-imgconverter/img.pdf
-tests/roots/test-ext-imgconverter/index.rst
-tests/roots/test-ext-imgconverter/svgimg.svg
-tests/roots/test-ext-inheritance_diagram/conf.py
-tests/roots/test-ext-inheritance_diagram/index.rst
-tests/roots/test-ext-inheritance_diagram/test.py
-tests/roots/test-ext-inheritance_diagram/example/__init__.py
-tests/roots/test-ext-inheritance_diagram/example/sphinx.py
-tests/roots/test-ext-intersphinx-cppdomain/conf.py
-tests/roots/test-ext-intersphinx-cppdomain/index.rst
-tests/roots/test-ext-intersphinx-role/conf.py
-tests/roots/test-ext-intersphinx-role/index.rst
-tests/roots/test-ext-math/conf.py
-tests/roots/test-ext-math/index.rst
-tests/roots/test-ext-math/math.rst
-tests/roots/test-ext-math/nomath.rst
-tests/roots/test-ext-math/page.rst
-tests/roots/test-ext-math-compat/conf.py
-tests/roots/test-ext-math-compat/index.rst
-tests/roots/test-ext-math-simple/conf.py
-tests/roots/test-ext-math-simple/index.rst
-tests/roots/test-ext-todo/bar.rst
-tests/roots/test-ext-todo/conf.py
-tests/roots/test-ext-todo/foo.rst
-tests/roots/test-ext-todo/index.rst
-tests/roots/test-ext-viewcode/conf.py
-tests/roots/test-ext-viewcode/index.rst
-tests/roots/test-ext-viewcode/objects.rst
-tests/roots/test-ext-viewcode-find/conf.py
-tests/roots/test-ext-viewcode-find/index.rst
-tests/roots/test-ext-viewcode-find/not_a_package/__init__.py
-tests/roots/test-ext-viewcode-find/not_a_package/submodule.py
-tests/roots/test-ext-viewcode/spam/__init__.py
-tests/roots/test-ext-viewcode/spam/mod1.py
-tests/roots/test-ext-viewcode/spam/mod2.py
-tests/roots/test-ext-viewcode/spam/mod3.py
-tests/roots/test-extensions/conf.py
-tests/roots/test-extensions/read_parallel.py
-tests/roots/test-extensions/read_serial.py
-tests/roots/test-extensions/write_parallel.py
-tests/roots/test-extensions/write_serial.py
-tests/roots/test-footnotes/bar.rst
-tests/roots/test-footnotes/baz.rst
-tests/roots/test-footnotes/conf.py
-tests/roots/test-footnotes/index.rst
-tests/roots/test-footnotes/rimg.png
-tests/roots/test-gettext-template/conf.py
-tests/roots/test-gettext-template/index.rst
-tests/roots/test-gettext-template/_templates/template1.html
-tests/roots/test-gettext-template/_templates/template2.html
-tests/roots/test-glossary/conf.py
-tests/roots/test-glossary/index.rst
-tests/roots/test-highlight_options/conf.py
-tests/roots/test-highlight_options/index.rst
-tests/roots/test-html_assets/conf.py
-tests/roots/test-html_assets/index.rst
-tests/roots/test-html_assets/extra/.htaccess
-tests/roots/test-html_assets/extra/.htpasswd
-tests/roots/test-html_assets/extra/API.html_t
-tests/roots/test-html_assets/extra/index.rst
-tests/roots/test-html_assets/extra/rimg.png
-tests/roots/test-html_assets/extra/css/style.css
-tests/roots/test-html_assets/extra/subdir/.htaccess
-tests/roots/test-html_assets/extra/subdir/.htpasswd
-tests/roots/test-html_assets/static/.htaccess
-tests/roots/test-html_assets/static/.htpasswd
-tests/roots/test-html_assets/static/API.html_t
-tests/roots/test-html_assets/static/index.rst
-tests/roots/test-html_assets/static/rimg.png
-tests/roots/test-html_assets/static/css/style.css
-tests/roots/test-html_assets/static/js/custom.js
-tests/roots/test-html_assets/static/subdir/.htaccess
-tests/roots/test-html_assets/static/subdir/.htpasswd
-tests/roots/test-html_assets/subdir/background.png
-tests/roots/test-html_assets/subdir/_build/index.html
-tests/roots/test-html_entity/conf.py
-tests/roots/test-html_entity/index.rst
-tests/roots/test-html_scaled_image_link/conf.py
-tests/roots/test-html_scaled_image_link/img.png
-tests/roots/test-html_scaled_image_link/index.rst
-tests/roots/test-html_signaturereturn_icon/conf.py
-tests/roots/test-html_signaturereturn_icon/index.rst
-tests/roots/test-html_style/conf.py
-tests/roots/test-html_style/index.rst
-tests/roots/test-html_style/_static/default.css
-tests/roots/test-image-in-parsed-literal/conf.py
-tests/roots/test-image-in-parsed-literal/index.rst
-tests/roots/test-image-in-parsed-literal/pic.png
-tests/roots/test-image-in-section/conf.py
-tests/roots/test-image-in-section/index.rst
-tests/roots/test-image-in-section/pic.png
-tests/roots/test-images/conf.py
-tests/roots/test-images/img.gif
-tests/roots/test-images/img.ja.png
-tests/roots/test-images/img.pdf
-tests/roots/test-images/img.png
-tests/roots/test-images/img.zh.png
-tests/roots/test-images/index.rst
-tests/roots/test-images/rimg.png
-tests/roots/test-images/rimg.png.xx
-tests/roots/test-images/rimg.xx.png
-tests/roots/test-images/testimäge.png
-tests/roots/test-images/subdir/index.rst
-tests/roots/test-images/subdir/rimg.png
-tests/roots/test-images/subdir/rimg.xx.png
-tests/roots/test-images/subdir/svgimg.pdf
-tests/roots/test-images/subdir/svgimg.svg
-tests/roots/test-images/subdir/svgimg.xx.svg
-tests/roots/test-index_on_title/conf.py
-tests/roots/test-index_on_title/contents.rst
-tests/roots/test-inheritance/basic_diagram.rst
-tests/roots/test-inheritance/conf.py
-tests/roots/test-inheritance/diagram_module_w_2_top_classes.rst
-tests/roots/test-inheritance/diagram_w_1_top_class.rst
-tests/roots/test-inheritance/diagram_w_2_top_classes.rst
-tests/roots/test-inheritance/diagram_w_nested_classes.rst
-tests/roots/test-inheritance/diagram_w_parts.rst
-tests/roots/test-inheritance/index.rst
-tests/roots/test-inheritance/dummy/__init__.py
-tests/roots/test-inheritance/dummy/test.py
-tests/roots/test-inheritance/dummy/test_nested.py
-tests/roots/test-intl/admonitions.txt
-tests/roots/test-intl/bom.txt
-tests/roots/test-intl/conf.py
-tests/roots/test-intl/definition_terms.txt
-tests/roots/test-intl/docfields.txt
-tests/roots/test-intl/external_links.txt
-tests/roots/test-intl/figure.txt
-tests/roots/test-intl/footnote.txt
-tests/roots/test-intl/glossary_terms.txt
-tests/roots/test-intl/glossary_terms_inconsistency.txt
-tests/roots/test-intl/i18n.png
-tests/roots/test-intl/img.png
-tests/roots/test-intl/index.txt
-tests/roots/test-intl/index_entries.txt
-tests/roots/test-intl/label_target.txt
-tests/roots/test-intl/literalblock.txt
-tests/roots/test-intl/only.txt
-tests/roots/test-intl/raw.txt
-tests/roots/test-intl/refs.txt
-tests/roots/test-intl/refs_inconsistency.txt
-tests/roots/test-intl/refs_python_domain.txt
-tests/roots/test-intl/role_xref.txt
-tests/roots/test-intl/rubric.txt
-tests/roots/test-intl/section.txt
-tests/roots/test-intl/seealso.txt
-tests/roots/test-intl/table.txt
-tests/roots/test-intl/toctree.txt
-tests/roots/test-intl/topic.txt
-tests/roots/test-intl/versionchange.txt
-tests/roots/test-intl/warnings.txt
-tests/roots/test-intl/_templates/contents.html
-tests/roots/test-intl/subdir/index.txt
-tests/roots/test-intl/xx/LC_MESSAGES/admonitions.po
-tests/roots/test-intl/xx/LC_MESSAGES/bom.po
-tests/roots/test-intl/xx/LC_MESSAGES/definition_terms.po
-tests/roots/test-intl/xx/LC_MESSAGES/docfields.po
-tests/roots/test-intl/xx/LC_MESSAGES/external_links.po
-tests/roots/test-intl/xx/LC_MESSAGES/figure.po
-tests/roots/test-intl/xx/LC_MESSAGES/footnote.po
-tests/roots/test-intl/xx/LC_MESSAGES/glossary_terms.po
-tests/roots/test-intl/xx/LC_MESSAGES/glossary_terms_inconsistency.po
-tests/roots/test-intl/xx/LC_MESSAGES/index.po
-tests/roots/test-intl/xx/LC_MESSAGES/index_entries.po
-tests/roots/test-intl/xx/LC_MESSAGES/label_target.po
-tests/roots/test-intl/xx/LC_MESSAGES/literalblock.po
-tests/roots/test-intl/xx/LC_MESSAGES/only.po
-tests/roots/test-intl/xx/LC_MESSAGES/raw.po
-tests/roots/test-intl/xx/LC_MESSAGES/refs.po
-tests/roots/test-intl/xx/LC_MESSAGES/refs_inconsistency.po
-tests/roots/test-intl/xx/LC_MESSAGES/refs_python_domain.po
-tests/roots/test-intl/xx/LC_MESSAGES/role_xref.po
-tests/roots/test-intl/xx/LC_MESSAGES/rubric.po
-tests/roots/test-intl/xx/LC_MESSAGES/section.po
-tests/roots/test-intl/xx/LC_MESSAGES/seealso.po
-tests/roots/test-intl/xx/LC_MESSAGES/sphinx.po
-tests/roots/test-intl/xx/LC_MESSAGES/table.po
-tests/roots/test-intl/xx/LC_MESSAGES/toctree.po
-tests/roots/test-intl/xx/LC_MESSAGES/topic.po
-tests/roots/test-intl/xx/LC_MESSAGES/versionchange.po
-tests/roots/test-intl/xx/LC_MESSAGES/warnings.po
-tests/roots/test-keep_warnings/conf.py
-tests/roots/test-keep_warnings/index.rst
-tests/roots/test-latex-babel/bar.rst
-tests/roots/test-latex-babel/conf.py
-tests/roots/test-latex-babel/foo.rst
-tests/roots/test-latex-babel/index.rst
-tests/roots/test-latex-container/conf.py
-tests/roots/test-latex-container/index.rst
-tests/roots/test-latex-equations/conf.py
-tests/roots/test-latex-equations/equations.rst
-tests/roots/test-latex-equations/expects/latex-equations.tex
-tests/roots/test-latex-figure-in-admonition/conf.py
-tests/roots/test-latex-figure-in-admonition/img.png
-tests/roots/test-latex-figure-in-admonition/index.rst
-tests/roots/test-latex-includegraphics/conf.py
-tests/roots/test-latex-includegraphics/img.png
-tests/roots/test-latex-includegraphics/index.rst
-tests/roots/test-latex-includegraphics/sphinx.png
-tests/roots/test-latex-includegraphics/tall.png
-tests/roots/test-latex-index/conf.py
-tests/roots/test-latex-index/index.rst
-tests/roots/test-latex-labels/conf.py
-tests/roots/test-latex-labels/index.rst
-tests/roots/test-latex-labels/otherdoc.rst
-tests/roots/test-latex-numfig/conf.py
-tests/roots/test-latex-numfig/index.rst
-tests/roots/test-latex-numfig/indexhowto.rst
-tests/roots/test-latex-numfig/indexmanual.rst
-tests/roots/test-latex-table/complex.rst
-tests/roots/test-latex-table/conf.py
-tests/roots/test-latex-table/index.rst
-tests/roots/test-latex-table/longtable.rst
-tests/roots/test-latex-table/tabular.rst
-tests/roots/test-latex-table/_mytemplates/latex/longtable.tex_t
-tests/roots/test-latex-table/expects/complex_spanning_cell.tex
-tests/roots/test-latex-table/expects/gridtable.tex
-tests/roots/test-latex-table/expects/longtable.tex
-tests/roots/test-latex-table/expects/longtable_having_align.tex
-tests/roots/test-latex-table/expects/longtable_having_caption.tex
-tests/roots/test-latex-table/expects/longtable_having_problematic_cell.tex
-tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_problematic_cell.tex
-tests/roots/test-latex-table/expects/longtable_having_verbatim.tex
-tests/roots/test-latex-table/expects/longtable_having_widths.tex
-tests/roots/test-latex-table/expects/longtable_having_widths_and_problematic_cell.tex
-tests/roots/test-latex-table/expects/longtable_with_tabularcolumn.tex
-tests/roots/test-latex-table/expects/simple_table.tex
-tests/roots/test-latex-table/expects/table_having_caption.tex
-tests/roots/test-latex-table/expects/table_having_problematic_cell.tex
-tests/roots/test-latex-table/expects/table_having_stub_columns_and_problematic_cell.tex
-tests/roots/test-latex-table/expects/table_having_threeparagraphs_cell_in_first_col.tex
-tests/roots/test-latex-table/expects/table_having_verbatim.tex
-tests/roots/test-latex-table/expects/table_having_widths.tex
-tests/roots/test-latex-table/expects/table_having_widths_and_problematic_cell.tex
-tests/roots/test-latex-table/expects/tabular_having_widths.tex
-tests/roots/test-latex-table/expects/tabularcolumn.tex
-tests/roots/test-latex-table/expects/tabulary_having_widths.tex
-tests/roots/test-latex-theme/conf.py
-tests/roots/test-latex-theme/index.rst
-tests/roots/test-latex-theme/theme/custom/theme.conf
-tests/roots/test-latex-title/conf.py
-tests/roots/test-latex-title/index.rst
-tests/roots/test-latex-unicode/conf.py
-tests/roots/test-latex-unicode/index.rst
-tests/roots/test-linkcheck/conf.py
-tests/roots/test-linkcheck/links.txt
-tests/roots/test-linkcheck-documents_exclude/br0ken_link.rst
-tests/roots/test-linkcheck-documents_exclude/broken_link.rst
-tests/roots/test-linkcheck-documents_exclude/conf.py
-tests/roots/test-linkcheck-documents_exclude/index.rst
-tests/roots/test-linkcheck-localserver/conf.py
-tests/roots/test-linkcheck-localserver/index.rst
-tests/roots/test-linkcheck-localserver-anchor/conf.py
-tests/roots/test-linkcheck-localserver-anchor/index.rst
-tests/roots/test-linkcheck-localserver-https/conf.py
-tests/roots/test-linkcheck-localserver-https/index.rst
-tests/roots/test-linkcheck-localserver-warn-redirects/conf.py
-tests/roots/test-linkcheck-localserver-warn-redirects/index.rst
-tests/roots/test-local-logo/conf.py
-tests/roots/test-local-logo/index.rst
-tests/roots/test-local-logo/images/img.png
-tests/roots/test-locale/locale1/en/LC_MESSAGES/myext.mo
-tests/roots/test-locale/locale1/en/LC_MESSAGES/myext.po
-tests/roots/test-locale/locale2/en/LC_MESSAGES/myext.mo
-tests/roots/test-locale/locale2/en/LC_MESSAGES/myext.po
-tests/roots/test-manpage_url/conf.py
-tests/roots/test-manpage_url/index.rst
-tests/roots/test-markup-citation/conf.py
-tests/roots/test-markup-citation/index.rst
-tests/roots/test-markup-rubric/conf.py
-tests/roots/test-markup-rubric/index.rst
-tests/roots/test-maxlistdepth/conf.py
-tests/roots/test-maxlistdepth/index.rst
-tests/roots/test-metadata/conf.py
-tests/roots/test-metadata/index.rst
-tests/roots/test-need-escaped/bar.rst
-tests/roots/test-need-escaped/baz.rst
-tests/roots/test-need-escaped/conf.py
-tests/roots/test-need-escaped/foo.rst
-tests/roots/test-need-escaped/index.rst
-tests/roots/test-need-escaped/quux.rst
-tests/roots/test-need-escaped/qux.rst
-tests/roots/test-nested-enumerated-list/conf.py
-tests/roots/test-nested-enumerated-list/index.rst
-tests/roots/test-nested-tables/conf.py
-tests/roots/test-nested-tables/index.rst
-tests/roots/test-nitpicky-warnings/conf.py
-tests/roots/test-nitpicky-warnings/index.rst
-tests/roots/test-numbered-circular/conf.py
-tests/roots/test-numbered-circular/index.rst
-tests/roots/test-numbered-circular/sub.rst
-tests/roots/test-numfig/bar.rst
-tests/roots/test-numfig/baz.rst
-tests/roots/test-numfig/conf.py
-tests/roots/test-numfig/foo.rst
-tests/roots/test-numfig/index.rst
-tests/roots/test-numfig/rimg.png
-tests/roots/test-productionlist/Bare.rst
-tests/roots/test-productionlist/Dup1.rst
-tests/roots/test-productionlist/Dup2.rst
-tests/roots/test-productionlist/LineContinuation.rst
-tests/roots/test-productionlist/P1.rst
-tests/roots/test-productionlist/P2.rst
-tests/roots/test-productionlist/conf.py
-tests/roots/test-productionlist/firstLineRule.rst
-tests/roots/test-productionlist/index.rst
-tests/roots/test-prolog/conf.py
-tests/roots/test-prolog/index.rst
-tests/roots/test-prolog/markdown.md
-tests/roots/test-prolog/prolog_markdown_parser.py
-tests/roots/test-prolog/restructuredtext.rst
-tests/roots/test-pycode/cp_1251_coded.py
-tests/roots/test-pycode-egg/conf.py
-tests/roots/test-pycode-egg/index.rst
-tests/roots/test-pycode-egg/sample-0.0.0-py3.7.egg
-tests/roots/test-pycode-egg/src/sample.py
-tests/roots/test-pycode-egg/src/setup.py
-tests/roots/test-reST-code-block/conf.py
-tests/roots/test-reST-code-block/index.rst
-tests/roots/test-refonly_bullet_list/conf.py
-tests/roots/test-refonly_bullet_list/index.rst
-tests/roots/test-remote-logo/conf.py
-tests/roots/test-remote-logo/index.rst
-tests/roots/test-roles-download/conf.py
-tests/roots/test-roles-download/dummy.dat
-tests/roots/test-roles-download/index.rst
-tests/roots/test-roles-download/another/dummy.dat
-tests/roots/test-root/Makefile
-tests/roots/test-root/autodoc.txt
-tests/roots/test-root/autodoc_target.py
-tests/roots/test-root/bom.txt
-tests/roots/test-root/conf.py
-tests/roots/test-root/extapi.txt
-tests/roots/test-root/extensions.txt
-tests/roots/test-root/file_with_special_#_chars.xyz
-tests/roots/test-root/footnote.txt
-tests/roots/test-root/images.txt
-tests/roots/test-root/img.foo.png
-tests/roots/test-root/img.gif
-tests/roots/test-root/img.pdf
-tests/roots/test-root/img.png
-tests/roots/test-root/includes.txt
-tests/roots/test-root/index.txt
-tests/roots/test-root/lists.txt
-tests/roots/test-root/literal.inc
-tests/roots/test-root/literal_orig.inc
-tests/roots/test-root/markup.txt
-tests/roots/test-root/math.txt
-tests/roots/test-root/objects.txt
-tests/roots/test-root/otherext.foo
-tests/roots/test-root/parsermod.py
-tests/roots/test-root/quotes.inc
-tests/roots/test-root/rimg.png
-tests/roots/test-root/svgimg.pdf
-tests/roots/test-root/svgimg.svg
-tests/roots/test-root/tabs.inc
-tests/roots/test-root/test.inc
-tests/roots/test-root/wrongenc.inc
-tests/roots/test-root/_templates/contentssb.html
-tests/roots/test-root/_templates/customsb.html
-tests/roots/test-root/_templates/layout.html
-tests/roots/test-root/special/api.h
-tests/roots/test-root/special/code.py
-tests/roots/test-root/subdir/excluded.txt
-tests/roots/test-root/subdir/images.txt
-tests/roots/test-root/subdir/img.png
-tests/roots/test-root/subdir/include.inc
-tests/roots/test-root/subdir/includes.txt
-tests/roots/test-root/subdir/simg.png
-tests/roots/test-search/conf.py
-tests/roots/test-search/index.rst
-tests/roots/test-search/nosearch.rst
-tests/roots/test-search/tocitem.rst
-tests/roots/test-setup/setup.cfg
-tests/roots/test-setup/setup.py
-tests/roots/test-setup/doc/conf.py
-tests/roots/test-setup/doc/index.txt
-tests/roots/test-smartquotes/conf.py
-tests/roots/test-smartquotes/index.rst
-tests/roots/test-smartquotes/literals.rst
-tests/roots/test-stylesheets/conf.py
-tests/roots/test-stylesheets/index.rst
-tests/roots/test-stylesheets/_templates/layout.html
-tests/roots/test-templating/autosummary_templating.txt
-tests/roots/test-templating/conf.py
-tests/roots/test-templating/index.txt
-tests/roots/test-templating/_templates/layout.html
-tests/roots/test-templating/_templates/autosummary/class.rst
-tests/roots/test-theming/MANIFEST.in
-tests/roots/test-theming/child.zip
-tests/roots/test-theming/conf.py
-tests/roots/test-theming/index.rst
-tests/roots/test-theming/parent.zip
-tests/roots/test-theming/setup.py
-tests/roots/test-theming/ziptheme.zip
-tests/roots/test-theming/test_theme/__init__.py
-tests/roots/test-theming/test_theme/staticfiles/layout.html
-tests/roots/test-theming/test_theme/staticfiles/theme.conf
-tests/roots/test-theming/test_theme/staticfiles/static/staticimg.png
-tests/roots/test-theming/test_theme/staticfiles/static/statictmpl.html_t
-tests/roots/test-theming/test_theme/test-theme/theme.conf
-tests/roots/test-tocdepth/bar.rst
-tests/roots/test-tocdepth/baz.rst
-tests/roots/test-tocdepth/conf.py
-tests/roots/test-tocdepth/foo.rst
-tests/roots/test-tocdepth/index.rst
-tests/roots/test-toctree/bar.rst
-tests/roots/test-toctree/baz.rst
-tests/roots/test-toctree/conf.py
-tests/roots/test-toctree/foo.rst
-tests/roots/test-toctree/index.rst
-tests/roots/test-toctree/quux.rst
-tests/roots/test-toctree/qux.rst
-tests/roots/test-toctree/tocdepth.rst
-tests/roots/test-toctree-duplicated/conf.py
-tests/roots/test-toctree-duplicated/foo.rst
-tests/roots/test-toctree-duplicated/index.rst
-tests/roots/test-toctree-empty/conf.py
-tests/roots/test-toctree-empty/index.rst
-tests/roots/test-toctree-empty/_templates/localtoc.html
-tests/roots/test-toctree-glob/baz.rst
-tests/roots/test-toctree-glob/conf.py
-tests/roots/test-toctree-glob/foo.rst
-tests/roots/test-toctree-glob/index.rst
-tests/roots/test-toctree-glob/quux.rst
-tests/roots/test-toctree-glob/bar/bar_1.rst
-tests/roots/test-toctree-glob/bar/bar_2.rst
-tests/roots/test-toctree-glob/bar/bar_3.rst
-tests/roots/test-toctree-glob/bar/index.rst
-tests/roots/test-toctree-glob/bar/bar_4/index.rst
-tests/roots/test-toctree-glob/qux/index.rst
-tests/roots/test-toctree-glob/qux/qux_1.rst
-tests/roots/test-toctree-glob/qux/qux_2.rst
-tests/roots/test-toctree-maxdepth/bar.rst
-tests/roots/test-toctree-maxdepth/baz.rst
-tests/roots/test-toctree-maxdepth/conf.py
-tests/roots/test-toctree-maxdepth/foo.rst
-tests/roots/test-toctree-maxdepth/index.rst
-tests/roots/test-toctree-maxdepth/qux.rst
-tests/roots/test-transforms-post_transforms-missing-reference/conf.py
-tests/roots/test-transforms-post_transforms-missing-reference/index.rst
-tests/roots/test-trim_doctest_flags/conf.py
-tests/roots/test-trim_doctest_flags/index.rst
-tests/roots/test-versioning/added.txt
-tests/roots/test-versioning/conf.py
-tests/roots/test-versioning/deleted.txt
-tests/roots/test-versioning/deleted_end.txt
-tests/roots/test-versioning/index.txt
-tests/roots/test-versioning/insert.txt
-tests/roots/test-versioning/insert_beginning.txt
-tests/roots/test-versioning/insert_similar.txt
-tests/roots/test-versioning/modified.txt
-tests/roots/test-versioning/original.txt
-tests/roots/test-warnings/autodoc_fodder.py
-tests/roots/test-warnings/conf.py
-tests/roots/test-warnings/index.rst
-tests/roots/test-warnings/svgimg.pdf
-tests/roots/test-warnings/svgimg.svg
-tests/roots/test-warnings/undecodable.rst
-tests/roots/test-warnings/wrongenc.inc
-utils/CHANGES_template
-utils/__init__.py
-utils/bump_docker.sh
-utils/bump_version.py
-utils/checks.py
-utils/doclinter.py
-utils/jssplitter_generator.py
-utils/release-checklist
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/dependency_links.txt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/entry_points.txt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/not-zip-safe Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/requires.txt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/Sphinx.egg-info/top_level.txt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/babel.cfg Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_static/pocoo.png Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_static/themes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_static/themes/fullsize Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_static/tutorial Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_templates/index.html Deleted

@@ -1,129 +0,0 @@
-{% extends "layout.html" %}
-{% set title = _('Overview') %}
-{% block body %}
-  <h1>{{ _('Welcome') }}</h1>
-
-  <div class="quotebar">
-    <p><em>{%trans%}What users say:{%endtrans%}</em></p>
-    <p>{%trans%}&#8220;Cheers for a great tool that actually makes programmers <b>want</b>
-      to write documentation!&#8220;{%endtrans%}</p>
-  </div>
-
-  <p>{%trans%}
-    Sphinx is a tool that makes it easy to create intelligent and beautiful
-    documentation, written by Georg Brandl and licensed under the BSD license.{%endtrans%}</p>
-  <p>{%trans%}It was originally created for <a href="https://docs.python.org/">the
-    Python documentation</a>, and it has excellent facilities for the
-    documentation of software projects in a range of languages.  Of
-    course, this site is also created from reStructuredText sources using
-    Sphinx!  The following features should be highlighted:{%endtrans%}
-  </p>
-  <ul>
-    <li>{%trans%}<b>Output formats:</b> HTML (including Windows HTML Help), LaTeX (for
-      printable PDF versions), ePub, Texinfo, manual pages, plain text{%endtrans%}</li>
-    <li>{%trans%}<b>Extensive cross-references:</b> semantic markup and automatic links
-      for functions, classes, citations, glossary terms and similar pieces of
-      information{%endtrans%}</li>
-    <li>{%trans%}<b>Hierarchical structure:</b> easy definition of a document tree, with
-      automatic links to siblings, parents and children{%endtrans%}</li>
-    <li>{%trans%}<b>Automatic indices:</b> general index as well as a language-specific
-      module indices{%endtrans%}</li>
-    <li>{%trans%}<b>Code handling:</b> automatic highlighting using the <a
-      href="https://pygments.org">Pygments</a> highlighter{%endtrans%}</li>
-    <li>{%trans path=pathto('ext/builtins')%}<b>Extensions:</b> automatic testing of code snippets, inclusion of
-      docstrings from Python modules (API docs), and
-      <a href="{{ path }}#builtin-sphinx-extensions">more</a>{%endtrans%}</li>
-    <li>{%trans path=pathto("usage/extensions/index")%}<b>Contributed extensions:</b> dozens of
-      extensions <a href="{{ path }}#third-party-extensions">contributed by users</a>;
-      most of them installable from PyPI{%endtrans%}</li>
-  </ul>
-  <p>{%trans%}
-    Sphinx uses <a href="https://docutils.sourceforge.io/rst.html">reStructuredText</a>
-    as its markup language, and many of its strengths come from the power and
-    straightforwardness of reStructuredText and its parsing and translating
-    suite, the <a href="https://docutils.sourceforge.io/">Docutils</a>.{%endtrans%}
-  </p>
-
-  <h2 style="margin-bottom: 0">{%trans%}Documentation{%endtrans%}</h2>
-
-  <table class="contentstable">
-    <tr>
-      <td>
-        <p class="biglink"><a class="biglink" href="{{ pathto("usage/quickstart") }}">{%trans%}First steps with Sphinx{%endtrans%}</a><br/>
-           <span class="linkdescr">{%trans%}overview of basic tasks{%endtrans%}</span></p>
-      </td><td>
-        <p class="biglink"><a class="biglink" href="{{ pathto("tutorial/index") }}">{%trans%}Tutorial{%endtrans%}</a><br/>
-           <span class="linkdescr">{%trans%}beginners tutorial{%endtrans%}</span></p>
-      </td>
-    </tr><tr>
-      <td>
-        <p class="biglink"><a class="biglink" href="{{ pathto("contents") }}">{%trans%}Contents{%endtrans%}</a><br/>
-           <span class="linkdescr">{%trans%}for a complete overview{%endtrans%}</span></p>
-      </td><td>
-        {%- if hasdoc('search') %}<p class="biglink"><a class="biglink" href="{{ pathto("search") }}">{%trans%}Search page{%endtrans%}</a><br/>
-           <span class="linkdescr">{%trans%}search the documentation{%endtrans%}</span></p>{%- endif %}
-      </td>
-    </tr><tr>
-      <td>
-        <p class="biglink"><a class="biglink" href="{{ pathto("changes") }}">{%trans%}Changes{%endtrans%}</a><br/>
-           <span class="linkdescr">{%trans%}release history{%endtrans%}</span></p>
-      </td><td>
-        {%- if hasdoc('genindex') %}<p class="biglink"><a class="biglink" href="{{ pathto("genindex") }}">{%trans%}General Index{%endtrans%}</a><br/>
-           <span class="linkdescr">{%trans%}all functions, classes, terms{%endtrans%}</span></p>{%- endif %}
-      </td><td>
-    </tr>
-  </table>
-
-  <p>{%trans%}
-    You can also download PDF/EPUB versions of the Sphinx documentation
-    from pop up menu on lower right corner.{%endtrans%}
-  </p>
-
-  <h2>{%trans%}Examples{%endtrans%}</h2>
-  <p>{%trans path=pathto("examples")%}Links to documentation generated with Sphinx can be found on the
-    <a href="{{ path }}">Projects using Sphinx</a> page.{%endtrans%}
-  </p>
-  <p>{%trans%}
-    For examples of how Sphinx source files look, use the &#8220;Show
-    source&#8221; links on all pages of the documentation apart from this
-    welcome page.{%endtrans%}
-  </p>
-
-  <p>{%trans%}You may also be interested in the very nice
-    <a href="http://matplotlib.sourceforge.net/sampledoc/">tutorial</a> on how to
-    create a customized documentation using Sphinx written by the matplotlib
-    developers.{%endtrans%}</p>
-
-  <p>{%trans%}There is a translation team in <a href="https://www.transifex.com/sphinx-doc/sphinx-doc/dashboard/">Transifex</a>
-    of this documentation, thanks to the Sphinx document translators.{%endtrans%}</p>
-  <p>{%trans%}A Japanese book about Sphinx has been published by O'Reilly:
-    <a href="https://www.oreilly.co.jp/books/9784873116488/">Sphinxをはじめよう /
-      Learning Sphinx</a>.{%endtrans%}</p>
-  <p>{%trans%}In 2019 the second edition of a German book about Sphinx was published:
-    <a href="https://literatur.hasecke.com/post/software-dokumentation-mit-sphinx/">Software-Dokumentation mit Sphinx</a>.{%endtrans%}</p>
-  
-
-
-  <h2>{%trans%}Hosting{%endtrans%}</h2>
-
-  <p>{%trans%}Need a place to host your Sphinx docs?
-    <a href="https://readthedocs.org/">readthedocs.org</a> hosts a lot of Sphinx docs
-    already, and integrates well with projects' source control.  It also features a
-    powerful built-in search that exceeds the possibilities of Sphinx' JavaScript-based
-    offline search.{%endtrans%}</p>
-
-  <h2>{%trans%}Contributor Guide{%endtrans%}</h2>
-
-  <p>{%trans%}If you want to contribute to the project,
-    this part of the documentation is for you.{%endtrans%}</p>
-
-    <ul>
-      <li>{%trans path=pathto("internals/contributing")%}<a href="{{ path }}">Sphinx Contributors’ Guide</a></li>{%endtrans%}
-      <li>{%trans path=pathto("internals/authors")%}<a href="{{ path }}">Sphinx Authors</a></li>{%endtrans%}
-    </ul>
-
-  <h2>{%trans%}Code of Conduct{%endtrans%}</h2>
-
-  <p>{%trans path=pathto("internals/code-of-conduct")%}Please adhere to our <a href="{{ path }}">Code of Conduct</a>.{%endtrans%}</p>
-
-{% endblock %}

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_templates/indexsidebar.html Deleted

@@ -1,23 +0,0 @@
-<p class="logo">A <a href="https://www.pocoo.org/">
-  <img src="{{ pathto("_static/pocoo.png", 1) }}" alt="Pocoo" /></a>
-  {%trans%}project{%endtrans%}</p>
-
-<h3>Download</h3>
-<p class="download">{%trans%}Current version: <a href="https://pypi.org/project/Sphinx/" alt="PyPI"><img src="https://img.shields.io/pypi/v/sphinx.svg"></a>{%endtrans%}</p>
-<p>{%trans%}Install Sphinx with:{%endtrans%}</p>
-<pre>pip install -U Sphinx</pre>
-
-<h3>{%trans%}Questions? Suggestions?{%endtrans%}</h3>
-
-<p>{%trans%}Join the <a href="https://groups.google.com/group/sphinx-users">sphinx-users</a> mailing list on Google Groups:{%endtrans%}</p>
-<div class="subscribeformwrapper">
-<form action="https://groups.google.com/group/sphinx-users/boxsubscribe"
-      class="subscribeform">
-  <input type="text" name="email" value="your@email"
-         onfocus="$(this).val('');" />
-  <input type="submit" name="sub" value="Subscribe" />
-</form>
-</div>
-<p>{%trans%}or come to the <tt>#sphinx-doc</tt> channel on <a href="https://web.libera.chat/?channel=#sphinx-doc">libera.chat</a>.{%endtrans%}</p>
-<p>{%trans%}You can also open an issue at the
-  <a href="https://github.com/sphinx-doc/sphinx/issues">tracker</a>.{%endtrans%}</p>

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static/bodybg.png Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static/footerbg.png Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static/headerbg.png Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static/listitem.png Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static/relbg.png Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/contents.rst Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/examples Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/internals Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/internals/authors.rst Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/man Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/templating.rst Deleted

@@ -1,485 +0,0 @@
-.. highlight:: html+jinja
-
-.. _templating:
-
-==========
-Templating
-==========
-
-Sphinx uses the `Jinja <https://jinja.palletsprojects.com/>`_ templating engine
-for its HTML templates.  Jinja is a text-based engine, inspired by Django
-templates, so anyone having used Django will already be familiar with it. It
-also has excellent documentation for those who need to make themselves familiar
-with it.
-
-
-Do I need to use Sphinx's templates to produce HTML?
-----------------------------------------------------
-
-No.  You have several other options:
-
-* You can write a :class:`~sphinx.application.TemplateBridge` subclass that
-  calls your template engine of choice, and set the :confval:`template_bridge`
-  configuration value accordingly.
-
-* You can :ref:`write a custom builder <writing-builders>` that derives from
-  :class:`~sphinx.builders.html.StandaloneHTMLBuilder` and calls your template
-  engine of choice.
-
-* You can use the :class:`~sphinx.builders.html.PickleHTMLBuilder` that produces
-  pickle files with the page contents, and postprocess them using a custom tool,
-  or use them in your Web application.
-
-
-Jinja/Sphinx Templating Primer
-------------------------------
-
-The default templating language in Sphinx is Jinja.  It's Django/Smarty inspired
-and easy to understand.  The most important concept in Jinja is :dfn:`template
-inheritance`, which means that you can overwrite only specific blocks within a
-template, customizing it while also keeping the changes at a minimum.
-
-To customize the output of your documentation you can override all the templates
-(both the layout templates and the child templates) by adding files with the
-same name as the original filename into the template directory of the structure
-the Sphinx quickstart generated for you.
-
-Sphinx will look for templates in the folders of :confval:`templates_path`
-first, and if it can't find the template it's looking for there, it falls back
-to the selected theme's templates.
-
-A template contains **variables**, which are replaced with values when the
-template is evaluated, **tags**, which control the logic of the template and
-**blocks** which are used for template inheritance.
-
-Sphinx's *basic* theme provides base templates with a couple of blocks it will
-fill with data.  These are located in the :file:`themes/basic` subdirectory of
-the Sphinx installation directory, and used by all builtin Sphinx themes.
-Templates with the same name in the :confval:`templates_path` override templates
-supplied by the selected theme.
-
-For example, to add a new link to the template area containing related links all
-you have to do is to add a new template called ``layout.html`` with the
-following contents::
-
-    {% extends "!layout.html" %}
-    {% block rootrellink %}
-        <li><a href="https://project.invalid/">Project Homepage</a> &raquo;</li>
-        {{ super() }}
-    {% endblock %}
-
-By prefixing the name of the overridden template with an exclamation mark,
-Sphinx will load the layout template from the underlying HTML theme.
-
-.. important::
-   If you override a block, call ``{{ super() }}`` somewhere to render the
-   block's original content in the extended template -- unless you don't want
-   that content to show up.
-
-
-Working with the builtin templates
-----------------------------------
-
-The builtin **basic** theme supplies the templates that all builtin Sphinx
-themes are based on.  It has the following elements you can override or use:
-
-Blocks
-~~~~~~
-
-The following blocks exist in the ``layout.html`` template:
-
-``doctype``
-    The doctype of the output format.  By default this is XHTML 1.0 Transitional
-    as this is the closest to what Sphinx and Docutils generate and it's a good
-    idea not to change it unless you want to switch to HTML 5 or a different but
-    compatible XHTML doctype.
-
-``linktags``
-    This block adds a couple of ``<link>`` tags to the head section of the
-    template.
-
-``extrahead``
-    This block is empty by default and can be used to add extra contents into
-    the ``<head>`` tag of the generated HTML file.  This is the right place to
-    add references to JavaScript or extra CSS files.
-
-``relbar1``, ``relbar2``
-    This block contains the *relation bar*, the list of related links (the
-    parent documents on the left, and the links to index, modules etc. on the
-    right).  ``relbar1`` appears before the document, ``relbar2`` after the
-    document.  By default, both blocks are filled; to show the relbar only
-    before the document, you would override `relbar2` like this::
-
-       {% block relbar2 %}{% endblock %}
-
-``rootrellink``, ``relbaritems``
-    Inside the relbar there are three sections: The ``rootrellink``, the links
-    from the documentation and the custom ``relbaritems``.  The ``rootrellink``
-    is a block that by default contains a list item pointing to the root
-    document by default, the ``relbaritems`` is an empty block.  If you
-    override them to add extra links into the bar make sure that they are list
-    items and end with the :data:`reldelim1`.
-
-``document``
-    The contents of the document itself.  It contains the block "body" where
-    the individual content is put by subtemplates like ``page.html``.
-
-    .. note::
-        In order for the built-in JavaScript search to show a page preview on
-        the results page, the document or body content should be wrapped in an
-        HTML element containing the ``role="main"`` attribute. For example::
-
-            <div role="main">
-              {% block document %}{% endblock %}
-            </div>
-
-``sidebar1``, ``sidebar2``
-    A possible location for a sidebar.  ``sidebar1`` appears before the document
-    and is empty by default, ``sidebar2`` after the document and contains the
-    default sidebar.  If you want to swap the sidebar location override this and
-    call the ``sidebar`` helper::
-
-        {% block sidebar1 %}{{ sidebar() }}{% endblock %}
-        {% block sidebar2 %}{% endblock %}
-
-    (The ``sidebar2`` location for the sidebar is needed by the ``sphinxdoc.css``
-    stylesheet, for example.)
-
-``sidebarlogo``
-    The logo location within the sidebar.  Override this if you want to place
-    some content at the top of the sidebar.
-
-``footer``
-    The block for the footer div.  If you want a custom footer or markup before
-    or after it, override this one.
-
-The following four blocks are *only* used for pages that do not have assigned a
-list of custom sidebars in the :confval:`html_sidebars` config value.  Their use
-is deprecated in favor of separate sidebar templates, which can be included via
-:confval:`html_sidebars`.
-
-``sidebartoc``
-    The table of contents within the sidebar.
-
-    .. deprecated:: 1.0
-
-``sidebarrel``
-    The relation links (previous, next document) within the sidebar.
-
-    .. deprecated:: 1.0
-
-``sidebarsourcelink``
-    The "Show source" link within the sidebar (normally only shown if this is
-    enabled by :confval:`html_show_sourcelink`).
-
-    .. deprecated:: 1.0
-
-``sidebarsearch``
-    The search box within the sidebar.  Override this if you want to place some
-    content at the bottom of the sidebar.
-
-    .. deprecated:: 1.0
-
-
-Configuration Variables
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Inside templates you can set a couple of variables used by the layout template
-using the ``{% set %}`` tag:
-
-.. data:: reldelim1
-
-   The delimiter for the items on the left side of the related bar.  This
-   defaults to ``' &raquo;'`` Each item in the related bar ends with the value
-   of this variable.
-
-.. data:: reldelim2
-
-   The delimiter for the items on the right side of the related bar.  This
-   defaults to ``' |'``.  Each item except of the last one in the related bar
-   ends with the value of this variable.
-
-Overriding works like this::
-
-   {% extends "!layout.html" %}
-   {% set reldelim1 = ' &gt;' %}
-
-.. data:: script_files
-
-   Add additional script files here, like this::
-
-      {% set script_files = script_files + "_static/myscript.js" %}
-
-   .. deprecated:: 1.8.0
-
-      Please use ``.Sphinx.add_js_file()`` instead.
-
-Helper Functions
-~~~~~~~~~~~~~~~~
-
-Sphinx provides various Jinja functions as helpers in the template.  You can use
-them to generate links or output multiply used elements.
-
-.. function:: pathto(document)
-
-   Return the path to a Sphinx document as a URL.  Use this to refer to built
-   documents.
-
-.. function:: pathto(file, 1)
-   :noindex:
-
-   Return the path to a *file* which is a filename relative to the root of the
-   generated output.  Use this to refer to static files.
-
-.. function:: hasdoc(document)
-
-   Check if a document with the name *document* exists.
-
-.. function:: sidebar()
-
-   Return the rendered sidebar.
-
-.. function:: relbar()
-
-   Return the rendered relation bar.
-
-.. function:: warning(message)
-
-   Emit a warning message.
-
-Global Variables
-~~~~~~~~~~~~~~~~
-
-These global variables are available in every template and are safe to use.
-There are more, but most of them are an implementation detail and might change
-in the future.
-
-.. data:: builder
-
-   The name of the builder (e.g. ``html`` or ``htmlhelp``).
-
-.. data:: copyright
-
-   The value of :confval:`copyright`.
-
-.. data:: docstitle
-
-   The title of the documentation (the value of :confval:`html_title`), except
-   when the "single-file" builder is used, when it is set to ``None``.
-
-.. data:: embedded
-
-   True if the built HTML is meant to be embedded in some viewing application
-   that handles navigation, not the web browser, such as for HTML help or Qt
-   help formats.  In this case, the sidebar is not included.
-
-.. data:: favicon
-
-   The path to the HTML favicon in the static path, or URL to the favicon, or
-   ``''``.
-
-   .. deprecated:: 4.0
-
-      Recommend to use ``favicon_url`` instead.
-
-.. data:: favicon_url
-
-   The relative path to the HTML favicon image from the current document, or
-   URL to the favicon, or ``''``.
-
-   .. versionadded:: 4.0
-
-.. data:: file_suffix
-
-   The value of the builder's :attr:`~.SerializingHTMLBuilder.out_suffix`
-   attribute, i.e. the file name extension that the output files will get.  For
-   a standard HTML builder, this is usually ``.html``.
-
-.. data:: has_source
-
-   True if the reST document sources are copied (if :confval:`html_copy_source`
-   is ``True``).
-
-.. data:: language
-
-   The value of :confval:`language`.
-
-.. data:: last_updated
-
-   The build date.
-
-.. data:: logo
-
-   The path to the HTML logo image in the static path, or URL to the logo, or
-   ``''``.
-
-   .. deprecated:: 4.0
-
-      Recommend to use ``logo_url`` instead.
-
-.. data:: logo_url
-
-   The relative path to the HTML logo image from the current document, or URL
-   to the logo, or ``''``.
-
-   .. versionadded:: 4.0
-
-.. data:: master_doc
-
-   Same as :data:`root_doc`.
-
-   .. versionchanged:: 4.0
-
-      Renamed to ``root_doc``.
-
-.. data:: root_doc
-
-   The value of :confval:`root_doc`, for usage with :func:`pathto`.
-
-   .. versionchanged:: 4.0
-
-      Renamed from ``master_doc``.
-
-.. data:: pagename
-
-   The "page name" of the current file, i.e. either the document name if the
-   file is generated from a reST source, or the equivalent hierarchical name
-   relative to the output directory
-   (``directory/filename_without_extension``).
-
-.. data:: project
-
-   The value of :confval:`project`.
-
-.. data:: release
-
-   The value of :confval:`release`.
-
-.. data:: rellinks
-
-   A list of links to put at the left side of the relbar, next to "next" and
-   "prev".  This usually contains links to the general index and other indices,
-   such as the Python module index.  If you add something yourself, it must be a
-   tuple ``(pagename, link title, accesskey, link text)``.
-
-.. data:: shorttitle
-
-   The value of :confval:`html_short_title`.
-
-.. data:: show_source
-
-   True if :confval:`html_show_sourcelink` is ``True``.
-
-.. data:: sphinx_version
-
-   The version of Sphinx used to build represented as a string for example "3.5.1".
-
-.. data:: sphinx_version_tuple
-
-   The version of Sphinx used to build represented as a tuple of five elements.
-   For Sphinx version 3.5.1 beta 3 this would be `(3, 5, 1, 'beta', 3)``.
-   The fourth element can be one of: ``alpha``, ``beta``, ``rc``, ``final``.
-   ``final`` always has 0 as the last element.
-
-   .. versionadded:: 4.2
-
-.. data:: style
-
-   The name of the main stylesheet, as given by the theme or
-   :confval:`html_style`.
-
-.. data:: title
-
-   The title of the current document, as used in the ``<title>`` tag.
-
-.. data:: use_opensearch
-
-   The value of :confval:`html_use_opensearch`.
-
-.. data:: version
-
-   The value of :confval:`version`.
-
-
-In addition to these values, there are also all **theme options** available
-(prefixed by ``theme_``), as well as the values given by the user in
-:confval:`html_context`.
-
-In documents that are created from source files (as opposed to
-automatically-generated files like the module index, or documents that already
-are in HTML form), these variables are also available:
-
-.. data:: body
-
-   A string containing the content of the page in HTML form as produced by the
-   HTML builder, before the theme is applied.
-
-.. data:: display_toc
-
-   A boolean that is True if the toc contains more than one entry.
-
-.. data:: meta
-
-   Document metadata (a dictionary), see :ref:`metadata`.
-
-.. data:: metatags
-
-   A string containing the page's HTML :dudir:`meta` tags.
-
-.. data:: next
-
-   The next document for the navigation.  This variable is either false or has
-   two attributes `link` and `title`.  The title contains HTML markup.  For
-   example, to generate a link to the next page, you can use this snippet::
-
-      {% if next %}
-      <a href="{{ next.link|e }}">{{ next.title }}</a>
-      {% endif %}
-
-.. data:: page_source_suffix
-
-   The suffix of the file that was rendered. Since we support a list of
-   :confval:`source_suffix`, this will allow you to properly link to the
-   original source file.
-
-.. data:: parents
-
-   A list of parent documents for navigation, structured like the :data:`next`
-   item.
-
-.. data:: prev
-
-   Like :data:`next`, but for the previous page.
-
-.. data:: sourcename
-
-   The name of the copied source file for the current document.  This is only
-   nonempty if the :confval:`html_copy_source` value is ``True``.
-   This has empty value on creating automatically-generated files.
-
-.. data:: toc
-
-   The local table of contents for the current page, rendered as HTML bullet
-   lists.
-
-.. data:: toctree
-
-   A callable yielding the global TOC tree containing the current page, rendered
-   as HTML bullet lists.  Optional keyword arguments:
-
-   ``collapse``
-     If true, all TOC entries that are not ancestors of the current page are
-     collapsed.
-     ``True`` by default.
-
-   ``maxdepth``
-     The maximum depth of the tree. Set it to ``-1`` to allow unlimited depth.
-     Defaults to the max depth selected in the toctree directive.
-
-   ``titles_only``
-     If true, put only top-level document titles in the tree.
-     ``False`` by default.
-
-   ``includehidden``
-     If true, the ToC tree will also contain hidden entries.
-     ``False`` by default.

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/tutorial Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/advanced Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/advanced/setuptools.rst Deleted

@@ -1,196 +0,0 @@
-.. _setuptools:
-
-Setuptools integration
-======================
-
-Sphinx supports integration with setuptools and distutils through a custom
-command - :class:`~sphinx.setup_command.BuildDoc`.
-
-Using setuptools integration
-----------------------------
-
-The Sphinx build can then be triggered from distutils, and some Sphinx
-options can be set in ``setup.py`` or ``setup.cfg`` instead of Sphinx's own
-configuration file.
-
-For instance, from ``setup.py``::
-
-    # this is only necessary when not using setuptools/distribute
-    from sphinx.setup_command import BuildDoc
-    cmdclass = {'build_sphinx': BuildDoc}
-
-    name = 'My project'
-    version = '1.2'
-    release = '1.2.0'
-    setup(
-        name=name,
-        author='Bernard Montgomery',
-        version=release,
-        cmdclass=cmdclass,
-        # these are optional and override conf.py settings
-        command_options={
-            'build_sphinx': {
-                'project': ('setup.py', name),
-                'version': ('setup.py', version),
-                'release': ('setup.py', release),
-                'source_dir': ('setup.py', 'doc')}},
-    )
-
-.. note::
-
-    If you set Sphinx options directly in the ``setup()`` command, replace
-    hyphens in variable names with underscores. In the example above,
-    ``source-dir`` becomes ``source_dir``.
-
-Or add this section in ``setup.cfg``::
-
-    build_sphinx
-    project = 'My project'
-    version = 1.2
-    release = 1.2.0
-    source-dir = 'doc'
-
-Once configured, call this by calling the relevant command on ``setup.py``::
-
-    $ python setup.py build_sphinx
-
-Options for setuptools integration
-----------------------------------
-
-.. setuptools-confval:: fresh-env
-
-   A boolean that determines whether the saved environment should be discarded
-   on build. Default is false.
-
-   This can also be set by passing the `-E` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -E
-
-.. setuptools-confval:: all-files
-
-   A boolean that determines whether all files should be built from scratch.
-   Default is false.
-
-   This can also be set by passing the `-a` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -a
-
-.. setuptools-confval:: source-dir
-
-   The target source directory. This can be relative to the ``setup.py`` or
-   ``setup.cfg`` file, or it can be absolute.  It defaults to ``./doc`` or
-   ``./docs`` if either contains a file named ``conf.py`` (checking ``./doc``
-   first); otherwise it defaults to the current directory.
-
-   This can also be set by passing the `-s` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -s $SOURCE_DIR
-
-.. setuptools-confval:: build-dir
-
-   The target build directory. This can be relative to the ``setup.py`` or
-   ``setup.cfg`` file, or it can be absolute. Default is ``./build/sphinx``.
-
-.. setuptools-confval:: config-dir
-
-   Location of the configuration directory. This can be relative to the
-   ``setup.py`` or ``setup.cfg`` file, or it can be absolute. Default is to use
-   `source-dir`.
-
-   This can also be set by passing the `-c` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -c $CONFIG_DIR
-
-   .. versionadded:: 1.0
-
-.. setuptools-confval:: builder
-
-   The builder or list of builders to use. Default is ``html``.
-
-   This can also be set by passing the `-b` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -b $BUILDER
-
-   .. versionchanged:: 1.6
-      This can now be a comma- or space-separated list of builders
-
-.. setuptools-confval:: warning-is-error
-
-   A boolean that ensures Sphinx warnings will result in a failed build.
-   Default is false.
-
-   This can also be set by passing the `-W` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -W
-
-   .. versionadded:: 1.5
-
-.. setuptools-confval:: project
-
-   The documented project's name. Default is ``''``.
-
-   .. versionadded:: 1.0
-
-.. setuptools-confval:: version
-
-   The short X.Y version. Default is ``''``.
-
-   .. versionadded:: 1.0
-
-.. setuptools-confval:: release
-
-   The full version, including alpha/beta/rc tags. Default is ``''``.
-
-   .. versionadded:: 1.0
-
-.. setuptools-confval:: today
-
-   How to format the current date, used as the replacement for ``|today|``.
-   Default is ``''``.
-
-   .. versionadded:: 1.0
-
-.. setuptools-confval:: link-index
-
-   A boolean that ensures index.html will be linked to the root doc. Default
-   is false.
-
-   This can also be set by passing the `-i` flag to ``setup.py``:
-
-   .. code-block:: console
-
-      $ python setup.py build_sphinx -i
-
-   .. versionadded:: 1.0
-
-.. setuptools-confval:: copyright
-
-   The copyright string. Default is ``''``.
-
-   .. versionadded:: 1.3
-
-.. setuptools-confval:: nitpicky
-
-   Run in nit-picky mode.  Currently, this generates warnings for all missing
-   references.  See the config value :confval:`nitpick_ignore` for a way to
-   exclude some references as "known missing".
-
-   .. versionadded:: 1.8
-
-.. setuptools-confval:: pdb
-
-   A boolean to configure ``pdb`` on exception. Default is false.
-
-   .. versionadded:: 1.5

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/advanced/websupport Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/builders Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/restructuredtext Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/setup.cfg Deleted

@@ -1,80 +0,0 @@
-metadata
-license_file = LICENSE
-
-egg_info
-tag_build = 
-tag_date = 0
-
-aliases
-release = egg_info -Db ''
-upload = upload --sign --identity=36580288
-
-build_sphinx
-warning-is-error = 1
-
-extract_messages
-mapping_file = babel.cfg
-output_file = sphinx/locale/sphinx.pot
-keywords = _ __ l_ lazy_gettext
-
-update_catalog
-input_file = sphinx/locale/sphinx.pot
-domain = sphinx
-output_dir = sphinx/locale/
-
-compile_catalog
-domain = sphinx
-directory = sphinx/locale/
-
-flake8
-max-line-length = 95
-ignore = E116,E241,E251,E741,W504,I101
-exclude = .git,.tox,.venv,tests/roots/*,build/*,doc/_build/*,sphinx/search/*,doc/usage/extensions/example*.py
-application-import-names = sphinx
-import-order-style = smarkets
-per-file-ignores = 
-	tests/*: E501
-
-flake8:local-plugins
-extension = 
-	X101 = utils.checks:sphinx_has_header
-paths = 
-	.
-
-isort
-line_length = 95
-
-mypy
-python_version = 3.6
-disallow_incomplete_defs = True
-show_column_numbers = True
-show_error_context = True
-ignore_missing_imports = True
-follow_imports = skip
-check_untyped_defs = True
-warn_unused_ignores = True
-strict_optional = False
-
-tool:pytest
-filterwarnings = 
-	all
-	ignore::DeprecationWarning:docutils.io
-	ignore::DeprecationWarning:pyximport.pyximport
-	ignore::ImportWarning:importlib._bootstrap
-markers = 
-	apidoc
-	setup_command
-testpaths = tests
-
-coverage:run
-branch = True
-parallel = True
-source = sphinx
-
-coverage:report
-exclude_lines = 
-	pragma: no cover
-	raise NotImplementedError
-	if __name__ == .__main__.:
-ignore_errors = True
-

_service:tar_scm:Sphinx-4.4.0.tar.gz/setup.py Deleted

@@ -1,250 +0,0 @@
-import os
-import sys
-from io import StringIO
-
-from setuptools import find_packages, setup
-
-import sphinx
-
-with open('README.rst') as f:
-    long_desc = f.read()
-
-if sys.version_info < (3, 6):
-    print('ERROR: Sphinx requires at least Python 3.6 to run.')
-    sys.exit(1)
-
-install_requires = 
-    'sphinxcontrib-applehelp',
-    'sphinxcontrib-devhelp',
-    'sphinxcontrib-jsmath',
-    'sphinxcontrib-htmlhelp>=2.0.0',
-    'sphinxcontrib-serializinghtml>=1.1.5',
-    'sphinxcontrib-qthelp',
-    'Jinja2>=2.3',
-    'Pygments>=2.0',
-    'docutils>=0.14,<0.18',
-    'snowballstemmer>=1.1',
-    'babel>=1.3',
-    'alabaster>=0.7,<0.8',
-    'imagesize',
-    'requests>=2.5.0',
-    'packaging',
-    "importlib-metadata>=4.4; python_version < '3.10'",
-
-
-extras_require = {
-    # Environment Marker works for wheel 0.24 or later
-    ':sys_platform=="win32"': 
-        'colorama>=0.3.5',
-    ,
-    'docs': 
-        'sphinxcontrib-websupport',
-    ,
-    'lint': 
-        'flake8>=3.5.0',
-        'isort',
-        'mypy>=0.931',
-        'docutils-stubs',
-        "types-typed-ast",
-        "types-requests",
-    ,
-    'test': 
-        'pytest',
-        'pytest-cov',
-        'html5lib',
-        "typed_ast; python_version < '3.8'",
-        'cython',
-    ,
-}
-
-# Provide a "compile_catalog" command that also creates the translated
-# JavaScript files if Babel is available.
-
-cmdclass = {}
-
-
-class Tee:
-    def __init__(self, stream):
-        self.stream = stream
-        self.buffer = StringIO()
-
-    def write(self, s):
-        self.stream.write(s)
-        self.buffer.write(s)
-
-    def flush(self):
-        self.stream.flush()
-
-
-try:
-    from json import dump
-
-    from babel.messages.frontend import compile_catalog
-    from babel.messages.pofile import read_po
-except ImportError:
-    pass
-else:
-    class compile_catalog_plusjs(compile_catalog):
-        """
-        An extended command that writes all message strings that occur in
-        JavaScript files to a JavaScript file along with the .mo file.
-
-        Unfortunately, babel's setup command isn't built very extensible, so
-        most of the run() code is duplicated here.
-        """
-
-        def run(self):
-            try:
-                sys.stderr = Tee(sys.stderr)
-                compile_catalog.run(self)
-            finally:
-                if sys.stderr.buffer.getvalue():
-                    print("Compiling failed.")
-                    sys.exit(1)
-
-            if isinstance(self.domain, list):
-                for domain in self.domain:
-                    self._run_domain_js(domain)
-            else:
-                self._run_domain_js(self.domain)
-
-        def _run_domain_js(self, domain):
-            po_files = 
-            js_files = 
-
-            if not self.input_file:
-                if self.locale:
-                    po_files.append((self.locale,
-                                     os.path.join(self.directory, self.locale,
-                                                  'LC_MESSAGES',
-                                                  domain + '.po')))
-                    js_files.append(os.path.join(self.directory, self.locale,
-                                                 'LC_MESSAGES',
-                                                 domain + '.js'))
-                else:
-                    for locale in os.listdir(self.directory):
-                        po_file = os.path.join(self.directory, locale,
-                                               'LC_MESSAGES',
-                                               domain + '.po')
-                        if os.path.exists(po_file):
-                            po_files.append((locale, po_file))
-                            js_files.append(os.path.join(self.directory, locale,
-                                                         'LC_MESSAGES',
-                                                         domain + '.js'))
-            else:
-                po_files.append((self.locale, self.input_file))
-                if self.output_file:
-                    js_files.append(self.output_file)
-                else:
-                    js_files.append(os.path.join(self.directory, self.locale,
-                                                 'LC_MESSAGES',
-                                                 domain + '.js'))
-
-            for js_file, (locale, po_file) in zip(js_files, po_files):
-                with open(po_file, encoding='utf8') as infile:
-                    catalog = read_po(infile, locale)
-
-                if catalog.fuzzy and not self.use_fuzzy:
-                    continue
-
-                self.log.info('writing JavaScript strings in catalog %r to %r',
-                              po_file, js_file)
-
-                jscatalog = {}
-                for message in catalog:
-                    if any(x0.endswith(('.js', '.js_t', '.html'))
-                           for x in message.locations):
-                        msgid = message.id
-                        if isinstance(msgid, (list, tuple)):
-                            msgid = msgid0
-                        jscatalogmsgid = message.string
-
-                with open(js_file, 'wt', encoding='utf8') as outfile:
-                    outfile.write('Documentation.addTranslations(')
-                    dump({
-                        'messages': jscatalog,
-                        'plural_expr': catalog.plural_expr,
-                        'locale': str(catalog.locale)
-                    }, outfile, sort_keys=True, indent=4)
-                    outfile.write(');')
-
-    cmdclass'compile_catalog' = compile_catalog_plusjs
-
-
-setup(
-    name='Sphinx',
-    version=sphinx.__version__,
-    url='https://www.sphinx-doc.org/',
-    download_url='https://pypi.org/project/Sphinx/',
-    license='BSD',
-    author='Georg Brandl',
-    author_email='georg@python.org',
-    description='Python documentation generator',
-    long_description=long_desc,
-    long_description_content_type='text/x-rst',
-    project_urls={
-        "Code": "https://github.com/sphinx-doc/sphinx",
-        "Issue tracker": "https://github.com/sphinx-doc/sphinx/issues",
-    },
-    zip_safe=False,
-    classifiers=
-        'Development Status :: 5 - Production/Stable',
-        'Environment :: Console',
-        'Environment :: Web Environment',
-        'Intended Audience :: Developers',
-        'Intended Audience :: Education',
-        'Intended Audience :: End Users/Desktop',
-        'Intended Audience :: Science/Research',
-        'Intended Audience :: System Administrators',
-        'License :: OSI Approved :: BSD License',
-        'Operating System :: OS Independent',
-        'Programming Language :: Python',
-        'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3 :: Only',
-        'Programming Language :: Python :: 3.6',
-        'Programming Language :: Python :: 3.7',
-        'Programming Language :: Python :: 3.8',
-        'Programming Language :: Python :: 3.9',
-        'Programming Language :: Python :: 3.10',
-        'Programming Language :: Python :: Implementation :: CPython',
-        'Programming Language :: Python :: Implementation :: PyPy',
-        'Framework :: Setuptools Plugin',
-        'Framework :: Sphinx',
-        'Framework :: Sphinx :: Extension',
-        'Framework :: Sphinx :: Theme',
-        'Topic :: Documentation',
-        'Topic :: Documentation :: Sphinx',
-        'Topic :: Internet :: WWW/HTTP :: Site Management',
-        'Topic :: Printing',
-        'Topic :: Software Development',
-        'Topic :: Software Development :: Documentation',
-        'Topic :: Text Processing',
-        'Topic :: Text Processing :: General',
-        'Topic :: Text Processing :: Indexing',
-        'Topic :: Text Processing :: Markup',
-        'Topic :: Text Processing :: Markup :: HTML',
-        'Topic :: Text Processing :: Markup :: LaTeX',
-        'Topic :: Utilities',
-    ,
-    platforms='any',
-    packages=find_packages(exclude='tests', 'utils'),
-    package_data = {
-        'sphinx': 'py.typed',
-    },
-    include_package_data=True,
-    entry_points={
-        'console_scripts': 
-            'sphinx-build = sphinx.cmd.build:main',
-            'sphinx-quickstart = sphinx.cmd.quickstart:main',
-            'sphinx-apidoc = sphinx.ext.apidoc:main',
-            'sphinx-autogen = sphinx.ext.autosummary.generate:main',
-        ,
-        'distutils.commands': 
-            'build_sphinx = sphinx.setup_command:BuildDoc',
-        ,
-    },
-    python_requires=">=3.6",
-    install_requires=install_requires,
-    extras_require=extras_require,
-    cmdclass=cmdclass,
-)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/html Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/cmd Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/directives Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/adapters Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/deprecated.py Deleted

@@ -1,126 +0,0 @@
-"""
-    sphinx.ext.autodoc.deprecated
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    The deprecated Documenters for autodoc.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any
-
-from sphinx.deprecation import RemovedInSphinx50Warning
-from sphinx.ext.autodoc import (AttributeDocumenter, DataDocumenter, FunctionDocumenter,
-                                MethodDocumenter)
-
-
-class SingledispatchFunctionDocumenter(FunctionDocumenter):
-    """
-    Used to be a specialized Documenter subclass for singledispatch'ed functions.
-
-    Retained for backwards compatibility, now does the same as the FunctionDocumenter
-    """
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)
-
-
-class DataDeclarationDocumenter(DataDocumenter):
-    """
-    Specialized Documenter subclass for data that cannot be imported
-    because they are declared without initial value (refs: PEP-526).
-    """
-    objtype = 'datadecl'
-    directivetype = 'data'
-    member_order = 60
-
-    # must be higher than AttributeDocumenter
-    priority = 11
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)
-
-
-class TypeVarDocumenter(DataDocumenter):
-    """
-    Specialized Documenter subclass for TypeVars.
-    """
-
-    objtype = 'typevar'
-    directivetype = 'data'
-    priority = DataDocumenter.priority + 1  # type: ignore
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)
-
-
-class SingledispatchMethodDocumenter(MethodDocumenter):
-    """
-    Used to be a specialized Documenter subclass for singledispatch'ed methods.
-
-    Retained for backwards compatibility, now does the same as the MethodDocumenter
-    """
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)
-
-
-class InstanceAttributeDocumenter(AttributeDocumenter):
-    """
-    Specialized Documenter subclass for attributes that cannot be imported
-    because they are instance attributes (e.g. assigned in __init__).
-    """
-    objtype = 'instanceattribute'
-    directivetype = 'attribute'
-    member_order = 60
-
-    # must be higher than AttributeDocumenter
-    priority = 11
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)
-
-
-class SlotsAttributeDocumenter(AttributeDocumenter):
-    """
-    Specialized Documenter subclass for attributes that cannot be imported
-    because they are attributes in __slots__.
-    """
-    objtype = 'slotsattribute'
-    directivetype = 'attribute'
-    member_order = 60
-
-    # must be higher than AttributeDocumenter
-    priority = 11
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)
-
-
-class GenericAliasDocumenter(DataDocumenter):
-    """
-    Specialized Documenter subclass for GenericAliases.
-    """
-
-    objtype = 'genericalias'
-    directivetype = 'data'
-    priority = DataDocumenter.priority + 1  # type: ignore
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn("%s is deprecated." % self.__class__.__name__,
-                      RemovedInSphinx50Warning, stacklevel=2)
-        super().__init__(*args, **kwargs)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autosummary Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autosummary/templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autosummary/templates/autosummary Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/napoleon Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/napoleon/iterators.py Deleted

@@ -1,237 +0,0 @@
-"""
-    sphinx.ext.napoleon.iterators
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-    A collection of helpful iterators.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import collections
-from typing import Any, Iterable, Optional
-
-
-class peek_iter:
-    """An iterator object that supports peeking ahead.
-
-    Parameters
-    ----------
-    o : iterable or callable
-        `o` is interpreted very differently depending on the presence of
-        `sentinel`.
-
-        If `sentinel` is not given, then `o` must be a collection object
-        which supports either the iteration protocol or the sequence protocol.
-
-        If `sentinel` is given, then `o` must be a callable object.
-
-    sentinel : any value, optional
-        If given, the iterator will call `o` with no arguments for each
-        call to its `next` method; if the value returned is equal to
-        `sentinel`, :exc:`StopIteration` will be raised, otherwise the
-        value will be returned.
-
-    See Also
-    --------
-    `peek_iter` can operate as a drop in replacement for the built-in
-    `iter <https://docs.python.org/3/library/functions.html#iter>`_ function.
-
-    Attributes
-    ----------
-    sentinel
-        The value used to indicate the iterator is exhausted. If `sentinel`
-        was not given when the `peek_iter` was instantiated, then it will
-        be set to a new object instance: ``object()``.
-
-    """
-    def __init__(self, *args: Any) -> None:
-        """__init__(o, sentinel=None)"""
-        self._iterable: Iterable = iter(*args)
-        self._cache: collections.deque = collections.deque()
-        if len(args) == 2:
-            self.sentinel = args1
-        else:
-            self.sentinel = object()
-
-    def __iter__(self) -> "peek_iter":
-        return self
-
-    def __next__(self, n: int = None) -> Any:
-        return self.next(n)
-
-    def _fillcache(self, n: Optionalint) -> None:
-        """Cache `n` items. If `n` is 0 or None, then 1 item is cached."""
-        if not n:
-            n = 1
-        try:
-            while len(self._cache) < n:
-                self._cache.append(next(self._iterable))  # type: ignore
-        except StopIteration:
-            while len(self._cache) < n:
-                self._cache.append(self.sentinel)
-
-    def has_next(self) -> bool:
-        """Determine if iterator is exhausted.
-
-        Returns
-        -------
-        bool
-            True if iterator has more items, False otherwise.
-
-        Note
-        ----
-        Will never raise :exc:`StopIteration`.
-
-        """
-        return self.peek() != self.sentinel
-
-    def next(self, n: int = None) -> Any:
-        """Get the next item or `n` items of the iterator.
-
-        Parameters
-        ----------
-        n : int or None
-            The number of items to retrieve. Defaults to None.
-
-        Returns
-        -------
-        item or list of items
-            The next item or `n` items of the iterator. If `n` is None, the
-            item itself is returned. If `n` is an int, the items will be
-            returned in a list. If `n` is 0, an empty list is returned.
-
-        Raises
-        ------
-        StopIteration
-            Raised if the iterator is exhausted, even if `n` is 0.
-
-        """
-        self._fillcache(n)
-        if not n:
-            if self._cache0 == self.sentinel:
-                raise StopIteration
-            if n is None:
-                result = self._cache.popleft()
-            else:
-                result = 
-        else:
-            if self._cachen - 1 == self.sentinel:
-                raise StopIteration
-            result = self._cache.popleft() for i in range(n)
-        return result
-
-    def peek(self, n: Optionalint = None) -> Any:
-        """Preview the next item or `n` items of the iterator.
-
-        The iterator is not advanced when peek is called.
-
-        Returns
-        -------
-        item or list of items
-            The next item or `n` items of the iterator. If `n` is None, the
-            item itself is returned. If `n` is an int, the items will be
-            returned in a list. If `n` is 0, an empty list is returned.
-
-            If the iterator is exhausted, `peek_iter.sentinel` is returned,
-            or placed as the last item in the returned list.
-
-        Note
-        ----
-        Will never raise :exc:`StopIteration`.
-
-        """
-        self._fillcache(n)
-        if n is None:
-            result = self._cache0
-        else:
-            result = self._cachei for i in range(n)
-        return result
-
-
-class modify_iter(peek_iter):
-    """An iterator object that supports modifying items as they are returned.
-
-    Parameters
-    ----------
-    o : iterable or callable
-        `o` is interpreted very differently depending on the presence of
-        `sentinel`.
-
-        If `sentinel` is not given, then `o` must be a collection object
-        which supports either the iteration protocol or the sequence protocol.
-
-        If `sentinel` is given, then `o` must be a callable object.
-
-    sentinel : any value, optional
-        If given, the iterator will call `o` with no arguments for each
-        call to its `next` method; if the value returned is equal to
-        `sentinel`, :exc:`StopIteration` will be raised, otherwise the
-        value will be returned.
-
-    modifier : callable, optional
-        The function that will be used to modify each item returned by the
-        iterator. `modifier` should take a single argument and return a
-        single value. Defaults to ``lambda x: x``.
-
-        If `sentinel` is not given, `modifier` must be passed as a keyword
-        argument.
-
-    Attributes
-    ----------
-    modifier : callable
-        `modifier` is called with each item in `o` as it is iterated. The
-        return value of `modifier` is returned in lieu of the item.
-
-        Values returned by `peek` as well as `next` are affected by
-        `modifier`. However, `modify_iter.sentinel` is never passed through
-        `modifier`; it will always be returned from `peek` unmodified.
-
-    Example
-    -------
-    >>> a = "     A list    ",
-    ...      "   of strings  ",
-    ...      "      with     ",
-    ...      "      extra    ",
-    ...      "   whitespace. "
-    >>> modifier = lambda s: s.strip().replace('with', 'without')
-    >>> for s in modify_iter(a, modifier=modifier):
-    ...   print('"%s"' % s)
-    "A list"
-    "of strings"
-    "without"
-    "extra"
-    "whitespace."
-
-    """
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        """__init__(o, sentinel=None, modifier=lambda x: x)"""
-        if 'modifier' in kwargs:
-            self.modifier = kwargs'modifier'
-        elif len(args) > 2:
-            self.modifier = args2
-            args = args:2
-        else:
-            self.modifier = lambda x: x
-        if not callable(self.modifier):
-            raise TypeError('modify_iter(o, modifier): '
-                            'modifier must be callable')
-        super().__init__(*args)
-
-    def _fillcache(self, n: Optionalint) -> None:
-        """Cache `n` modified items. If `n` is 0 or None, 1 item is cached.
-
-        Each item returned by the iterator is passed through the
-        `modify_iter.modified` function before being cached.
-
-        """
-        if not n:
-            n = 1
-        try:
-            while len(self._cache) < n:
-                self._cache.append(self.modifier(next(self._iterable)))  # type: ignore
-        except StopIteration:
-            while len(self._cache) < n:
-                self._cache.append(self.sentinel)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ar Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ar/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bg Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bg/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bn Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bn/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ca Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ca/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cak Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cak/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cs Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cs/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cy Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cy/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/da Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/da/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/de Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/de/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/el Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/el/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_FR Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_FR/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_GB Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_GB/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_HK Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_HK/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eo/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/es Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/es/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/et Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/et/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eu Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eu/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fa Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fa/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fi Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fi/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr_FR Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/he Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/he/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi_IN Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hr Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hr/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hu Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hu/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/id Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/id/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/is Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/is/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/it Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/it/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ja Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ja/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ko Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ko/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lt/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lv Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lv/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/mk Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/mk/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nb_NO Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ne Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ne/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nl Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nl/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pl Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pl/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_BR Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_PT Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ro Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ro/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ru Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ru/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/si Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/si/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sk Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sk/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sl Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sl/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sq Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sq/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr@latin Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr_RS Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sv Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sv/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ta Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ta/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/te Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/te/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/tr Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/tr/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/uk_UA Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ur Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ur/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/vi Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/vi/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/yue Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/yue/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_CN Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_HK Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW.Big5 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/pycode Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/jssplitter.py Deleted

@@ -1,109 +0,0 @@
-"""
-    sphinx.search.jssplitter
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Provides Python compatible word splitter to JavaScript
-
-    DO NOT EDIT. This is generated by utils/jssplitter_generator.py
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-splitter_code = """
-
-var splitChars = (function() {
-    var result = {};
-    var singles = 96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648,
-         1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702,
-         2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971,
-         2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345,
-         3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761,
-         3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823,
-         4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125,
-         8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695,
-         11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587,
-         43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141;
-    var i, j, start, end;
-    for (i = 0; i < singles.length; i++) {
-        resultsinglesi = true;
-    }
-    var ranges = 0, 47, 58, 64, 91, 94, 123, 169, 171, 177, 182, 184, 706, 709,
-         722, 735, 741, 747, 751, 879, 888, 889, 894, 901, 1154, 1161,
-         1318, 1328, 1367, 1368, 1370, 1376, 1416, 1487, 1515, 1519, 1523, 1568,
-         1611, 1631, 1642, 1645, 1750, 1764, 1767, 1773, 1789, 1790, 1792, 1807,
-         1840, 1868, 1958, 1968, 1970, 1983, 2027, 2035, 2038, 2041, 2043, 2047,
-         2070, 2073, 2075, 2083, 2085, 2087, 2089, 2307, 2362, 2364, 2366, 2383,
-         2385, 2391, 2402, 2405, 2419, 2424, 2432, 2436, 2445, 2446, 2449, 2450,
-         2483, 2485, 2490, 2492, 2494, 2509, 2511, 2523, 2530, 2533, 2546, 2547,
-         2554, 2564, 2571, 2574, 2577, 2578, 2618, 2648, 2655, 2661, 2672, 2673,
-         2677, 2692, 2746, 2748, 2750, 2767, 2769, 2783, 2786, 2789, 2800, 2820,
-         2829, 2830, 2833, 2834, 2874, 2876, 2878, 2907, 2914, 2917, 2930, 2946,
-         2955, 2957, 2966, 2968, 2976, 2978, 2981, 2983, 2987, 2989, 3002, 3023,
-         3025, 3045, 3059, 3076, 3130, 3132, 3134, 3159, 3162, 3167, 3170, 3173,
-         3184, 3191, 3199, 3204, 3258, 3260, 3262, 3293, 3298, 3301, 3312, 3332,
-         3386, 3388, 3390, 3423, 3426, 3429, 3446, 3449, 3456, 3460, 3479, 3481,
-         3518, 3519, 3527, 3584, 3636, 3647, 3655, 3663, 3674, 3712, 3717, 3718,
-         3723, 3724, 3726, 3731, 3752, 3753, 3764, 3772, 3774, 3775, 3783, 3791,
-         3802, 3803, 3806, 3839, 3841, 3871, 3892, 3903, 3949, 3975, 3980, 4095,
-         4139, 4158, 4170, 4175, 4182, 4185, 4190, 4192, 4194, 4196, 4199, 4205,
-         4209, 4212, 4226, 4237, 4250, 4255, 4294, 4303, 4349, 4351, 4686, 4687,
-         4702, 4703, 4750, 4751, 4790, 4791, 4806, 4807, 4886, 4887, 4955, 4968,
-         4989, 4991, 5008, 5023, 5109, 5120, 5741, 5742, 5787, 5791, 5867, 5869,
-         5873, 5887, 5906, 5919, 5938, 5951, 5970, 5983, 6001, 6015, 6068, 6102,
-         6104, 6107, 6109, 6111, 6122, 6127, 6138, 6159, 6170, 6175, 6264, 6271,
-         6315, 6319, 6390, 6399, 6429, 6469, 6510, 6511, 6517, 6527, 6572, 6592,
-         6600, 6607, 6619, 6655, 6679, 6687, 6741, 6783, 6794, 6799, 6810, 6822,
-         6824, 6916, 6964, 6980, 6988, 6991, 7002, 7042, 7073, 7085, 7098, 7167,
-         7204, 7231, 7242, 7244, 7294, 7400, 7410, 7423, 7616, 7679, 7958, 7959,
-         7966, 7967, 8006, 8007, 8014, 8015, 8062, 8063, 8127, 8129, 8141, 8143,
-         8148, 8149, 8156, 8159, 8173, 8177, 8189, 8303, 8306, 8307, 8314, 8318,
-         8330, 8335, 8341, 8449, 8451, 8454, 8456, 8457, 8470, 8472, 8478, 8483,
-         8506, 8507, 8512, 8516, 8522, 8525, 8586, 9311, 9372, 9449, 9472, 10101,
-         10132, 11263, 11493, 11498, 11503, 11516, 11518, 11519, 11558, 11567,
-         11622, 11630, 11632, 11647, 11671, 11679, 11743, 11822, 11824, 12292,
-         12296, 12320, 12330, 12336, 12342, 12343, 12349, 12352, 12439, 12444,
-         12544, 12548, 12590, 12592, 12687, 12689, 12694, 12703, 12728, 12783,
-         12800, 12831, 12842, 12880, 12896, 12927, 12938, 12976, 12992, 13311,
-         19894, 19967, 40908, 40959, 42125, 42191, 42238, 42239, 42509, 42511,
-         42540, 42559, 42592, 42593, 42607, 42622, 42648, 42655, 42736, 42774,
-         42784, 42785, 42889, 42890, 42893, 43002, 43043, 43055, 43062, 43071,
-         43124, 43137, 43188, 43215, 43226, 43249, 43256, 43258, 43260, 43263,
-         43302, 43311, 43335, 43359, 43389, 43395, 43443, 43470, 43482, 43519,
-         43561, 43583, 43596, 43599, 43610, 43615, 43639, 43641, 43643, 43647,
-         43698, 43700, 43703, 43704, 43710, 43711, 43715, 43738, 43742, 43967,
-         44003, 44015, 44026, 44031, 55204, 55215, 55239, 55242, 55292, 55295,
-         57344, 63743, 64046, 64047, 64110, 64111, 64218, 64255, 64263, 64274,
-         64280, 64284, 64434, 64466, 64830, 64847, 64912, 64913, 64968, 65007,
-         65020, 65135, 65277, 65295, 65306, 65312, 65339, 65344, 65371, 65381,
-         65471, 65473, 65480, 65481, 65488, 65489, 65496, 65497;
-    for (i = 0; i < ranges.length; i++) {
-        start = rangesi0;
-        end = rangesi1;
-        for (j = start; j <= end; j++) {
-            resultj = true;
-        }
-    }
-    return result;
-})();
-
-function splitQuery(query) {
-    var result = ;
-    var start = -1;
-    for (var i = 0; i < query.length; i++) {
-        if (splitCharsquery.charCodeAt(i)) {
-            if (start !== -1) {
-                result.push(query.slice(start, i));
-                start = -1;
-            }
-        } else if (start === -1) {
-            start = i;
-        }
-    }
-    if (start !== -1) {
-        result.push(query.slice(start));
-    }
-    return result;
-}
-
-"""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/minified-js Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/non-minified-js Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/setup_command.py Deleted

@@ -1,189 +0,0 @@
-"""
-    sphinx.setup_command
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Setuptools/distutils commands to assist the building of sphinx
-    documentation.
-
-    :author: Sebastian Wiesner
-    :contact: basti.wiesner@gmx.net
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import os
-import sys
-from distutils.cmd import Command
-from distutils.errors import DistutilsExecError
-from io import StringIO
-from typing import Any, Dict
-
-from sphinx.application import Sphinx
-from sphinx.cmd.build import handle_exception
-from sphinx.util.console import color_terminal, nocolor
-from sphinx.util.docutils import docutils_namespace, patch_docutils
-from sphinx.util.osutil import abspath
-
-
-class BuildDoc(Command):
-    """
-    Distutils command to build Sphinx documentation.
-
-    The Sphinx build can then be triggered from distutils, and some Sphinx
-    options can be set in ``setup.py`` or ``setup.cfg`` instead of Sphinx's
-    own configuration file.
-
-    For instance, from `setup.py`::
-
-       # this is only necessary when not using setuptools/distribute
-       from sphinx.setup_command import BuildDoc
-       cmdclass = {'build_sphinx': BuildDoc}
-
-       name = 'My project'
-       version = '1.2'
-       release = '1.2.0'
-       setup(
-           name=name,
-           author='Bernard Montgomery',
-           version=release,
-           cmdclass=cmdclass,
-           # these are optional and override conf.py settings
-           command_options={
-               'build_sphinx': {
-                   'project': ('setup.py', name),
-                   'version': ('setup.py', version),
-                   'release': ('setup.py', release)}},
-       )
-
-    Or add this section in ``setup.cfg``::
-
-       build_sphinx
-       project = 'My project'
-       version = 1.2
-       release = 1.2.0
-    """
-
-    description = 'Build Sphinx documentation'
-    user_options = 
-        ('fresh-env', 'E', 'discard saved environment'),
-        ('all-files', 'a', 'build all files'),
-        ('source-dir=', 's', 'Source directory'),
-        ('build-dir=', None, 'Build directory'),
-        ('config-dir=', 'c', 'Location of the configuration directory'),
-        ('builder=', 'b', 'The builder (or builders) to use. Can be a comma- '
-         'or space-separated list. Defaults to "html"'),
-        ('warning-is-error', 'W', 'Turn warning into errors'),
-        ('project=', None, 'The documented project\'s name'),
-        ('version=', None, 'The short X.Y version'),
-        ('release=', None, 'The full version, including alpha/beta/rc tags'),
-        ('today=', None, 'How to format the current date, used as the '
-         'replacement for |today|'),
-        ('link-index', 'i', 'Link index.html to the master doc'),
-        ('copyright', None, 'The copyright string'),
-        ('pdb', None, 'Start pdb on exception'),
-        ('verbosity', 'v', 'increase verbosity (can be repeated)'),
-        ('nitpicky', 'n', 'nit-picky mode, warn about all missing references'),
-        ('keep-going', None, 'With -W, keep going when getting warnings'),
-    
-    boolean_options = 'fresh-env', 'all-files', 'warning-is-error',
-                       'link-index', 'nitpicky'
-
-    def initialize_options(self) -> None:
-        self.fresh_env = self.all_files = False
-        self.pdb = False
-        self.source_dir: str = None
-        self.build_dir: str = None
-        self.builder = 'html'
-        self.warning_is_error = False
-        self.project = ''
-        self.version = ''
-        self.release = ''
-        self.today = ''
-        self.config_dir: str = None
-        self.link_index = False
-        self.copyright = ''
-        # Link verbosity to distutils' (which uses 1 by default).
-        self.verbosity = self.distribution.verbose - 1  # type: ignore
-        self.traceback = False
-        self.nitpicky = False
-        self.keep_going = False
-
-    def _guess_source_dir(self) -> str:
-        for guess in ('doc', 'docs'):
-            if not os.path.isdir(guess):
-                continue
-            for root, _dirnames, filenames in os.walk(guess):
-                if 'conf.py' in filenames:
-                    return root
-        return os.curdir
-
-    def finalize_options(self) -> None:
-        self.ensure_string_list('builder')
-
-        if self.source_dir is None:
-            self.source_dir = self._guess_source_dir()
-            self.announce('Using source directory %s' % self.source_dir)
-
-        self.ensure_dirname('source_dir')
-
-        if self.config_dir is None:
-            self.config_dir = self.source_dir
-
-        if self.build_dir is None:
-            build = self.get_finalized_command('build')
-            self.build_dir = os.path.join(abspath(build.build_base), 'sphinx')  # type: ignore
-
-        self.doctree_dir = os.path.join(self.build_dir, 'doctrees')
-
-        self.builder_target_dirs = 
-            (builder, os.path.join(self.build_dir, builder))
-            for builder in self.builder
-
-    def run(self) -> None:
-        if not color_terminal():
-            nocolor()
-        if not self.verbose:  # type: ignore
-            status_stream = StringIO()
-        else:
-            status_stream = sys.stdout  # type: ignore
-        confoverrides: Dictstr, Any = {}
-        if self.project:
-            confoverrides'project' = self.project
-        if self.version:
-            confoverrides'version' = self.version
-        if self.release:
-            confoverrides'release' = self.release
-        if self.today:
-            confoverrides'today' = self.today
-        if self.copyright:
-            confoverrides'copyright' = self.copyright
-        if self.nitpicky:
-            confoverrides'nitpicky' = self.nitpicky
-
-        for builder, builder_target_dir in self.builder_target_dirs:
-            app = None
-
-            try:
-                confdir = self.config_dir or self.source_dir
-                with patch_docutils(confdir), docutils_namespace():
-                    app = Sphinx(self.source_dir, self.config_dir,
-                                 builder_target_dir, self.doctree_dir,
-                                 builder, confoverrides, status_stream,
-                                 freshenv=self.fresh_env,
-                                 warningiserror=self.warning_is_error,
-                                 verbosity=self.verbosity, keep_going=self.keep_going)
-                    app.build(force_all=self.all_files)
-                    if app.statuscode:
-                        raise DistutilsExecError(
-                            'caused by %s builder.' % app.builder.name)
-            except Exception as exc:
-                handle_exception(app, self, exc, sys.stderr)
-                if not self.pdb:
-                    raise SystemExit(1) from exc
-
-            if not self.link_index:
-                continue
-
-            src = app.config.root_doc + app.builder.out_suffix  # type: ignore
-            dst = app.builder.get_outfilename('index')  # type: ignore
-            os.symlink(src, dst)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/apidoc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/epub3 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/gettext Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/graphviz Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/htmlhelp Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/imgmath Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/latex Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/quickstart Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/texinfo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs_win Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/agogo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/agogo/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/changes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/jquery-3.5.1.js Deleted

@@ -1,10872 +0,0 @@
-/*!
- * jQuery JavaScript Library v3.5.1
- * https://jquery.com/
- *
- * Includes Sizzle.js
- * https://sizzlejs.com/
- *
- * Copyright JS Foundation and other contributors
- * Released under the MIT license
- * https://jquery.org/license
- *
- * Date: 2020-05-04T22:49Z
- */
-( function( global, factory ) {
-
-	"use strict";
-
-	if ( typeof module === "object" && typeof module.exports === "object" ) {
-
-		// For CommonJS and CommonJS-like environments where a proper `window`
-		// is present, execute the factory and get jQuery.
-		// For environments that do not have a `window` with a `document`
-		// (such as Node.js), expose a factory as module.exports.
-		// This accentuates the need for the creation of a real `window`.
-		// e.g. var jQuery = require("jquery")(window);
-		// See ticket #14549 for more info.
-		module.exports = global.document ?
-			factory( global, true ) :
-			function( w ) {
-				if ( !w.document ) {
-					throw new Error( "jQuery requires a window with a document" );
-				}
-				return factory( w );
-			};
-	} else {
-		factory( global );
-	}
-
-// Pass this if window is not defined yet
-} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
-
-// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
-// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
-// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
-// enough that all such attempts are guarded in a try block.
-"use strict";
-
-var arr = ;
-
-var getProto = Object.getPrototypeOf;
-
-var slice = arr.slice;
-
-var flat = arr.flat ? function( array ) {
-	return arr.flat.call( array );
-} : function( array ) {
-	return arr.concat.apply( , array );
-};
-
-
-var push = arr.push;
-
-var indexOf = arr.indexOf;
-
-var class2type = {};
-
-var toString = class2type.toString;
-
-var hasOwn = class2type.hasOwnProperty;
-
-var fnToString = hasOwn.toString;
-
-var ObjectFunctionString = fnToString.call( Object );
-
-var support = {};
-
-var isFunction = function isFunction( obj ) {
-
-      // Support: Chrome <=57, Firefox <=52
-      // In some browsers, typeof returns "function" for HTML <object> elements
-      // (i.e., `typeof document.createElement( "object" ) === "function"`).
-      // We don't want to classify *any* DOM node as a function.
-      return typeof obj === "function" && typeof obj.nodeType !== "number";
-  };
-
-
-var isWindow = function isWindow( obj ) {
-		return obj != null && obj === obj.window;
-	};
-
-
-var document = window.document;
-
-
-
-	var preservedScriptAttributes = {
-		type: true,
-		src: true,
-		nonce: true,
-		noModule: true
-	};
-
-	function DOMEval( code, node, doc ) {
-		doc = doc || document;
-
-		var i, val,
-			script = doc.createElement( "script" );
-
-		script.text = code;
-		if ( node ) {
-			for ( i in preservedScriptAttributes ) {
-
-				// Support: Firefox 64+, Edge 18+
-				// Some browsers don't support the "nonce" property on scripts.
-				// On the other hand, just using `getAttribute` is not enough as
-				// the `nonce` attribute is reset to an empty string whenever it
-				// becomes browsing-context connected.
-				// See https://github.com/whatwg/html/issues/2369
-				// See https://html.spec.whatwg.org/#nonce-attributes
-				// The `node.getAttribute` check was added for the sake of
-				// `jQuery.globalEval` so that it can fake a nonce-containing node
-				// via an object.
-				val = node i  || node.getAttribute && node.getAttribute( i );
-				if ( val ) {
-					script.setAttribute( i, val );
-				}
-			}
-		}
-		doc.head.appendChild( script ).parentNode.removeChild( script );
-	}
-
-
-function toType( obj ) {
-	if ( obj == null ) {
-		return obj + "";
-	}
-
-	// Support: Android <=2.3 only (functionish RegExp)
-	return typeof obj === "object" || typeof obj === "function" ?
-		class2type toString.call( obj )  || "object" :
-		typeof obj;
-}
-/* global Symbol */
-// Defining this global in .eslintrc.json would create a danger of using the global
-// unguarded in another place, it seems safer to define global only for this module
-
-
-
-var
-	version = "3.5.1",
-
-	// Define a local copy of jQuery
-	jQuery = function( selector, context ) {
-
-		// The jQuery object is actually just the init constructor 'enhanced'
-		// Need init if jQuery is called (just allow error to be thrown if not included)
-		return new jQuery.fn.init( selector, context );
-	};
-
-jQuery.fn = jQuery.prototype = {
-
-	// The current version of jQuery being used
-	jquery: version,
-
-	constructor: jQuery,
-
-	// The default length of a jQuery object is 0
-	length: 0,
-
-	toArray: function() {
-		return slice.call( this );
-	},
-
-	// Get the Nth element in the matched element set OR
-	// Get the whole matched element set as a clean array
-	get: function( num ) {
-
-		// Return all the elements in a clean array
-		if ( num == null ) {
-			return slice.call( this );
-		}
-
-		// Return just the one element from the set
-		return num < 0 ? this num + this.length  : this num ;
-	},
-
-	// Take an array of elements and push it onto the stack
-	// (returning the new matched element set)
-	pushStack: function( elems ) {
-
-		// Build a new jQuery matched element set
-		var ret = jQuery.merge( this.constructor(), elems );
-
-		// Add the old object onto the stack (as a reference)
-		ret.prevObject = this;
-
-		// Return the newly-formed element set
-		return ret;
-	},
-
-	// Execute a callback for every element in the matched set.
-	each: function( callback ) {
-		return jQuery.each( this, callback );
-	},
-
-	map: function( callback ) {
-		return this.pushStack( jQuery.map( this, function( elem, i ) {
-			return callback.call( elem, i, elem );
-		} ) );
-	},
-
-	slice: function() {
-		return this.pushStack( slice.apply( this, arguments ) );
-	},
-
-	first: function() {
-		return this.eq( 0 );
-	},
-
-	last: function() {
-		return this.eq( -1 );
-	},
-
-	even: function() {
-		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
-			return ( i + 1 ) % 2;
-		} ) );
-	},
-
-	odd: function() {
-		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
-			return i % 2;
-		} ) );
-	},
-
-	eq: function( i ) {
-		var len = this.length,
-			j = +i + ( i < 0 ? len : 0 );
-		return this.pushStack( j >= 0 && j < len ?  this j   :  );
-	},
-
-	end: function() {
-		return this.prevObject || this.constructor();
-	},
-
-	// For internal use only.
-	// Behaves like an Array's method, not like a jQuery method.
-	push: push,
-	sort: arr.sort,
-	splice: arr.splice
-};
-
-jQuery.extend = jQuery.fn.extend = function() {
-	var options, name, src, copy, copyIsArray, clone,
-		target = arguments 0  || {},
-		i = 1,
-		length = arguments.length,
-		deep = false;
-
-	// Handle a deep copy situation
-	if ( typeof target === "boolean" ) {
-		deep = target;
-
-		// Skip the boolean and the target
-		target = arguments i  || {};
-		i++;
-	}
-
-	// Handle case when target is a string or something (possible in deep copy)
-	if ( typeof target !== "object" && !isFunction( target ) ) {
-		target = {};
-	}
-
-	// Extend jQuery itself if only one argument is passed
-	if ( i === length ) {
-		target = this;
-		i--;
-	}
-
-	for ( ; i < length; i++ ) {
-
-		// Only deal with non-null/undefined values
-		if ( ( options = arguments i  ) != null ) {
-
-			// Extend the base object
-			for ( name in options ) {
-				copy = options name ;
-
-				// Prevent Object.prototype pollution
-				// Prevent never-ending loop
-				if ( name === "__proto__" || target === copy ) {
-					continue;
-				}
-
-				// Recurse if we're merging plain objects or arrays
-				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
-					( copyIsArray = Array.isArray( copy ) ) ) ) {
-					src = target name ;
-
-					// Ensure proper type for the source value
-					if ( copyIsArray && !Array.isArray( src ) ) {
-						clone = ;
-					} else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) {
-						clone = {};
-					} else {
-						clone = src;
-					}
-					copyIsArray = false;
-
-					// Never move original objects, clone them
-					target name  = jQuery.extend( deep, clone, copy );
-
-				// Don't bring in undefined values
-				} else if ( copy !== undefined ) {
-					target name  = copy;
-				}
-			}
-		}
-	}
-
-	// Return the modified object
-	return target;
-};
-
-jQuery.extend( {
-
-	// Unique for each copy of jQuery on the page
-	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),
-
-	// Assume jQuery is ready without the ready module
-	isReady: true,
-
-	error: function( msg ) {
-		throw new Error( msg );
-	},
-
-	noop: function() {},
-
-	isPlainObject: function( obj ) {
-		var proto, Ctor;
-
-		// Detect obvious negatives
-		// Use toString instead of jQuery.type to catch host objects
-		if ( !obj || toString.call( obj ) !== "object Object" ) {
-			return false;
-		}
-
-		proto = getProto( obj );
-
-		// Objects with no prototype (e.g., `Object.create( null )`) are plain
-		if ( !proto ) {
-			return true;
-		}
-
-		// Objects with prototype are plain iff they were constructed by a global Object function
-		Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
-		return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
-	},
-
-	isEmptyObject: function( obj ) {
-		var name;
-
-		for ( name in obj ) {
-			return false;
-		}
-		return true;
-	},
-
-	// Evaluates a script in a provided context; falls back to the global one
-	// if not specified.
-	globalEval: function( code, options, doc ) {
-		DOMEval( code, { nonce: options && options.nonce }, doc );
-	},
-
-	each: function( obj, callback ) {
-		var length, i = 0;
-
-		if ( isArrayLike( obj ) ) {
-			length = obj.length;
-			for ( ; i < length; i++ ) {
-				if ( callback.call( obj i , i, obj i  ) === false ) {
-					break;
-				}
-			}
-		} else {
-			for ( i in obj ) {
-				if ( callback.call( obj i , i, obj i  ) === false ) {
-					break;
-				}
-			}
-		}
-
-		return obj;
-	},
-
-	// results is for internal usage only
-	makeArray: function( arr, results ) {
-		var ret = results || ;
-
-		if ( arr != null ) {
-			if ( isArrayLike( Object( arr ) ) ) {
-				jQuery.merge( ret,
-					typeof arr === "string" ?
-					 arr  : arr
-				);
-			} else {
-				push.call( ret, arr );
-			}
-		}
-
-		return ret;
-	},
-
-	inArray: function( elem, arr, i ) {
-		return arr == null ? -1 : indexOf.call( arr, elem, i );
-	},
-
-	// Support: Android <=4.0 only, PhantomJS 1 only
-	// push.apply(_, arraylike) throws on ancient WebKit
-	merge: function( first, second ) {
-		var len = +second.length,
-			j = 0,
-			i = first.length;
-
-		for ( ; j < len; j++ ) {
-			first i++  = second j ;
-		}
-
-		first.length = i;
-
-		return first;
-	},
-
-	grep: function( elems, callback, invert ) {
-		var callbackInverse,
-			matches = ,
-			i = 0,
-			length = elems.length,
-			callbackExpect = !invert;
-
-		// Go through the array, only saving the items
-		// that pass the validator function
-		for ( ; i < length; i++ ) {
-			callbackInverse = !callback( elems i , i );
-			if ( callbackInverse !== callbackExpect ) {
-				matches.push( elems i  );
-			}
-		}
-
-		return matches;
-	},
-
-	// arg is for internal usage only
-	map: function( elems, callback, arg ) {
-		var length, value,
-			i = 0,
-			ret = ;
-
-		// Go through the array, translating each of the items to their new values
-		if ( isArrayLike( elems ) ) {
-			length = elems.length;
-			for ( ; i < length; i++ ) {
-				value = callback( elems i , i, arg );
-
-				if ( value != null ) {
-					ret.push( value );
-				}
-			}
-
-		// Go through every key on the object,
-		} else {
-			for ( i in elems ) {
-				value = callback( elems i , i, arg );
-
-				if ( value != null ) {
-					ret.push( value );
-				}
-			}
-		}
-
-		// Flatten any nested arrays
-		return flat( ret );
-	},
-
-	// A global GUID counter for objects
-	guid: 1,
-
-	// jQuery.support is not used in Core but other projects attach their
-	// properties to it so it needs to exist.
-	support: support
-} );
-
-if ( typeof Symbol === "function" ) {
-	jQuery.fn Symbol.iterator  = arr Symbol.iterator ;
-}
-
-// Populate the class2type map
-jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
-function( _i, name ) {
-	class2type "object " + name + ""  = name.toLowerCase();
-} );
-
-function isArrayLike( obj ) {
-
-	// Support: real iOS 8.2 only (not reproducible in simulator)
-	// `in` check used to prevent JIT error (gh-2145)
-	// hasOwn isn't used here due to false negatives
-	// regarding Nodelist length in IE
-	var length = !!obj && "length" in obj && obj.length,
-		type = toType( obj );
-
-	if ( isFunction( obj ) || isWindow( obj ) ) {
-		return false;
-	}
-
-	return type === "array" || length === 0 ||
-		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
-}
-var Sizzle =
-/*!
- * Sizzle CSS Selector Engine v2.3.5
- * https://sizzlejs.com/
- *
- * Copyright JS Foundation and other contributors
- * Released under the MIT license
- * https://js.foundation/
- *
- * Date: 2020-03-14
- */
-( function( window ) {
-var i,
-	support,
-	Expr,
-	getText,
-	isXML,
-	tokenize,
-	compile,
-	select,
-	outermostContext,
-	sortInput,
-	hasDuplicate,
-
-	// Local document vars
-	setDocument,
-	document,
-	docElem,
-	documentIsHTML,
-	rbuggyQSA,
-	rbuggyMatches,
-	matches,
-	contains,
-
-	// Instance-specific data
-	expando = "sizzle" + 1 * new Date(),
-	preferredDoc = window.document,
-	dirruns = 0,
-	done = 0,
-	classCache = createCache(),
-	tokenCache = createCache(),
-	compilerCache = createCache(),
-	nonnativeSelectorCache = createCache(),
-	sortOrder = function( a, b ) {
-		if ( a === b ) {
-			hasDuplicate = true;
-		}
-		return 0;
-	},
-
-	// Instance methods
-	hasOwn = ( {} ).hasOwnProperty,
-	arr = ,
-	pop = arr.pop,
-	pushNative = arr.push,
-	push = arr.push,
-	slice = arr.slice,
-
-	// Use a stripped-down indexOf as it's faster than native
-	// https://jsperf.com/thor-indexof-vs-for/5
-	indexOf = function( list, elem ) {
-		var i = 0,
-			len = list.length;
-		for ( ; i < len; i++ ) {
-			if ( list i  === elem ) {
-				return i;
-			}
-		}
-		return -1;
-	},
-
-	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" +
-		"ismap|loop|multiple|open|readonly|required|scoped",
-
-	// Regular expressions
-
-	// http://www.w3.org/TR/css3-selectors/#whitespace
-	whitespace = "\\x20\\t\\r\\n\\f",
-
-	// https://www.w3.org/TR/css-syntax-3/#ident-token-diagram
-	identifier = "(?:\\\\\\da-fA-F{1,6}" + whitespace +
-		"?|\\\\^\\r\\n\\f|\\w-|^\0-\\x7f)+",
-
-	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
-	attributes = "\\" + whitespace + "*(" + identifier + ")(?:" + whitespace +
-
-		// Operator (capture 2)
-		"*(*^$|!~?=)" + whitespace +
-
-		// "Attribute values must be CSS identifiers capture 5
-		// or strings capture 3 or capture 4"
-		"*(?:'((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\"|(" + identifier + "))|)" +
-		whitespace + "*\\",
-
-	pseudos = ":(" + identifier + ")(?:\$(" +
-
-		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
-		// 1. quoted (capture 3; capture 4 or capture 5)
-		"('((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\")|" +
-
-		// 2. simple (capture 6)
-		"((?:\\\\.|^\\\\()\\|" + attributes + ")*)|" +
-
-		// 3. anything else (capture 2)
-		".*" +
-		")\$|)",
-
-	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
-	rwhitespace = new RegExp( whitespace + "+", "g" ),
-	rtrim = new RegExp( "^" + whitespace + "+|((?:^|^\\\\)(?:\\\\.)*)" +
-		whitespace + "+$", "g" ),
-
-	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
-	rcombinators = new RegExp( "^" + whitespace + "*(>+~|" + whitespace + ")" + whitespace +
-		"*" ),
-	rdescend = new RegExp( whitespace + "|>" ),
-
-	rpseudo = new RegExp( pseudos ),
-	ridentifier = new RegExp( "^" + identifier + "$" ),
-
-	matchExpr = {
-		"ID": new RegExp( "^#(" + identifier + ")" ),
-		"CLASS": new RegExp( "^\\.(" + identifier + ")" ),
-		"TAG": new RegExp( "^(" + identifier + "|*)" ),
-		"ATTR": new RegExp( "^" + attributes ),
-		"PSEUDO": new RegExp( "^" + pseudos ),
-		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\$" +
-			whitespace + "*(even|odd|((+-|)(\\d*)n|)" + whitespace + "*(?:(+-|)" +
-			whitespace + "*(\\d+)|))" + whitespace + "*\$|)", "i" ),
-		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),
-
-		// For use in libraries implementing .is()
-		// We use this for POS matching in `select`
-		"needsContext": new RegExp( "^" + whitespace +
-			"*>+~|:(even|odd|eq|gt|lt|nth|first|last)(?:\$" + whitespace +
-			"*((?:-\\d)?\\d*)" + whitespace + "*\$|)(?=^-|$)", "i" )
-	},
-
-	rhtml = /HTML$/i,
-	rinputs = /^(?:input|select|textarea|button)$/i,
-	rheader = /^h\d$/i,
-
-	rnative = /^^{+\{\s*\native \w/,
-
-	// Easily-parseable/retrievable ID or TAG or CLASS selectors
-	rquickExpr = /^(?:#(\w-+)|(\w+)|\.(\w-+))$/,
-
-	rsibling = /+~/,
-
-	// CSS escapes
-	// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
-	runescape = new RegExp( "\\\\\\da-fA-F{1,6}" + whitespace + "?|\\\\(^\\r\\n\\f)", "g" ),
-	funescape = function( escape, nonHex ) {
-		var high = "0x" + escape.slice( 1 ) - 0x10000;
-
-		return nonHex ?
-
-			// Strip the backslash prefix from a non-hex escape sequence
-			nonHex :
-
-			// Replace a hexadecimal escape sequence with the encoded Unicode code point
-			// Support: IE <=11+
-			// For values outside the Basic Multilingual Plane (BMP), manually construct a
-			// surrogate pair
-			high < 0 ?
-				String.fromCharCode( high + 0x10000 ) :
-				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
-	},
-
-	// CSS string/identifier serialization
-	// https://drafts.csswg.org/cssom/#common-serializing-idioms
-	rcssescape = /(\0-\x1f\x7f|^-?\d)|^-$|^\0-\x1f\x7f-\uFFFF\w-/g,
-	fcssescape = function( ch, asCodePoint ) {
-		if ( asCodePoint ) {
-
-			// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER
-			if ( ch === "\0" ) {
-				return "\uFFFD";
-			}
-
-			// Control characters and (dependent upon position) numbers get escaped as code points
-			return ch.slice( 0, -1 ) + "\\" +
-				ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " ";
-		}
-
-		// Other potentially-special ASCII characters get backslash-escaped
-		return "\\" + ch;
-	},
-
-	// Used for iframes
-	// See setDocument()
-	// Removing the function wrapper causes a "Permission Denied"
-	// error in IE
-	unloadHandler = function() {
-		setDocument();
-	},
-
-	inDisabledFieldset = addCombinator(
-		function( elem ) {
-			return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset";
-		},
-		{ dir: "parentNode", next: "legend" }
-	);
-
-// Optimize for push.apply( _, NodeList )
-try {
-	push.apply(
-		( arr = slice.call( preferredDoc.childNodes ) ),
-		preferredDoc.childNodes
-	);
-
-	// Support: Android<4.0
-	// Detect silently failing push.apply
-	// eslint-disable-next-line no-unused-expressions
-	arr preferredDoc.childNodes.length .nodeType;
-} catch ( e ) {
-	push = { apply: arr.length ?
-
-		// Leverage slice if possible
-		function( target, els ) {
-			pushNative.apply( target, slice.call( els ) );
-		} :
-
-		// Support: IE<9
-		// Otherwise append directly
-		function( target, els ) {
-			var j = target.length,
-				i = 0;
-
-			// Can't trust NodeList.length
-			while ( ( target j++  = els i++  ) ) {}
-			target.length = j - 1;
-		}
-	};
-}
-
-function Sizzle( selector, context, results, seed ) {
-	var m, i, elem, nid, match, groups, newSelector,
-		newContext = context && context.ownerDocument,
-
-		// nodeType defaults to 9, since context defaults to document
-		nodeType = context ? context.nodeType : 9;
-
-	results = results || ;
-
-	// Return early from calls with invalid selector or context
-	if ( typeof selector !== "string" || !selector ||
-		nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {
-
-		return results;
-	}
-
-	// Try to shortcut find operations (as opposed to filters) in HTML documents
-	if ( !seed ) {
-		setDocument( context );
-		context = context || document;
-
-		if ( documentIsHTML ) {
-
-			// If the selector is sufficiently simple, try using a "get*By*" DOM method
-			// (excepting DocumentFragment context, where the methods don't exist)
-			if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) {
-
-				// ID selector
-				if ( ( m = match 1  ) ) {
-
-					// Document context
-					if ( nodeType === 9 ) {
-						if ( ( elem = context.getElementById( m ) ) ) {
-
-							// Support: IE, Opera, Webkit
-							// TODO: identify versions
-							// getElementById can match elements by name instead of ID
-							if ( elem.id === m ) {
-								results.push( elem );
-								return results;
-							}
-						} else {
-							return results;
-						}
-
-					// Element context
-					} else {
-
-						// Support: IE, Opera, Webkit
-						// TODO: identify versions
-						// getElementById can match elements by name instead of ID
-						if ( newContext && ( elem = newContext.getElementById( m ) ) &&
-							contains( context, elem ) &&
-							elem.id === m ) {
-
-							results.push( elem );
-							return results;
-						}
-					}
-
-				// Type selector
-				} else if ( match 2  ) {
-					push.apply( results, context.getElementsByTagName( selector ) );
-					return results;
-
-				// Class selector
-				} else if ( ( m = match 3  ) && support.getElementsByClassName &&
-					context.getElementsByClassName ) {
-
-					push.apply( results, context.getElementsByClassName( m ) );
-					return results;
-				}
-			}
-
-			// Take advantage of querySelectorAll
-			if ( support.qsa &&
-				!nonnativeSelectorCache selector + " "  &&
-				( !rbuggyQSA || !rbuggyQSA.test( selector ) ) &&
-
-				// Support: IE 8 only
-				// Exclude object elements
-				( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) {
-
-				newSelector = selector;
-				newContext = context;
-
-				// qSA considers elements outside a scoping root when evaluating child or
-				// descendant combinators, which is not what we want.
-				// In such cases, we work around the behavior by prefixing every selector in the
-				// list with an ID selector referencing the scope context.
-				// The technique has to be used as well when a leading combinator is used
-				// as such selectors are not recognized by querySelectorAll.
-				// Thanks to Andrew Dupont for this technique.
-				if ( nodeType === 1 &&
-					( rdescend.test( selector ) || rcombinators.test( selector ) ) ) {
-
-					// Expand context for sibling selectors
-					newContext = rsibling.test( selector ) && testContext( context.parentNode ) ||
-						context;
-
-					// We can use :scope instead of the ID hack if the browser
-					// supports it & if we're not changing the context.
-					if ( newContext !== context || !support.scope ) {
-
-						// Capture the context ID, setting it first if necessary
-						if ( ( nid = context.getAttribute( "id" ) ) ) {
-							nid = nid.replace( rcssescape, fcssescape );
-						} else {
-							context.setAttribute( "id", ( nid = expando ) );
-						}
-					}
-
-					// Prefix every selector in the list
-					groups = tokenize( selector );
-					i = groups.length;
-					while ( i-- ) {
-						groups i  = ( nid ? "#" + nid : ":scope" ) + " " +
-							toSelector( groups i  );
-					}
-					newSelector = groups.join( "," );
-				}
-
-				try {
-					push.apply( results,
-						newContext.querySelectorAll( newSelector )
-					);
-					return results;
-				} catch ( qsaError ) {
-					nonnativeSelectorCache( selector, true );
-				} finally {
-					if ( nid === expando ) {
-						context.removeAttribute( "id" );
-					}
-				}
-			}
-		}
-	}
-
-	// All others
-	return select( selector.replace( rtrim, "$1" ), context, results, seed );
-}
-
-/**
- * Create key-value caches of limited size
- * @returns {function(string, object)} Returns the Object data after storing it on itself with
- *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
- *	deleting the oldest entry
- */
-function createCache() {
-	var keys = ;
-
-	function cache( key, value ) {
-
-		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
-		if ( keys.push( key + " " ) > Expr.cacheLength ) {
-
-			// Only keep the most recent entries
-			delete cache keys.shift() ;
-		}
-		return ( cache key + " "  = value );
-	}
-	return cache;
-}
-
-/**
- * Mark a function for special use by Sizzle
- * @param {Function} fn The function to mark
- */
-function markFunction( fn ) {
-	fn expando  = true;
-	return fn;
-}
-
-/**
- * Support testing using an element
- * @param {Function} fn Passed the created element and returns a boolean result
- */
-function assert( fn ) {
-	var el = document.createElement( "fieldset" );
-
-	try {
-		return !!fn( el );
-	} catch ( e ) {
-		return false;
-	} finally {
-
-		// Remove from its parent by default
-		if ( el.parentNode ) {
-			el.parentNode.removeChild( el );
-		}
-
-		// release memory in IE
-		el = null;
-	}
-}
-
-/**
- * Adds the same handler for all of the specified attrs
- * @param {String} attrs Pipe-separated list of attributes
- * @param {Function} handler The method that will be applied
- */
-function addHandle( attrs, handler ) {
-	var arr = attrs.split( "|" ),
-		i = arr.length;
-
-	while ( i-- ) {
-		Expr.attrHandle arr i   = handler;
-	}
-}
-
-/**
- * Checks document order of two siblings
- * @param {Element} a
- * @param {Element} b
- * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
- */
-function siblingCheck( a, b ) {
-	var cur = b && a,
-		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
-			a.sourceIndex - b.sourceIndex;
-
-	// Use IE sourceIndex if available on both nodes
-	if ( diff ) {
-		return diff;
-	}
-
-	// Check if b follows a
-	if ( cur ) {
-		while ( ( cur = cur.nextSibling ) ) {
-			if ( cur === b ) {
-				return -1;
-			}
-		}
-	}
-
-	return a ? 1 : -1;
-}
-
-/**
- * Returns a function to use in pseudos for input types
- * @param {String} type
- */
-function createInputPseudo( type ) {
-	return function( elem ) {
-		var name = elem.nodeName.toLowerCase();
-		return name === "input" && elem.type === type;
-	};
-}
-
-/**
- * Returns a function to use in pseudos for buttons
- * @param {String} type
- */
-function createButtonPseudo( type ) {
-	return function( elem ) {
-		var name = elem.nodeName.toLowerCase();
-		return ( name === "input" || name === "button" ) && elem.type === type;
-	};
-}
-
-/**
- * Returns a function to use in pseudos for :enabled/:disabled
- * @param {Boolean} disabled true for :disabled; false for :enabled
- */
-function createDisabledPseudo( disabled ) {
-
-	// Known :disabled false positives: fieldsetdisabled > legend:nth-of-type(n+2) :can-disable
-	return function( elem ) {
-
-		// Only certain elements can match :enabled or :disabled
-		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
-		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
-		if ( "form" in elem ) {
-
-			// Check for inherited disabledness on relevant non-disabled elements:
-			// * listed form-associated elements in a disabled fieldset
-			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
-			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
-			// * option elements in a disabled optgroup
-			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
-			// All such elements have a "form" property.
-			if ( elem.parentNode && elem.disabled === false ) {
-
-				// Option elements defer to a parent optgroup if present
-				if ( "label" in elem ) {
-					if ( "label" in elem.parentNode ) {
-						return elem.parentNode.disabled === disabled;
-					} else {
-						return elem.disabled === disabled;
-					}
-				}
-
-				// Support: IE 6 - 11
-				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
-				return elem.isDisabled === disabled ||
-
-					// Where there is no isDisabled, check manually
-					/* jshint -W018 */
-					elem.isDisabled !== !disabled &&
-					inDisabledFieldset( elem ) === disabled;
-			}
-
-			return elem.disabled === disabled;
-
-		// Try to winnow out elements that can't be disabled before trusting the disabled property.
-		// Some victims get caught in our net (label, legend, menu, track), but it shouldn't
-		// even exist on them, let alone have a boolean value.
-		} else if ( "label" in elem ) {
-			return elem.disabled === disabled;
-		}
-
-		// Remaining elements are neither :enabled nor :disabled
-		return false;
-	};
-}
-
-/**
- * Returns a function to use in pseudos for positionals
- * @param {Function} fn
- */
-function createPositionalPseudo( fn ) {
-	return markFunction( function( argument ) {
-		argument = +argument;
-		return markFunction( function( seed, matches ) {
-			var j,
-				matchIndexes = fn( , seed.length, argument ),
-				i = matchIndexes.length;
-
-			// Match elements found at the specified indexes
-			while ( i-- ) {
-				if ( seed ( j = matchIndexes i  )  ) {
-					seed j  = !( matches j  = seed j  );
-				}
-			}
-		} );
-	} );
-}
-
-/**
- * Checks a node for validity as a Sizzle context
- * @param {Element|Object=} context
- * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
- */
-function testContext( context ) {
-	return context && typeof context.getElementsByTagName !== "undefined" && context;
-}
-
-// Expose support vars for convenience
-support = Sizzle.support = {};
-
-/**
- * Detects XML nodes
- * @param {Element|Object} elem An element or a document
- * @returns {Boolean} True iff elem is a non-HTML XML node
- */
-isXML = Sizzle.isXML = function( elem ) {
-	var namespace = elem.namespaceURI,
-		docElem = ( elem.ownerDocument || elem ).documentElement;
-
-	// Support: IE <=8
-	// Assume HTML when documentElement doesn't yet exist, such as inside loading iframes
-	// https://bugs.jquery.com/ticket/4833
-	return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" );
-};
-
-/**
- * Sets document-related variables once based on the current document
- * @param {Element|Object} doc An element or document object to use to set the document
- * @returns {Object} Returns the current document
- */
-setDocument = Sizzle.setDocument = function( node ) {
-	var hasCompare, subWindow,
-		doc = node ? node.ownerDocument || node : preferredDoc;
-
-	// Return early if doc is invalid or already selected
-	// Support: IE 11+, Edge 17 - 18+
-	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-	// two documents; shallow comparisons work.
-	// eslint-disable-next-line eqeqeq
-	if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) {
-		return document;
-	}
-
-	// Update global variables
-	document = doc;
-	docElem = document.documentElement;
-	documentIsHTML = !isXML( document );
-
-	// Support: IE 9 - 11+, Edge 12 - 18+
-	// Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936)
-	// Support: IE 11+, Edge 17 - 18+
-	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-	// two documents; shallow comparisons work.
-	// eslint-disable-next-line eqeqeq
-	if ( preferredDoc != document &&
-		( subWindow = document.defaultView ) && subWindow.top !== subWindow ) {
-
-		// Support: IE 11, Edge
-		if ( subWindow.addEventListener ) {
-			subWindow.addEventListener( "unload", unloadHandler, false );
-
-		// Support: IE 9 - 10 only
-		} else if ( subWindow.attachEvent ) {
-			subWindow.attachEvent( "onunload", unloadHandler );
-		}
-	}
-
-	// Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only,
-	// Safari 4 - 5 only, Opera <=11.6 - 12.x only
-	// IE/Edge & older browsers don't support the :scope pseudo-class.
-	// Support: Safari 6.0 only
-	// Safari 6.0 supports :scope but it's an alias of :root there.
-	support.scope = assert( function( el ) {
-		docElem.appendChild( el ).appendChild( document.createElement( "div" ) );
-		return typeof el.querySelectorAll !== "undefined" &&
-			!el.querySelectorAll( ":scope fieldset div" ).length;
-	} );
-
-	/* Attributes
-	---------------------------------------------------------------------- */
-
-	// Support: IE<8
-	// Verify that getAttribute really returns attributes and not properties
-	// (excepting IE8 booleans)
-	support.attributes = assert( function( el ) {
-		el.className = "i";
-		return !el.getAttribute( "className" );
-	} );
-
-	/* getElement(s)By*
-	---------------------------------------------------------------------- */
-
-	// Check if getElementsByTagName("*") returns only elements
-	support.getElementsByTagName = assert( function( el ) {
-		el.appendChild( document.createComment( "" ) );
-		return !el.getElementsByTagName( "*" ).length;
-	} );
-
-	// Support: IE<9
-	support.getElementsByClassName = rnative.test( document.getElementsByClassName );
-
-	// Support: IE<10
-	// Check if getElementById returns elements by name
-	// The broken getElementById methods don't pick up programmatically-set names,
-	// so use a roundabout getElementsByName test
-	support.getById = assert( function( el ) {
-		docElem.appendChild( el ).id = expando;
-		return !document.getElementsByName || !document.getElementsByName( expando ).length;
-	} );
-
-	// ID filter and find
-	if ( support.getById ) {
-		Expr.filter "ID"  = function( id ) {
-			var attrId = id.replace( runescape, funescape );
-			return function( elem ) {
-				return elem.getAttribute( "id" ) === attrId;
-			};
-		};
-		Expr.find "ID"  = function( id, context ) {
-			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
-				var elem = context.getElementById( id );
-				return elem ?  elem  : ;
-			}
-		};
-	} else {
-		Expr.filter "ID"  =  function( id ) {
-			var attrId = id.replace( runescape, funescape );
-			return function( elem ) {
-				var node = typeof elem.getAttributeNode !== "undefined" &&
-					elem.getAttributeNode( "id" );
-				return node && node.value === attrId;
-			};
-		};
-
-		// Support: IE 6 - 7 only
-		// getElementById is not reliable as a find shortcut
-		Expr.find "ID"  = function( id, context ) {
-			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
-				var node, i, elems,
-					elem = context.getElementById( id );
-
-				if ( elem ) {
-
-					// Verify the id attribute
-					node = elem.getAttributeNode( "id" );
-					if ( node && node.value === id ) {
-						return  elem ;
-					}
-
-					// Fall back on getElementsByName
-					elems = context.getElementsByName( id );
-					i = 0;
-					while ( ( elem = elems i++  ) ) {
-						node = elem.getAttributeNode( "id" );
-						if ( node && node.value === id ) {
-							return  elem ;
-						}
-					}
-				}
-
-				return ;
-			}
-		};
-	}
-
-	// Tag
-	Expr.find "TAG"  = support.getElementsByTagName ?
-		function( tag, context ) {
-			if ( typeof context.getElementsByTagName !== "undefined" ) {
-				return context.getElementsByTagName( tag );
-
-			// DocumentFragment nodes don't have gEBTN
-			} else if ( support.qsa ) {
-				return context.querySelectorAll( tag );
-			}
-		} :
-
-		function( tag, context ) {
-			var elem,
-				tmp = ,
-				i = 0,
-
-				// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too
-				results = context.getElementsByTagName( tag );
-
-			// Filter out possible comments
-			if ( tag === "*" ) {
-				while ( ( elem = results i++  ) ) {
-					if ( elem.nodeType === 1 ) {
-						tmp.push( elem );
-					}
-				}
-
-				return tmp;
-			}
-			return results;
-		};
-
-	// Class
-	Expr.find "CLASS"  = support.getElementsByClassName && function( className, context ) {
-		if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) {
-			return context.getElementsByClassName( className );
-		}
-	};
-
-	/* QSA/matchesSelector
-	---------------------------------------------------------------------- */
-
-	// QSA and matchesSelector support
-
-	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
-	rbuggyMatches = ;
-
-	// qSa(:focus) reports false when true (Chrome 21)
-	// We allow this because of a bug in IE8/9 that throws an error
-	// whenever `document.activeElement` is accessed on an iframe
-	// So, we allow :focus to pass through QSA all the time to avoid the IE error
-	// See https://bugs.jquery.com/ticket/13378
-	rbuggyQSA = ;
-
-	if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) {
-
-		// Build QSA regex
-		// Regex strategy adopted from Diego Perini
-		assert( function( el ) {
-
-			var input;
-
-			// Select is set to empty string on purpose
-			// This is to test IE's treatment of not explicitly
-			// setting a boolean content attribute,
-			// since its presence should be enough
-			// https://bugs.jquery.com/ticket/12359
-			docElem.appendChild( el ).innerHTML = "<a id='" + expando + "'></a>" +
-				"<select id='" + expando + "-\r\\' msallowcapture=''>" +
-				"<option selected=''></option></select>";
-
-			// Support: IE8, Opera 11-12.16
-			// Nothing should be selected when empty strings follow ^= or $= or *=
-			// The test attribute must be unknown in Opera but "safe" for WinRT
-			// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
-			if ( el.querySelectorAll( "msallowcapture^=''" ).length ) {
-				rbuggyQSA.push( "*^$=" + whitespace + "*(?:''|\"\")" );
-			}
-
-			// Support: IE8
-			// Boolean attributes and "value" are not treated correctly
-			if ( !el.querySelectorAll( "selected" ).length ) {
-				rbuggyQSA.push( "\\" + whitespace + "*(?:value|" + booleans + ")" );
-			}
-
-			// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+
-			if ( !el.querySelectorAll( "id~=" + expando + "-" ).length ) {
-				rbuggyQSA.push( "~=" );
-			}
-
-			// Support: IE 11+, Edge 15 - 18+
-			// IE 11/Edge don't find elements on a `name=''` query in some cases.
-			// Adding a temporary attribute to the document before the selection works
-			// around the issue.
-			// Interestingly, IE 10 & older don't seem to have the issue.
-			input = document.createElement( "input" );
-			input.setAttribute( "name", "" );
-			el.appendChild( input );
-			if ( !el.querySelectorAll( "name=''" ).length ) {
-				rbuggyQSA.push( "\\" + whitespace + "*name" + whitespace + "*=" +
-					whitespace + "*(?:''|\"\")" );
-			}
-
-			// Webkit/Opera - :checked should return selected option elements
-			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
-			// IE8 throws error here and will not see later tests
-			if ( !el.querySelectorAll( ":checked" ).length ) {
-				rbuggyQSA.push( ":checked" );
-			}
-
-			// Support: Safari 8+, iOS 8+
-			// https://bugs.webkit.org/show_bug.cgi?id=136851
-			// In-page `selector#id sibling-combinator selector` fails
-			if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) {
-				rbuggyQSA.push( ".#.++~" );
-			}
-
-			// Support: Firefox <=3.6 - 5 only
-			// Old Firefox doesn't throw on a badly-escaped identifier.
-			el.querySelectorAll( "\\\f" );
-			rbuggyQSA.push( "\\r\\n\\f" );
-		} );
-
-		assert( function( el ) {
-			el.innerHTML = "<a href='' disabled='disabled'></a>" +
-				"<select disabled='disabled'><option/></select>";
-
-			// Support: Windows 8 Native Apps
-			// The type and name attributes are restricted during .innerHTML assignment
-			var input = document.createElement( "input" );
-			input.setAttribute( "type", "hidden" );
-			el.appendChild( input ).setAttribute( "name", "D" );
-
-			// Support: IE8
-			// Enforce case-sensitivity of name attribute
-			if ( el.querySelectorAll( "name=d" ).length ) {
-				rbuggyQSA.push( "name" + whitespace + "**^$|!~?=" );
-			}
-
-			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
-			// IE8 throws error here and will not see later tests
-			if ( el.querySelectorAll( ":enabled" ).length !== 2 ) {
-				rbuggyQSA.push( ":enabled", ":disabled" );
-			}
-
-			// Support: IE9-11+
-			// IE's :disabled selector does not pick up the children of disabled fieldsets
-			docElem.appendChild( el ).disabled = true;
-			if ( el.querySelectorAll( ":disabled" ).length !== 2 ) {
-				rbuggyQSA.push( ":enabled", ":disabled" );
-			}
-
-			// Support: Opera 10 - 11 only
-			// Opera 10-11 does not throw on post-comma invalid pseudos
-			el.querySelectorAll( "*,:x" );
-			rbuggyQSA.push( ",.*:" );
-		} );
-	}
-
-	if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches ||
-		docElem.webkitMatchesSelector ||
-		docElem.mozMatchesSelector ||
-		docElem.oMatchesSelector ||
-		docElem.msMatchesSelector ) ) ) ) {
-
-		assert( function( el ) {
-
-			// Check to see if it's possible to do matchesSelector
-			// on a disconnected node (IE 9)
-			support.disconnectedMatch = matches.call( el, "*" );
-
-			// This should fail with an exception
-			// Gecko does not error, returns false instead
-			matches.call( el, "s!='':x" );
-			rbuggyMatches.push( "!=", pseudos );
-		} );
-	}
-
-	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) );
-	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) );
-
-	/* Contains
-	---------------------------------------------------------------------- */
-	hasCompare = rnative.test( docElem.compareDocumentPosition );
-
-	// Element contains another
-	// Purposefully self-exclusive
-	// As in, an element does not contain itself
-	contains = hasCompare || rnative.test( docElem.contains ) ?
-		function( a, b ) {
-			var adown = a.nodeType === 9 ? a.documentElement : a,
-				bup = b && b.parentNode;
-			return a === bup || !!( bup && bup.nodeType === 1 && (
-				adown.contains ?
-					adown.contains( bup ) :
-					a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16
-			) );
-		} :
-		function( a, b ) {
-			if ( b ) {
-				while ( ( b = b.parentNode ) ) {
-					if ( b === a ) {
-						return true;
-					}
-				}
-			}
-			return false;
-		};
-
-	/* Sorting
-	---------------------------------------------------------------------- */
-
-	// Document order sorting
-	sortOrder = hasCompare ?
-	function( a, b ) {
-
-		// Flag for duplicate removal
-		if ( a === b ) {
-			hasDuplicate = true;
-			return 0;
-		}
-
-		// Sort on method existence if only one input has compareDocumentPosition
-		var compare = !a.compareDocumentPosition - !b.compareDocumentPosition;
-		if ( compare ) {
-			return compare;
-		}
-
-		// Calculate position if both inputs belong to the same document
-		// Support: IE 11+, Edge 17 - 18+
-		// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-		// two documents; shallow comparisons work.
-		// eslint-disable-next-line eqeqeq
-		compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ?
-			a.compareDocumentPosition( b ) :
-
-			// Otherwise we know they are disconnected
-			1;
-
-		// Disconnected nodes
-		if ( compare & 1 ||
-			( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) {
-
-			// Choose the first element that is related to our preferred document
-			// Support: IE 11+, Edge 17 - 18+
-			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-			// two documents; shallow comparisons work.
-			// eslint-disable-next-line eqeqeq
-			if ( a == document || a.ownerDocument == preferredDoc &&
-				contains( preferredDoc, a ) ) {
-				return -1;
-			}
-
-			// Support: IE 11+, Edge 17 - 18+
-			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-			// two documents; shallow comparisons work.
-			// eslint-disable-next-line eqeqeq
-			if ( b == document || b.ownerDocument == preferredDoc &&
-				contains( preferredDoc, b ) ) {
-				return 1;
-			}
-
-			// Maintain original order
-			return sortInput ?
-				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
-				0;
-		}
-
-		return compare & 4 ? -1 : 1;
-	} :
-	function( a, b ) {
-
-		// Exit early if the nodes are identical
-		if ( a === b ) {
-			hasDuplicate = true;
-			return 0;
-		}
-
-		var cur,
-			i = 0,
-			aup = a.parentNode,
-			bup = b.parentNode,
-			ap =  a ,
-			bp =  b ;
-
-		// Parentless nodes are either documents or disconnected
-		if ( !aup || !bup ) {
-
-			// Support: IE 11+, Edge 17 - 18+
-			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-			// two documents; shallow comparisons work.
-			/* eslint-disable eqeqeq */
-			return a == document ? -1 :
-				b == document ? 1 :
-				/* eslint-enable eqeqeq */
-				aup ? -1 :
-				bup ? 1 :
-				sortInput ?
-				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
-				0;
-
-		// If the nodes are siblings, we can do a quick check
-		} else if ( aup === bup ) {
-			return siblingCheck( a, b );
-		}
-
-		// Otherwise we need full lists of their ancestors for comparison
-		cur = a;
-		while ( ( cur = cur.parentNode ) ) {
-			ap.unshift( cur );
-		}
-		cur = b;
-		while ( ( cur = cur.parentNode ) ) {
-			bp.unshift( cur );
-		}
-
-		// Walk down the tree looking for a discrepancy
-		while ( ap i  === bp i  ) {
-			i++;
-		}
-
-		return i ?
-
-			// Do a sibling check if the nodes have a common ancestor
-			siblingCheck( ap i , bp i  ) :
-
-			// Otherwise nodes in our document sort first
-			// Support: IE 11+, Edge 17 - 18+
-			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-			// two documents; shallow comparisons work.
-			/* eslint-disable eqeqeq */
-			ap i  == preferredDoc ? -1 :
-			bp i  == preferredDoc ? 1 :
-			/* eslint-enable eqeqeq */
-			0;
-	};
-
-	return document;
-};
-
-Sizzle.matches = function( expr, elements ) {
-	return Sizzle( expr, null, null, elements );
-};
-
-Sizzle.matchesSelector = function( elem, expr ) {
-	setDocument( elem );
-
-	if ( support.matchesSelector && documentIsHTML &&
-		!nonnativeSelectorCache expr + " "  &&
-		( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&
-		( !rbuggyQSA     || !rbuggyQSA.test( expr ) ) ) {
-
-		try {
-			var ret = matches.call( elem, expr );
-
-			// IE 9's matchesSelector returns false on disconnected nodes
-			if ( ret || support.disconnectedMatch ||
-
-				// As well, disconnected nodes are said to be in a document
-				// fragment in IE 9
-				elem.document && elem.document.nodeType !== 11 ) {
-				return ret;
-			}
-		} catch ( e ) {
-			nonnativeSelectorCache( expr, true );
-		}
-	}
-
-	return Sizzle( expr, document, null,  elem  ).length > 0;
-};
-
-Sizzle.contains = function( context, elem ) {
-
-	// Set document vars if needed
-	// Support: IE 11+, Edge 17 - 18+
-	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-	// two documents; shallow comparisons work.
-	// eslint-disable-next-line eqeqeq
-	if ( ( context.ownerDocument || context ) != document ) {
-		setDocument( context );
-	}
-	return contains( context, elem );
-};
-
-Sizzle.attr = function( elem, name ) {
-
-	// Set document vars if needed
-	// Support: IE 11+, Edge 17 - 18+
-	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-	// two documents; shallow comparisons work.
-	// eslint-disable-next-line eqeqeq
-	if ( ( elem.ownerDocument || elem ) != document ) {
-		setDocument( elem );
-	}
-
-	var fn = Expr.attrHandle name.toLowerCase() ,
-
-		// Don't get fooled by Object.prototype properties (jQuery #13807)
-		val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?
-			fn( elem, name, !documentIsHTML ) :
-			undefined;
-
-	return val !== undefined ?
-		val :
-		support.attributes || !documentIsHTML ?
-			elem.getAttribute( name ) :
-			( val = elem.getAttributeNode( name ) ) && val.specified ?
-				val.value :
-				null;
-};
-
-Sizzle.escape = function( sel ) {
-	return ( sel + "" ).replace( rcssescape, fcssescape );
-};
-
-Sizzle.error = function( msg ) {
-	throw new Error( "Syntax error, unrecognized expression: " + msg );
-};
-
-/**
- * Document sorting and removing duplicates
- * @param {ArrayLike} results
- */
-Sizzle.uniqueSort = function( results ) {
-	var elem,
-		duplicates = ,
-		j = 0,
-		i = 0;
-
-	// Unless we *know* we can detect duplicates, assume their presence
-	hasDuplicate = !support.detectDuplicates;
-	sortInput = !support.sortStable && results.slice( 0 );
-	results.sort( sortOrder );
-
-	if ( hasDuplicate ) {
-		while ( ( elem = results i++  ) ) {
-			if ( elem === results i  ) {
-				j = duplicates.push( i );
-			}
-		}
-		while ( j-- ) {
-			results.splice( duplicates j , 1 );
-		}
-	}
-
-	// Clear input after sorting to release objects
-	// See https://github.com/jquery/sizzle/pull/225
-	sortInput = null;
-
-	return results;
-};
-
-/**
- * Utility function for retrieving the text value of an array of DOM nodes
- * @param {Array|Element} elem
- */
-getText = Sizzle.getText = function( elem ) {
-	var node,
-		ret = "",
-		i = 0,
-		nodeType = elem.nodeType;
-
-	if ( !nodeType ) {
-
-		// If no nodeType, this is expected to be an array
-		while ( ( node = elem i++  ) ) {
-
-			// Do not traverse comment nodes
-			ret += getText( node );
-		}
-	} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
-
-		// Use textContent for elements
-		// innerText usage removed for consistency of new lines (jQuery #11153)
-		if ( typeof elem.textContent === "string" ) {
-			return elem.textContent;
-		} else {
-
-			// Traverse its children
-			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
-				ret += getText( elem );
-			}
-		}
-	} else if ( nodeType === 3 || nodeType === 4 ) {
-		return elem.nodeValue;
-	}
-
-	// Do not include comment or processing instruction nodes
-
-	return ret;
-};
-
-Expr = Sizzle.selectors = {
-
-	// Can be adjusted by the user
-	cacheLength: 50,
-
-	createPseudo: markFunction,
-
-	match: matchExpr,
-
-	attrHandle: {},
-
-	find: {},
-
-	relative: {
-		">": { dir: "parentNode", first: true },
-		" ": { dir: "parentNode" },
-		"+": { dir: "previousSibling", first: true },
-		"~": { dir: "previousSibling" }
-	},
-
-	preFilter: {
-		"ATTR": function( match ) {
-			match 1  = match 1 .replace( runescape, funescape );
-
-			// Move the given value to match3 whether quoted or unquoted
-			match 3  = ( match 3  || match 4  ||
-				match 5  || "" ).replace( runescape, funescape );
-
-			if ( match 2  === "~=" ) {
-				match 3  = " " + match 3  + " ";
-			}
-
-			return match.slice( 0, 4 );
-		},
-
-		"CHILD": function( match ) {
-
-			/* matches from matchExpr"CHILD"
-				1 type (only|nth|...)
-				2 what (child|of-type)
-				3 argument (even|odd|\d*|\d*n(+-\d+)?|...)
-				4 xn-component of xn+y argument (+-?\d*n|)
-				5 sign of xn-component
-				6 x of xn-component
-				7 sign of y-component
-				8 y of y-component
-			*/
-			match 1  = match 1 .toLowerCase();
-
-			if ( match 1 .slice( 0, 3 ) === "nth" ) {
-
-				// nth-* requires argument
-				if ( !match 3  ) {
-					Sizzle.error( match 0  );
-				}
-
-				// numeric x and y parameters for Expr.filter.CHILD
-				// remember that false/true cast respectively to 0/1
-				match 4  = +( match 4  ?
-					match 5  + ( match 6  || 1 ) :
-					2 * ( match 3  === "even" || match 3  === "odd" ) );
-				match 5  = +( ( match 7  + match 8  ) || match 3  === "odd" );
-
-				// other types prohibit arguments
-			} else if ( match 3  ) {
-				Sizzle.error( match 0  );
-			}
-
-			return match;
-		},
-
-		"PSEUDO": function( match ) {
-			var excess,
-				unquoted = !match 6  && match 2 ;
-
-			if ( matchExpr "CHILD" .test( match 0  ) ) {
-				return null;
-			}
-
-			// Accept quoted arguments as-is
-			if ( match 3  ) {
-				match 2  = match 4  || match 5  || "";
-
-			// Strip excess characters from unquoted arguments
-			} else if ( unquoted && rpseudo.test( unquoted ) &&
-
-				// Get excess from tokenize (recursively)
-				( excess = tokenize( unquoted, true ) ) &&
-
-				// advance to the next closing parenthesis
-				( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) {
-
-				// excess is a negative index
-				match 0  = match 0 .slice( 0, excess );
-				match 2  = unquoted.slice( 0, excess );
-			}
-
-			// Return only captures needed by the pseudo filter method (type and argument)
-			return match.slice( 0, 3 );
-		}
-	},
-
-	filter: {
-
-		"TAG": function( nodeNameSelector ) {
-			var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();
-			return nodeNameSelector === "*" ?
-				function() {
-					return true;
-				} :
-				function( elem ) {
-					return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
-				};
-		},
-
-		"CLASS": function( className ) {
-			var pattern = classCache className + " " ;
-
-			return pattern ||
-				( pattern = new RegExp( "(^|" + whitespace +
-					")" + className + "(" + whitespace + "|$)" ) ) && classCache(
-						className, function( elem ) {
-							return pattern.test(
-								typeof elem.className === "string" && elem.className ||
-								typeof elem.getAttribute !== "undefined" &&
-									elem.getAttribute( "class" ) ||
-								""
-							);
-				} );
-		},
-
-		"ATTR": function( name, operator, check ) {
-			return function( elem ) {
-				var result = Sizzle.attr( elem, name );
-
-				if ( result == null ) {
-					return operator === "!=";
-				}
-				if ( !operator ) {
-					return true;
-				}
-
-				result += "";
-
-				/* eslint-disable max-len */
-
-				return operator === "=" ? result === check :
-					operator === "!=" ? result !== check :
-					operator === "^=" ? check && result.indexOf( check ) === 0 :
-					operator === "*=" ? check && result.indexOf( check ) > -1 :
-					operator === "$=" ? check && result.slice( -check.length ) === check :
-					operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 :
-					operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" :
-					false;
-				/* eslint-enable max-len */
-
-			};
-		},
-
-		"CHILD": function( type, what, _argument, first, last ) {
-			var simple = type.slice( 0, 3 ) !== "nth",
-				forward = type.slice( -4 ) !== "last",
-				ofType = what === "of-type";
-
-			return first === 1 && last === 0 ?
-
-				// Shortcut for :nth-*(n)
-				function( elem ) {
-					return !!elem.parentNode;
-				} :
-
-				function( elem, _context, xml ) {
-					var cache, uniqueCache, outerCache, node, nodeIndex, start,
-						dir = simple !== forward ? "nextSibling" : "previousSibling",
-						parent = elem.parentNode,
-						name = ofType && elem.nodeName.toLowerCase(),
-						useCache = !xml && !ofType,
-						diff = false;
-
-					if ( parent ) {
-
-						// :(first|last|only)-(child|of-type)
-						if ( simple ) {
-							while ( dir ) {
-								node = elem;
-								while ( ( node = node dir  ) ) {
-									if ( ofType ?
-										node.nodeName.toLowerCase() === name :
-										node.nodeType === 1 ) {
-
-										return false;
-									}
-								}
-
-								// Reverse direction for :only-* (if we haven't yet done so)
-								start = dir = type === "only" && !start && "nextSibling";
-							}
-							return true;
-						}
-
-						start =  forward ? parent.firstChild : parent.lastChild ;
-
-						// non-xml :nth-child(...) stores cache data on `parent`
-						if ( forward && useCache ) {
-
-							// Seek `elem` from a previously-cached index
-
-							// ...in a gzip-friendly way
-							node = parent;
-							outerCache = node expando  || ( node expando  = {} );
-
-							// Support: IE <9 only
-							// Defend against cloned attroperties (jQuery gh-1709)
-							uniqueCache = outerCache node.uniqueID  ||
-								( outerCache node.uniqueID  = {} );
-
-							cache = uniqueCache type  || ;
-							nodeIndex = cache 0  === dirruns && cache 1 ;
-							diff = nodeIndex && cache 2 ;
-							node = nodeIndex && parent.childNodes nodeIndex ;
-
-							while ( ( node = ++nodeIndex && node && node dir  ||
-
-								// Fallback to seeking `elem` from the start
-								( diff = nodeIndex = 0 ) || start.pop() ) ) {
-
-								// When found, cache indexes on `parent` and break
-								if ( node.nodeType === 1 && ++diff && node === elem ) {
-									uniqueCache type  =  dirruns, nodeIndex, diff ;
-									break;
-								}
-							}
-
-						} else {
-
-							// Use previously-cached element index if available
-							if ( useCache ) {
-
-								// ...in a gzip-friendly way
-								node = elem;
-								outerCache = node expando  || ( node expando  = {} );
-
-								// Support: IE <9 only
-								// Defend against cloned attroperties (jQuery gh-1709)
-								uniqueCache = outerCache node.uniqueID  ||
-									( outerCache node.uniqueID  = {} );
-
-								cache = uniqueCache type  || ;
-								nodeIndex = cache 0  === dirruns && cache 1 ;
-								diff = nodeIndex;
-							}
-
-							// xml :nth-child(...)
-							// or :nth-last-child(...) or :nth(-last)?-of-type(...)
-							if ( diff === false ) {
-
-								// Use the same loop as above to seek `elem` from the start
-								while ( ( node = ++nodeIndex && node && node dir  ||
-									( diff = nodeIndex = 0 ) || start.pop() ) ) {
-
-									if ( ( ofType ?
-										node.nodeName.toLowerCase() === name :
-										node.nodeType === 1 ) &&
-										++diff ) {
-
-										// Cache the index of each encountered element
-										if ( useCache ) {
-											outerCache = node expando  ||
-												( node expando  = {} );
-
-											// Support: IE <9 only
-											// Defend against cloned attroperties (jQuery gh-1709)
-											uniqueCache = outerCache node.uniqueID  ||
-												( outerCache node.uniqueID  = {} );
-
-											uniqueCache type  =  dirruns, diff ;
-										}
-
-										if ( node === elem ) {
-											break;
-										}
-									}
-								}
-							}
-						}
-
-						// Incorporate the offset, then check against cycle size
-						diff -= last;
-						return diff === first || ( diff % first === 0 && diff / first >= 0 );
-					}
-				};
-		},
-
-		"PSEUDO": function( pseudo, argument ) {
-
-			// pseudo-class names are case-insensitive
-			// http://www.w3.org/TR/selectors/#pseudo-classes
-			// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters
-			// Remember that setFilters inherits from pseudos
-			var args,
-				fn = Expr.pseudos pseudo  || Expr.setFilters pseudo.toLowerCase()  ||
-					Sizzle.error( "unsupported pseudo: " + pseudo );
-
-			// The user may use createPseudo to indicate that
-			// arguments are needed to create the filter function
-			// just as Sizzle does
-			if ( fn expando  ) {
-				return fn( argument );
-			}
-
-			// But maintain support for old signatures
-			if ( fn.length > 1 ) {
-				args =  pseudo, pseudo, "", argument ;
-				return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?
-					markFunction( function( seed, matches ) {
-						var idx,
-							matched = fn( seed, argument ),
-							i = matched.length;
-						while ( i-- ) {
-							idx = indexOf( seed, matched i  );
-							seed idx  = !( matches idx  = matched i  );
-						}
-					} ) :
-					function( elem ) {
-						return fn( elem, 0, args );
-					};
-			}
-
-			return fn;
-		}
-	},
-
-	pseudos: {
-
-		// Potentially complex pseudos
-		"not": markFunction( function( selector ) {
-
-			// Trim the selector passed to compile
-			// to avoid treating leading and trailing
-			// spaces as combinators
-			var input = ,
-				results = ,
-				matcher = compile( selector.replace( rtrim, "$1" ) );
-
-			return matcher expando  ?
-				markFunction( function( seed, matches, _context, xml ) {
-					var elem,
-						unmatched = matcher( seed, null, xml,  ),
-						i = seed.length;
-
-					// Match elements unmatched by `matcher`
-					while ( i-- ) {
-						if ( ( elem = unmatched i  ) ) {
-							seed i  = !( matches i  = elem );
-						}
-					}
-				} ) :
-				function( elem, _context, xml ) {
-					input 0  = elem;
-					matcher( input, null, xml, results );
-
-					// Don't keep the element (issue #299)
-					input 0  = null;
-					return !results.pop();
-				};
-		} ),
-
-		"has": markFunction( function( selector ) {
-			return function( elem ) {
-				return Sizzle( selector, elem ).length > 0;
-			};
-		} ),
-
-		"contains": markFunction( function( text ) {
-			text = text.replace( runescape, funescape );
-			return function( elem ) {
-				return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1;
-			};
-		} ),
-
-		// "Whether an element is represented by a :lang() selector
-		// is based solely on the element's language value
-		// being equal to the identifier C,
-		// or beginning with the identifier C immediately followed by "-".
-		// The matching of C against the element's language value is performed case-insensitively.
-		// The identifier C does not have to be a valid language name."
-		// http://www.w3.org/TR/selectors/#lang-pseudo
-		"lang": markFunction( function( lang ) {
-
-			// lang value must be a valid identifier
-			if ( !ridentifier.test( lang || "" ) ) {
-				Sizzle.error( "unsupported lang: " + lang );
-			}
-			lang = lang.replace( runescape, funescape ).toLowerCase();
-			return function( elem ) {
-				var elemLang;
-				do {
-					if ( ( elemLang = documentIsHTML ?
-						elem.lang :
-						elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) {
-
-						elemLang = elemLang.toLowerCase();
-						return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0;
-					}
-				} while ( ( elem = elem.parentNode ) && elem.nodeType === 1 );
-				return false;
-			};
-		} ),
-
-		// Miscellaneous
-		"target": function( elem ) {
-			var hash = window.location && window.location.hash;
-			return hash && hash.slice( 1 ) === elem.id;
-		},
-
-		"root": function( elem ) {
-			return elem === docElem;
-		},
-
-		"focus": function( elem ) {
-			return elem === document.activeElement &&
-				( !document.hasFocus || document.hasFocus() ) &&
-				!!( elem.type || elem.href || ~elem.tabIndex );
-		},
-
-		// Boolean properties
-		"enabled": createDisabledPseudo( false ),
-		"disabled": createDisabledPseudo( true ),
-
-		"checked": function( elem ) {
-
-			// In CSS3, :checked should return both checked and selected elements
-			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
-			var nodeName = elem.nodeName.toLowerCase();
-			return ( nodeName === "input" && !!elem.checked ) ||
-				( nodeName === "option" && !!elem.selected );
-		},
-
-		"selected": function( elem ) {
-
-			// Accessing this property makes selected-by-default
-			// options in Safari work properly
-			if ( elem.parentNode ) {
-				// eslint-disable-next-line no-unused-expressions
-				elem.parentNode.selectedIndex;
-			}
-
-			return elem.selected === true;
-		},
-
-		// Contents
-		"empty": function( elem ) {
-
-			// http://www.w3.org/TR/selectors/#empty-pseudo
-			// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),
-			//   but not by others (comment: 8; processing instruction: 7; etc.)
-			// nodeType < 6 works because attributes (2) do not appear as children
-			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
-				if ( elem.nodeType < 6 ) {
-					return false;
-				}
-			}
-			return true;
-		},
-
-		"parent": function( elem ) {
-			return !Expr.pseudos "empty" ( elem );
-		},
-
-		// Element/input types
-		"header": function( elem ) {
-			return rheader.test( elem.nodeName );
-		},
-
-		"input": function( elem ) {
-			return rinputs.test( elem.nodeName );
-		},
-
-		"button": function( elem ) {
-			var name = elem.nodeName.toLowerCase();
-			return name === "input" && elem.type === "button" || name === "button";
-		},
-
-		"text": function( elem ) {
-			var attr;
-			return elem.nodeName.toLowerCase() === "input" &&
-				elem.type === "text" &&
-
-				// Support: IE<8
-				// New HTML5 attribute values (e.g., "search") appear with elem.type === "text"
-				( ( attr = elem.getAttribute( "type" ) ) == null ||
-					attr.toLowerCase() === "text" );
-		},
-
-		// Position-in-collection
-		"first": createPositionalPseudo( function() {
-			return  0 ;
-		} ),
-
-		"last": createPositionalPseudo( function( _matchIndexes, length ) {
-			return  length - 1 ;
-		} ),
-
-		"eq": createPositionalPseudo( function( _matchIndexes, length, argument ) {
-			return  argument < 0 ? argument + length : argument ;
-		} ),
-
-		"even": createPositionalPseudo( function( matchIndexes, length ) {
-			var i = 0;
-			for ( ; i < length; i += 2 ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		} ),
-
-		"odd": createPositionalPseudo( function( matchIndexes, length ) {
-			var i = 1;
-			for ( ; i < length; i += 2 ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		} ),
-
-		"lt": createPositionalPseudo( function( matchIndexes, length, argument ) {
-			var i = argument < 0 ?
-				argument + length :
-				argument > length ?
-					length :
-					argument;
-			for ( ; --i >= 0; ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		} ),
-
-		"gt": createPositionalPseudo( function( matchIndexes, length, argument ) {
-			var i = argument < 0 ? argument + length : argument;
-			for ( ; ++i < length; ) {
-				matchIndexes.push( i );
-			}
-			return matchIndexes;
-		} )
-	}
-};
-
-Expr.pseudos "nth"  = Expr.pseudos "eq" ;
-
-// Add button/input type pseudos
-for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {
-	Expr.pseudos i  = createInputPseudo( i );
-}
-for ( i in { submit: true, reset: true } ) {
-	Expr.pseudos i  = createButtonPseudo( i );
-}
-
-// Easy API for creating new setFilters
-function setFilters() {}
-setFilters.prototype = Expr.filters = Expr.pseudos;
-Expr.setFilters = new setFilters();
-
-tokenize = Sizzle.tokenize = function( selector, parseOnly ) {
-	var matched, match, tokens, type,
-		soFar, groups, preFilters,
-		cached = tokenCache selector + " " ;
-
-	if ( cached ) {
-		return parseOnly ? 0 : cached.slice( 0 );
-	}
-
-	soFar = selector;
-	groups = ;
-	preFilters = Expr.preFilter;
-
-	while ( soFar ) {
-
-		// Comma and first run
-		if ( !matched || ( match = rcomma.exec( soFar ) ) ) {
-			if ( match ) {
-
-				// Don't consume trailing commas as valid
-				soFar = soFar.slice( match 0 .length ) || soFar;
-			}
-			groups.push( ( tokens =  ) );
-		}
-
-		matched = false;
-
-		// Combinators
-		if ( ( match = rcombinators.exec( soFar ) ) ) {
-			matched = match.shift();
-			tokens.push( {
-				value: matched,
-
-				// Cast descendant combinators to space
-				type: match 0 .replace( rtrim, " " )
-			} );
-			soFar = soFar.slice( matched.length );
-		}
-
-		// Filters
-		for ( type in Expr.filter ) {
-			if ( ( match = matchExpr type .exec( soFar ) ) && ( !preFilters type  ||
-				( match = preFilters type ( match ) ) ) ) {
-				matched = match.shift();
-				tokens.push( {
-					value: matched,
-					type: type,
-					matches: match
-				} );
-				soFar = soFar.slice( matched.length );
-			}
-		}
-
-		if ( !matched ) {
-			break;
-		}
-	}
-
-	// Return the length of the invalid excess
-	// if we're just parsing
-	// Otherwise, throw an error or return tokens
-	return parseOnly ?
-		soFar.length :
-		soFar ?
-			Sizzle.error( selector ) :
-
-			// Cache the tokens
-			tokenCache( selector, groups ).slice( 0 );
-};
-
-function toSelector( tokens ) {
-	var i = 0,
-		len = tokens.length,
-		selector = "";
-	for ( ; i < len; i++ ) {
-		selector += tokens i .value;
-	}
-	return selector;
-}
-
-function addCombinator( matcher, combinator, base ) {
-	var dir = combinator.dir,
-		skip = combinator.next,
-		key = skip || dir,
-		checkNonElements = base && key === "parentNode",
-		doneName = done++;
-
-	return combinator.first ?
-
-		// Check against closest ancestor/preceding element
-		function( elem, context, xml ) {
-			while ( ( elem = elem dir  ) ) {
-				if ( elem.nodeType === 1 || checkNonElements ) {
-					return matcher( elem, context, xml );
-				}
-			}
-			return false;
-		} :
-
-		// Check against all ancestor/preceding elements
-		function( elem, context, xml ) {
-			var oldCache, uniqueCache, outerCache,
-				newCache =  dirruns, doneName ;
-
-			// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching
-			if ( xml ) {
-				while ( ( elem = elem dir  ) ) {
-					if ( elem.nodeType === 1 || checkNonElements ) {
-						if ( matcher( elem, context, xml ) ) {
-							return true;
-						}
-					}
-				}
-			} else {
-				while ( ( elem = elem dir  ) ) {
-					if ( elem.nodeType === 1 || checkNonElements ) {
-						outerCache = elem expando  || ( elem expando  = {} );
-
-						// Support: IE <9 only
-						// Defend against cloned attroperties (jQuery gh-1709)
-						uniqueCache = outerCache elem.uniqueID  ||
-							( outerCache elem.uniqueID  = {} );
-
-						if ( skip && skip === elem.nodeName.toLowerCase() ) {
-							elem = elem dir  || elem;
-						} else if ( ( oldCache = uniqueCache key  ) &&
-							oldCache 0  === dirruns && oldCache 1  === doneName ) {
-
-							// Assign to newCache so results back-propagate to previous elements
-							return ( newCache 2  = oldCache 2  );
-						} else {
-
-							// Reuse newcache so results back-propagate to previous elements
-							uniqueCache key  = newCache;
-
-							// A match means we're done; a fail means we have to keep checking
-							if ( ( newCache 2  = matcher( elem, context, xml ) ) ) {
-								return true;
-							}
-						}
-					}
-				}
-			}
-			return false;
-		};
-}
-
-function elementMatcher( matchers ) {
-	return matchers.length > 1 ?
-		function( elem, context, xml ) {
-			var i = matchers.length;
-			while ( i-- ) {
-				if ( !matchers i ( elem, context, xml ) ) {
-					return false;
-				}
-			}
-			return true;
-		} :
-		matchers 0 ;
-}
-
-function multipleContexts( selector, contexts, results ) {
-	var i = 0,
-		len = contexts.length;
-	for ( ; i < len; i++ ) {
-		Sizzle( selector, contexts i , results );
-	}
-	return results;
-}
-
-function condense( unmatched, map, filter, context, xml ) {
-	var elem,
-		newUnmatched = ,
-		i = 0,
-		len = unmatched.length,
-		mapped = map != null;
-
-	for ( ; i < len; i++ ) {
-		if ( ( elem = unmatched i  ) ) {
-			if ( !filter || filter( elem, context, xml ) ) {
-				newUnmatched.push( elem );
-				if ( mapped ) {
-					map.push( i );
-				}
-			}
-		}
-	}
-
-	return newUnmatched;
-}
-
-function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {
-	if ( postFilter && !postFilter expando  ) {
-		postFilter = setMatcher( postFilter );
-	}
-	if ( postFinder && !postFinder expando  ) {
-		postFinder = setMatcher( postFinder, postSelector );
-	}
-	return markFunction( function( seed, results, context, xml ) {
-		var temp, i, elem,
-			preMap = ,
-			postMap = ,
-			preexisting = results.length,
-
-			// Get initial elements from seed or context
-			elems = seed || multipleContexts(
-				selector || "*",
-				context.nodeType ?  context  : context,
-				
-			),
-
-			// Prefilter to get matcher input, preserving a map for seed-results synchronization
-			matcherIn = preFilter && ( seed || !selector ) ?
-				condense( elems, preMap, preFilter, context, xml ) :
-				elems,
-
-			matcherOut = matcher ?
-
-				// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
-				postFinder || ( seed ? preFilter : preexisting || postFilter ) ?
-
-					// ...intermediate processing is necessary
-					 :
-
-					// ...otherwise use results directly
-					results :
-				matcherIn;
-
-		// Find primary matches
-		if ( matcher ) {
-			matcher( matcherIn, matcherOut, context, xml );
-		}
-
-		// Apply postFilter
-		if ( postFilter ) {
-			temp = condense( matcherOut, postMap );
-			postFilter( temp, , context, xml );
-
-			// Un-match failing elements by moving them back to matcherIn
-			i = temp.length;
-			while ( i-- ) {
-				if ( ( elem = temp i  ) ) {
-					matcherOut postMap i   = !( matcherIn postMap i   = elem );
-				}
-			}
-		}
-
-		if ( seed ) {
-			if ( postFinder || preFilter ) {
-				if ( postFinder ) {
-
-					// Get the final matcherOut by condensing this intermediate into postFinder contexts
-					temp = ;
-					i = matcherOut.length;
-					while ( i-- ) {
-						if ( ( elem = matcherOut i  ) ) {
-
-							// Restore matcherIn since elem is not yet a final match
-							temp.push( ( matcherIn i  = elem ) );
-						}
-					}
-					postFinder( null, ( matcherOut =  ), temp, xml );
-				}
-
-				// Move matched elements from seed to results to keep them synchronized
-				i = matcherOut.length;
-				while ( i-- ) {
-					if ( ( elem = matcherOut i  ) &&
-						( temp = postFinder ? indexOf( seed, elem ) : preMap i  ) > -1 ) {
-
-						seed temp  = !( results temp  = elem );
-					}
-				}
-			}
-
-		// Add elements to results, through postFinder if defined
-		} else {
-			matcherOut = condense(
-				matcherOut === results ?
-					matcherOut.splice( preexisting, matcherOut.length ) :
-					matcherOut
-			);
-			if ( postFinder ) {
-				postFinder( null, results, matcherOut, xml );
-			} else {
-				push.apply( results, matcherOut );
-			}
-		}
-	} );
-}
-
-function matcherFromTokens( tokens ) {
-	var checkContext, matcher, j,
-		len = tokens.length,
-		leadingRelative = Expr.relative tokens 0 .type ,
-		implicitRelative = leadingRelative || Expr.relative " " ,
-		i = leadingRelative ? 1 : 0,
-
-		// The foundational matcher ensures that elements are reachable from top-level context(s)
-		matchContext = addCombinator( function( elem ) {
-			return elem === checkContext;
-		}, implicitRelative, true ),
-		matchAnyContext = addCombinator( function( elem ) {
-			return indexOf( checkContext, elem ) > -1;
-		}, implicitRelative, true ),
-		matchers =  function( elem, context, xml ) {
-			var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (
-				( checkContext = context ).nodeType ?
-					matchContext( elem, context, xml ) :
-					matchAnyContext( elem, context, xml ) );
-
-			// Avoid hanging onto element (issue #299)
-			checkContext = null;
-			return ret;
-		} ;
-
-	for ( ; i < len; i++ ) {
-		if ( ( matcher = Expr.relative tokens i .type  ) ) {
-			matchers =  addCombinator( elementMatcher( matchers ), matcher ) ;
-		} else {
-			matcher = Expr.filter tokens i .type .apply( null, tokens i .matches );
-
-			// Return special upon seeing a positional matcher
-			if ( matcher expando  ) {
-
-				// Find the next relative operator (if any) for proper handling
-				j = ++i;
-				for ( ; j < len; j++ ) {
-					if ( Expr.relative tokens j .type  ) {
-						break;
-					}
-				}
-				return setMatcher(
-					i > 1 && elementMatcher( matchers ),
-					i > 1 && toSelector(
-
-					// If the preceding token was a descendant combinator, insert an implicit any-element `*`
-					tokens
-						.slice( 0, i - 1 )
-						.concat( { value: tokens i - 2 .type === " " ? "*" : "" } )
-					).replace( rtrim, "$1" ),
-					matcher,
-					i < j && matcherFromTokens( tokens.slice( i, j ) ),
-					j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ),
-					j < len && toSelector( tokens )
-				);
-			}
-			matchers.push( matcher );
-		}
-	}
-
-	return elementMatcher( matchers );
-}
-
-function matcherFromGroupMatchers( elementMatchers, setMatchers ) {
-	var bySet = setMatchers.length > 0,
-		byElement = elementMatchers.length > 0,
-		superMatcher = function( seed, context, xml, results, outermost ) {
-			var elem, j, matcher,
-				matchedCount = 0,
-				i = "0",
-				unmatched = seed && ,
-				setMatched = ,
-				contextBackup = outermostContext,
-
-				// We must always have either seed elements or outermost context
-				elems = seed || byElement && Expr.find "TAG" ( "*", outermost ),
-
-				// Use integer dirruns iff this is the outermost matcher
-				dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ),
-				len = elems.length;
-
-			if ( outermost ) {
-
-				// Support: IE 11+, Edge 17 - 18+
-				// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-				// two documents; shallow comparisons work.
-				// eslint-disable-next-line eqeqeq
-				outermostContext = context == document || context || outermost;
-			}
-
-			// Add elements passing elementMatchers directly to results
-			// Support: IE<9, Safari
-			// Tolerate NodeList properties (IE: "length"; Safari: <number>) matching elements by id
-			for ( ; i !== len && ( elem = elems i  ) != null; i++ ) {
-				if ( byElement && elem ) {
-					j = 0;
-
-					// Support: IE 11+, Edge 17 - 18+
-					// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
-					// two documents; shallow comparisons work.
-					// eslint-disable-next-line eqeqeq
-					if ( !context && elem.ownerDocument != document ) {
-						setDocument( elem );
-						xml = !documentIsHTML;
-					}
-					while ( ( matcher = elementMatchers j++  ) ) {
-						if ( matcher( elem, context || document, xml ) ) {
-							results.push( elem );
-							break;
-						}
-					}
-					if ( outermost ) {
-						dirruns = dirrunsUnique;
-					}
-				}
-
-				// Track unmatched elements for set filters
-				if ( bySet ) {
-
-					// They will have gone through all possible matchers
-					if ( ( elem = !matcher && elem ) ) {
-						matchedCount--;
-					}
-
-					// Lengthen the array for every element, matched or not
-					if ( seed ) {
-						unmatched.push( elem );
-					}
-				}
-			}
-
-			// `i` is now the count of elements visited above, and adding it to `matchedCount`
-			// makes the latter nonnegative.
-			matchedCount += i;
-
-			// Apply set filters to unmatched elements
-			// NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount`
-			// equals `i`), unless we didn't visit _any_ elements in the above loop because we have
-			// no element matchers and no seed.
-			// Incrementing an initially-string "0" `i` allows `i` to remain a string only in that
-			// case, which will result in a "00" `matchedCount` that differs from `i` but is also
-			// numerically zero.
-			if ( bySet && i !== matchedCount ) {
-				j = 0;
-				while ( ( matcher = setMatchers j++  ) ) {
-					matcher( unmatched, setMatched, context, xml );
-				}
-
-				if ( seed ) {
-
-					// Reintegrate element matches to eliminate the need for sorting
-					if ( matchedCount > 0 ) {
-						while ( i-- ) {
-							if ( !( unmatched i  || setMatched i  ) ) {
-								setMatched i  = pop.call( results );
-							}
-						}
-					}
-
-					// Discard index placeholder values to get only actual matches
-					setMatched = condense( setMatched );
-				}
-
-				// Add matches to results
-				push.apply( results, setMatched );
-
-				// Seedless set matches succeeding multiple successful matchers stipulate sorting
-				if ( outermost && !seed && setMatched.length > 0 &&
-					( matchedCount + setMatchers.length ) > 1 ) {
-
-					Sizzle.uniqueSort( results );
-				}
-			}
-
-			// Override manipulation of globals by nested matchers
-			if ( outermost ) {
-				dirruns = dirrunsUnique;
-				outermostContext = contextBackup;
-			}
-
-			return unmatched;
-		};
-
-	return bySet ?
-		markFunction( superMatcher ) :
-		superMatcher;
-}
-
-compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {
-	var i,
-		setMatchers = ,
-		elementMatchers = ,
-		cached = compilerCache selector + " " ;
-
-	if ( !cached ) {
-
-		// Generate a function of recursive functions that can be used to check each element
-		if ( !match ) {
-			match = tokenize( selector );
-		}
-		i = match.length;
-		while ( i-- ) {
-			cached = matcherFromTokens( match i  );
-			if ( cached expando  ) {
-				setMatchers.push( cached );
-			} else {
-				elementMatchers.push( cached );
-			}
-		}
-
-		// Cache the compiled function
-		cached = compilerCache(
-			selector,
-			matcherFromGroupMatchers( elementMatchers, setMatchers )
-		);
-
-		// Save selector and tokenization
-		cached.selector = selector;
-	}
-	return cached;
-};
-
-/**
- * A low-level selection function that works with Sizzle's compiled
- *  selector functions
- * @param {String|Function} selector A selector or a pre-compiled
- *  selector function built with Sizzle.compile
- * @param {Element} context
- * @param {Array} results
- * @param {Array} seed A set of elements to match against
- */
-select = Sizzle.select = function( selector, context, results, seed ) {
-	var i, tokens, token, type, find,
-		compiled = typeof selector === "function" && selector,
-		match = !seed && tokenize( ( selector = compiled.selector || selector ) );
-
-	results = results || ;
-
-	// Try to minimize operations if there is only one selector in the list and no seed
-	// (the latter of which guarantees us context)
-	if ( match.length === 1 ) {
-
-		// Reduce context if the leading compound selector is an ID
-		tokens = match 0  = match 0 .slice( 0 );
-		if ( tokens.length > 2 && ( token = tokens 0  ).type === "ID" &&
-			context.nodeType === 9 && documentIsHTML && Expr.relative tokens 1 .type  ) {
-
-			context = ( Expr.find "ID" ( token.matches 0 
-				.replace( runescape, funescape ), context ) ||  ) 0 ;
-			if ( !context ) {
-				return results;
-
-			// Precompiled matchers will still verify ancestry, so step up a level
-			} else if ( compiled ) {
-				context = context.parentNode;
-			}
-
-			selector = selector.slice( tokens.shift().value.length );
-		}
-
-		// Fetch a seed set for right-to-left matching
-		i = matchExpr "needsContext" .test( selector ) ? 0 : tokens.length;
-		while ( i-- ) {
-			token = tokens i ;
-
-			// Abort if we hit a combinator
-			if ( Expr.relative ( type = token.type )  ) {
-				break;
-			}
-			if ( ( find = Expr.find type  ) ) {
-
-				// Search, expanding context for leading sibling combinators
-				if ( ( seed = find(
-					token.matches 0 .replace( runescape, funescape ),
-					rsibling.test( tokens 0 .type ) && testContext( context.parentNode ) ||
-						context
-				) ) ) {
-
-					// If seed is empty or no tokens remain, we can return early
-					tokens.splice( i, 1 );
-					selector = seed.length && toSelector( tokens );
-					if ( !selector ) {
-						push.apply( results, seed );
-						return results;
-					}
-
-					break;
-				}
-			}
-		}
-	}
-
-	// Compile and execute a filtering function if one is not provided
-	// Provide `match` to avoid retokenization if we modified the selector above
-	( compiled || compile( selector, match ) )(
-		seed,
-		context,
-		!documentIsHTML,
-		results,
-		!context || rsibling.test( selector ) && testContext( context.parentNode ) || context
-	);
-	return results;
-};
-
-// One-time assignments
-
-// Sort stability
-support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando;
-
-// Support: Chrome 14-35+
-// Always assume duplicates if they aren't passed to the comparison function
-support.detectDuplicates = !!hasDuplicate;
-
-// Initialize against the default document
-setDocument();
-
-// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)
-// Detached nodes confoundingly follow *each other*
-support.sortDetached = assert( function( el ) {
-
-	// Should return 1, but returns 4 (following)
-	return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1;
-} );
-
-// Support: IE<8
-// Prevent attribute/property "interpolation"
-// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
-if ( !assert( function( el ) {
-	el.innerHTML = "<a href='#'></a>";
-	return el.firstChild.getAttribute( "href" ) === "#";
-} ) ) {
-	addHandle( "type|href|height|width", function( elem, name, isXML ) {
-		if ( !isXML ) {
-			return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 );
-		}
-	} );
-}
-
-// Support: IE<9
-// Use defaultValue in place of getAttribute("value")
-if ( !support.attributes || !assert( function( el ) {
-	el.innerHTML = "<input/>";
-	el.firstChild.setAttribute( "value", "" );
-	return el.firstChild.getAttribute( "value" ) === "";
-} ) ) {
-	addHandle( "value", function( elem, _name, isXML ) {
-		if ( !isXML && elem.nodeName.toLowerCase() === "input" ) {
-			return elem.defaultValue;
-		}
-	} );
-}
-
-// Support: IE<9
-// Use getAttributeNode to fetch booleans when getAttribute lies
-if ( !assert( function( el ) {
-	return el.getAttribute( "disabled" ) == null;
-} ) ) {
-	addHandle( booleans, function( elem, name, isXML ) {
-		var val;
-		if ( !isXML ) {
-			return elem name  === true ? name.toLowerCase() :
-				( val = elem.getAttributeNode( name ) ) && val.specified ?
-					val.value :
-					null;
-		}
-	} );
-}
-
-return Sizzle;
-
-} )( window );
-
-
-
-jQuery.find = Sizzle;
-jQuery.expr = Sizzle.selectors;
-
-// Deprecated
-jQuery.expr ":"  = jQuery.expr.pseudos;
-jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;
-jQuery.text = Sizzle.getText;
-jQuery.isXMLDoc = Sizzle.isXML;
-jQuery.contains = Sizzle.contains;
-jQuery.escapeSelector = Sizzle.escape;
-
-
-
-
-var dir = function( elem, dir, until ) {
-	var matched = ,
-		truncate = until !== undefined;
-
-	while ( ( elem = elem dir  ) && elem.nodeType !== 9 ) {
-		if ( elem.nodeType === 1 ) {
-			if ( truncate && jQuery( elem ).is( until ) ) {
-				break;
-			}
-			matched.push( elem );
-		}
-	}
-	return matched;
-};
-
-
-var siblings = function( n, elem ) {
-	var matched = ;
-
-	for ( ; n; n = n.nextSibling ) {
-		if ( n.nodeType === 1 && n !== elem ) {
-			matched.push( n );
-		}
-	}
-
-	return matched;
-};
-
-
-var rneedsContext = jQuery.expr.match.needsContext;
-
-
-
-function nodeName( elem, name ) {
-
-  return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
-
-};
-var rsingleTag = ( /^<(a-z^\/\0>:\x20\t\r\n\f*)\x20\t\r\n\f*\/?>(?:<\/\1>|)$/i );
-
-
-
-// Implement the identical functionality for filter and not
-function winnow( elements, qualifier, not ) {
-	if ( isFunction( qualifier ) ) {
-		return jQuery.grep( elements, function( elem, i ) {
-			return !!qualifier.call( elem, i, elem ) !== not;
-		} );
-	}
-
-	// Single element
-	if ( qualifier.nodeType ) {
-		return jQuery.grep( elements, function( elem ) {
-			return ( elem === qualifier ) !== not;
-		} );
-	}
-
-	// Arraylike of elements (jQuery, arguments, Array)
-	if ( typeof qualifier !== "string" ) {
-		return jQuery.grep( elements, function( elem ) {
-			return ( indexOf.call( qualifier, elem ) > -1 ) !== not;
-		} );
-	}
-
-	// Filtered directly for both simple and complex selectors
-	return jQuery.filter( qualifier, elements, not );
-}
-
-jQuery.filter = function( expr, elems, not ) {
-	var elem = elems 0 ;
-
-	if ( not ) {
-		expr = ":not(" + expr + ")";
-	}
-
-	if ( elems.length === 1 && elem.nodeType === 1 ) {
-		return jQuery.find.matchesSelector( elem, expr ) ?  elem  : ;
-	}
-
-	return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {
-		return elem.nodeType === 1;
-	} ) );
-};
-
-jQuery.fn.extend( {
-	find: function( selector ) {
-		var i, ret,
-			len = this.length,
-			self = this;
-
-		if ( typeof selector !== "string" ) {
-			return this.pushStack( jQuery( selector ).filter( function() {
-				for ( i = 0; i < len; i++ ) {
-					if ( jQuery.contains( self i , this ) ) {
-						return true;
-					}
-				}
-			} ) );
-		}
-
-		ret = this.pushStack(  );
-
-		for ( i = 0; i < len; i++ ) {
-			jQuery.find( selector, self i , ret );
-		}
-
-		return len > 1 ? jQuery.uniqueSort( ret ) : ret;
-	},
-	filter: function( selector ) {
-		return this.pushStack( winnow( this, selector || , false ) );
-	},
-	not: function( selector ) {
-		return this.pushStack( winnow( this, selector || , true ) );
-	},
-	is: function( selector ) {
-		return !!winnow(
-			this,
-
-			// If this is a positional/relative selector, check membership in the returned set
-			// so $("p:first").is("p:last") won't return true for a doc with two "p".
-			typeof selector === "string" && rneedsContext.test( selector ) ?
-				jQuery( selector ) :
-				selector || ,
-			false
-		).length;
-	}
-} );
-
-
-// Initialize a jQuery object
-
-
-// A central reference to the root jQuery(document)
-var rootjQuery,
-
-	// A simple way to check for HTML strings
-	// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
-	// Strict HTML recognition (#11290: must start with <)
-	// Shortcut simple #id case for speed
-	rquickExpr = /^(?:\s*(<\w\W+>)^>*|#(\w-+))$/,
-
-	init = jQuery.fn.init = function( selector, context, root ) {
-		var match, elem;
-
-		// HANDLE: $(""), $(null), $(undefined), $(false)
-		if ( !selector ) {
-			return this;
-		}
-
-		// Method init() accepts an alternate rootjQuery
-		// so migrate can support jQuery.sub (gh-2101)
-		root = root || rootjQuery;
-
-		// Handle HTML strings
-		if ( typeof selector === "string" ) {
-			if ( selector 0  === "<" &&
-				selector selector.length - 1  === ">" &&
-				selector.length >= 3 ) {
-
-				// Assume that strings that start and end with <> are HTML and skip the regex check
-				match =  null, selector, null ;
-
-			} else {
-				match = rquickExpr.exec( selector );
-			}
-
-			// Match html or make sure no context is specified for #id
-			if ( match && ( match 1  || !context ) ) {
-
-				// HANDLE: $(html) -> $(array)
-				if ( match 1  ) {
-					context = context instanceof jQuery ? context 0  : context;
-
-					// Option to run scripts is true for back-compat
-					// Intentionally let the error be thrown if parseHTML is not present
-					jQuery.merge( this, jQuery.parseHTML(
-						match 1 ,
-						context && context.nodeType ? context.ownerDocument || context : document,
-						true
-					) );
-
-					// HANDLE: $(html, props)
-					if ( rsingleTag.test( match 1  ) && jQuery.isPlainObject( context ) ) {
-						for ( match in context ) {
-
-							// Properties of context are called as methods if possible
-							if ( isFunction( this match  ) ) {
-								this match ( context match  );
-
-							// ...and otherwise set as attributes
-							} else {
-								this.attr( match, context match  );
-							}
-						}
-					}
-
-					return this;
-
-				// HANDLE: $(#id)
-				} else {
-					elem = document.getElementById( match 2  );
-
-					if ( elem ) {
-
-						// Inject the element directly into the jQuery object
-						this 0  = elem;
-						this.length = 1;
-					}
-					return this;
-				}
-
-			// HANDLE: $(expr, $(...))
-			} else if ( !context || context.jquery ) {
-				return ( context || root ).find( selector );
-
-			// HANDLE: $(expr, context)
-			// (which is just equivalent to: $(context).find(expr)
-			} else {
-				return this.constructor( context ).find( selector );
-			}
-
-		// HANDLE: $(DOMElement)
-		} else if ( selector.nodeType ) {
-			this 0  = selector;
-			this.length = 1;
-			return this;
-
-		// HANDLE: $(function)
-		// Shortcut for document ready
-		} else if ( isFunction( selector ) ) {
-			return root.ready !== undefined ?
-				root.ready( selector ) :
-
-				// Execute immediately if ready is not present
-				selector( jQuery );
-		}
-
-		return jQuery.makeArray( selector, this );
-	};
-
-// Give the init function the jQuery prototype for later instantiation
-init.prototype = jQuery.fn;
-
-// Initialize central reference
-rootjQuery = jQuery( document );
-
-
-var rparentsprev = /^(?:parents|prev(?:Until|All))/,
-
-	// Methods guaranteed to produce a unique set when starting from a unique set
-	guaranteedUnique = {
-		children: true,
-		contents: true,
-		next: true,
-		prev: true
-	};
-
-jQuery.fn.extend( {
-	has: function( target ) {
-		var targets = jQuery( target, this ),
-			l = targets.length;
-
-		return this.filter( function() {
-			var i = 0;
-			for ( ; i < l; i++ ) {
-				if ( jQuery.contains( this, targets i  ) ) {
-					return true;
-				}
-			}
-		} );
-	},
-
-	closest: function( selectors, context ) {
-		var cur,
-			i = 0,
-			l = this.length,
-			matched = ,
-			targets = typeof selectors !== "string" && jQuery( selectors );
-
-		// Positional selectors never match, since there's no _selection_ context
-		if ( !rneedsContext.test( selectors ) ) {
-			for ( ; i < l; i++ ) {
-				for ( cur = this i ; cur && cur !== context; cur = cur.parentNode ) {
-
-					// Always skip document fragments
-					if ( cur.nodeType < 11 && ( targets ?
-						targets.index( cur ) > -1 :
-
-						// Don't pass non-elements to Sizzle
-						cur.nodeType === 1 &&
-							jQuery.find.matchesSelector( cur, selectors ) ) ) {
-
-						matched.push( cur );
-						break;
-					}
-				}
-			}
-		}
-
-		return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );
-	},
-
-	// Determine the position of an element within the set
-	index: function( elem ) {
-
-		// No argument, return index in parent
-		if ( !elem ) {
-			return ( this 0  && this 0 .parentNode ) ? this.first().prevAll().length : -1;
-		}
-
-		// Index in selector
-		if ( typeof elem === "string" ) {
-			return indexOf.call( jQuery( elem ), this 0  );
-		}
-
-		// Locate the position of the desired element
-		return indexOf.call( this,
-
-			// If it receives a jQuery object, the first element is used
-			elem.jquery ? elem 0  : elem
-		);
-	},
-
-	add: function( selector, context ) {
-		return this.pushStack(
-			jQuery.uniqueSort(
-				jQuery.merge( this.get(), jQuery( selector, context ) )
-			)
-		);
-	},
-
-	addBack: function( selector ) {
-		return this.add( selector == null ?
-			this.prevObject : this.prevObject.filter( selector )
-		);
-	}
-} );
-
-function sibling( cur, dir ) {
-	while ( ( cur = cur dir  ) && cur.nodeType !== 1 ) {}
-	return cur;
-}
-
-jQuery.each( {
-	parent: function( elem ) {
-		var parent = elem.parentNode;
-		return parent && parent.nodeType !== 11 ? parent : null;
-	},
-	parents: function( elem ) {
-		return dir( elem, "parentNode" );
-	},
-	parentsUntil: function( elem, _i, until ) {
-		return dir( elem, "parentNode", until );
-	},
-	next: function( elem ) {
-		return sibling( elem, "nextSibling" );
-	},
-	prev: function( elem ) {
-		return sibling( elem, "previousSibling" );
-	},
-	nextAll: function( elem ) {
-		return dir( elem, "nextSibling" );
-	},
-	prevAll: function( elem ) {
-		return dir( elem, "previousSibling" );
-	},
-	nextUntil: function( elem, _i, until ) {
-		return dir( elem, "nextSibling", until );
-	},
-	prevUntil: function( elem, _i, until ) {
-		return dir( elem, "previousSibling", until );
-	},
-	siblings: function( elem ) {
-		return siblings( ( elem.parentNode || {} ).firstChild, elem );
-	},
-	children: function( elem ) {
-		return siblings( elem.firstChild );
-	},
-	contents: function( elem ) {
-		if ( elem.contentDocument != null &&
-
-			// Support: IE 11+
-			// <object> elements with no `data` attribute has an object
-			// `contentDocument` with a `null` prototype.
-			getProto( elem.contentDocument ) ) {
-
-			return elem.contentDocument;
-		}
-
-		// Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only
-		// Treat the template element as a regular one in browsers that
-		// don't support it.
-		if ( nodeName( elem, "template" ) ) {
-			elem = elem.content || elem;
-		}
-
-		return jQuery.merge( , elem.childNodes );
-	}
-}, function( name, fn ) {
-	jQuery.fn name  = function( until, selector ) {
-		var matched = jQuery.map( this, fn, until );
-
-		if ( name.slice( -5 ) !== "Until" ) {
-			selector = until;
-		}
-
-		if ( selector && typeof selector === "string" ) {
-			matched = jQuery.filter( selector, matched );
-		}
-
-		if ( this.length > 1 ) {
-
-			// Remove duplicates
-			if ( !guaranteedUnique name  ) {
-				jQuery.uniqueSort( matched );
-			}
-
-			// Reverse order for parents* and prev-derivatives
-			if ( rparentsprev.test( name ) ) {
-				matched.reverse();
-			}
-		}
-
-		return this.pushStack( matched );
-	};
-} );
-var rnothtmlwhite = ( /^\x20\t\r\n\f+/g );
-
-
-
-// Convert String-formatted options into Object-formatted ones
-function createOptions( options ) {
-	var object = {};
-	jQuery.each( options.match( rnothtmlwhite ) || , function( _, flag ) {
-		object flag  = true;
-	} );
-	return object;
-}
-
-/*
- * Create a callback list using the following parameters:
- *
- *	options: an optional list of space-separated options that will change how
- *			the callback list behaves or a more traditional option object
- *
- * By default a callback list will act like an event callback list and can be
- * "fired" multiple times.
- *
- * Possible options:
- *
- *	once:			will ensure the callback list can only be fired once (like a Deferred)
- *
- *	memory:			will keep track of previous values and will call any callback added
- *					after the list has been fired right away with the latest "memorized"
- *					values (like a Deferred)
- *
- *	unique:			will ensure a callback can only be added once (no duplicate in the list)
- *
- *	stopOnFalse:	interrupt callings when a callback returns false
- *
- */
-jQuery.Callbacks = function( options ) {
-
-	// Convert options from String-formatted to Object-formatted if needed
-	// (we check in cache first)
-	options = typeof options === "string" ?
-		createOptions( options ) :
-		jQuery.extend( {}, options );
-
-	var // Flag to know if list is currently firing
-		firing,
-
-		// Last fire value for non-forgettable lists
-		memory,
-
-		// Flag to know if list was already fired
-		fired,
-
-		// Flag to prevent firing
-		locked,
-
-		// Actual callback list
-		list = ,
-
-		// Queue of execution data for repeatable lists
-		queue = ,
-
-		// Index of currently firing callback (modified by add/remove as needed)
-		firingIndex = -1,
-
-		// Fire callbacks
-		fire = function() {
-
-			// Enforce single-firing
-			locked = locked || options.once;
-
-			// Execute callbacks for all pending executions,
-			// respecting firingIndex overrides and runtime changes
-			fired = firing = true;
-			for ( ; queue.length; firingIndex = -1 ) {
-				memory = queue.shift();
-				while ( ++firingIndex < list.length ) {
-
-					// Run callback and check for early termination
-					if ( list firingIndex .apply( memory 0 , memory 1  ) === false &&
-						options.stopOnFalse ) {
-
-						// Jump to end and forget the data so .add doesn't re-fire
-						firingIndex = list.length;
-						memory = false;
-					}
-				}
-			}
-
-			// Forget the data if we're done with it
-			if ( !options.memory ) {
-				memory = false;
-			}
-
-			firing = false;
-
-			// Clean up if we're done firing for good
-			if ( locked ) {
-
-				// Keep an empty list if we have data for future add calls
-				if ( memory ) {
-					list = ;
-
-				// Otherwise, this object is spent
-				} else {
-					list = "";
-				}
-			}
-		},
-
-		// Actual Callbacks object
-		self = {
-
-			// Add a callback or a collection of callbacks to the list
-			add: function() {
-				if ( list ) {
-
-					// If we have memory from a past run, we should fire after adding
-					if ( memory && !firing ) {
-						firingIndex = list.length - 1;
-						queue.push( memory );
-					}
-
-					( function add( args ) {
-						jQuery.each( args, function( _, arg ) {
-							if ( isFunction( arg ) ) {
-								if ( !options.unique || !self.has( arg ) ) {
-									list.push( arg );
-								}
-							} else if ( arg && arg.length && toType( arg ) !== "string" ) {
-
-								// Inspect recursively
-								add( arg );
-							}
-						} );
-					} )( arguments );
-
-					if ( memory && !firing ) {
-						fire();
-					}
-				}
-				return this;
-			},
-
-			// Remove a callback from the list
-			remove: function() {
-				jQuery.each( arguments, function( _, arg ) {
-					var index;
-					while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {
-						list.splice( index, 1 );
-
-						// Handle firing indexes
-						if ( index <= firingIndex ) {
-							firingIndex--;
-						}
-					}
-				} );
-				return this;
-			},
-
-			// Check if a given callback is in the list.
-			// If no argument is given, return whether or not list has callbacks attached.
-			has: function( fn ) {
-				return fn ?
-					jQuery.inArray( fn, list ) > -1 :
-					list.length > 0;
-			},
-
-			// Remove all callbacks from the list
-			empty: function() {
-				if ( list ) {
-					list = ;
-				}
-				return this;
-			},
-
-			// Disable .fire and .add
-			// Abort any current/pending executions
-			// Clear all callbacks and values
-			disable: function() {
-				locked = queue = ;
-				list = memory = "";
-				return this;
-			},
-			disabled: function() {
-				return !list;
-			},
-
-			// Disable .fire
-			// Also disable .add unless we have memory (since it would have no effect)
-			// Abort any pending executions
-			lock: function() {
-				locked = queue = ;
-				if ( !memory && !firing ) {
-					list = memory = "";
-				}
-				return this;
-			},
-			locked: function() {
-				return !!locked;
-			},
-
-			// Call all callbacks with the given context and arguments
-			fireWith: function( context, args ) {
-				if ( !locked ) {
-					args = args || ;
-					args =  context, args.slice ? args.slice() : args ;
-					queue.push( args );
-					if ( !firing ) {
-						fire();
-					}
-				}
-				return this;
-			},
-
-			// Call all the callbacks with the given arguments
-			fire: function() {
-				self.fireWith( this, arguments );
-				return this;
-			},
-
-			// To know if the callbacks have already been called at least once
-			fired: function() {
-				return !!fired;
-			}
-		};
-
-	return self;
-};
-
-
-function Identity( v ) {
-	return v;
-}
-function Thrower( ex ) {
-	throw ex;
-}
-
-function adoptValue( value, resolve, reject, noValue ) {
-	var method;
-
-	try {
-
-		// Check for promise aspect first to privilege synchronous behavior
-		if ( value && isFunction( ( method = value.promise ) ) ) {
-			method.call( value ).done( resolve ).fail( reject );
-
-		// Other thenables
-		} else if ( value && isFunction( ( method = value.then ) ) ) {
-			method.call( value, resolve, reject );
-
-		// Other non-thenables
-		} else {
-
-			// Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer:
-			// * false:  value .slice( 0 ) => resolve( value )
-			// * true:  value .slice( 1 ) => resolve()
-			resolve.apply( undefined,  value .slice( noValue ) );
-		}
-
-	// For Promises/A+, convert exceptions into rejections
-	// Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in
-	// Deferred#then to conditionally suppress rejection.
-	} catch ( value ) {
-
-		// Support: Android 4.0 only
-		// Strict mode functions invoked without .call/.apply get global-object context
-		reject.apply( undefined,  value  );
-	}
-}
-
-jQuery.extend( {
-
-	Deferred: function( func ) {
-		var tuples = 
-
-				// action, add listener, callbacks,
-				// ... .then handlers, argument index, final state
-				 "notify", "progress", jQuery.Callbacks( "memory" ),
-					jQuery.Callbacks( "memory" ), 2 ,
-				 "resolve", "done", jQuery.Callbacks( "once memory" ),
-					jQuery.Callbacks( "once memory" ), 0, "resolved" ,
-				 "reject", "fail", jQuery.Callbacks( "once memory" ),
-					jQuery.Callbacks( "once memory" ), 1, "rejected" 
-			,
-			state = "pending",
-			promise = {
-				state: function() {
-					return state;
-				},
-				always: function() {
-					deferred.done( arguments ).fail( arguments );
-					return this;
-				},
-				"catch": function( fn ) {
-					return promise.then( null, fn );
-				},
-
-				// Keep pipe for back-compat
-				pipe: function( /* fnDone, fnFail, fnProgress */ ) {
-					var fns = arguments;
-
-					return jQuery.Deferred( function( newDefer ) {
-						jQuery.each( tuples, function( _i, tuple ) {
-
-							// Map tuples (progress, done, fail) to arguments (done, fail, progress)
-							var fn = isFunction( fns tuple 4   ) && fns tuple 4  ;
-
-							// deferred.progress(function() { bind to newDefer or newDefer.notify })
-							// deferred.done(function() { bind to newDefer or newDefer.resolve })
-							// deferred.fail(function() { bind to newDefer or newDefer.reject })
-							deferred tuple 1  ( function() {
-								var returned = fn && fn.apply( this, arguments );
-								if ( returned && isFunction( returned.promise ) ) {
-									returned.promise()
-										.progress( newDefer.notify )
-										.done( newDefer.resolve )
-										.fail( newDefer.reject );
-								} else {
-									newDefer tuple 0  + "With" (
-										this,
-										fn ?  returned  : arguments
-									);
-								}
-							} );
-						} );
-						fns = null;
-					} ).promise();
-				},
-				then: function( onFulfilled, onRejected, onProgress ) {
-					var maxDepth = 0;
-					function resolve( depth, deferred, handler, special ) {
-						return function() {
-							var that = this,
-								args = arguments,
-								mightThrow = function() {
-									var returned, then;
-
-									// Support: Promises/A+ section 2.3.3.3.3
-									// https://promisesaplus.com/#point-59
-									// Ignore double-resolution attempts
-									if ( depth < maxDepth ) {
-										return;
-									}
-
-									returned = handler.apply( that, args );
-
-									// Support: Promises/A+ section 2.3.1
-									// https://promisesaplus.com/#point-48
-									if ( returned === deferred.promise() ) {
-										throw new TypeError( "Thenable self-resolution" );
-									}
-
-									// Support: Promises/A+ sections 2.3.3.1, 3.5
-									// https://promisesaplus.com/#point-54
-									// https://promisesaplus.com/#point-75
-									// Retrieve `then` only once
-									then = returned &&
-
-										// Support: Promises/A+ section 2.3.4
-										// https://promisesaplus.com/#point-64
-										// Only check objects and functions for thenability
-										( typeof returned === "object" ||
-											typeof returned === "function" ) &&
-										returned.then;
-
-									// Handle a returned thenable
-									if ( isFunction( then ) ) {
-
-										// Special processors (notify) just wait for resolution
-										if ( special ) {
-											then.call(
-												returned,
-												resolve( maxDepth, deferred, Identity, special ),
-												resolve( maxDepth, deferred, Thrower, special )
-											);
-
-										// Normal processors (resolve) also hook into progress
-										} else {
-
-											// ...and disregard older resolution values
-											maxDepth++;
-
-											then.call(
-												returned,
-												resolve( maxDepth, deferred, Identity, special ),
-												resolve( maxDepth, deferred, Thrower, special ),
-												resolve( maxDepth, deferred, Identity,
-													deferred.notifyWith )
-											);
-										}
-
-									// Handle all other returned values
-									} else {
-
-										// Only substitute handlers pass on context
-										// and multiple values (non-spec behavior)
-										if ( handler !== Identity ) {
-											that = undefined;
-											args =  returned ;
-										}
-
-										// Process the value(s)
-										// Default process is resolve
-										( special || deferred.resolveWith )( that, args );
-									}
-								},
-
-								// Only normal processors (resolve) catch and reject exceptions
-								process = special ?
-									mightThrow :
-									function() {
-										try {
-											mightThrow();
-										} catch ( e ) {
-
-											if ( jQuery.Deferred.exceptionHook ) {
-												jQuery.Deferred.exceptionHook( e,
-													process.stackTrace );
-											}
-
-											// Support: Promises/A+ section 2.3.3.3.4.1
-											// https://promisesaplus.com/#point-61
-											// Ignore post-resolution exceptions
-											if ( depth + 1 >= maxDepth ) {
-
-												// Only substitute handlers pass on context
-												// and multiple values (non-spec behavior)
-												if ( handler !== Thrower ) {
-													that = undefined;
-													args =  e ;
-												}
-
-												deferred.rejectWith( that, args );
-											}
-										}
-									};
-
-							// Support: Promises/A+ section 2.3.3.3.1
-							// https://promisesaplus.com/#point-57
-							// Re-resolve promises immediately to dodge false rejection from
-							// subsequent errors
-							if ( depth ) {
-								process();
-							} else {
-
-								// Call an optional hook to record the stack, in case of exception
-								// since it's otherwise lost when execution goes async
-								if ( jQuery.Deferred.getStackHook ) {
-									process.stackTrace = jQuery.Deferred.getStackHook();
-								}
-								window.setTimeout( process );
-							}
-						};
-					}
-
-					return jQuery.Deferred( function( newDefer ) {
-
-						// progress_handlers.add( ... )
-						tuples 0  3 .add(
-							resolve(
-								0,
-								newDefer,
-								isFunction( onProgress ) ?
-									onProgress :
-									Identity,
-								newDefer.notifyWith
-							)
-						);
-
-						// fulfilled_handlers.add( ... )
-						tuples 1  3 .add(
-							resolve(
-								0,
-								newDefer,
-								isFunction( onFulfilled ) ?
-									onFulfilled :
-									Identity
-							)
-						);
-
-						// rejected_handlers.add( ... )
-						tuples 2  3 .add(
-							resolve(
-								0,
-								newDefer,
-								isFunction( onRejected ) ?
-									onRejected :
-									Thrower
-							)
-						);
-					} ).promise();
-				},
-
-				// Get a promise for this deferred
-				// If obj is provided, the promise aspect is added to the object
-				promise: function( obj ) {
-					return obj != null ? jQuery.extend( obj, promise ) : promise;
-				}
-			},
-			deferred = {};
-
-		// Add list-specific methods
-		jQuery.each( tuples, function( i, tuple ) {
-			var list = tuple 2 ,
-				stateString = tuple 5 ;
-
-			// promise.progress = list.add
-			// promise.done = list.add
-			// promise.fail = list.add
-			promise tuple 1   = list.add;
-
-			// Handle state
-			if ( stateString ) {
-				list.add(
-					function() {
-
-						// state = "resolved" (i.e., fulfilled)
-						// state = "rejected"
-						state = stateString;
-					},
-
-					// rejected_callbacks.disable
-					// fulfilled_callbacks.disable
-					tuples 3 - i  2 .disable,
-
-					// rejected_handlers.disable
-					// fulfilled_handlers.disable
-					tuples 3 - i  3 .disable,
-
-					// progress_callbacks.lock
-					tuples 0  2 .lock,
-
-					// progress_handlers.lock
-					tuples 0  3 .lock
-				);
-			}
-
-			// progress_handlers.fire
-			// fulfilled_handlers.fire
-			// rejected_handlers.fire
-			list.add( tuple 3 .fire );
-
-			// deferred.notify = function() { deferred.notifyWith(...) }
-			// deferred.resolve = function() { deferred.resolveWith(...) }
-			// deferred.reject = function() { deferred.rejectWith(...) }
-			deferred tuple 0   = function() {
-				deferred tuple 0  + "With" ( this === deferred ? undefined : this, arguments );
-				return this;
-			};
-
-			// deferred.notifyWith = list.fireWith
-			// deferred.resolveWith = list.fireWith
-			// deferred.rejectWith = list.fireWith
-			deferred tuple 0  + "With"  = list.fireWith;
-		} );
-
-		// Make the deferred a promise
-		promise.promise( deferred );
-
-		// Call given func if any
-		if ( func ) {
-			func.call( deferred, deferred );
-		}
-
-		// All done!
-		return deferred;
-	},
-
-	// Deferred helper
-	when: function( singleValue ) {
-		var
-
-			// count of uncompleted subordinates
-			remaining = arguments.length,
-
-			// count of unprocessed arguments
-			i = remaining,
-
-			// subordinate fulfillment data
-			resolveContexts = Array( i ),
-			resolveValues = slice.call( arguments ),
-
-			// the master Deferred
-			master = jQuery.Deferred(),
-
-			// subordinate callback factory
-			updateFunc = function( i ) {
-				return function( value ) {
-					resolveContexts i  = this;
-					resolveValues i  = arguments.length > 1 ? slice.call( arguments ) : value;
-					if ( !( --remaining ) ) {
-						master.resolveWith( resolveContexts, resolveValues );
-					}
-				};
-			};
-
-		// Single- and empty arguments are adopted like Promise.resolve
-		if ( remaining <= 1 ) {
-			adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject,
-				!remaining );
-
-			// Use .then() to unwrap secondary thenables (cf. gh-3000)
-			if ( master.state() === "pending" ||
-				isFunction( resolveValues i  && resolveValues i .then ) ) {
-
-				return master.then();
-			}
-		}
-
-		// Multiple arguments are aggregated like Promise.all array elements
-		while ( i-- ) {
-			adoptValue( resolveValues i , updateFunc( i ), master.reject );
-		}
-
-		return master.promise();
-	}
-} );
-
-
-// These usually indicate a programmer mistake during development,
-// warn about them ASAP rather than swallowing them by default.
-var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;
-
-jQuery.Deferred.exceptionHook = function( error, stack ) {
-
-	// Support: IE 8 - 9 only
-	// Console exists when dev tools are open, which can happen at any time
-	if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) {
-		window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack );
-	}
-};
-
-
-
-
-jQuery.readyException = function( error ) {
-	window.setTimeout( function() {
-		throw error;
-	} );
-};
-
-
-
-
-// The deferred used on DOM ready
-var readyList = jQuery.Deferred();
-
-jQuery.fn.ready = function( fn ) {
-
-	readyList
-		.then( fn )
-
-		// Wrap jQuery.readyException in a function so that the lookup
-		// happens at the time of error handling instead of callback
-		// registration.
-		.catch( function( error ) {
-			jQuery.readyException( error );
-		} );
-
-	return this;
-};
-
-jQuery.extend( {
-
-	// Is the DOM ready to be used? Set to true once it occurs.
-	isReady: false,
-
-	// A counter to track how many items to wait for before
-	// the ready event fires. See #6781
-	readyWait: 1,
-
-	// Handle when the DOM is ready
-	ready: function( wait ) {
-
-		// Abort if there are pending holds or we're already ready
-		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
-			return;
-		}
-
-		// Remember that the DOM is ready
-		jQuery.isReady = true;
-
-		// If a normal DOM Ready event fired, decrement, and wait if need be
-		if ( wait !== true && --jQuery.readyWait > 0 ) {
-			return;
-		}
-
-		// If there are functions bound, to execute
-		readyList.resolveWith( document,  jQuery  );
-	}
-} );
-
-jQuery.ready.then = readyList.then;
-
-// The ready event handler and self cleanup method
-function completed() {
-	document.removeEventListener( "DOMContentLoaded", completed );
-	window.removeEventListener( "load", completed );
-	jQuery.ready();
-}
-
-// Catch cases where $(document).ready() is called
-// after the browser event has already occurred.
-// Support: IE <=9 - 10 only
-// Older IE sometimes signals "interactive" too soon
-if ( document.readyState === "complete" ||
-	( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
-
-	// Handle it asynchronously to allow scripts the opportunity to delay ready
-	window.setTimeout( jQuery.ready );
-
-} else {
-
-	// Use the handy event callback
-	document.addEventListener( "DOMContentLoaded", completed );
-
-	// A fallback to window.onload, that will always work
-	window.addEventListener( "load", completed );
-}
-
-
-
-
-// Multifunctional method to get and set values of a collection
-// The value/s can optionally be executed if it's a function
-var access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
-	var i = 0,
-		len = elems.length,
-		bulk = key == null;
-
-	// Sets many values
-	if ( toType( key ) === "object" ) {
-		chainable = true;
-		for ( i in key ) {
-			access( elems, fn, i, key i , true, emptyGet, raw );
-		}
-
-	// Sets one value
-	} else if ( value !== undefined ) {
-		chainable = true;
-
-		if ( !isFunction( value ) ) {
-			raw = true;
-		}
-
-		if ( bulk ) {
-
-			// Bulk operations run against the entire set
-			if ( raw ) {
-				fn.call( elems, value );
-				fn = null;
-
-			// ...except when executing function values
-			} else {
-				bulk = fn;
-				fn = function( elem, _key, value ) {
-					return bulk.call( jQuery( elem ), value );
-				};
-			}
-		}
-
-		if ( fn ) {
-			for ( ; i < len; i++ ) {
-				fn(
-					elems i , key, raw ?
-					value :
-					value.call( elems i , i, fn( elems i , key ) )
-				);
-			}
-		}
-	}
-
-	if ( chainable ) {
-		return elems;
-	}
-
-	// Gets
-	if ( bulk ) {
-		return fn.call( elems );
-	}
-
-	return len ? fn( elems 0 , key ) : emptyGet;
-};
-
-
-// Matches dashed string for camelizing
-var rmsPrefix = /^-ms-/,
-	rdashAlpha = /-(a-z)/g;
-
-// Used by camelCase as callback to replace()
-function fcamelCase( _all, letter ) {
-	return letter.toUpperCase();
-}
-
-// Convert dashed to camelCase; used by the css and data modules
-// Support: IE <=9 - 11, Edge 12 - 15
-// Microsoft forgot to hump their vendor prefix (#9572)
-function camelCase( string ) {
-	return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
-}
-var acceptData = function( owner ) {
-
-	// Accepts only:
-	//  - Node
-	//    - Node.ELEMENT_NODE
-	//    - Node.DOCUMENT_NODE
-	//  - Object
-	//    - Any
-	return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType );
-};
-
-
-
-
-function Data() {
-	this.expando = jQuery.expando + Data.uid++;
-}
-
-Data.uid = 1;
-
-Data.prototype = {
-
-	cache: function( owner ) {
-
-		// Check if the owner object already has a cache
-		var value = owner this.expando ;
-
-		// If not, create one
-		if ( !value ) {
-			value = {};
-
-			// We can accept data for non-element nodes in modern browsers,
-			// but we should not, see #8335.
-			// Always return an empty object.
-			if ( acceptData( owner ) ) {
-
-				// If it is a node unlikely to be stringify-ed or looped over
-				// use plain assignment
-				if ( owner.nodeType ) {
-					owner this.expando  = value;
-
-				// Otherwise secure it in a non-enumerable property
-				// configurable must be true to allow the property to be
-				// deleted when data is removed
-				} else {
-					Object.defineProperty( owner, this.expando, {
-						value: value,
-						configurable: true
-					} );
-				}
-			}
-		}
-
-		return value;
-	},
-	set: function( owner, data, value ) {
-		var prop,
-			cache = this.cache( owner );
-
-		// Handle:  owner, key, value  args
-		// Always use camelCase key (gh-2257)
-		if ( typeof data === "string" ) {
-			cache camelCase( data )  = value;
-
-		// Handle:  owner, { properties }  args
-		} else {
-
-			// Copy the properties one-by-one to the cache object
-			for ( prop in data ) {
-				cache camelCase( prop )  = data prop ;
-			}
-		}
-		return cache;
-	},
-	get: function( owner, key ) {
-		return key === undefined ?
-			this.cache( owner ) :
-
-			// Always use camelCase key (gh-2257)
-			owner this.expando  && owner this.expando  camelCase( key ) ;
-	},
-	access: function( owner, key, value ) {
-
-		// In cases where either:
-		//
-		//   1. No key was specified
-		//   2. A string key was specified, but no value provided
-		//
-		// Take the "read" path and allow the get method to determine
-		// which value to return, respectively either:
-		//
-		//   1. The entire cache object
-		//   2. The data stored at the key
-		//
-		if ( key === undefined ||
-				( ( key && typeof key === "string" ) && value === undefined ) ) {
-
-			return this.get( owner, key );
-		}
-
-		// When the key is not a string, or both a key and value
-		// are specified, set or extend (existing objects) with either:
-		//
-		//   1. An object of properties
-		//   2. A key and value
-		//
-		this.set( owner, key, value );
-
-		// Since the "set" path can have two possible entry points
-		// return the expected data based on which path was taken*
-		return value !== undefined ? value : key;
-	},
-	remove: function( owner, key ) {
-		var i,
-			cache = owner this.expando ;
-
-		if ( cache === undefined ) {
-			return;
-		}
-
-		if ( key !== undefined ) {
-
-			// Support array or space separated string of keys
-			if ( Array.isArray( key ) ) {
-
-				// If key is an array of keys...
-				// We always set camelCase keys, so remove that.
-				key = key.map( camelCase );
-			} else {
-				key = camelCase( key );
-
-				// If a key with the spaces exists, use it.
-				// Otherwise, create an array by matching non-whitespace
-				key = key in cache ?
-					 key  :
-					( key.match( rnothtmlwhite ) ||  );
-			}
-
-			i = key.length;
-
-			while ( i-- ) {
-				delete cache key i  ;
-			}
-		}
-
-		// Remove the expando if there's no more data
-		if ( key === undefined || jQuery.isEmptyObject( cache ) ) {
-
-			// Support: Chrome <=35 - 45
-			// Webkit & Blink performance suffers when deleting properties
-			// from DOM nodes, so set to undefined instead
-			// https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted)
-			if ( owner.nodeType ) {
-				owner this.expando  = undefined;
-			} else {
-				delete owner this.expando ;
-			}
-		}
-	},
-	hasData: function( owner ) {
-		var cache = owner this.expando ;
-		return cache !== undefined && !jQuery.isEmptyObject( cache );
-	}
-};
-var dataPriv = new Data();
-
-var dataUser = new Data();
-
-
-
-//	Implementation Summary
-//
-//	1. Enforce API surface and semantic compatibility with 1.9.x branch
-//	2. Improve the module's maintainability by reducing the storage
-//		paths to a single mechanism.
-//	3. Use the same single mechanism to support "private" and "user" data.
-//	4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData)
-//	5. Avoid exposing implementation details on user objects (eg. expando properties)
-//	6. Provide a clear path for implementation upgrade to WeakMap in 2014
-
-var rbrace = /^(?:\{\w\W*\}|\\w\W*\)$/,
-	rmultiDash = /A-Z/g;
-
-function getData( data ) {
-	if ( data === "true" ) {
-		return true;
-	}
-
-	if ( data === "false" ) {
-		return false;
-	}
-
-	if ( data === "null" ) {
-		return null;
-	}
-
-	// Only convert to a number if it doesn't change the string
-	if ( data === +data + "" ) {
-		return +data;
-	}
-
-	if ( rbrace.test( data ) ) {
-		return JSON.parse( data );
-	}
-
-	return data;
-}
-
-function dataAttr( elem, key, data ) {
-	var name;
-
-	// If nothing was found internally, try to fetch any
-	// data from the HTML5 data-* attribute
-	if ( data === undefined && elem.nodeType === 1 ) {
-		name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase();
-		data = elem.getAttribute( name );
-
-		if ( typeof data === "string" ) {
-			try {
-				data = getData( data );
-			} catch ( e ) {}
-
-			// Make sure we set the data so it isn't changed later
-			dataUser.set( elem, key, data );
-		} else {
-			data = undefined;
-		}
-	}
-	return data;
-}
-
-jQuery.extend( {
-	hasData: function( elem ) {
-		return dataUser.hasData( elem ) || dataPriv.hasData( elem );
-	},
-
-	data: function( elem, name, data ) {
-		return dataUser.access( elem, name, data );
-	},
-
-	removeData: function( elem, name ) {
-		dataUser.remove( elem, name );
-	},
-
-	// TODO: Now that all calls to _data and _removeData have been replaced
-	// with direct calls to dataPriv methods, these can be deprecated.
-	_data: function( elem, name, data ) {
-		return dataPriv.access( elem, name, data );
-	},
-
-	_removeData: function( elem, name ) {
-		dataPriv.remove( elem, name );
-	}
-} );
-
-jQuery.fn.extend( {
-	data: function( key, value ) {
-		var i, name, data,
-			elem = this 0 ,
-			attrs = elem && elem.attributes;
-
-		// Gets all values
-		if ( key === undefined ) {
-			if ( this.length ) {
-				data = dataUser.get( elem );
-
-				if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) {
-					i = attrs.length;
-					while ( i-- ) {
-
-						// Support: IE 11 only
-						// The attrs elements can be null (#14894)
-						if ( attrs i  ) {
-							name = attrs i .name;
-							if ( name.indexOf( "data-" ) === 0 ) {
-								name = camelCase( name.slice( 5 ) );
-								dataAttr( elem, name, data name  );
-							}
-						}
-					}
-					dataPriv.set( elem, "hasDataAttrs", true );
-				}
-			}
-
-			return data;
-		}
-
-		// Sets multiple values
-		if ( typeof key === "object" ) {
-			return this.each( function() {
-				dataUser.set( this, key );
-			} );
-		}
-
-		return access( this, function( value ) {
-			var data;
-
-			// The calling jQuery object (element matches) is not empty
-			// (and therefore has an element appears at this 0 ) and the
-			// `value` parameter was not undefined. An empty jQuery object
-			// will result in `undefined` for elem = this 0  which will
-			// throw an exception if an attempt to read a data cache is made.
-			if ( elem && value === undefined ) {
-
-				// Attempt to get data from the cache
-				// The key will always be camelCased in Data
-				data = dataUser.get( elem, key );
-				if ( data !== undefined ) {
-					return data;
-				}
-
-				// Attempt to "discover" the data in
-				// HTML5 custom data-* attrs
-				data = dataAttr( elem, key );
-				if ( data !== undefined ) {
-					return data;
-				}
-
-				// We tried really hard, but the data doesn't exist.
-				return;
-			}
-
-			// Set the data...
-			this.each( function() {
-
-				// We always store the camelCased key
-				dataUser.set( this, key, value );
-			} );
-		}, null, value, arguments.length > 1, null, true );
-	},
-
-	removeData: function( key ) {
-		return this.each( function() {
-			dataUser.remove( this, key );
-		} );
-	}
-} );
-
-
-jQuery.extend( {
-	queue: function( elem, type, data ) {
-		var queue;
-
-		if ( elem ) {
-			type = ( type || "fx" ) + "queue";
-			queue = dataPriv.get( elem, type );
-
-			// Speed up dequeue by getting out quickly if this is just a lookup
-			if ( data ) {
-				if ( !queue || Array.isArray( data ) ) {
-					queue = dataPriv.access( elem, type, jQuery.makeArray( data ) );
-				} else {
-					queue.push( data );
-				}
-			}
-			return queue || ;
-		}
-	},
-
-	dequeue: function( elem, type ) {
-		type = type || "fx";
-
-		var queue = jQuery.queue( elem, type ),
-			startLength = queue.length,
-			fn = queue.shift(),
-			hooks = jQuery._queueHooks( elem, type ),
-			next = function() {
-				jQuery.dequeue( elem, type );
-			};
-
-		// If the fx queue is dequeued, always remove the progress sentinel
-		if ( fn === "inprogress" ) {
-			fn = queue.shift();
-			startLength--;
-		}
-
-		if ( fn ) {
-
-			// Add a progress sentinel to prevent the fx queue from being
-			// automatically dequeued
-			if ( type === "fx" ) {
-				queue.unshift( "inprogress" );
-			}
-
-			// Clear up the last queue stop function
-			delete hooks.stop;
-			fn.call( elem, next, hooks );
-		}
-
-		if ( !startLength && hooks ) {
-			hooks.empty.fire();
-		}
-	},
-
-	// Not public - generate a queueHooks object, or return the current one
-	_queueHooks: function( elem, type ) {
-		var key = type + "queueHooks";
-		return dataPriv.get( elem, key ) || dataPriv.access( elem, key, {
-			empty: jQuery.Callbacks( "once memory" ).add( function() {
-				dataPriv.remove( elem,  type + "queue", key  );
-			} )
-		} );
-	}
-} );
-
-jQuery.fn.extend( {
-	queue: function( type, data ) {
-		var setter = 2;
-
-		if ( typeof type !== "string" ) {
-			data = type;
-			type = "fx";
-			setter--;
-		}
-
-		if ( arguments.length < setter ) {
-			return jQuery.queue( this 0 , type );
-		}
-
-		return data === undefined ?
-			this :
-			this.each( function() {
-				var queue = jQuery.queue( this, type, data );
-
-				// Ensure a hooks for this queue
-				jQuery._queueHooks( this, type );
-
-				if ( type === "fx" && queue 0  !== "inprogress" ) {
-					jQuery.dequeue( this, type );
-				}
-			} );
-	},
-	dequeue: function( type ) {
-		return this.each( function() {
-			jQuery.dequeue( this, type );
-		} );
-	},
-	clearQueue: function( type ) {
-		return this.queue( type || "fx",  );
-	},
-
-	// Get a promise resolved when queues of a certain type
-	// are emptied (fx is the type by default)
-	promise: function( type, obj ) {
-		var tmp,
-			count = 1,
-			defer = jQuery.Deferred(),
-			elements = this,
-			i = this.length,
-			resolve = function() {
-				if ( !( --count ) ) {
-					defer.resolveWith( elements,  elements  );
-				}
-			};
-
-		if ( typeof type !== "string" ) {
-			obj = type;
-			type = undefined;
-		}
-		type = type || "fx";
-
-		while ( i-- ) {
-			tmp = dataPriv.get( elements i , type + "queueHooks" );
-			if ( tmp && tmp.empty ) {
-				count++;
-				tmp.empty.add( resolve );
-			}
-		}
-		resolve();
-		return defer.promise( obj );
-	}
-} );
-var pnum = ( /+-?(?:\d*\.|)\d+(?:eE+-?\d+|)/ ).source;
-
-var rcssNum = new RegExp( "^(?:(+-)=|)(" + pnum + ")(a-z%*)$", "i" );
-
-
-var cssExpand =  "Top", "Right", "Bottom", "Left" ;
-
-var documentElement = document.documentElement;
-
-
-
-	var isAttached = function( elem ) {
-			return jQuery.contains( elem.ownerDocument, elem );
-		},
-		composed = { composed: true };
-
-	// Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only
-	// Check attachment across shadow DOM boundaries when possible (gh-3504)
-	// Support: iOS 10.0-10.2 only
-	// Early iOS 10 versions support `attachShadow` but not `getRootNode`,
-	// leading to errors. We need to check for `getRootNode`.
-	if ( documentElement.getRootNode ) {
-		isAttached = function( elem ) {
-			return jQuery.contains( elem.ownerDocument, elem ) ||
-				elem.getRootNode( composed ) === elem.ownerDocument;
-		};
-	}
-var isHiddenWithinTree = function( elem, el ) {
-
-		// isHiddenWithinTree might be called from jQuery#filter function;
-		// in that case, element will be second argument
-		elem = el || elem;
-
-		// Inline style trumps all
-		return elem.style.display === "none" ||
-			elem.style.display === "" &&
-
-			// Otherwise, check computed style
-			// Support: Firefox <=43 - 45
-			// Disconnected elements can have computed display: none, so first confirm that elem is
-			// in the document.
-			isAttached( elem ) &&
-
-			jQuery.css( elem, "display" ) === "none";
-	};
-
-
-
-function adjustCSS( elem, prop, valueParts, tween ) {
-	var adjusted, scale,
-		maxIterations = 20,
-		currentValue = tween ?
-			function() {
-				return tween.cur();
-			} :
-			function() {
-				return jQuery.css( elem, prop, "" );
-			},
-		initial = currentValue(),
-		unit = valueParts && valueParts 3  || ( jQuery.cssNumber prop  ? "" : "px" ),
-
-		// Starting value computation is required for potential unit mismatches
-		initialInUnit = elem.nodeType &&
-			( jQuery.cssNumber prop  || unit !== "px" && +initial ) &&
-			rcssNum.exec( jQuery.css( elem, prop ) );
-
-	if ( initialInUnit && initialInUnit 3  !== unit ) {
-
-		// Support: Firefox <=54
-		// Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144)
-		initial = initial / 2;
-
-		// Trust units reported by jQuery.css
-		unit = unit || initialInUnit 3 ;
-
-		// Iteratively approximate from a nonzero starting point
-		initialInUnit = +initial || 1;
-
-		while ( maxIterations-- ) {
-
-			// Evaluate and update our best guess (doubling guesses that zero out).
-			// Finish if the scale equals or crosses 1 (making the old*new product non-positive).
-			jQuery.style( elem, prop, initialInUnit + unit );
-			if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) {
-				maxIterations = 0;
-			}
-			initialInUnit = initialInUnit / scale;
-
-		}
-
-		initialInUnit = initialInUnit * 2;
-		jQuery.style( elem, prop, initialInUnit + unit );
-
-		// Make sure we update the tween properties later on
-		valueParts = valueParts || ;
-	}
-
-	if ( valueParts ) {
-		initialInUnit = +initialInUnit || +initial || 0;
-
-		// Apply relative offset (+=/-=) if specified
-		adjusted = valueParts 1  ?
-			initialInUnit + ( valueParts 1  + 1 ) * valueParts 2  :
-			+valueParts 2 ;
-		if ( tween ) {
-			tween.unit = unit;
-			tween.start = initialInUnit;
-			tween.end = adjusted;
-		}
-	}
-	return adjusted;
-}
-
-
-var defaultDisplayMap = {};
-
-function getDefaultDisplay( elem ) {
-	var temp,
-		doc = elem.ownerDocument,
-		nodeName = elem.nodeName,
-		display = defaultDisplayMap nodeName ;
-
-	if ( display ) {
-		return display;
-	}
-
-	temp = doc.body.appendChild( doc.createElement( nodeName ) );
-	display = jQuery.css( temp, "display" );
-
-	temp.parentNode.removeChild( temp );
-
-	if ( display === "none" ) {
-		display = "block";
-	}
-	defaultDisplayMap nodeName  = display;
-
-	return display;
-}
-
-function showHide( elements, show ) {
-	var display, elem,
-		values = ,
-		index = 0,
-		length = elements.length;
-
-	// Determine new display value for elements that need to change
-	for ( ; index < length; index++ ) {
-		elem = elements index ;
-		if ( !elem.style ) {
-			continue;
-		}
-
-		display = elem.style.display;
-		if ( show ) {
-
-			// Since we force visibility upon cascade-hidden elements, an immediate (and slow)
-			// check is required in this first loop unless we have a nonempty display value (either
-			// inline or about-to-be-restored)
-			if ( display === "none" ) {
-				values index  = dataPriv.get( elem, "display" ) || null;
-				if ( !values index  ) {
-					elem.style.display = "";
-				}
-			}
-			if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) {
-				values index  = getDefaultDisplay( elem );
-			}
-		} else {
-			if ( display !== "none" ) {
-				values index  = "none";
-
-				// Remember what we're overwriting
-				dataPriv.set( elem, "display", display );
-			}
-		}
-	}
-
-	// Set the display of the elements in a second loop to avoid constant reflow
-	for ( index = 0; index < length; index++ ) {
-		if ( values index  != null ) {
-			elements index .style.display = values index ;
-		}
-	}
-
-	return elements;
-}
-
-jQuery.fn.extend( {
-	show: function() {
-		return showHide( this, true );
-	},
-	hide: function() {
-		return showHide( this );
-	},
-	toggle: function( state ) {
-		if ( typeof state === "boolean" ) {
-			return state ? this.show() : this.hide();
-		}
-
-		return this.each( function() {
-			if ( isHiddenWithinTree( this ) ) {
-				jQuery( this ).show();
-			} else {
-				jQuery( this ).hide();
-			}
-		} );
-	}
-} );
-var rcheckableType = ( /^(?:checkbox|radio)$/i );
-
-var rtagName = ( /<(a-z^\/\0>\x20\t\r\n\f*)/i );
-
-var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i );
-
-
-
-( function() {
-	var fragment = document.createDocumentFragment(),
-		div = fragment.appendChild( document.createElement( "div" ) ),
-		input = document.createElement( "input" );
-
-	// Support: Android 4.0 - 4.3 only
-	// Check state lost if the name is set (#11217)
-	// Support: Windows Web Apps (WWA)
-	// `name` and `type` must use .setAttribute for WWA (#14901)
-	input.setAttribute( "type", "radio" );
-	input.setAttribute( "checked", "checked" );
-	input.setAttribute( "name", "t" );
-
-	div.appendChild( input );
-
-	// Support: Android <=4.1 only
-	// Older WebKit doesn't clone checked state correctly in fragments
-	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
-
-	// Support: IE <=11 only
-	// Make sure textarea (and checkbox) defaultValue is properly cloned
-	div.innerHTML = "<textarea>x</textarea>";
-	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
-
-	// Support: IE <=9 only
-	// IE <=9 replaces <option> tags with their contents when inserted outside of
-	// the select element.
-	div.innerHTML = "<option></option>";
-	support.option = !!div.lastChild;
-} )();
-
-
-// We have to close these tags to support XHTML (#13200)
-var wrapMap = {
-
-	// XHTML parsers do not magically insert elements in the
-	// same way that tag soup parsers do. So we cannot shorten
-	// this by omitting <tbody> or other required elements.
-	thead:  1, "<table>", "</table>" ,
-	col:  2, "<table><colgroup>", "</colgroup></table>" ,
-	tr:  2, "<table><tbody>", "</tbody></table>" ,
-	td:  3, "<table><tbody><tr>", "</tr></tbody></table>" ,
-
-	_default:  0, "", "" 
-};
-
-wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
-wrapMap.th = wrapMap.td;
-
-// Support: IE <=9 only
-if ( !support.option ) {
-	wrapMap.optgroup = wrapMap.option =  1, "<select multiple='multiple'>", "</select>" ;
-}
-
-
-function getAll( context, tag ) {
-
-	// Support: IE <=9 - 11 only
-	// Use typeof to avoid zero-argument method invocation on host objects (#15151)
-	var ret;
-
-	if ( typeof context.getElementsByTagName !== "undefined" ) {
-		ret = context.getElementsByTagName( tag || "*" );
-
-	} else if ( typeof context.querySelectorAll !== "undefined" ) {
-		ret = context.querySelectorAll( tag || "*" );
-
-	} else {
-		ret = ;
-	}
-
-	if ( tag === undefined || tag && nodeName( context, tag ) ) {
-		return jQuery.merge(  context , ret );
-	}
-
-	return ret;
-}
-
-
-// Mark scripts as having already been evaluated
-function setGlobalEval( elems, refElements ) {
-	var i = 0,
-		l = elems.length;
-
-	for ( ; i < l; i++ ) {
-		dataPriv.set(
-			elems i ,
-			"globalEval",
-			!refElements || dataPriv.get( refElements i , "globalEval" )
-		);
-	}
-}
-
-
-var rhtml = /<|&#?\w+;/;
-
-function buildFragment( elems, context, scripts, selection, ignored ) {
-	var elem, tmp, tag, wrap, attached, j,
-		fragment = context.createDocumentFragment(),
-		nodes = ,
-		i = 0,
-		l = elems.length;
-
-	for ( ; i < l; i++ ) {
-		elem = elems i ;
-
-		if ( elem || elem === 0 ) {
-
-			// Add nodes directly
-			if ( toType( elem ) === "object" ) {
-
-				// Support: Android <=4.0 only, PhantomJS 1 only
-				// push.apply(_, arraylike) throws on ancient WebKit
-				jQuery.merge( nodes, elem.nodeType ?  elem  : elem );
-
-			// Convert non-html into a text node
-			} else if ( !rhtml.test( elem ) ) {
-				nodes.push( context.createTextNode( elem ) );
-
-			// Convert html into DOM nodes
-			} else {
-				tmp = tmp || fragment.appendChild( context.createElement( "div" ) );
-
-				// Deserialize a standard representation
-				tag = ( rtagName.exec( elem ) ||  "", ""  ) 1 .toLowerCase();
-				wrap = wrapMap tag  || wrapMap._default;
-				tmp.innerHTML = wrap 1  + jQuery.htmlPrefilter( elem ) + wrap 2 ;
-
-				// Descend through wrappers to the right content
-				j = wrap 0 ;
-				while ( j-- ) {
-					tmp = tmp.lastChild;
-				}
-
-				// Support: Android <=4.0 only, PhantomJS 1 only
-				// push.apply(_, arraylike) throws on ancient WebKit
-				jQuery.merge( nodes, tmp.childNodes );
-
-				// Remember the top-level container
-				tmp = fragment.firstChild;
-
-				// Ensure the created nodes are orphaned (#12392)
-				tmp.textContent = "";
-			}
-		}
-	}
-
-	// Remove wrapper from fragment
-	fragment.textContent = "";
-
-	i = 0;
-	while ( ( elem = nodes i++  ) ) {
-
-		// Skip elements already in the context collection (trac-4087)
-		if ( selection && jQuery.inArray( elem, selection ) > -1 ) {
-			if ( ignored ) {
-				ignored.push( elem );
-			}
-			continue;
-		}
-
-		attached = isAttached( elem );
-
-		// Append to fragment
-		tmp = getAll( fragment.appendChild( elem ), "script" );
-
-		// Preserve script evaluation history
-		if ( attached ) {
-			setGlobalEval( tmp );
-		}
-
-		// Capture executables
-		if ( scripts ) {
-			j = 0;
-			while ( ( elem = tmp j++  ) ) {
-				if ( rscriptType.test( elem.type || "" ) ) {
-					scripts.push( elem );
-				}
-			}
-		}
-	}
-
-	return fragment;
-}
-
-
-var
-	rkeyEvent = /^key/,
-	rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/,
-	rtypenamespace = /^(^.*)(?:\.(.+)|)/;
-
-function returnTrue() {
-	return true;
-}
-
-function returnFalse() {
-	return false;
-}
-
-// Support: IE <=9 - 11+
-// focus() and blur() are asynchronous, except when they are no-op.
-// So expect focus to be synchronous when the element is already active,
-// and blur to be synchronous when the element is not already active.
-// (focus and blur are always synchronous in other supported browsers,
-// this just defines when we can count on it).
-function expectSync( elem, type ) {
-	return ( elem === safeActiveElement() ) === ( type === "focus" );
-}
-
-// Support: IE <=9 only
-// Accessing document.activeElement can throw unexpectedly
-// https://bugs.jquery.com/ticket/13393
-function safeActiveElement() {
-	try {
-		return document.activeElement;
-	} catch ( err ) { }
-}
-
-function on( elem, types, selector, data, fn, one ) {
-	var origFn, type;
-
-	// Types can be a map of types/handlers
-	if ( typeof types === "object" ) {
-
-		// ( types-Object, selector, data )
-		if ( typeof selector !== "string" ) {
-
-			// ( types-Object, data )
-			data = data || selector;
-			selector = undefined;
-		}
-		for ( type in types ) {
-			on( elem, type, selector, data, types type , one );
-		}
-		return elem;
-	}
-
-	if ( data == null && fn == null ) {
-
-		// ( types, fn )
-		fn = selector;
-		data = selector = undefined;
-	} else if ( fn == null ) {
-		if ( typeof selector === "string" ) {
-
-			// ( types, selector, fn )
-			fn = data;
-			data = undefined;
-		} else {
-
-			// ( types, data, fn )
-			fn = data;
-			data = selector;
-			selector = undefined;
-		}
-	}
-	if ( fn === false ) {
-		fn = returnFalse;
-	} else if ( !fn ) {
-		return elem;
-	}
-
-	if ( one === 1 ) {
-		origFn = fn;
-		fn = function( event ) {
-
-			// Can use an empty set, since event contains the info
-			jQuery().off( event );
-			return origFn.apply( this, arguments );
-		};
-
-		// Use same guid so caller can remove using origFn
-		fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
-	}
-	return elem.each( function() {
-		jQuery.event.add( this, types, fn, data, selector );
-	} );
-}
-
-/*
- * Helper functions for managing events -- not part of the public interface.
- * Props to Dean Edwards' addEvent library for many of the ideas.
- */
-jQuery.event = {
-
-	global: {},
-
-	add: function( elem, types, handler, data, selector ) {
-
-		var handleObjIn, eventHandle, tmp,
-			events, t, handleObj,
-			special, handlers, type, namespaces, origType,
-			elemData = dataPriv.get( elem );
-
-		// Only attach events to objects that accept data
-		if ( !acceptData( elem ) ) {
-			return;
-		}
-
-		// Caller can pass in an object of custom data in lieu of the handler
-		if ( handler.handler ) {
-			handleObjIn = handler;
-			handler = handleObjIn.handler;
-			selector = handleObjIn.selector;
-		}
-
-		// Ensure that invalid selectors throw exceptions at attach time
-		// Evaluate against documentElement in case elem is a non-element node (e.g., document)
-		if ( selector ) {
-			jQuery.find.matchesSelector( documentElement, selector );
-		}
-
-		// Make sure that the handler has a unique ID, used to find/remove it later
-		if ( !handler.guid ) {
-			handler.guid = jQuery.guid++;
-		}
-
-		// Init the element's event structure and main handler, if this is the first
-		if ( !( events = elemData.events ) ) {
-			events = elemData.events = Object.create( null );
-		}
-		if ( !( eventHandle = elemData.handle ) ) {
-			eventHandle = elemData.handle = function( e ) {
-
-				// Discard the second event of a jQuery.event.trigger() and
-				// when an event is called after a page has unloaded
-				return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ?
-					jQuery.event.dispatch.apply( elem, arguments ) : undefined;
-			};
-		}
-
-		// Handle multiple events separated by a space
-		types = ( types || "" ).match( rnothtmlwhite ) ||  "" ;
-		t = types.length;
-		while ( t-- ) {
-			tmp = rtypenamespace.exec( types t  ) || ;
-			type = origType = tmp 1 ;
-			namespaces = ( tmp 2  || "" ).split( "." ).sort();
-
-			// There *must* be a type, no attaching namespace-only handlers
-			if ( !type ) {
-				continue;
-			}
-
-			// If event changes its type, use the special event handlers for the changed type
-			special = jQuery.event.special type  || {};
-
-			// If selector defined, determine special event api type, otherwise given type
-			type = ( selector ? special.delegateType : special.bindType ) || type;
-
-			// Update special based on newly reset type
-			special = jQuery.event.special type  || {};
-
-			// handleObj is passed to all event handlers
-			handleObj = jQuery.extend( {
-				type: type,
-				origType: origType,
-				data: data,
-				handler: handler,
-				guid: handler.guid,
-				selector: selector,
-				needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
-				namespace: namespaces.join( "." )
-			}, handleObjIn );
-
-			// Init the event handler queue if we're the first
-			if ( !( handlers = events type  ) ) {
-				handlers = events type  = ;
-				handlers.delegateCount = 0;
-
-				// Only use addEventListener if the special events handler returns false
-				if ( !special.setup ||
-					special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
-
-					if ( elem.addEventListener ) {
-						elem.addEventListener( type, eventHandle );
-					}
-				}
-			}
-
-			if ( special.add ) {
-				special.add.call( elem, handleObj );
-
-				if ( !handleObj.handler.guid ) {
-					handleObj.handler.guid = handler.guid;
-				}
-			}
-
-			// Add to the element's handler list, delegates in front
-			if ( selector ) {
-				handlers.splice( handlers.delegateCount++, 0, handleObj );
-			} else {
-				handlers.push( handleObj );
-			}
-
-			// Keep track of which events have ever been used, for event optimization
-			jQuery.event.global type  = true;
-		}
-
-	},
-
-	// Detach an event or set of events from an element
-	remove: function( elem, types, handler, selector, mappedTypes ) {
-
-		var j, origCount, tmp,
-			events, t, handleObj,
-			special, handlers, type, namespaces, origType,
-			elemData = dataPriv.hasData( elem ) && dataPriv.get( elem );
-
-		if ( !elemData || !( events = elemData.events ) ) {
-			return;
-		}
-
-		// Once for each type.namespace in types; type may be omitted
-		types = ( types || "" ).match( rnothtmlwhite ) ||  "" ;
-		t = types.length;
-		while ( t-- ) {
-			tmp = rtypenamespace.exec( types t  ) || ;
-			type = origType = tmp 1 ;
-			namespaces = ( tmp 2  || "" ).split( "." ).sort();
-
-			// Unbind all events (on this namespace, if provided) for the element
-			if ( !type ) {
-				for ( type in events ) {
-					jQuery.event.remove( elem, type + types t , handler, selector, true );
-				}
-				continue;
-			}
-
-			special = jQuery.event.special type  || {};
-			type = ( selector ? special.delegateType : special.bindType ) || type;
-			handlers = events type  || ;
-			tmp = tmp 2  &&
-				new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" );
-
-			// Remove matching events
-			origCount = j = handlers.length;
-			while ( j-- ) {
-				handleObj = handlers j ;
-
-				if ( ( mappedTypes || origType === handleObj.origType ) &&
-					( !handler || handler.guid === handleObj.guid ) &&
-					( !tmp || tmp.test( handleObj.namespace ) ) &&
-					( !selector || selector === handleObj.selector ||
-						selector === "**" && handleObj.selector ) ) {
-					handlers.splice( j, 1 );
-
-					if ( handleObj.selector ) {
-						handlers.delegateCount--;
-					}
-					if ( special.remove ) {
-						special.remove.call( elem, handleObj );
-					}
-				}
-			}
-
-			// Remove generic event handler if we removed something and no more handlers exist
-			// (avoids potential for endless recursion during removal of special event handlers)
-			if ( origCount && !handlers.length ) {
-				if ( !special.teardown ||
-					special.teardown.call( elem, namespaces, elemData.handle ) === false ) {
-
-					jQuery.removeEvent( elem, type, elemData.handle );
-				}
-
-				delete events type ;
-			}
-		}
-
-		// Remove data and the expando if it's no longer used
-		if ( jQuery.isEmptyObject( events ) ) {
-			dataPriv.remove( elem, "handle events" );
-		}
-	},
-
-	dispatch: function( nativeEvent ) {
-
-		var i, j, ret, matched, handleObj, handlerQueue,
-			args = new Array( arguments.length ),
-
-			// Make a writable jQuery.Event from the native event object
-			event = jQuery.event.fix( nativeEvent ),
-
-			handlers = (
-					dataPriv.get( this, "events" ) || Object.create( null )
-				) event.type  || ,
-			special = jQuery.event.special event.type  || {};
-
-		// Use the fix-ed jQuery.Event rather than the (read-only) native event
-		args 0  = event;
-
-		for ( i = 1; i < arguments.length; i++ ) {
-			args i  = arguments i ;
-		}
-
-		event.delegateTarget = this;
-
-		// Call the preDispatch hook for the mapped type, and let it bail if desired
-		if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {
-			return;
-		}
-
-		// Determine handlers
-		handlerQueue = jQuery.event.handlers.call( this, event, handlers );
-
-		// Run delegates first; they may want to stop propagation beneath us
-		i = 0;
-		while ( ( matched = handlerQueue i++  ) && !event.isPropagationStopped() ) {
-			event.currentTarget = matched.elem;
-
-			j = 0;
-			while ( ( handleObj = matched.handlers j++  ) &&
-				!event.isImmediatePropagationStopped() ) {
-
-				// If the event is namespaced, then each handler is only invoked if it is
-				// specially universal or its namespaces are a superset of the event's.
-				if ( !event.rnamespace || handleObj.namespace === false ||
-					event.rnamespace.test( handleObj.namespace ) ) {
-
-					event.handleObj = handleObj;
-					event.data = handleObj.data;
-
-					ret = ( ( jQuery.event.special handleObj.origType  || {} ).handle ||
-						handleObj.handler ).apply( matched.elem, args );
-
-					if ( ret !== undefined ) {
-						if ( ( event.result = ret ) === false ) {
-							event.preventDefault();
-							event.stopPropagation();
-						}
-					}
-				}
-			}
-		}
-
-		// Call the postDispatch hook for the mapped type
-		if ( special.postDispatch ) {
-			special.postDispatch.call( this, event );
-		}
-
-		return event.result;
-	},
-
-	handlers: function( event, handlers ) {
-		var i, handleObj, sel, matchedHandlers, matchedSelectors,
-			handlerQueue = ,
-			delegateCount = handlers.delegateCount,
-			cur = event.target;
-
-		// Find delegate handlers
-		if ( delegateCount &&
-
-			// Support: IE <=9
-			// Black-hole SVG <use> instance trees (trac-13180)
-			cur.nodeType &&
-
-			// Support: Firefox <=42
-			// Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861)
-			// https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click
-			// Support: IE 11 only
-			// ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343)
-			!( event.type === "click" && event.button >= 1 ) ) {
-
-			for ( ; cur !== this; cur = cur.parentNode || this ) {
-
-				// Don't check non-elements (#13208)
-				// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)
-				if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) {
-					matchedHandlers = ;
-					matchedSelectors = {};
-					for ( i = 0; i < delegateCount; i++ ) {
-						handleObj = handlers i ;
-
-						// Don't conflict with Object.prototype properties (#13203)
-						sel = handleObj.selector + " ";
-
-						if ( matchedSelectors sel  === undefined ) {
-							matchedSelectors sel  = handleObj.needsContext ?
-								jQuery( sel, this ).index( cur ) > -1 :
-								jQuery.find( sel, this, null,  cur  ).length;
-						}
-						if ( matchedSelectors sel  ) {
-							matchedHandlers.push( handleObj );
-						}
-					}
-					if ( matchedHandlers.length ) {
-						handlerQueue.push( { elem: cur, handlers: matchedHandlers } );
-					}
-				}
-			}
-		}
-
-		// Add the remaining (directly-bound) handlers
-		cur = this;
-		if ( delegateCount < handlers.length ) {
-			handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } );
-		}
-
-		return handlerQueue;
-	},
-
-	addProp: function( name, hook ) {
-		Object.defineProperty( jQuery.Event.prototype, name, {
-			enumerable: true,
-			configurable: true,
-
-			get: isFunction( hook ) ?
-				function() {
-					if ( this.originalEvent ) {
-							return hook( this.originalEvent );
-					}
-				} :
-				function() {
-					if ( this.originalEvent ) {
-							return this.originalEvent name ;
-					}
-				},
-
-			set: function( value ) {
-				Object.defineProperty( this, name, {
-					enumerable: true,
-					configurable: true,
-					writable: true,
-					value: value
-				} );
-			}
-		} );
-	},
-
-	fix: function( originalEvent ) {
-		return originalEvent jQuery.expando  ?
-			originalEvent :
-			new jQuery.Event( originalEvent );
-	},
-
-	special: {
-		load: {
-
-			// Prevent triggered image.load events from bubbling to window.load
-			noBubble: true
-		},
-		click: {
-
-			// Utilize native event to ensure correct state for checkable inputs
-			setup: function( data ) {
-
-				// For mutual compressibility with _default, replace `this` access with a local var.
-				// `|| data` is dead code meant only to preserve the variable through minification.
-				var el = this || data;
-
-				// Claim the first handler
-				if ( rcheckableType.test( el.type ) &&
-					el.click && nodeName( el, "input" ) ) {
-
-					// dataPriv.set( el, "click", ... )
-					leverageNative( el, "click", returnTrue );
-				}
-
-				// Return false to allow normal processing in the caller
-				return false;
-			},
-			trigger: function( data ) {
-
-				// For mutual compressibility with _default, replace `this` access with a local var.
-				// `|| data` is dead code meant only to preserve the variable through minification.
-				var el = this || data;
-
-				// Force setup before triggering a click
-				if ( rcheckableType.test( el.type ) &&
-					el.click && nodeName( el, "input" ) ) {
-
-					leverageNative( el, "click" );
-				}
-
-				// Return non-false to allow normal event-path propagation
-				return true;
-			},
-
-			// For cross-browser consistency, suppress native .click() on links
-			// Also prevent it if we're currently inside a leveraged native-event stack
-			_default: function( event ) {
-				var target = event.target;
-				return rcheckableType.test( target.type ) &&
-					target.click && nodeName( target, "input" ) &&
-					dataPriv.get( target, "click" ) ||
-					nodeName( target, "a" );
-			}
-		},
-
-		beforeunload: {
-			postDispatch: function( event ) {
-
-				// Support: Firefox 20+
-				// Firefox doesn't alert if the returnValue field is not set.
-				if ( event.result !== undefined && event.originalEvent ) {
-					event.originalEvent.returnValue = event.result;
-				}
-			}
-		}
-	}
-};
-
-// Ensure the presence of an event listener that handles manually-triggered
-// synthetic events by interrupting progress until reinvoked in response to
-// *native* events that it fires directly, ensuring that state changes have
-// already occurred before other listeners are invoked.
-function leverageNative( el, type, expectSync ) {
-
-	// Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add
-	if ( !expectSync ) {
-		if ( dataPriv.get( el, type ) === undefined ) {
-			jQuery.event.add( el, type, returnTrue );
-		}
-		return;
-	}
-
-	// Register the controller as a special universal handler for all event namespaces
-	dataPriv.set( el, type, false );
-	jQuery.event.add( el, type, {
-		namespace: false,
-		handler: function( event ) {
-			var notAsync, result,
-				saved = dataPriv.get( this, type );
-
-			if ( ( event.isTrigger & 1 ) && this type  ) {
-
-				// Interrupt processing of the outer synthetic .trigger()ed event
-				// Saved data should be false in such cases, but might be a leftover capture object
-				// from an async native handler (gh-4350)
-				if ( !saved.length ) {
-
-					// Store arguments for use when handling the inner native event
-					// There will always be at least one argument (an event object), so this array
-					// will not be confused with a leftover capture object.
-					saved = slice.call( arguments );
-					dataPriv.set( this, type, saved );
-
-					// Trigger the native event and capture its result
-					// Support: IE <=9 - 11+
-					// focus() and blur() are asynchronous
-					notAsync = expectSync( this, type );
-					this type ();
-					result = dataPriv.get( this, type );
-					if ( saved !== result || notAsync ) {
-						dataPriv.set( this, type, false );
-					} else {
-						result = {};
-					}
-					if ( saved !== result ) {
-
-						// Cancel the outer synthetic event
-						event.stopImmediatePropagation();
-						event.preventDefault();
-						return result.value;
-					}
-
-				// If this is an inner synthetic event for an event with a bubbling surrogate
-				// (focus or blur), assume that the surrogate already propagated from triggering the
-				// native event and prevent that from happening again here.
-				// This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the
-				// bubbling surrogate propagates *after* the non-bubbling base), but that seems
-				// less bad than duplication.
-				} else if ( ( jQuery.event.special type  || {} ).delegateType ) {
-					event.stopPropagation();
-				}
-
-			// If this is a native event triggered above, everything is now in order
-			// Fire an inner synthetic event with the original arguments
-			} else if ( saved.length ) {
-
-				// ...and capture the result
-				dataPriv.set( this, type, {
-					value: jQuery.event.trigger(
-
-						// Support: IE <=9 - 11+
-						// Extend with the prototype to reset the above stopImmediatePropagation()
-						jQuery.extend( saved 0 , jQuery.Event.prototype ),
-						saved.slice( 1 ),
-						this
-					)
-				} );
-
-				// Abort handling of the native event
-				event.stopImmediatePropagation();
-			}
-		}
-	} );
-}
-
-jQuery.removeEvent = function( elem, type, handle ) {
-
-	// This "if" is needed for plain objects
-	if ( elem.removeEventListener ) {
-		elem.removeEventListener( type, handle );
-	}
-};
-
-jQuery.Event = function( src, props ) {
-
-	// Allow instantiation without the 'new' keyword
-	if ( !( this instanceof jQuery.Event ) ) {
-		return new jQuery.Event( src, props );
-	}
-
-	// Event object
-	if ( src && src.type ) {
-		this.originalEvent = src;
-		this.type = src.type;
-
-		// Events bubbling up the document may have been marked as prevented
-		// by a handler lower down the tree; reflect the correct value.
-		this.isDefaultPrevented = src.defaultPrevented ||
-				src.defaultPrevented === undefined &&
-
-				// Support: Android <=2.3 only
-				src.returnValue === false ?
-			returnTrue :
-			returnFalse;
-
-		// Create target properties
-		// Support: Safari <=6 - 7 only
-		// Target should not be a text node (#504, #13143)
-		this.target = ( src.target && src.target.nodeType === 3 ) ?
-			src.target.parentNode :
-			src.target;
-
-		this.currentTarget = src.currentTarget;
-		this.relatedTarget = src.relatedTarget;
-
-	// Event type
-	} else {
-		this.type = src;
-	}
-
-	// Put explicitly provided properties onto the event object
-	if ( props ) {
-		jQuery.extend( this, props );
-	}
-
-	// Create a timestamp if incoming event doesn't have one
-	this.timeStamp = src && src.timeStamp || Date.now();
-
-	// Mark it as fixed
-	this jQuery.expando  = true;
-};
-
-// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding
-// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html
-jQuery.Event.prototype = {
-	constructor: jQuery.Event,
-	isDefaultPrevented: returnFalse,
-	isPropagationStopped: returnFalse,
-	isImmediatePropagationStopped: returnFalse,
-	isSimulated: false,
-
-	preventDefault: function() {
-		var e = this.originalEvent;
-
-		this.isDefaultPrevented = returnTrue;
-
-		if ( e && !this.isSimulated ) {
-			e.preventDefault();
-		}
-	},
-	stopPropagation: function() {
-		var e = this.originalEvent;
-
-		this.isPropagationStopped = returnTrue;
-
-		if ( e && !this.isSimulated ) {
-			e.stopPropagation();
-		}
-	},
-	stopImmediatePropagation: function() {
-		var e = this.originalEvent;
-
-		this.isImmediatePropagationStopped = returnTrue;
-
-		if ( e && !this.isSimulated ) {
-			e.stopImmediatePropagation();
-		}
-
-		this.stopPropagation();
-	}
-};
-
-// Includes all common event props including KeyEvent and MouseEvent specific props
-jQuery.each( {
-	altKey: true,
-	bubbles: true,
-	cancelable: true,
-	changedTouches: true,
-	ctrlKey: true,
-	detail: true,
-	eventPhase: true,
-	metaKey: true,
-	pageX: true,
-	pageY: true,
-	shiftKey: true,
-	view: true,
-	"char": true,
-	code: true,
-	charCode: true,
-	key: true,
-	keyCode: true,
-	button: true,
-	buttons: true,
-	clientX: true,
-	clientY: true,
-	offsetX: true,
-	offsetY: true,
-	pointerId: true,
-	pointerType: true,
-	screenX: true,
-	screenY: true,
-	targetTouches: true,
-	toElement: true,
-	touches: true,
-
-	which: function( event ) {
-		var button = event.button;
-
-		// Add which for key events
-		if ( event.which == null && rkeyEvent.test( event.type ) ) {
-			return event.charCode != null ? event.charCode : event.keyCode;
-		}
-
-		// Add which for click: 1 === left; 2 === middle; 3 === right
-		if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) {
-			if ( button & 1 ) {
-				return 1;
-			}
-
-			if ( button & 2 ) {
-				return 3;
-			}
-
-			if ( button & 4 ) {
-				return 2;
-			}
-
-			return 0;
-		}
-
-		return event.which;
-	}
-}, jQuery.event.addProp );
-
-jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) {
-	jQuery.event.special type  = {
-
-		// Utilize native event if possible so blur/focus sequence is correct
-		setup: function() {
-
-			// Claim the first handler
-			// dataPriv.set( this, "focus", ... )
-			// dataPriv.set( this, "blur", ... )
-			leverageNative( this, type, expectSync );
-
-			// Return false to allow normal processing in the caller
-			return false;
-		},
-		trigger: function() {
-
-			// Force setup before trigger
-			leverageNative( this, type );
-
-			// Return non-false to allow normal event-path propagation
-			return true;
-		},
-
-		delegateType: delegateType
-	};
-} );
-
-// Create mouseenter/leave events using mouseover/out and event-time checks
-// so that event delegation works in jQuery.
-// Do the same for pointerenter/pointerleave and pointerover/pointerout
-//
-// Support: Safari 7 only
-// Safari sends mouseenter too often; see:
-// https://bugs.chromium.org/p/chromium/issues/detail?id=470258
-// for the description of the bug (it existed in older Chrome versions as well).
-jQuery.each( {
-	mouseenter: "mouseover",
-	mouseleave: "mouseout",
-	pointerenter: "pointerover",
-	pointerleave: "pointerout"
-}, function( orig, fix ) {
-	jQuery.event.special orig  = {
-		delegateType: fix,
-		bindType: fix,
-
-		handle: function( event ) {
-			var ret,
-				target = this,
-				related = event.relatedTarget,
-				handleObj = event.handleObj;
-
-			// For mouseenter/leave call the handler if related is outside the target.
-			// NB: No relatedTarget if the mouse left/entered the browser window
-			if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) {
-				event.type = handleObj.origType;
-				ret = handleObj.handler.apply( this, arguments );
-				event.type = fix;
-			}
-			return ret;
-		}
-	};
-} );
-
-jQuery.fn.extend( {
-
-	on: function( types, selector, data, fn ) {
-		return on( this, types, selector, data, fn );
-	},
-	one: function( types, selector, data, fn ) {
-		return on( this, types, selector, data, fn, 1 );
-	},
-	off: function( types, selector, fn ) {
-		var handleObj, type;
-		if ( types && types.preventDefault && types.handleObj ) {
-
-			// ( event )  dispatched jQuery.Event
-			handleObj = types.handleObj;
-			jQuery( types.delegateTarget ).off(
-				handleObj.namespace ?
-					handleObj.origType + "." + handleObj.namespace :
-					handleObj.origType,
-				handleObj.selector,
-				handleObj.handler
-			);
-			return this;
-		}
-		if ( typeof types === "object" ) {
-
-			// ( types-object , selector )
-			for ( type in types ) {
-				this.off( type, selector, types type  );
-			}
-			return this;
-		}
-		if ( selector === false || typeof selector === "function" ) {
-
-			// ( types , fn )
-			fn = selector;
-			selector = undefined;
-		}
-		if ( fn === false ) {
-			fn = returnFalse;
-		}
-		return this.each( function() {
-			jQuery.event.remove( this, types, fn, selector );
-		} );
-	}
-} );
-
-
-var
-
-	// Support: IE <=10 - 11, Edge 12 - 13 only
-	// In IE/Edge using regex groups here causes severe slowdowns.
-	// See https://connect.microsoft.com/IE/feedback/details/1736512/
-	rnoInnerhtml = /<script|<style|<link/i,
-
-	// checked="checked" or checked
-	rchecked = /checked\s*(?:^=|=\s*.checked.)/i,
-	rcleanScript = /^\s*<!(?:\CDATA\|--)|(?:\\|--)>\s*$/g;
-
-// Prefer a tbody over its parent table for containing new rows
-function manipulationTarget( elem, content ) {
-	if ( nodeName( elem, "table" ) &&
-		nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) {
-
-		return jQuery( elem ).children( "tbody" ) 0  || elem;
-	}
-
-	return elem;
-}
-
-// Replace/restore the type attribute of script elements for safe DOM manipulation
-function disableScript( elem ) {
-	elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type;
-	return elem;
-}
-function restoreScript( elem ) {
-	if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) {
-		elem.type = elem.type.slice( 5 );
-	} else {
-		elem.removeAttribute( "type" );
-	}
-
-	return elem;
-}
-
-function cloneCopyEvent( src, dest ) {
-	var i, l, type, pdataOld, udataOld, udataCur, events;
-
-	if ( dest.nodeType !== 1 ) {
-		return;
-	}
-
-	// 1. Copy private data: events, handlers, etc.
-	if ( dataPriv.hasData( src ) ) {
-		pdataOld = dataPriv.get( src );
-		events = pdataOld.events;
-
-		if ( events ) {
-			dataPriv.remove( dest, "handle events" );
-
-			for ( type in events ) {
-				for ( i = 0, l = events type .length; i < l; i++ ) {
-					jQuery.event.add( dest, type, events type  i  );
-				}
-			}
-		}
-	}
-
-	// 2. Copy user data
-	if ( dataUser.hasData( src ) ) {
-		udataOld = dataUser.access( src );
-		udataCur = jQuery.extend( {}, udataOld );
-
-		dataUser.set( dest, udataCur );
-	}
-}
-
-// Fix IE bugs, see support tests
-function fixInput( src, dest ) {
-	var nodeName = dest.nodeName.toLowerCase();
-
-	// Fails to persist the checked state of a cloned checkbox or radio button.
-	if ( nodeName === "input" && rcheckableType.test( src.type ) ) {
-		dest.checked = src.checked;
-
-	// Fails to return the selected option to the default selected state when cloning options
-	} else if ( nodeName === "input" || nodeName === "textarea" ) {
-		dest.defaultValue = src.defaultValue;
-	}
-}
-
-function domManip( collection, args, callback, ignored ) {
-
-	// Flatten any nested arrays
-	args = flat( args );
-
-	var fragment, first, scripts, hasScripts, node, doc,
-		i = 0,
-		l = collection.length,
-		iNoClone = l - 1,
-		value = args 0 ,
-		valueIsFunction = isFunction( value );
-
-	// We can't cloneNode fragments that contain checked, in WebKit
-	if ( valueIsFunction ||
-			( l > 1 && typeof value === "string" &&
-				!support.checkClone && rchecked.test( value ) ) ) {
-		return collection.each( function( index ) {
-			var self = collection.eq( index );
-			if ( valueIsFunction ) {
-				args 0  = value.call( this, index, self.html() );
-			}
-			domManip( self, args, callback, ignored );
-		} );
-	}
-
-	if ( l ) {
-		fragment = buildFragment( args, collection 0 .ownerDocument, false, collection, ignored );
-		first = fragment.firstChild;
-
-		if ( fragment.childNodes.length === 1 ) {
-			fragment = first;
-		}
-
-		// Require either new content or an interest in ignored elements to invoke the callback
-		if ( first || ignored ) {
-			scripts = jQuery.map( getAll( fragment, "script" ), disableScript );
-			hasScripts = scripts.length;
-
-			// Use the original fragment for the last item
-			// instead of the first because it can end up
-			// being emptied incorrectly in certain situations (#8070).
-			for ( ; i < l; i++ ) {
-				node = fragment;
-
-				if ( i !== iNoClone ) {
-					node = jQuery.clone( node, true, true );
-
-					// Keep references to cloned scripts for later restoration
-					if ( hasScripts ) {
-
-						// Support: Android <=4.0 only, PhantomJS 1 only
-						// push.apply(_, arraylike) throws on ancient WebKit
-						jQuery.merge( scripts, getAll( node, "script" ) );
-					}
-				}
-
-				callback.call( collection i , node, i );
-			}
-
-			if ( hasScripts ) {
-				doc = scripts scripts.length - 1 .ownerDocument;
-
-				// Reenable scripts
-				jQuery.map( scripts, restoreScript );
-
-				// Evaluate executable scripts on first document insertion
-				for ( i = 0; i < hasScripts; i++ ) {
-					node = scripts i ;
-					if ( rscriptType.test( node.type || "" ) &&
-						!dataPriv.access( node, "globalEval" ) &&
-						jQuery.contains( doc, node ) ) {
-
-						if ( node.src && ( node.type || "" ).toLowerCase()  !== "module" ) {
-
-							// Optional AJAX dependency, but won't run scripts if not present
-							if ( jQuery._evalUrl && !node.noModule ) {
-								jQuery._evalUrl( node.src, {
-									nonce: node.nonce || node.getAttribute( "nonce" )
-								}, doc );
-							}
-						} else {
-							DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc );
-						}
-					}
-				}
-			}
-		}
-	}
-
-	return collection;
-}
-
-function remove( elem, selector, keepData ) {
-	var node,
-		nodes = selector ? jQuery.filter( selector, elem ) : elem,
-		i = 0;
-
-	for ( ; ( node = nodes i  ) != null; i++ ) {
-		if ( !keepData && node.nodeType === 1 ) {
-			jQuery.cleanData( getAll( node ) );
-		}
-
-		if ( node.parentNode ) {
-			if ( keepData && isAttached( node ) ) {
-				setGlobalEval( getAll( node, "script" ) );
-			}
-			node.parentNode.removeChild( node );
-		}
-	}
-
-	return elem;
-}
-
-jQuery.extend( {
-	htmlPrefilter: function( html ) {
-		return html;
-	},
-
-	clone: function( elem, dataAndEvents, deepDataAndEvents ) {
-		var i, l, srcElements, destElements,
-			clone = elem.cloneNode( true ),
-			inPage = isAttached( elem );
-
-		// Fix IE cloning issues
-		if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) &&
-				!jQuery.isXMLDoc( elem ) ) {
-
-			// We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2
-			destElements = getAll( clone );
-			srcElements = getAll( elem );
-
-			for ( i = 0, l = srcElements.length; i < l; i++ ) {
-				fixInput( srcElements i , destElements i  );
-			}
-		}
-
-		// Copy the events from the original to the clone
-		if ( dataAndEvents ) {
-			if ( deepDataAndEvents ) {
-				srcElements = srcElements || getAll( elem );
-				destElements = destElements || getAll( clone );
-
-				for ( i = 0, l = srcElements.length; i < l; i++ ) {
-					cloneCopyEvent( srcElements i , destElements i  );
-				}
-			} else {
-				cloneCopyEvent( elem, clone );
-			}
-		}
-
-		// Preserve script evaluation history
-		destElements = getAll( clone, "script" );
-		if ( destElements.length > 0 ) {
-			setGlobalEval( destElements, !inPage && getAll( elem, "script" ) );
-		}
-
-		// Return the cloned set
-		return clone;
-	},
-
-	cleanData: function( elems ) {
-		var data, elem, type,
-			special = jQuery.event.special,
-			i = 0;
-
-		for ( ; ( elem = elems i  ) !== undefined; i++ ) {
-			if ( acceptData( elem ) ) {
-				if ( ( data = elem dataPriv.expando  ) ) {
-					if ( data.events ) {
-						for ( type in data.events ) {
-							if ( special type  ) {
-								jQuery.event.remove( elem, type );
-
-							// This is a shortcut to avoid jQuery.event.remove's overhead
-							} else {
-								jQuery.removeEvent( elem, type, data.handle );
-							}
-						}
-					}
-
-					// Support: Chrome <=35 - 45+
-					// Assign undefined instead of using delete, see Data#remove
-					elem dataPriv.expando  = undefined;
-				}
-				if ( elem dataUser.expando  ) {
-
-					// Support: Chrome <=35 - 45+
-					// Assign undefined instead of using delete, see Data#remove
-					elem dataUser.expando  = undefined;
-				}
-			}
-		}
-	}
-} );
-
-jQuery.fn.extend( {
-	detach: function( selector ) {
-		return remove( this, selector, true );
-	},
-
-	remove: function( selector ) {
-		return remove( this, selector );
-	},
-
-	text: function( value ) {
-		return access( this, function( value ) {
-			return value === undefined ?
-				jQuery.text( this ) :
-				this.empty().each( function() {
-					if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
-						this.textContent = value;
-					}
-				} );
-		}, null, value, arguments.length );
-	},
-
-	append: function() {
-		return domManip( this, arguments, function( elem ) {
-			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
-				var target = manipulationTarget( this, elem );
-				target.appendChild( elem );
-			}
-		} );
-	},
-
-	prepend: function() {
-		return domManip( this, arguments, function( elem ) {
-			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
-				var target = manipulationTarget( this, elem );
-				target.insertBefore( elem, target.firstChild );
-			}
-		} );
-	},
-
-	before: function() {
-		return domManip( this, arguments, function( elem ) {
-			if ( this.parentNode ) {
-				this.parentNode.insertBefore( elem, this );
-			}
-		} );
-	},
-
-	after: function() {
-		return domManip( this, arguments, function( elem ) {
-			if ( this.parentNode ) {
-				this.parentNode.insertBefore( elem, this.nextSibling );
-			}
-		} );
-	},
-
-	empty: function() {
-		var elem,
-			i = 0;
-
-		for ( ; ( elem = this i  ) != null; i++ ) {
-			if ( elem.nodeType === 1 ) {
-
-				// Prevent memory leaks
-				jQuery.cleanData( getAll( elem, false ) );
-
-				// Remove any remaining nodes
-				elem.textContent = "";
-			}
-		}
-
-		return this;
-	},
-
-	clone: function( dataAndEvents, deepDataAndEvents ) {
-		dataAndEvents = dataAndEvents == null ? false : dataAndEvents;
-		deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;
-
-		return this.map( function() {
-			return jQuery.clone( this, dataAndEvents, deepDataAndEvents );
-		} );
-	},
-
-	html: function( value ) {
-		return access( this, function( value ) {
-			var elem = this 0  || {},
-				i = 0,
-				l = this.length;
-
-			if ( value === undefined && elem.nodeType === 1 ) {
-				return elem.innerHTML;
-			}
-
-			// See if we can take a shortcut and just use innerHTML
-			if ( typeof value === "string" && !rnoInnerhtml.test( value ) &&
-				!wrapMap ( rtagName.exec( value ) ||  "", ""  ) 1 .toLowerCase()  ) {
-
-				value = jQuery.htmlPrefilter( value );
-
-				try {
-					for ( ; i < l; i++ ) {
-						elem = this i  || {};
-
-						// Remove element nodes and prevent memory leaks
-						if ( elem.nodeType === 1 ) {
-							jQuery.cleanData( getAll( elem, false ) );
-							elem.innerHTML = value;
-						}
-					}
-
-					elem = 0;
-
-				// If using innerHTML throws an exception, use the fallback method
-				} catch ( e ) {}
-			}
-
-			if ( elem ) {
-				this.empty().append( value );
-			}
-		}, null, value, arguments.length );
-	},
-
-	replaceWith: function() {
-		var ignored = ;
-
-		// Make the changes, replacing each non-ignored context element with the new content
-		return domManip( this, arguments, function( elem ) {
-			var parent = this.parentNode;
-
-			if ( jQuery.inArray( this, ignored ) < 0 ) {
-				jQuery.cleanData( getAll( this ) );
-				if ( parent ) {
-					parent.replaceChild( elem, this );
-				}
-			}
-
-		// Force callback invocation
-		}, ignored );
-	}
-} );
-
-jQuery.each( {
-	appendTo: "append",
-	prependTo: "prepend",
-	insertBefore: "before",
-	insertAfter: "after",
-	replaceAll: "replaceWith"
-}, function( name, original ) {
-	jQuery.fn name  = function( selector ) {
-		var elems,
-			ret = ,
-			insert = jQuery( selector ),
-			last = insert.length - 1,
-			i = 0;
-
-		for ( ; i <= last; i++ ) {
-			elems = i === last ? this : this.clone( true );
-			jQuery( insert i  ) original ( elems );
-
-			// Support: Android <=4.0 only, PhantomJS 1 only
-			// .get() because push.apply(_, arraylike) throws on ancient WebKit
-			push.apply( ret, elems.get() );
-		}
-
-		return this.pushStack( ret );
-	};
-} );
-var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)a-z%+$", "i" );
-
-var getStyles = function( elem ) {
-
-		// Support: IE <=11 only, Firefox <=30 (#15098, #14150)
-		// IE throws on elements created in popups
-		// FF meanwhile throws on frame elements through "defaultView.getComputedStyle"
-		var view = elem.ownerDocument.defaultView;
-
-		if ( !view || !view.opener ) {
-			view = window;
-		}
-
-		return view.getComputedStyle( elem );
-	};
-
-var swap = function( elem, options, callback ) {
-	var ret, name,
-		old = {};
-
-	// Remember the old values, and insert the new ones
-	for ( name in options ) {
-		old name  = elem.style name ;
-		elem.style name  = options name ;
-	}
-
-	ret = callback.call( elem );
-
-	// Revert the old values
-	for ( name in options ) {
-		elem.style name  = old name ;
-	}
-
-	return ret;
-};
-
-
-var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
-
-
-
-( function() {
-
-	// Executing both pixelPosition & boxSizingReliable tests require only one layout
-	// so they're executed at the same time to save the second computation.
-	function computeStyleTests() {
-
-		// This is a singleton, we need to execute it only once
-		if ( !div ) {
-			return;
-		}
-
-		container.style.cssText = "position:absolute;left:-11111px;width:60px;" +
-			"margin-top:1px;padding:0;border:0";
-		div.style.cssText =
-			"position:relative;display:block;box-sizing:border-box;overflow:scroll;" +
-			"margin:auto;border:1px;padding:1px;" +
-			"width:60%;top:1%";
-		documentElement.appendChild( container ).appendChild( div );
-
-		var divStyle = window.getComputedStyle( div );
-		pixelPositionVal = divStyle.top !== "1%";
-
-		// Support: Android 4.0 - 4.3 only, Firefox <=3 - 44
-		reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12;
-
-		// Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3
-		// Some styles come back with percentage values, even though they shouldn't
-		div.style.right = "60%";
-		pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36;
-
-		// Support: IE 9 - 11 only
-		// Detect misreporting of content dimensions for box-sizing:border-box elements
-		boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36;
-
-		// Support: IE 9 only
-		// Detect overflow:scroll screwiness (gh-3699)
-		// Support: Chrome <=64
-		// Don't get tricked when zoom affects offsetWidth (gh-4029)
-		div.style.position = "absolute";
-		scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12;
-
-		documentElement.removeChild( container );
-
-		// Nullify the div so it wouldn't be stored in the memory and
-		// it will also be a sign that checks already performed
-		div = null;
-	}
-
-	function roundPixelMeasures( measure ) {
-		return Math.round( parseFloat( measure ) );
-	}
-
-	var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal,
-		reliableTrDimensionsVal, reliableMarginLeftVal,
-		container = document.createElement( "div" ),
-		div = document.createElement( "div" );
-
-	// Finish early in limited (non-browser) environments
-	if ( !div.style ) {
-		return;
-	}
-
-	// Support: IE <=9 - 11 only
-	// Style of cloned element affects source element cloned (#8908)
-	div.style.backgroundClip = "content-box";
-	div.cloneNode( true ).style.backgroundClip = "";
-	support.clearCloneStyle = div.style.backgroundClip === "content-box";
-
-	jQuery.extend( support, {
-		boxSizingReliable: function() {
-			computeStyleTests();
-			return boxSizingReliableVal;
-		},
-		pixelBoxStyles: function() {
-			computeStyleTests();
-			return pixelBoxStylesVal;
-		},
-		pixelPosition: function() {
-			computeStyleTests();
-			return pixelPositionVal;
-		},
-		reliableMarginLeft: function() {
-			computeStyleTests();
-			return reliableMarginLeftVal;
-		},
-		scrollboxSize: function() {
-			computeStyleTests();
-			return scrollboxSizeVal;
-		},
-
-		// Support: IE 9 - 11+, Edge 15 - 18+
-		// IE/Edge misreport `getComputedStyle` of table rows with width/height
-		// set in CSS while `offset*` properties report correct values.
-		// Behavior in IE 9 is more subtle than in newer versions & it passes
-		// some versions of this test; make sure not to make it pass there!
-		reliableTrDimensions: function() {
-			var table, tr, trChild, trStyle;
-			if ( reliableTrDimensionsVal == null ) {
-				table = document.createElement( "table" );
-				tr = document.createElement( "tr" );
-				trChild = document.createElement( "div" );
-
-				table.style.cssText = "position:absolute;left:-11111px";
-				tr.style.height = "1px";
-				trChild.style.height = "9px";
-
-				documentElement
-					.appendChild( table )
-					.appendChild( tr )
-					.appendChild( trChild );
-
-				trStyle = window.getComputedStyle( tr );
-				reliableTrDimensionsVal = parseInt( trStyle.height ) > 3;
-
-				documentElement.removeChild( table );
-			}
-			return reliableTrDimensionsVal;
-		}
-	} );
-} )();
-
-
-function curCSS( elem, name, computed ) {
-	var width, minWidth, maxWidth, ret,
-
-		// Support: Firefox 51+
-		// Retrieving style before computed somehow
-		// fixes an issue with getting wrong values
-		// on detached elements
-		style = elem.style;
-
-	computed = computed || getStyles( elem );
-
-	// getPropertyValue is needed for:
-	//   .css('filter') (IE 9 only, #12537)
-	//   .css('--customProperty) (#3144)
-	if ( computed ) {
-		ret = computed.getPropertyValue( name ) || computed name ;
-
-		if ( ret === "" && !isAttached( elem ) ) {
-			ret = jQuery.style( elem, name );
-		}
-
-		// A tribute to the "awesome hack by Dean Edwards"
-		// Android Browser returns percentage for some values,
-		// but width seems to be reliably pixels.
-		// This is against the CSSOM draft spec:
-		// https://drafts.csswg.org/cssom/#resolved-values
-		if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) {
-
-			// Remember the original values
-			width = style.width;
-			minWidth = style.minWidth;
-			maxWidth = style.maxWidth;
-
-			// Put in the new values to get a computed value out
-			style.minWidth = style.maxWidth = style.width = ret;
-			ret = computed.width;
-
-			// Revert the changed values
-			style.width = width;
-			style.minWidth = minWidth;
-			style.maxWidth = maxWidth;
-		}
-	}
-
-	return ret !== undefined ?
-
-		// Support: IE <=9 - 11 only
-		// IE returns zIndex value as an integer.
-		ret + "" :
-		ret;
-}
-
-
-function addGetHookIf( conditionFn, hookFn ) {
-
-	// Define the hook, we'll check on the first run if it's really needed.
-	return {
-		get: function() {
-			if ( conditionFn() ) {
-
-				// Hook not needed (or it's not possible to use it due
-				// to missing dependency), remove it.
-				delete this.get;
-				return;
-			}
-
-			// Hook needed; redefine it so that the support test is not executed again.
-			return ( this.get = hookFn ).apply( this, arguments );
-		}
-	};
-}
-
-
-var cssPrefixes =  "Webkit", "Moz", "ms" ,
-	emptyStyle = document.createElement( "div" ).style,
-	vendorProps = {};
-
-// Return a vendor-prefixed property or undefined
-function vendorPropName( name ) {
-
-	// Check for vendor prefixed names
-	var capName = name 0 .toUpperCase() + name.slice( 1 ),
-		i = cssPrefixes.length;
-
-	while ( i-- ) {
-		name = cssPrefixes i  + capName;
-		if ( name in emptyStyle ) {
-			return name;
-		}
-	}
-}
-
-// Return a potentially-mapped jQuery.cssProps or vendor prefixed property
-function finalPropName( name ) {
-	var final = jQuery.cssProps name  || vendorProps name ;
-
-	if ( final ) {
-		return final;
-	}
-	if ( name in emptyStyle ) {
-		return name;
-	}
-	return vendorProps name  = vendorPropName( name ) || name;
-}
-
-
-var
-
-	// Swappable if display is none or starts with table
-	// except "table", "table-cell", or "table-caption"
-	// See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display
-	rdisplayswap = /^(none|table(?!-cea).+)/,
-	rcustomProp = /^--/,
-	cssShow = { position: "absolute", visibility: "hidden", display: "block" },
-	cssNormalTransform = {
-		letterSpacing: "0",
-		fontWeight: "400"
-	};
-
-function setPositiveNumber( _elem, value, subtract ) {
-
-	// Any relative (+/-) values have already been
-	// normalized at this point
-	var matches = rcssNum.exec( value );
-	return matches ?
-
-		// Guard against undefined "subtract", e.g., when used as in cssHooks
-		Math.max( 0, matches 2  - ( subtract || 0 ) ) + ( matches 3  || "px" ) :
-		value;
-}
-
-function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) {
-	var i = dimension === "width" ? 1 : 0,
-		extra = 0,
-		delta = 0;
-
-	// Adjustment may not be necessary
-	if ( box === ( isBorderBox ? "border" : "content" ) ) {
-		return 0;
-	}
-
-	for ( ; i < 4; i += 2 ) {
-
-		// Both box models exclude margin
-		if ( box === "margin" ) {
-			delta += jQuery.css( elem, box + cssExpand i , true, styles );
-		}
-
-		// If we get here with a content-box, we're seeking "padding" or "border" or "margin"
-		if ( !isBorderBox ) {
-
-			// Add padding
-			delta += jQuery.css( elem, "padding" + cssExpand i , true, styles );
-
-			// For "border" or "margin", add border
-			if ( box !== "padding" ) {
-				delta += jQuery.css( elem, "border" + cssExpand i  + "Width", true, styles );
-
-			// But still keep track of it otherwise
-			} else {
-				extra += jQuery.css( elem, "border" + cssExpand i  + "Width", true, styles );
-			}
-
-		// If we get here with a border-box (content + padding + border), we're seeking "content" or
-		// "padding" or "margin"
-		} else {
-
-			// For "content", subtract padding
-			if ( box === "content" ) {
-				delta -= jQuery.css( elem, "padding" + cssExpand i , true, styles );
-			}
-
-			// For "content" or "padding", subtract border
-			if ( box !== "margin" ) {
-				delta -= jQuery.css( elem, "border" + cssExpand i  + "Width", true, styles );
-			}
-		}
-	}
-
-	// Account for positive content-box scroll gutter when requested by providing computedVal
-	if ( !isBorderBox && computedVal >= 0 ) {
-
-		// offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border
-		// Assuming integer scroll gutter, subtract the rest and round down
-		delta += Math.max( 0, Math.ceil(
-			elem "offset" + dimension 0 .toUpperCase() + dimension.slice( 1 )  -
-			computedVal -
-			delta -
-			extra -
-			0.5
-
-		// If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter
-		// Use an explicit zero to avoid NaN (gh-3964)
-		) ) || 0;
-	}
-
-	return delta;
-}
-
-function getWidthOrHeight( elem, dimension, extra ) {
-
-	// Start with computed style
-	var styles = getStyles( elem ),
-
-		// To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322).
-		// Fake content-box until we know it's needed to know the true value.
-		boxSizingNeeded = !support.boxSizingReliable() || extra,
-		isBorderBox = boxSizingNeeded &&
-			jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
-		valueIsBorderBox = isBorderBox,
-
-		val = curCSS( elem, dimension, styles ),
-		offsetProp = "offset" + dimension 0 .toUpperCase() + dimension.slice( 1 );
-
-	// Support: Firefox <=54
-	// Return a confounding non-pixel value or feign ignorance, as appropriate.
-	if ( rnumnonpx.test( val ) ) {
-		if ( !extra ) {
-			return val;
-		}
-		val = "auto";
-	}
-
-
-	// Support: IE 9 - 11 only
-	// Use offsetWidth/offsetHeight for when box sizing is unreliable.
-	// In those cases, the computed value can be trusted to be border-box.
-	if ( ( !support.boxSizingReliable() && isBorderBox ||
-
-		// Support: IE 10 - 11+, Edge 15 - 18+
-		// IE/Edge misreport `getComputedStyle` of table rows with width/height
-		// set in CSS while `offset*` properties report correct values.
-		// Interestingly, in some cases IE 9 doesn't suffer from this issue.
-		!support.reliableTrDimensions() && nodeName( elem, "tr" ) ||
-
-		// Fall back to offsetWidth/offsetHeight when value is "auto"
-		// This happens for inline elements with no explicit setting (gh-3571)
-		val === "auto" ||
-
-		// Support: Android <=4.1 - 4.3 only
-		// Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602)
-		!parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) &&
-
-		// Make sure the element is visible & connected
-		elem.getClientRects().length ) {
-
-		isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box";
-
-		// Where available, offsetWidth/offsetHeight approximate border box dimensions.
-		// Where not available (e.g., SVG), assume unreliable box-sizing and interpret the
-		// retrieved value as a content box dimension.
-		valueIsBorderBox = offsetProp in elem;
-		if ( valueIsBorderBox ) {
-			val = elem offsetProp ;
-		}
-	}
-
-	// Normalize "" and auto
-	val = parseFloat( val ) || 0;
-
-	// Adjust for the element's box model
-	return ( val +
-		boxModelAdjustment(
-			elem,
-			dimension,
-			extra || ( isBorderBox ? "border" : "content" ),
-			valueIsBorderBox,
-			styles,
-
-			// Provide the current computed size to request scroll gutter calculation (gh-3589)
-			val
-		)
-	) + "px";
-}
-
-jQuery.extend( {
-
-	// Add in style property hooks for overriding the default
-	// behavior of getting and setting a style property
-	cssHooks: {
-		opacity: {
-			get: function( elem, computed ) {
-				if ( computed ) {
-
-					// We should always get a number back from opacity
-					var ret = curCSS( elem, "opacity" );
-					return ret === "" ? "1" : ret;
-				}
-			}
-		}
-	},
-
-	// Don't automatically add "px" to these possibly-unitless properties
-	cssNumber: {
-		"animationIterationCount": true,
-		"columnCount": true,
-		"fillOpacity": true,
-		"flexGrow": true,
-		"flexShrink": true,
-		"fontWeight": true,
-		"gridArea": true,
-		"gridColumn": true,
-		"gridColumnEnd": true,
-		"gridColumnStart": true,
-		"gridRow": true,
-		"gridRowEnd": true,
-		"gridRowStart": true,
-		"lineHeight": true,
-		"opacity": true,
-		"order": true,
-		"orphans": true,
-		"widows": true,
-		"zIndex": true,
-		"zoom": true
-	},
-
-	// Add in properties whose names you wish to fix before
-	// setting or getting the value
-	cssProps: {},
-
-	// Get and set the style property on a DOM Node
-	style: function( elem, name, value, extra ) {
-
-		// Don't set styles on text and comment nodes
-		if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {
-			return;
-		}
-
-		// Make sure that we're working with the right name
-		var ret, type, hooks,
-			origName = camelCase( name ),
-			isCustomProp = rcustomProp.test( name ),
-			style = elem.style;
-
-		// Make sure that we're working with the right name. We don't
-		// want to query the value if it is a CSS custom property
-		// since they are user-defined.
-		if ( !isCustomProp ) {
-			name = finalPropName( origName );
-		}
-
-		// Gets hook for the prefixed version, then unprefixed version
-		hooks = jQuery.cssHooks name  || jQuery.cssHooks origName ;
-
-		// Check if we're setting a value
-		if ( value !== undefined ) {
-			type = typeof value;
-
-			// Convert "+=" or "-=" to relative numbers (#7345)
-			if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret 1  ) {
-				value = adjustCSS( elem, name, ret );
-
-				// Fixes bug #9237
-				type = "number";
-			}
-
-			// Make sure that null and NaN values aren't set (#7116)
-			if ( value == null || value !== value ) {
-				return;
-			}
-
-			// If a number was passed in, add the unit (except for certain CSS properties)
-			// The isCustomProp check can be removed in jQuery 4.0 when we only auto-append
-			// "px" to a few hardcoded values.
-			if ( type === "number" && !isCustomProp ) {
-				value += ret && ret 3  || ( jQuery.cssNumber origName  ? "" : "px" );
-			}
-
-			// background-* props affect original clone's values
-			if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) {
-				style name  = "inherit";
-			}
-
-			// If a hook was provided, use that value, otherwise just set the specified value
-			if ( !hooks || !( "set" in hooks ) ||
-				( value = hooks.set( elem, value, extra ) ) !== undefined ) {
-
-				if ( isCustomProp ) {
-					style.setProperty( name, value );
-				} else {
-					style name  = value;
-				}
-			}
-
-		} else {
-
-			// If a hook was provided get the non-computed value from there
-			if ( hooks && "get" in hooks &&
-				( ret = hooks.get( elem, false, extra ) ) !== undefined ) {
-
-				return ret;
-			}
-
-			// Otherwise just get the value from the style object
-			return style name ;
-		}
-	},
-
-	css: function( elem, name, extra, styles ) {
-		var val, num, hooks,
-			origName = camelCase( name ),
-			isCustomProp = rcustomProp.test( name );
-
-		// Make sure that we're working with the right name. We don't
-		// want to modify the value if it is a CSS custom property
-		// since they are user-defined.
-		if ( !isCustomProp ) {
-			name = finalPropName( origName );
-		}
-
-		// Try prefixed name followed by the unprefixed name
-		hooks = jQuery.cssHooks name  || jQuery.cssHooks origName ;
-
-		// If a hook was provided get the computed value from there
-		if ( hooks && "get" in hooks ) {
-			val = hooks.get( elem, true, extra );
-		}
-
-		// Otherwise, if a way to get the computed value exists, use that
-		if ( val === undefined ) {
-			val = curCSS( elem, name, styles );
-		}
-
-		// Convert "normal" to computed value
-		if ( val === "normal" && name in cssNormalTransform ) {
-			val = cssNormalTransform name ;
-		}
-
-		// Make numeric if forced or a qualifier was provided and val looks numeric
-		if ( extra === "" || extra ) {
-			num = parseFloat( val );
-			return extra === true || isFinite( num ) ? num || 0 : val;
-		}
-
-		return val;
-	}
-} );
-
-jQuery.each(  "height", "width" , function( _i, dimension ) {
-	jQuery.cssHooks dimension  = {
-		get: function( elem, computed, extra ) {
-			if ( computed ) {
-
-				// Certain elements can have dimension info if we invisibly show them
-				// but it must have a current display style that would benefit
-				return rdisplayswap.test( jQuery.css( elem, "display" ) ) &&
-
-					// Support: Safari 8+
-					// Table columns in Safari have non-zero offsetWidth & zero
-					// getBoundingClientRect().width unless display is changed.
-					// Support: IE <=11 only
-					// Running getBoundingClientRect on a disconnected node
-					// in IE throws an error.
-					( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?
-						swap( elem, cssShow, function() {
-							return getWidthOrHeight( elem, dimension, extra );
-						} ) :
-						getWidthOrHeight( elem, dimension, extra );
-			}
-		},
-
-		set: function( elem, value, extra ) {
-			var matches,
-				styles = getStyles( elem ),
-
-				// Only read styles.position if the test has a chance to fail
-				// to avoid forcing a reflow.
-				scrollboxSizeBuggy = !support.scrollboxSize() &&
-					styles.position === "absolute",
-
-				// To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991)
-				boxSizingNeeded = scrollboxSizeBuggy || extra,
-				isBorderBox = boxSizingNeeded &&
-					jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
-				subtract = extra ?
-					boxModelAdjustment(
-						elem,
-						dimension,
-						extra,
-						isBorderBox,
-						styles
-					) :
-					0;
-
-			// Account for unreliable border-box dimensions by comparing offset* to computed and
-			// faking a content-box to get border and padding (gh-3699)
-			if ( isBorderBox && scrollboxSizeBuggy ) {
-				subtract -= Math.ceil(
-					elem "offset" + dimension 0 .toUpperCase() + dimension.slice( 1 )  -
-					parseFloat( styles dimension  ) -
-					boxModelAdjustment( elem, dimension, "border", false, styles ) -
-					0.5
-				);
-			}
-
-			// Convert to pixels if value adjustment is needed
-			if ( subtract && ( matches = rcssNum.exec( value ) ) &&
-				( matches 3  || "px" ) !== "px" ) {
-
-				elem.style dimension  = value;
-				value = jQuery.css( elem, dimension );
-			}
-
-			return setPositiveNumber( elem, value, subtract );
-		}
-	};
-} );
-
-jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,
-	function( elem, computed ) {
-		if ( computed ) {
-			return ( parseFloat( curCSS( elem, "marginLeft" ) ) ||
-				elem.getBoundingClientRect().left -
-					swap( elem, { marginLeft: 0 }, function() {
-						return elem.getBoundingClientRect().left;
-					} )
-				) + "px";
-		}
-	}
-);
-
-// These hooks are used by animate to expand properties
-jQuery.each( {
-	margin: "",
-	padding: "",
-	border: "Width"
-}, function( prefix, suffix ) {
-	jQuery.cssHooks prefix + suffix  = {
-		expand: function( value ) {
-			var i = 0,
-				expanded = {},
-
-				// Assumes a single number if not a string
-				parts = typeof value === "string" ? value.split( " " ) :  value ;
-
-			for ( ; i < 4; i++ ) {
-				expanded prefix + cssExpand i  + suffix  =
-					parts i  || parts i - 2  || parts 0 ;
-			}
-
-			return expanded;
-		}
-	};
-
-	if ( prefix !== "margin" ) {
-		jQuery.cssHooks prefix + suffix .set = setPositiveNumber;
-	}
-} );
-
-jQuery.fn.extend( {
-	css: function( name, value ) {
-		return access( this, function( elem, name, value ) {
-			var styles, len,
-				map = {},
-				i = 0;
-
-			if ( Array.isArray( name ) ) {
-				styles = getStyles( elem );
-				len = name.length;
-
-				for ( ; i < len; i++ ) {
-					map name i   = jQuery.css( elem, name i , false, styles );
-				}
-
-				return map;
-			}
-
-			return value !== undefined ?
-				jQuery.style( elem, name, value ) :
-				jQuery.css( elem, name );
-		}, name, value, arguments.length > 1 );
-	}
-} );
-
-
-function Tween( elem, options, prop, end, easing ) {
-	return new Tween.prototype.init( elem, options, prop, end, easing );
-}
-jQuery.Tween = Tween;
-
-Tween.prototype = {
-	constructor: Tween,
-	init: function( elem, options, prop, end, easing, unit ) {
-		this.elem = elem;
-		this.prop = prop;
-		this.easing = easing || jQuery.easing._default;
-		this.options = options;
-		this.start = this.now = this.cur();
-		this.end = end;
-		this.unit = unit || ( jQuery.cssNumber prop  ? "" : "px" );
-	},
-	cur: function() {
-		var hooks = Tween.propHooks this.prop ;
-
-		return hooks && hooks.get ?
-			hooks.get( this ) :
-			Tween.propHooks._default.get( this );
-	},
-	run: function( percent ) {
-		var eased,
-			hooks = Tween.propHooks this.prop ;
-
-		if ( this.options.duration ) {
-			this.pos = eased = jQuery.easing this.easing (
-				percent, this.options.duration * percent, 0, 1, this.options.duration
-			);
-		} else {
-			this.pos = eased = percent;
-		}
-		this.now = ( this.end - this.start ) * eased + this.start;
-
-		if ( this.options.step ) {
-			this.options.step.call( this.elem, this.now, this );
-		}
-
-		if ( hooks && hooks.set ) {
-			hooks.set( this );
-		} else {
-			Tween.propHooks._default.set( this );
-		}
-		return this;
-	}
-};
-
-Tween.prototype.init.prototype = Tween.prototype;
-
-Tween.propHooks = {
-	_default: {
-		get: function( tween ) {
-			var result;
-
-			// Use a property on the element directly when it is not a DOM element,
-			// or when there is no matching style property that exists.
-			if ( tween.elem.nodeType !== 1 ||
-				tween.elem tween.prop  != null && tween.elem.style tween.prop  == null ) {
-				return tween.elem tween.prop ;
-			}
-
-			// Passing an empty string as a 3rd parameter to .css will automatically
-			// attempt a parseFloat and fallback to a string if the parse fails.
-			// Simple values such as "10px" are parsed to Float;
-			// complex values such as "rotate(1rad)" are returned as-is.
-			result = jQuery.css( tween.elem, tween.prop, "" );
-
-			// Empty strings, null, undefined and "auto" are converted to 0.
-			return !result || result === "auto" ? 0 : result;
-		},
-		set: function( tween ) {
-
-			// Use step hook for back compat.
-			// Use cssHook if its there.
-			// Use .style if available and use plain properties where available.
-			if ( jQuery.fx.step tween.prop  ) {
-				jQuery.fx.step tween.prop ( tween );
-			} else if ( tween.elem.nodeType === 1 && (
-					jQuery.cssHooks tween.prop  ||
-					tween.elem.style finalPropName( tween.prop )  != null ) ) {
-				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
-			} else {
-				tween.elem tween.prop  = tween.now;
-			}
-		}
-	}
-};
-
-// Support: IE <=9 only
-// Panic based approach to setting things on disconnected nodes
-Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
-	set: function( tween ) {
-		if ( tween.elem.nodeType && tween.elem.parentNode ) {
-			tween.elem tween.prop  = tween.now;
-		}
-	}
-};
-
-jQuery.easing = {
-	linear: function( p ) {
-		return p;
-	},
-	swing: function( p ) {
-		return 0.5 - Math.cos( p * Math.PI ) / 2;
-	},
-	_default: "swing"
-};
-
-jQuery.fx = Tween.prototype.init;
-
-// Back compat <1.8 extension point
-jQuery.fx.step = {};
-
-
-
-
-var
-	fxNow, inProgress,
-	rfxtypes = /^(?:toggle|show|hide)$/,
-	rrun = /queueHooks$/;
-
-function schedule() {
-	if ( inProgress ) {
-		if ( document.hidden === false && window.requestAnimationFrame ) {
-			window.requestAnimationFrame( schedule );
-		} else {
-			window.setTimeout( schedule, jQuery.fx.interval );
-		}
-
-		jQuery.fx.tick();
-	}
-}
-
-// Animations created synchronously will run synchronously
-function createFxNow() {
-	window.setTimeout( function() {
-		fxNow = undefined;
-	} );
-	return ( fxNow = Date.now() );
-}
-
-// Generate parameters to create a standard animation
-function genFx( type, includeWidth ) {
-	var which,
-		i = 0,
-		attrs = { height: type };
-
-	// If we include width, step value is 1 to do all cssExpand values,
-	// otherwise step value is 2 to skip over Left and Right
-	includeWidth = includeWidth ? 1 : 0;
-	for ( ; i < 4; i += 2 - includeWidth ) {
-		which = cssExpand i ;
-		attrs "margin" + which  = attrs "padding" + which  = type;
-	}
-
-	if ( includeWidth ) {
-		attrs.opacity = attrs.width = type;
-	}
-
-	return attrs;
-}
-
-function createTween( value, prop, animation ) {
-	var tween,
-		collection = ( Animation.tweeners prop  ||  ).concat( Animation.tweeners "*"  ),
-		index = 0,
-		length = collection.length;
-	for ( ; index < length; index++ ) {
-		if ( ( tween = collection index .call( animation, prop, value ) ) ) {
-
-			// We're done with this property
-			return tween;
-		}
-	}
-}
-
-function defaultPrefilter( elem, props, opts ) {
-	var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display,
-		isBox = "width" in props || "height" in props,
-		anim = this,
-		orig = {},
-		style = elem.style,
-		hidden = elem.nodeType && isHiddenWithinTree( elem ),
-		dataShow = dataPriv.get( elem, "fxshow" );
-
-	// Queue-skipping animations hijack the fx hooks
-	if ( !opts.queue ) {
-		hooks = jQuery._queueHooks( elem, "fx" );
-		if ( hooks.unqueued == null ) {
-			hooks.unqueued = 0;
-			oldfire = hooks.empty.fire;
-			hooks.empty.fire = function() {
-				if ( !hooks.unqueued ) {
-					oldfire();
-				}
-			};
-		}
-		hooks.unqueued++;
-
-		anim.always( function() {
-
-			// Ensure the complete handler is called before this completes
-			anim.always( function() {
-				hooks.unqueued--;
-				if ( !jQuery.queue( elem, "fx" ).length ) {
-					hooks.empty.fire();
-				}
-			} );
-		} );
-	}
-
-	// Detect show/hide animations
-	for ( prop in props ) {
-		value = props prop ;
-		if ( rfxtypes.test( value ) ) {
-			delete props prop ;
-			toggle = toggle || value === "toggle";
-			if ( value === ( hidden ? "hide" : "show" ) ) {
-
-				// Pretend to be hidden if this is a "show" and
-				// there is still data from a stopped show/hide
-				if ( value === "show" && dataShow && dataShow prop  !== undefined ) {
-					hidden = true;
-
-				// Ignore all other no-op show/hide data
-				} else {
-					continue;
-				}
-			}
-			orig prop  = dataShow && dataShow prop  || jQuery.style( elem, prop );
-		}
-	}
-
-	// Bail out if this is a no-op like .hide().hide()
-	propTween = !jQuery.isEmptyObject( props );
-	if ( !propTween && jQuery.isEmptyObject( orig ) ) {
-		return;
-	}
-
-	// Restrict "overflow" and "display" styles during box animations
-	if ( isBox && elem.nodeType === 1 ) {
-
-		// Support: IE <=9 - 11, Edge 12 - 15
-		// Record all 3 overflow attributes because IE does not infer the shorthand
-		// from identically-valued overflowX and overflowY and Edge just mirrors
-		// the overflowX value there.
-		opts.overflow =  style.overflow, style.overflowX, style.overflowY ;
-
-		// Identify a display type, preferring old show/hide data over the CSS cascade
-		restoreDisplay = dataShow && dataShow.display;
-		if ( restoreDisplay == null ) {
-			restoreDisplay = dataPriv.get( elem, "display" );
-		}
-		display = jQuery.css( elem, "display" );
-		if ( display === "none" ) {
-			if ( restoreDisplay ) {
-				display = restoreDisplay;
-			} else {
-
-				// Get nonempty value(s) by temporarily forcing visibility
-				showHide(  elem , true );
-				restoreDisplay = elem.style.display || restoreDisplay;
-				display = jQuery.css( elem, "display" );
-				showHide(  elem  );
-			}
-		}
-
-		// Animate inline elements as inline-block
-		if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) {
-			if ( jQuery.css( elem, "float" ) === "none" ) {
-
-				// Restore the original display value at the end of pure show/hide animations
-				if ( !propTween ) {
-					anim.done( function() {
-						style.display = restoreDisplay;
-					} );
-					if ( restoreDisplay == null ) {
-						display = style.display;
-						restoreDisplay = display === "none" ? "" : display;
-					}
-				}
-				style.display = "inline-block";
-			}
-		}
-	}
-
-	if ( opts.overflow ) {
-		style.overflow = "hidden";
-		anim.always( function() {
-			style.overflow = opts.overflow 0 ;
-			style.overflowX = opts.overflow 1 ;
-			style.overflowY = opts.overflow 2 ;
-		} );
-	}
-
-	// Implement show/hide animations
-	propTween = false;
-	for ( prop in orig ) {
-
-		// General show/hide setup for this element animation
-		if ( !propTween ) {
-			if ( dataShow ) {
-				if ( "hidden" in dataShow ) {
-					hidden = dataShow.hidden;
-				}
-			} else {
-				dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } );
-			}
-
-			// Store hidden/visible for toggle so `.stop().toggle()` "reverses"
-			if ( toggle ) {
-				dataShow.hidden = !hidden;
-			}
-
-			// Show elements before animating them
-			if ( hidden ) {
-				showHide(  elem , true );
-			}
-
-			/* eslint-disable no-loop-func */
-
-			anim.done( function() {
-
-			/* eslint-enable no-loop-func */
-
-				// The final step of a "hide" animation is actually hiding the element
-				if ( !hidden ) {
-					showHide(  elem  );
-				}
-				dataPriv.remove( elem, "fxshow" );
-				for ( prop in orig ) {
-					jQuery.style( elem, prop, orig prop  );
-				}
-			} );
-		}
-
-		// Per-property setup
-		propTween = createTween( hidden ? dataShow prop  : 0, prop, anim );
-		if ( !( prop in dataShow ) ) {
-			dataShow prop  = propTween.start;
-			if ( hidden ) {
-				propTween.end = propTween.start;
-				propTween.start = 0;
-			}
-		}
-	}
-}
-
-function propFilter( props, specialEasing ) {
-	var index, name, easing, value, hooks;
-
-	// camelCase, specialEasing and expand cssHook pass
-	for ( index in props ) {
-		name = camelCase( index );
-		easing = specialEasing name ;
-		value = props index ;
-		if ( Array.isArray( value ) ) {
-			easing = value 1 ;
-			value = props index  = value 0 ;
-		}
-
-		if ( index !== name ) {
-			props name  = value;
-			delete props index ;
-		}
-
-		hooks = jQuery.cssHooks name ;
-		if ( hooks && "expand" in hooks ) {
-			value = hooks.expand( value );
-			delete props name ;
-
-			// Not quite $.extend, this won't overwrite existing keys.
-			// Reusing 'index' because we have the correct "name"
-			for ( index in value ) {
-				if ( !( index in props ) ) {
-					props index  = value index ;
-					specialEasing index  = easing;
-				}
-			}
-		} else {
-			specialEasing name  = easing;
-		}
-	}
-}
-
-function Animation( elem, properties, options ) {
-	var result,
-		stopped,
-		index = 0,
-		length = Animation.prefilters.length,
-		deferred = jQuery.Deferred().always( function() {
-
-			// Don't match elem in the :animated selector
-			delete tick.elem;
-		} ),
-		tick = function() {
-			if ( stopped ) {
-				return false;
-			}
-			var currentTime = fxNow || createFxNow(),
-				remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ),
-
-				// Support: Android 2.3 only
-				// Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497)
-				temp = remaining / animation.duration || 0,
-				percent = 1 - temp,
-				index = 0,
-				length = animation.tweens.length;
-
-			for ( ; index < length; index++ ) {
-				animation.tweens index .run( percent );
-			}
-
-			deferred.notifyWith( elem,  animation, percent, remaining  );
-
-			// If there's more to do, yield
-			if ( percent < 1 && length ) {
-				return remaining;
-			}
-
-			// If this was an empty animation, synthesize a final progress notification
-			if ( !length ) {
-				deferred.notifyWith( elem,  animation, 1, 0  );
-			}
-
-			// Resolve the animation and report its conclusion
-			deferred.resolveWith( elem,  animation  );
-			return false;
-		},
-		animation = deferred.promise( {
-			elem: elem,
-			props: jQuery.extend( {}, properties ),
-			opts: jQuery.extend( true, {
-				specialEasing: {},
-				easing: jQuery.easing._default
-			}, options ),
-			originalProperties: properties,
-			originalOptions: options,
-			startTime: fxNow || createFxNow(),
-			duration: options.duration,
-			tweens: ,
-			createTween: function( prop, end ) {
-				var tween = jQuery.Tween( elem, animation.opts, prop, end,
-						animation.opts.specialEasing prop  || animation.opts.easing );
-				animation.tweens.push( tween );
-				return tween;
-			},
-			stop: function( gotoEnd ) {
-				var index = 0,
-
-					// If we are going to the end, we want to run all the tweens
-					// otherwise we skip this part
-					length = gotoEnd ? animation.tweens.length : 0;
-				if ( stopped ) {
-					return this;
-				}
-				stopped = true;
-				for ( ; index < length; index++ ) {
-					animation.tweens index .run( 1 );
-				}
-
-				// Resolve when we played the last frame; otherwise, reject
-				if ( gotoEnd ) {
-					deferred.notifyWith( elem,  animation, 1, 0  );
-					deferred.resolveWith( elem,  animation, gotoEnd  );
-				} else {
-					deferred.rejectWith( elem,  animation, gotoEnd  );
-				}
-				return this;
-			}
-		} ),
-		props = animation.props;
-
-	propFilter( props, animation.opts.specialEasing );
-
-	for ( ; index < length; index++ ) {
-		result = Animation.prefilters index .call( animation, elem, props, animation.opts );
-		if ( result ) {
-			if ( isFunction( result.stop ) ) {
-				jQuery._queueHooks( animation.elem, animation.opts.queue ).stop =
-					result.stop.bind( result );
-			}
-			return result;
-		}
-	}
-
-	jQuery.map( props, createTween, animation );
-
-	if ( isFunction( animation.opts.start ) ) {
-		animation.opts.start.call( elem, animation );
-	}
-
-	// Attach callbacks from options
-	animation
-		.progress( animation.opts.progress )
-		.done( animation.opts.done, animation.opts.complete )
-		.fail( animation.opts.fail )
-		.always( animation.opts.always );
-
-	jQuery.fx.timer(
-		jQuery.extend( tick, {
-			elem: elem,
-			anim: animation,
-			queue: animation.opts.queue
-		} )
-	);
-
-	return animation;
-}
-
-jQuery.Animation = jQuery.extend( Animation, {
-
-	tweeners: {
-		"*":  function( prop, value ) {
-			var tween = this.createTween( prop, value );
-			adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween );
-			return tween;
-		} 
-	},
-
-	tweener: function( props, callback ) {
-		if ( isFunction( props ) ) {
-			callback = props;
-			props =  "*" ;
-		} else {
-			props = props.match( rnothtmlwhite );
-		}
-
-		var prop,
-			index = 0,
-			length = props.length;
-
-		for ( ; index < length; index++ ) {
-			prop = props index ;
-			Animation.tweeners prop  = Animation.tweeners prop  || ;
-			Animation.tweeners prop .unshift( callback );
-		}
-	},
-
-	prefilters:  defaultPrefilter ,
-
-	prefilter: function( callback, prepend ) {
-		if ( prepend ) {
-			Animation.prefilters.unshift( callback );
-		} else {
-			Animation.prefilters.push( callback );
-		}
-	}
-} );
-
-jQuery.speed = function( speed, easing, fn ) {
-	var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
-		complete: fn || !fn && easing ||
-			isFunction( speed ) && speed,
-		duration: speed,
-		easing: fn && easing || easing && !isFunction( easing ) && easing
-	};
-
-	// Go to the end state if fx are off
-	if ( jQuery.fx.off ) {
-		opt.duration = 0;
-
-	} else {
-		if ( typeof opt.duration !== "number" ) {
-			if ( opt.duration in jQuery.fx.speeds ) {
-				opt.duration = jQuery.fx.speeds opt.duration ;
-
-			} else {
-				opt.duration = jQuery.fx.speeds._default;
-			}
-		}
-	}
-
-	// Normalize opt.queue - true/undefined/null -> "fx"
-	if ( opt.queue == null || opt.queue === true ) {
-		opt.queue = "fx";
-	}
-
-	// Queueing
-	opt.old = opt.complete;
-
-	opt.complete = function() {
-		if ( isFunction( opt.old ) ) {
-			opt.old.call( this );
-		}
-
-		if ( opt.queue ) {
-			jQuery.dequeue( this, opt.queue );
-		}
-	};
-
-	return opt;
-};
-
-jQuery.fn.extend( {
-	fadeTo: function( speed, to, easing, callback ) {
-
-		// Show any hidden elements after setting opacity to 0
-		return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show()
-
-			// Animate to the value specified
-			.end().animate( { opacity: to }, speed, easing, callback );
-	},
-	animate: function( prop, speed, easing, callback ) {
-		var empty = jQuery.isEmptyObject( prop ),
-			optall = jQuery.speed( speed, easing, callback ),
-			doAnimation = function() {
-
-				// Operate on a copy of prop so per-property easing won't be lost
-				var anim = Animation( this, jQuery.extend( {}, prop ), optall );
-
-				// Empty animations, or finishing resolves immediately
-				if ( empty || dataPriv.get( this, "finish" ) ) {
-					anim.stop( true );
-				}
-			};
-			doAnimation.finish = doAnimation;
-
-		return empty || optall.queue === false ?
-			this.each( doAnimation ) :
-			this.queue( optall.queue, doAnimation );
-	},
-	stop: function( type, clearQueue, gotoEnd ) {
-		var stopQueue = function( hooks ) {
-			var stop = hooks.stop;
-			delete hooks.stop;
-			stop( gotoEnd );
-		};
-
-		if ( typeof type !== "string" ) {
-			gotoEnd = clearQueue;
-			clearQueue = type;
-			type = undefined;
-		}
-		if ( clearQueue ) {
-			this.queue( type || "fx",  );
-		}
-
-		return this.each( function() {
-			var dequeue = true,
-				index = type != null && type + "queueHooks",
-				timers = jQuery.timers,
-				data = dataPriv.get( this );
-
-			if ( index ) {
-				if ( data index  && data index .stop ) {
-					stopQueue( data index  );
-				}
-			} else {
-				for ( index in data ) {
-					if ( data index  && data index .stop && rrun.test( index ) ) {
-						stopQueue( data index  );
-					}
-				}
-			}
-
-			for ( index = timers.length; index--; ) {
-				if ( timers index .elem === this &&
-					( type == null || timers index .queue === type ) ) {
-
-					timers index .anim.stop( gotoEnd );
-					dequeue = false;
-					timers.splice( index, 1 );
-				}
-			}
-
-			// Start the next in the queue if the last step wasn't forced.
-			// Timers currently will call their complete callbacks, which
-			// will dequeue but only if they were gotoEnd.
-			if ( dequeue || !gotoEnd ) {
-				jQuery.dequeue( this, type );
-			}
-		} );
-	},
-	finish: function( type ) {
-		if ( type !== false ) {
-			type = type || "fx";
-		}
-		return this.each( function() {
-			var index,
-				data = dataPriv.get( this ),
-				queue = data type + "queue" ,
-				hooks = data type + "queueHooks" ,
-				timers = jQuery.timers,
-				length = queue ? queue.length : 0;
-
-			// Enable finishing flag on private data
-			data.finish = true;
-
-			// Empty the queue first
-			jQuery.queue( this, type,  );
-
-			if ( hooks && hooks.stop ) {
-				hooks.stop.call( this, true );
-			}
-
-			// Look for any active animations, and finish them
-			for ( index = timers.length; index--; ) {
-				if ( timers index .elem === this && timers index .queue === type ) {
-					timers index .anim.stop( true );
-					timers.splice( index, 1 );
-				}
-			}
-
-			// Look for any animations in the old queue and finish them
-			for ( index = 0; index < length; index++ ) {
-				if ( queue index  && queue index .finish ) {
-					queue index .finish.call( this );
-				}
-			}
-
-			// Turn off finishing flag
-			delete data.finish;
-		} );
-	}
-} );
-
-jQuery.each(  "toggle", "show", "hide" , function( _i, name ) {
-	var cssFn = jQuery.fn name ;
-	jQuery.fn name  = function( speed, easing, callback ) {
-		return speed == null || typeof speed === "boolean" ?
-			cssFn.apply( this, arguments ) :
-			this.animate( genFx( name, true ), speed, easing, callback );
-	};
-} );
-
-// Generate shortcuts for custom animations
-jQuery.each( {
-	slideDown: genFx( "show" ),
-	slideUp: genFx( "hide" ),
-	slideToggle: genFx( "toggle" ),
-	fadeIn: { opacity: "show" },
-	fadeOut: { opacity: "hide" },
-	fadeToggle: { opacity: "toggle" }
-}, function( name, props ) {
-	jQuery.fn name  = function( speed, easing, callback ) {
-		return this.animate( props, speed, easing, callback );
-	};
-} );
-
-jQuery.timers = ;
-jQuery.fx.tick = function() {
-	var timer,
-		i = 0,
-		timers = jQuery.timers;
-
-	fxNow = Date.now();
-
-	for ( ; i < timers.length; i++ ) {
-		timer = timers i ;
-
-		// Run the timer and safely remove it when done (allowing for external removal)
-		if ( !timer() && timers i  === timer ) {
-			timers.splice( i--, 1 );
-		}
-	}
-
-	if ( !timers.length ) {
-		jQuery.fx.stop();
-	}
-	fxNow = undefined;
-};
-
-jQuery.fx.timer = function( timer ) {
-	jQuery.timers.push( timer );
-	jQuery.fx.start();
-};
-
-jQuery.fx.interval = 13;
-jQuery.fx.start = function() {
-	if ( inProgress ) {
-		return;
-	}
-
-	inProgress = true;
-	schedule();
-};
-
-jQuery.fx.stop = function() {
-	inProgress = null;
-};
-
-jQuery.fx.speeds = {
-	slow: 600,
-	fast: 200,
-
-	// Default speed
-	_default: 400
-};
-
-
-// Based off of the plugin by Clint Helfers, with permission.
-// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/
-jQuery.fn.delay = function( time, type ) {
-	time = jQuery.fx ? jQuery.fx.speeds time  || time : time;
-	type = type || "fx";
-
-	return this.queue( type, function( next, hooks ) {
-		var timeout = window.setTimeout( next, time );
-		hooks.stop = function() {
-			window.clearTimeout( timeout );
-		};
-	} );
-};
-
-
-( function() {
-	var input = document.createElement( "input" ),
-		select = document.createElement( "select" ),
-		opt = select.appendChild( document.createElement( "option" ) );
-
-	input.type = "checkbox";
-
-	// Support: Android <=4.3 only
-	// Default value for a checkbox should be "on"
-	support.checkOn = input.value !== "";
-
-	// Support: IE <=11 only
-	// Must access selectedIndex to make default options select
-	support.optSelected = opt.selected;
-
-	// Support: IE <=11 only
-	// An input loses its value after becoming a radio
-	input = document.createElement( "input" );
-	input.value = "t";
-	input.type = "radio";
-	support.radioValue = input.value === "t";
-} )();
-
-
-var boolHook,
-	attrHandle = jQuery.expr.attrHandle;
-
-jQuery.fn.extend( {
-	attr: function( name, value ) {
-		return access( this, jQuery.attr, name, value, arguments.length > 1 );
-	},
-
-	removeAttr: function( name ) {
-		return this.each( function() {
-			jQuery.removeAttr( this, name );
-		} );
-	}
-} );
-
-jQuery.extend( {
-	attr: function( elem, name, value ) {
-		var ret, hooks,
-			nType = elem.nodeType;
-
-		// Don't get/set attributes on text, comment and attribute nodes
-		if ( nType === 3 || nType === 8 || nType === 2 ) {
-			return;
-		}
-
-		// Fallback to prop when attributes are not supported
-		if ( typeof elem.getAttribute === "undefined" ) {
-			return jQuery.prop( elem, name, value );
-		}
-
-		// Attribute hooks are determined by the lowercase version
-		// Grab necessary hook if one is defined
-		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
-			hooks = jQuery.attrHooks name.toLowerCase()  ||
-				( jQuery.expr.match.bool.test( name ) ? boolHook : undefined );
-		}
-
-		if ( value !== undefined ) {
-			if ( value === null ) {
-				jQuery.removeAttr( elem, name );
-				return;
-			}
-
-			if ( hooks && "set" in hooks &&
-				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
-				return ret;
-			}
-
-			elem.setAttribute( name, value + "" );
-			return value;
-		}
-
-		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
-			return ret;
-		}
-
-		ret = jQuery.find.attr( elem, name );
-
-		// Non-existent attributes return null, we normalize to undefined
-		return ret == null ? undefined : ret;
-	},
-
-	attrHooks: {
-		type: {
-			set: function( elem, value ) {
-				if ( !support.radioValue && value === "radio" &&
-					nodeName( elem, "input" ) ) {
-					var val = elem.value;
-					elem.setAttribute( "type", value );
-					if ( val ) {
-						elem.value = val;
-					}
-					return value;
-				}
-			}
-		}
-	},
-
-	removeAttr: function( elem, value ) {
-		var name,
-			i = 0,
-
-			// Attribute names can contain non-HTML whitespace characters
-			// https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
-			attrNames = value && value.match( rnothtmlwhite );
-
-		if ( attrNames && elem.nodeType === 1 ) {
-			while ( ( name = attrNames i++  ) ) {
-				elem.removeAttribute( name );
-			}
-		}
-	}
-} );
-
-// Hooks for boolean attributes
-boolHook = {
-	set: function( elem, value, name ) {
-		if ( value === false ) {
-
-			// Remove boolean attributes when set to false
-			jQuery.removeAttr( elem, name );
-		} else {
-			elem.setAttribute( name, name );
-		}
-		return name;
-	}
-};
-
-jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) {
-	var getter = attrHandle name  || jQuery.find.attr;
-
-	attrHandle name  = function( elem, name, isXML ) {
-		var ret, handle,
-			lowercaseName = name.toLowerCase();
-
-		if ( !isXML ) {
-
-			// Avoid an infinite loop by temporarily removing this function from the getter
-			handle = attrHandle lowercaseName ;
-			attrHandle lowercaseName  = ret;
-			ret = getter( elem, name, isXML ) != null ?
-				lowercaseName :
-				null;
-			attrHandle lowercaseName  = handle;
-		}
-		return ret;
-	};
-} );
-
-
-
-
-var rfocusable = /^(?:input|select|textarea|button)$/i,
-	rclickable = /^(?:a|area)$/i;
-
-jQuery.fn.extend( {
-	prop: function( name, value ) {
-		return access( this, jQuery.prop, name, value, arguments.length > 1 );
-	},
-
-	removeProp: function( name ) {
-		return this.each( function() {
-			delete this jQuery.propFix name  || name ;
-		} );
-	}
-} );
-
-jQuery.extend( {
-	prop: function( elem, name, value ) {
-		var ret, hooks,
-			nType = elem.nodeType;
-
-		// Don't get/set properties on text, comment and attribute nodes
-		if ( nType === 3 || nType === 8 || nType === 2 ) {
-			return;
-		}
-
-		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
-
-			// Fix name and attach hooks
-			name = jQuery.propFix name  || name;
-			hooks = jQuery.propHooks name ;
-		}
-
-		if ( value !== undefined ) {
-			if ( hooks && "set" in hooks &&
-				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
-				return ret;
-			}
-
-			return ( elem name  = value );
-		}
-
-		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
-			return ret;
-		}
-
-		return elem name ;
-	},
-
-	propHooks: {
-		tabIndex: {
-			get: function( elem ) {
-
-				// Support: IE <=9 - 11 only
-				// elem.tabIndex doesn't always return the
-				// correct value when it hasn't been explicitly set
-				// https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
-				// Use proper attribute retrieval(#12072)
-				var tabindex = jQuery.find.attr( elem, "tabindex" );
-
-				if ( tabindex ) {
-					return parseInt( tabindex, 10 );
-				}
-
-				if (
-					rfocusable.test( elem.nodeName ) ||
-					rclickable.test( elem.nodeName ) &&
-					elem.href
-				) {
-					return 0;
-				}
-
-				return -1;
-			}
-		}
-	},
-
-	propFix: {
-		"for": "htmlFor",
-		"class": "className"
-	}
-} );
-
-// Support: IE <=11 only
-// Accessing the selectedIndex property
-// forces the browser to respect setting selected
-// on the option
-// The getter ensures a default option is selected
-// when in an optgroup
-// eslint rule "no-unused-expressions" is disabled for this code
-// since it considers such accessions noop
-if ( !support.optSelected ) {
-	jQuery.propHooks.selected = {
-		get: function( elem ) {
-
-			/* eslint no-unused-expressions: "off" */
-
-			var parent = elem.parentNode;
-			if ( parent && parent.parentNode ) {
-				parent.parentNode.selectedIndex;
-			}
-			return null;
-		},
-		set: function( elem ) {
-
-			/* eslint no-unused-expressions: "off" */
-
-			var parent = elem.parentNode;
-			if ( parent ) {
-				parent.selectedIndex;
-
-				if ( parent.parentNode ) {
-					parent.parentNode.selectedIndex;
-				}
-			}
-		}
-	};
-}
-
-jQuery.each( 
-	"tabIndex",
-	"readOnly",
-	"maxLength",
-	"cellSpacing",
-	"cellPadding",
-	"rowSpan",
-	"colSpan",
-	"useMap",
-	"frameBorder",
-	"contentEditable"
-, function() {
-	jQuery.propFix this.toLowerCase()  = this;
-} );
-
-
-
-
-	// Strip and collapse whitespace according to HTML spec
-	// https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace
-	function stripAndCollapse( value ) {
-		var tokens = value.match( rnothtmlwhite ) || ;
-		return tokens.join( " " );
-	}
-
-
-function getClass( elem ) {
-	return elem.getAttribute && elem.getAttribute( "class" ) || "";
-}
-
-function classesToArray( value ) {
-	if ( Array.isArray( value ) ) {
-		return value;
-	}
-	if ( typeof value === "string" ) {
-		return value.match( rnothtmlwhite ) || ;
-	}
-	return ;
-}
-
-jQuery.fn.extend( {
-	addClass: function( value ) {
-		var classes, elem, cur, curValue, clazz, j, finalValue,
-			i = 0;
-
-		if ( isFunction( value ) ) {
-			return this.each( function( j ) {
-				jQuery( this ).addClass( value.call( this, j, getClass( this ) ) );
-			} );
-		}
-
-		classes = classesToArray( value );
-
-		if ( classes.length ) {
-			while ( ( elem = this i++  ) ) {
-				curValue = getClass( elem );
-				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
-
-				if ( cur ) {
-					j = 0;
-					while ( ( clazz = classes j++  ) ) {
-						if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
-							cur += clazz + " ";
-						}
-					}
-
-					// Only assign if different to avoid unneeded rendering.
-					finalValue = stripAndCollapse( cur );
-					if ( curValue !== finalValue ) {
-						elem.setAttribute( "class", finalValue );
-					}
-				}
-			}
-		}
-
-		return this;
-	},
-
-	removeClass: function( value ) {
-		var classes, elem, cur, curValue, clazz, j, finalValue,
-			i = 0;
-
-		if ( isFunction( value ) ) {
-			return this.each( function( j ) {
-				jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) );
-			} );
-		}
-
-		if ( !arguments.length ) {
-			return this.attr( "class", "" );
-		}
-
-		classes = classesToArray( value );
-
-		if ( classes.length ) {
-			while ( ( elem = this i++  ) ) {
-				curValue = getClass( elem );
-
-				// This expression is here for better compressibility (see addClass)
-				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
-
-				if ( cur ) {
-					j = 0;
-					while ( ( clazz = classes j++  ) ) {
-
-						// Remove *all* instances
-						while ( cur.indexOf( " " + clazz + " " ) > -1 ) {
-							cur = cur.replace( " " + clazz + " ", " " );
-						}
-					}
-
-					// Only assign if different to avoid unneeded rendering.
-					finalValue = stripAndCollapse( cur );
-					if ( curValue !== finalValue ) {
-						elem.setAttribute( "class", finalValue );
-					}
-				}
-			}
-		}
-
-		return this;
-	},
-
-	toggleClass: function( value, stateVal ) {
-		var type = typeof value,
-			isValidValue = type === "string" || Array.isArray( value );
-
-		if ( typeof stateVal === "boolean" && isValidValue ) {
-			return stateVal ? this.addClass( value ) : this.removeClass( value );
-		}
-
-		if ( isFunction( value ) ) {
-			return this.each( function( i ) {
-				jQuery( this ).toggleClass(
-					value.call( this, i, getClass( this ), stateVal ),
-					stateVal
-				);
-			} );
-		}
-
-		return this.each( function() {
-			var className, i, self, classNames;
-
-			if ( isValidValue ) {
-
-				// Toggle individual class names
-				i = 0;
-				self = jQuery( this );
-				classNames = classesToArray( value );
-
-				while ( ( className = classNames i++  ) ) {
-
-					// Check each className given, space separated list
-					if ( self.hasClass( className ) ) {
-						self.removeClass( className );
-					} else {
-						self.addClass( className );
-					}
-				}
-
-			// Toggle whole class name
-			} else if ( value === undefined || type === "boolean" ) {
-				className = getClass( this );
-				if ( className ) {
-
-					// Store className if set
-					dataPriv.set( this, "__className__", className );
-				}
-
-				// If the element has a class name or if we're passed `false`,
-				// then remove the whole classname (if there was one, the above saved it).
-				// Otherwise bring back whatever was previously saved (if anything),
-				// falling back to the empty string if nothing was stored.
-				if ( this.setAttribute ) {
-					this.setAttribute( "class",
-						className || value === false ?
-						"" :
-						dataPriv.get( this, "__className__" ) || ""
-					);
-				}
-			}
-		} );
-	},
-
-	hasClass: function( selector ) {
-		var className, elem,
-			i = 0;
-
-		className = " " + selector + " ";
-		while ( ( elem = this i++  ) ) {
-			if ( elem.nodeType === 1 &&
-				( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) {
-					return true;
-			}
-		}
-
-		return false;
-	}
-} );
-
-
-
-
-var rreturn = /\r/g;
-
-jQuery.fn.extend( {
-	val: function( value ) {
-		var hooks, ret, valueIsFunction,
-			elem = this 0 ;
-
-		if ( !arguments.length ) {
-			if ( elem ) {
-				hooks = jQuery.valHooks elem.type  ||
-					jQuery.valHooks elem.nodeName.toLowerCase() ;
-
-				if ( hooks &&
-					"get" in hooks &&
-					( ret = hooks.get( elem, "value" ) ) !== undefined
-				) {
-					return ret;
-				}
-
-				ret = elem.value;
-
-				// Handle most common string cases
-				if ( typeof ret === "string" ) {
-					return ret.replace( rreturn, "" );
-				}
-
-				// Handle cases where value is null/undef or number
-				return ret == null ? "" : ret;
-			}
-
-			return;
-		}
-
-		valueIsFunction = isFunction( value );
-
-		return this.each( function( i ) {
-			var val;
-
-			if ( this.nodeType !== 1 ) {
-				return;
-			}
-
-			if ( valueIsFunction ) {
-				val = value.call( this, i, jQuery( this ).val() );
-			} else {
-				val = value;
-			}
-
-			// Treat null/undefined as ""; convert numbers to string
-			if ( val == null ) {
-				val = "";
-
-			} else if ( typeof val === "number" ) {
-				val += "";
-
-			} else if ( Array.isArray( val ) ) {
-				val = jQuery.map( val, function( value ) {
-					return value == null ? "" : value + "";
-				} );
-			}
-
-			hooks = jQuery.valHooks this.type  || jQuery.valHooks this.nodeName.toLowerCase() ;
-
-			// If set returns undefined, fall back to normal setting
-			if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
-				this.value = val;
-			}
-		} );
-	}
-} );
-
-jQuery.extend( {
-	valHooks: {
-		option: {
-			get: function( elem ) {
-
-				var val = jQuery.find.attr( elem, "value" );
-				return val != null ?
-					val :
-
-					// Support: IE <=10 - 11 only
-					// option.text throws exceptions (#14686, #14858)
-					// Strip and collapse whitespace
-					// https://html.spec.whatwg.org/#strip-and-collapse-whitespace
-					stripAndCollapse( jQuery.text( elem ) );
-			}
-		},
-		select: {
-			get: function( elem ) {
-				var value, option, i,
-					options = elem.options,
-					index = elem.selectedIndex,
-					one = elem.type === "select-one",
-					values = one ? null : ,
-					max = one ? index + 1 : options.length;
-
-				if ( index < 0 ) {
-					i = max;
-
-				} else {
-					i = one ? index : 0;
-				}
-
-				// Loop through all the selected options
-				for ( ; i < max; i++ ) {
-					option = options i ;
-
-					// Support: IE <=9 only
-					// IE8-9 doesn't update selected after form reset (#2551)
-					if ( ( option.selected || i === index ) &&
-
-							// Don't return options that are disabled or in a disabled optgroup
-							!option.disabled &&
-							( !option.parentNode.disabled ||
-								!nodeName( option.parentNode, "optgroup" ) ) ) {
-
-						// Get the specific value for the option
-						value = jQuery( option ).val();
-
-						// We don't need an array for one selects
-						if ( one ) {
-							return value;
-						}
-
-						// Multi-Selects return an array
-						values.push( value );
-					}
-				}
-
-				return values;
-			},
-
-			set: function( elem, value ) {
-				var optionSet, option,
-					options = elem.options,
-					values = jQuery.makeArray( value ),
-					i = options.length;
-
-				while ( i-- ) {
-					option = options i ;
-
-					/* eslint-disable no-cond-assign */
-
-					if ( option.selected =
-						jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1
-					) {
-						optionSet = true;
-					}
-
-					/* eslint-enable no-cond-assign */
-				}
-
-				// Force browsers to behave consistently when non-matching value is set
-				if ( !optionSet ) {
-					elem.selectedIndex = -1;
-				}
-				return values;
-			}
-		}
-	}
-} );
-
-// Radios and checkboxes getter/setter
-jQuery.each(  "radio", "checkbox" , function() {
-	jQuery.valHooks this  = {
-		set: function( elem, value ) {
-			if ( Array.isArray( value ) ) {
-				return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );
-			}
-		}
-	};
-	if ( !support.checkOn ) {
-		jQuery.valHooks this .get = function( elem ) {
-			return elem.getAttribute( "value" ) === null ? "on" : elem.value;
-		};
-	}
-} );
-
-
-
-
-// Return jQuery for attributes-only inclusion
-
-
-support.focusin = "onfocusin" in window;
-
-
-var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
-	stopPropagationCallback = function( e ) {
-		e.stopPropagation();
-	};
-
-jQuery.extend( jQuery.event, {
-
-	trigger: function( event, data, elem, onlyHandlers ) {
-
-		var i, cur, tmp, bubbleType, ontype, handle, special, lastElement,
-			eventPath =  elem || document ,
-			type = hasOwn.call( event, "type" ) ? event.type : event,
-			namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : ;
-
-		cur = lastElement = tmp = elem = elem || document;
-
-		// Don't do events on text and comment nodes
-		if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
-			return;
-		}
-
-		// focus/blur morphs to focusin/out; ensure we're not firing them right now
-		if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
-			return;
-		}
-
-		if ( type.indexOf( "." ) > -1 ) {
-
-			// Namespaced trigger; create a regexp to match event type in handle()
-			namespaces = type.split( "." );
-			type = namespaces.shift();
-			namespaces.sort();
-		}
-		ontype = type.indexOf( ":" ) < 0 && "on" + type;
-
-		// Caller can pass in a jQuery.Event object, Object, or just an event type string
-		event = event jQuery.expando  ?
-			event :
-			new jQuery.Event( type, typeof event === "object" && event );
-
-		// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
-		event.isTrigger = onlyHandlers ? 2 : 3;
-		event.namespace = namespaces.join( "." );
-		event.rnamespace = event.namespace ?
-			new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) :
-			null;
-
-		// Clean up the event in case it is being reused
-		event.result = undefined;
-		if ( !event.target ) {
-			event.target = elem;
-		}
-
-		// Clone any incoming data and prepend the event, creating the handler arg list
-		data = data == null ?
-			 event  :
-			jQuery.makeArray( data,  event  );
-
-		// Allow special events to draw outside the lines
-		special = jQuery.event.special type  || {};
-		if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
-			return;
-		}
-
-		// Determine event propagation path in advance, per W3C events spec (#9951)
-		// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
-		if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) {
-
-			bubbleType = special.delegateType || type;
-			if ( !rfocusMorph.test( bubbleType + type ) ) {
-				cur = cur.parentNode;
-			}
-			for ( ; cur; cur = cur.parentNode ) {
-				eventPath.push( cur );
-				tmp = cur;
-			}
-
-			// Only add window if we got to document (e.g., not plain obj or detached DOM)
-			if ( tmp === ( elem.ownerDocument || document ) ) {
-				eventPath.push( tmp.defaultView || tmp.parentWindow || window );
-			}
-		}
-
-		// Fire handlers on the event path
-		i = 0;
-		while ( ( cur = eventPath i++  ) && !event.isPropagationStopped() ) {
-			lastElement = cur;
-			event.type = i > 1 ?
-				bubbleType :
-				special.bindType || type;
-
-			// jQuery handler
-			handle = (
-					dataPriv.get( cur, "events" ) || Object.create( null )
-				) event.type  &&
-				dataPriv.get( cur, "handle" );
-			if ( handle ) {
-				handle.apply( cur, data );
-			}
-
-			// Native handler
-			handle = ontype && cur ontype ;
-			if ( handle && handle.apply && acceptData( cur ) ) {
-				event.result = handle.apply( cur, data );
-				if ( event.result === false ) {
-					event.preventDefault();
-				}
-			}
-		}
-		event.type = type;
-
-		// If nobody prevented the default action, do it now
-		if ( !onlyHandlers && !event.isDefaultPrevented() ) {
-
-			if ( ( !special._default ||
-				special._default.apply( eventPath.pop(), data ) === false ) &&
-				acceptData( elem ) ) {
-
-				// Call a native DOM method on the target with the same name as the event.
-				// Don't do default actions on window, that's where global variables be (#6170)
-				if ( ontype && isFunction( elem type  ) && !isWindow( elem ) ) {
-
-					// Don't re-trigger an onFOO event when we call its FOO() method
-					tmp = elem ontype ;
-
-					if ( tmp ) {
-						elem ontype  = null;
-					}
-
-					// Prevent re-triggering of the same event, since we already bubbled it above
-					jQuery.event.triggered = type;
-
-					if ( event.isPropagationStopped() ) {
-						lastElement.addEventListener( type, stopPropagationCallback );
-					}
-
-					elem type ();
-
-					if ( event.isPropagationStopped() ) {
-						lastElement.removeEventListener( type, stopPropagationCallback );
-					}
-
-					jQuery.event.triggered = undefined;
-
-					if ( tmp ) {
-						elem ontype  = tmp;
-					}
-				}
-			}
-		}
-
-		return event.result;
-	},
-
-	// Piggyback on a donor event to simulate a different one
-	// Used only for `focus(in | out)` events
-	simulate: function( type, elem, event ) {
-		var e = jQuery.extend(
-			new jQuery.Event(),
-			event,
-			{
-				type: type,
-				isSimulated: true
-			}
-		);
-
-		jQuery.event.trigger( e, null, elem );
-	}
-
-} );
-
-jQuery.fn.extend( {
-
-	trigger: function( type, data ) {
-		return this.each( function() {
-			jQuery.event.trigger( type, data, this );
-		} );
-	},
-	triggerHandler: function( type, data ) {
-		var elem = this 0 ;
-		if ( elem ) {
-			return jQuery.event.trigger( type, data, elem, true );
-		}
-	}
-} );
-
-
-// Support: Firefox <=44
-// Firefox doesn't have focus(in | out) events
-// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787
-//
-// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1
-// focus(in | out) events fire after focus & blur events,
-// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order
-// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857
-if ( !support.focusin ) {
-	jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) {
-
-		// Attach a single capturing handler on the document while someone wants focusin/focusout
-		var handler = function( event ) {
-			jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) );
-		};
-
-		jQuery.event.special fix  = {
-			setup: function() {
-
-				// Handle: regular nodes (via `this.ownerDocument`), window
-				// (via `this.document`) & document (via `this`).
-				var doc = this.ownerDocument || this.document || this,
-					attaches = dataPriv.access( doc, fix );
-
-				if ( !attaches ) {
-					doc.addEventListener( orig, handler, true );
-				}
-				dataPriv.access( doc, fix, ( attaches || 0 ) + 1 );
-			},
-			teardown: function() {
-				var doc = this.ownerDocument || this.document || this,
-					attaches = dataPriv.access( doc, fix ) - 1;
-
-				if ( !attaches ) {
-					doc.removeEventListener( orig, handler, true );
-					dataPriv.remove( doc, fix );
-
-				} else {
-					dataPriv.access( doc, fix, attaches );
-				}
-			}
-		};
-	} );
-}
-var location = window.location;
-
-var nonce = { guid: Date.now() };
-
-var rquery = ( /\?/ );
-
-
-
-// Cross-browser xml parsing
-jQuery.parseXML = function( data ) {
-	var xml;
-	if ( !data || typeof data !== "string" ) {
-		return null;
-	}
-
-	// Support: IE 9 - 11 only
-	// IE throws on parseFromString with invalid input.
-	try {
-		xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" );
-	} catch ( e ) {
-		xml = undefined;
-	}
-
-	if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) {
-		jQuery.error( "Invalid XML: " + data );
-	}
-	return xml;
-};
-
-
-var
-	rbracket = /\\$/,
-	rCRLF = /\r?\n/g,
-	rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
-	rsubmittable = /^(?:input|select|textarea|keygen)/i;
-
-function buildParams( prefix, obj, traditional, add ) {
-	var name;
-
-	if ( Array.isArray( obj ) ) {
-
-		// Serialize array item.
-		jQuery.each( obj, function( i, v ) {
-			if ( traditional || rbracket.test( prefix ) ) {
-
-				// Treat each array item as a scalar.
-				add( prefix, v );
-
-			} else {
-
-				// Item is non-scalar (array or object), encode its numeric index.
-				buildParams(
-					prefix + "" + ( typeof v === "object" && v != null ? i : "" ) + "",
-					v,
-					traditional,
-					add
-				);
-			}
-		} );
-
-	} else if ( !traditional && toType( obj ) === "object" ) {
-
-		// Serialize object item.
-		for ( name in obj ) {
-			buildParams( prefix + "" + name + "", obj name , traditional, add );
-		}
-
-	} else {
-
-		// Serialize scalar item.
-		add( prefix, obj );
-	}
-}
-
-// Serialize an array of form elements or a set of
-// key/values into a query string
-jQuery.param = function( a, traditional ) {
-	var prefix,
-		s = ,
-		add = function( key, valueOrFunction ) {
-
-			// If value is a function, invoke it and use its return value
-			var value = isFunction( valueOrFunction ) ?
-				valueOrFunction() :
-				valueOrFunction;
-
-			s s.length  = encodeURIComponent( key ) + "=" +
-				encodeURIComponent( value == null ? "" : value );
-		};
-
-	if ( a == null ) {
-		return "";
-	}
-
-	// If an array was passed in, assume that it is an array of form elements.
-	if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
-
-		// Serialize the form elements
-		jQuery.each( a, function() {
-			add( this.name, this.value );
-		} );
-
-	} else {
-
-		// If traditional, encode the "old" way (the way 1.3.2 or older
-		// did it), otherwise encode params recursively.
-		for ( prefix in a ) {
-			buildParams( prefix, a prefix , traditional, add );
-		}
-	}
-
-	// Return the resulting serialization
-	return s.join( "&" );
-};
-
-jQuery.fn.extend( {
-	serialize: function() {
-		return jQuery.param( this.serializeArray() );
-	},
-	serializeArray: function() {
-		return this.map( function() {
-
-			// Can add propHook for "elements" to filter or add form elements
-			var elements = jQuery.prop( this, "elements" );
-			return elements ? jQuery.makeArray( elements ) : this;
-		} )
-		.filter( function() {
-			var type = this.type;
-
-			// Use .is( ":disabled" ) so that fieldsetdisabled works
-			return this.name && !jQuery( this ).is( ":disabled" ) &&
-				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
-				( this.checked || !rcheckableType.test( type ) );
-		} )
-		.map( function( _i, elem ) {
-			var val = jQuery( this ).val();
-
-			if ( val == null ) {
-				return null;
-			}
-
-			if ( Array.isArray( val ) ) {
-				return jQuery.map( val, function( val ) {
-					return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
-				} );
-			}
-
-			return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
-		} ).get();
-	}
-} );
-
-
-var
-	r20 = /%20/g,
-	rhash = /#.*$/,
-	rantiCache = /(?&)_=^&*/,
-	rheaders = /^(.*?): \t*(^\r\n*)$/mg,
-
-	// #7653, #8125, #8152: local protocol detection
-	rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/,
-	rnoContent = /^(?:GET|HEAD)$/,
-	rprotocol = /^\/\//,
-
-	/* Prefilters
-	 * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example)
-	 * 2) These are called:
-	 *    - BEFORE asking for a transport
-	 *    - AFTER param serialization (s.data is a string if s.processData is true)
-	 * 3) key is the dataType
-	 * 4) the catchall symbol "*" can be used
-	 * 5) execution will start with transport dataType and THEN continue down to "*" if needed
-	 */
-	prefilters = {},
-
-	/* Transports bindings
-	 * 1) key is the dataType
-	 * 2) the catchall symbol "*" can be used
-	 * 3) selection will start with transport dataType and THEN go to "*" if needed
-	 */
-	transports = {},
-
-	// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression
-	allTypes = "*/".concat( "*" ),
-
-	// Anchor tag for parsing the document origin
-	originAnchor = document.createElement( "a" );
-	originAnchor.href = location.href;
-
-// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
-function addToPrefiltersOrTransports( structure ) {
-
-	// dataTypeExpression is optional and defaults to "*"
-	return function( dataTypeExpression, func ) {
-
-		if ( typeof dataTypeExpression !== "string" ) {
-			func = dataTypeExpression;
-			dataTypeExpression = "*";
-		}
-
-		var dataType,
-			i = 0,
-			dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || ;
-
-		if ( isFunction( func ) ) {
-
-			// For each dataType in the dataTypeExpression
-			while ( ( dataType = dataTypes i++  ) ) {
-
-				// Prepend if requested
-				if ( dataType 0  === "+" ) {
-					dataType = dataType.slice( 1 ) || "*";
-					( structure dataType  = structure dataType  ||  ).unshift( func );
-
-				// Otherwise append
-				} else {
-					( structure dataType  = structure dataType  ||  ).push( func );
-				}
-			}
-		}
-	};
-}
-
-// Base inspection function for prefilters and transports
-function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) {
-
-	var inspected = {},
-		seekingTransport = ( structure === transports );
-
-	function inspect( dataType ) {
-		var selected;
-		inspected dataType  = true;
-		jQuery.each( structure dataType  || , function( _, prefilterOrFactory ) {
-			var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR );
-			if ( typeof dataTypeOrTransport === "string" &&
-				!seekingTransport && !inspected dataTypeOrTransport  ) {
-
-				options.dataTypes.unshift( dataTypeOrTransport );
-				inspect( dataTypeOrTransport );
-				return false;
-			} else if ( seekingTransport ) {
-				return !( selected = dataTypeOrTransport );
-			}
-		} );
-		return selected;
-	}
-
-	return inspect( options.dataTypes 0  ) || !inspected "*"  && inspect( "*" );
-}
-
-// A special extend for ajax options
-// that takes "flat" options (not to be deep extended)
-// Fixes #9887
-function ajaxExtend( target, src ) {
-	var key, deep,
-		flatOptions = jQuery.ajaxSettings.flatOptions || {};
-
-	for ( key in src ) {
-		if ( src key  !== undefined ) {
-			( flatOptions key  ? target : ( deep || ( deep = {} ) ) ) key  = src key ;
-		}
-	}
-	if ( deep ) {
-		jQuery.extend( true, target, deep );
-	}
-
-	return target;
-}
-
-/* Handles responses to an ajax request:
- * - finds the right dataType (mediates between content-type and expected dataType)
- * - returns the corresponding response
- */
-function ajaxHandleResponses( s, jqXHR, responses ) {
-
-	var ct, type, finalDataType, firstDataType,
-		contents = s.contents,
-		dataTypes = s.dataTypes;
-
-	// Remove auto dataType and get content-type in the process
-	while ( dataTypes 0  === "*" ) {
-		dataTypes.shift();
-		if ( ct === undefined ) {
-			ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" );
-		}
-	}
-
-	// Check if we're dealing with a known content-type
-	if ( ct ) {
-		for ( type in contents ) {
-			if ( contents type  && contents type .test( ct ) ) {
-				dataTypes.unshift( type );
-				break;
-			}
-		}
-	}
-
-	// Check to see if we have a response for the expected dataType
-	if ( dataTypes 0  in responses ) {
-		finalDataType = dataTypes 0 ;
-	} else {
-
-		// Try convertible dataTypes
-		for ( type in responses ) {
-			if ( !dataTypes 0  || s.converters type + " " + dataTypes 0   ) {
-				finalDataType = type;
-				break;
-			}
-			if ( !firstDataType ) {
-				firstDataType = type;
-			}
-		}
-
-		// Or just use first one
-		finalDataType = finalDataType || firstDataType;
-	}
-
-	// If we found a dataType
-	// We add the dataType to the list if needed
-	// and return the corresponding response
-	if ( finalDataType ) {
-		if ( finalDataType !== dataTypes 0  ) {
-			dataTypes.unshift( finalDataType );
-		}
-		return responses finalDataType ;
-	}
-}
-
-/* Chain conversions given the request and the original response
- * Also sets the responseXXX fields on the jqXHR instance
- */
-function ajaxConvert( s, response, jqXHR, isSuccess ) {
-	var conv2, current, conv, tmp, prev,
-		converters = {},
-
-		// Work with a copy of dataTypes in case we need to modify it for conversion
-		dataTypes = s.dataTypes.slice();
-
-	// Create converters map with lowercased keys
-	if ( dataTypes 1  ) {
-		for ( conv in s.converters ) {
-			converters conv.toLowerCase()  = s.converters conv ;
-		}
-	}
-
-	current = dataTypes.shift();
-
-	// Convert to each sequential dataType
-	while ( current ) {
-
-		if ( s.responseFields current  ) {
-			jqXHR s.responseFields current   = response;
-		}
-
-		// Apply the dataFilter if provided
-		if ( !prev && isSuccess && s.dataFilter ) {
-			response = s.dataFilter( response, s.dataType );
-		}
-
-		prev = current;
-		current = dataTypes.shift();
-
-		if ( current ) {
-
-			// There's only work to do if current dataType is non-auto
-			if ( current === "*" ) {
-
-				current = prev;
-
-			// Convert response if prev dataType is non-auto and differs from current
-			} else if ( prev !== "*" && prev !== current ) {
-
-				// Seek a direct converter
-				conv = converters prev + " " + current  || converters "* " + current ;
-
-				// If none found, seek a pair
-				if ( !conv ) {
-					for ( conv2 in converters ) {
-
-						// If conv2 outputs current
-						tmp = conv2.split( " " );
-						if ( tmp 1  === current ) {
-
-							// If prev can be converted to accepted input
-							conv = converters prev + " " + tmp 0   ||
-								converters "* " + tmp 0  ;
-							if ( conv ) {
-
-								// Condense equivalence converters
-								if ( conv === true ) {
-									conv = converters conv2 ;
-
-								// Otherwise, insert the intermediate dataType
-								} else if ( converters conv2  !== true ) {
-									current = tmp 0 ;
-									dataTypes.unshift( tmp 1  );
-								}
-								break;
-							}
-						}
-					}
-				}
-
-				// Apply converter (if not an equivalence)
-				if ( conv !== true ) {
-
-					// Unless errors are allowed to bubble, catch and return them
-					if ( conv && s.throws ) {
-						response = conv( response );
-					} else {
-						try {
-							response = conv( response );
-						} catch ( e ) {
-							return {
-								state: "parsererror",
-								error: conv ? e : "No conversion from " + prev + " to " + current
-							};
-						}
-					}
-				}
-			}
-		}
-	}
-
-	return { state: "success", data: response };
-}
-
-jQuery.extend( {
-
-	// Counter for holding the number of active queries
-	active: 0,
-
-	// Last-Modified header cache for next request
-	lastModified: {},
-	etag: {},
-
-	ajaxSettings: {
-		url: location.href,
-		type: "GET",
-		isLocal: rlocalProtocol.test( location.protocol ),
-		global: true,
-		processData: true,
-		async: true,
-		contentType: "application/x-www-form-urlencoded; charset=UTF-8",
-
-		/*
-		timeout: 0,
-		data: null,
-		dataType: null,
-		username: null,
-		password: null,
-		cache: null,
-		throws: false,
-		traditional: false,
-		headers: {},
-		*/
-
-		accepts: {
-			"*": allTypes,
-			text: "text/plain",
-			html: "text/html",
-			xml: "application/xml, text/xml",
-			json: "application/json, text/javascript"
-		},
-
-		contents: {
-			xml: /\bxml\b/,
-			html: /\bhtml/,
-			json: /\bjson\b/
-		},
-
-		responseFields: {
-			xml: "responseXML",
-			text: "responseText",
-			json: "responseJSON"
-		},
-
-		// Data converters
-		// Keys separate source (or catchall "*") and destination types with a single space
-		converters: {
-
-			// Convert anything to text
-			"* text": String,
-
-			// Text to html (true = no transformation)
-			"text html": true,
-
-			// Evaluate text as a json expression
-			"text json": JSON.parse,
-
-			// Parse text as xml
-			"text xml": jQuery.parseXML
-		},
-
-		// For options that shouldn't be deep extended:
-		// you can add your own custom options here if
-		// and when you create one that shouldn't be
-		// deep extended (see ajaxExtend)
-		flatOptions: {
-			url: true,
-			context: true
-		}
-	},
-
-	// Creates a full fledged settings object into target
-	// with both ajaxSettings and settings fields.
-	// If target is omitted, writes into ajaxSettings.
-	ajaxSetup: function( target, settings ) {
-		return settings ?
-
-			// Building a settings object
-			ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
-
-			// Extending ajaxSettings
-			ajaxExtend( jQuery.ajaxSettings, target );
-	},
-
-	ajaxPrefilter: addToPrefiltersOrTransports( prefilters ),
-	ajaxTransport: addToPrefiltersOrTransports( transports ),
-
-	// Main method
-	ajax: function( url, options ) {
-
-		// If url is an object, simulate pre-1.5 signature
-		if ( typeof url === "object" ) {
-			options = url;
-			url = undefined;
-		}
-
-		// Force options to be an object
-		options = options || {};
-
-		var transport,
-
-			// URL without anti-cache param
-			cacheURL,
-
-			// Response headers
-			responseHeadersString,
-			responseHeaders,
-
-			// timeout handle
-			timeoutTimer,
-
-			// Url cleanup var
-			urlAnchor,
-
-			// Request state (becomes false upon send and true upon completion)
-			completed,
-
-			// To know if global events are to be dispatched
-			fireGlobals,
-
-			// Loop variable
-			i,
-
-			// uncached part of the url
-			uncached,
-
-			// Create the final options object
-			s = jQuery.ajaxSetup( {}, options ),
-
-			// Callbacks context
-			callbackContext = s.context || s,
-
-			// Context for global events is callbackContext if it is a DOM node or jQuery collection
-			globalEventContext = s.context &&
-				( callbackContext.nodeType || callbackContext.jquery ) ?
-					jQuery( callbackContext ) :
-					jQuery.event,
-
-			// Deferreds
-			deferred = jQuery.Deferred(),
-			completeDeferred = jQuery.Callbacks( "once memory" ),
-
-			// Status-dependent callbacks
-			statusCode = s.statusCode || {},
-
-			// Headers (they are sent all at once)
-			requestHeaders = {},
-			requestHeadersNames = {},
-
-			// Default abort message
-			strAbort = "canceled",
-
-			// Fake xhr
-			jqXHR = {
-				readyState: 0,
-
-				// Builds headers hashtable if needed
-				getResponseHeader: function( key ) {
-					var match;
-					if ( completed ) {
-						if ( !responseHeaders ) {
-							responseHeaders = {};
-							while ( ( match = rheaders.exec( responseHeadersString ) ) ) {
-								responseHeaders match 1 .toLowerCase() + " "  =
-									( responseHeaders match 1 .toLowerCase() + " "  ||  )
-										.concat( match 2  );
-							}
-						}
-						match = responseHeaders key.toLowerCase() + " " ;
-					}
-					return match == null ? null : match.join( ", " );
-				},
-
-				// Raw string
-				getAllResponseHeaders: function() {
-					return completed ? responseHeadersString : null;
-				},
-
-				// Caches the header
-				setRequestHeader: function( name, value ) {
-					if ( completed == null ) {
-						name = requestHeadersNames name.toLowerCase()  =
-							requestHeadersNames name.toLowerCase()  || name;
-						requestHeaders name  = value;
-					}
-					return this;
-				},
-
-				// Overrides response content-type header
-				overrideMimeType: function( type ) {
-					if ( completed == null ) {
-						s.mimeType = type;
-					}
-					return this;
-				},
-
-				// Status-dependent callbacks
-				statusCode: function( map ) {
-					var code;
-					if ( map ) {
-						if ( completed ) {
-
-							// Execute the appropriate callbacks
-							jqXHR.always( map jqXHR.status  );
-						} else {
-
-							// Lazy-add the new callbacks in a way that preserves old ones
-							for ( code in map ) {
-								statusCode code  =  statusCode code , map code  ;
-							}
-						}
-					}
-					return this;
-				},
-
-				// Cancel the request
-				abort: function( statusText ) {
-					var finalText = statusText || strAbort;
-					if ( transport ) {
-						transport.abort( finalText );
-					}
-					done( 0, finalText );
-					return this;
-				}
-			};
-
-		// Attach deferreds
-		deferred.promise( jqXHR );
-
-		// Add protocol if not provided (prefilters might expect it)
-		// Handle falsy url in the settings object (#10093: consistency with old signature)
-		// We also use the url parameter if available
-		s.url = ( ( url || s.url || location.href ) + "" )
-			.replace( rprotocol, location.protocol + "//" );
-
-		// Alias method option to type as per ticket #12004
-		s.type = options.method || options.type || s.method || s.type;
-
-		// Extract dataTypes list
-		s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) ||  "" ;
-
-		// A cross-domain request is in order when the origin doesn't match the current origin.
-		if ( s.crossDomain == null ) {
-			urlAnchor = document.createElement( "a" );
-
-			// Support: IE <=8 - 11, Edge 12 - 15
-			// IE throws exception on accessing the href property if url is malformed,
-			// e.g. http://example.com:80x/
-			try {
-				urlAnchor.href = s.url;
-
-				// Support: IE <=8 - 11 only
-				// Anchor's host property isn't correctly set when s.url is relative
-				urlAnchor.href = urlAnchor.href;
-				s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !==
-					urlAnchor.protocol + "//" + urlAnchor.host;
-			} catch ( e ) {
-
-				// If there is an error parsing the URL, assume it is crossDomain,
-				// it can be rejected by the transport if it is invalid
-				s.crossDomain = true;
-			}
-		}
-
-		// Convert data if not already a string
-		if ( s.data && s.processData && typeof s.data !== "string" ) {
-			s.data = jQuery.param( s.data, s.traditional );
-		}
-
-		// Apply prefilters
-		inspectPrefiltersOrTransports( prefilters, s, options, jqXHR );
-
-		// If request was aborted inside a prefilter, stop there
-		if ( completed ) {
-			return jqXHR;
-		}
-
-		// We can fire global events as of now if asked to
-		// Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118)
-		fireGlobals = jQuery.event && s.global;
-
-		// Watch for a new set of requests
-		if ( fireGlobals && jQuery.active++ === 0 ) {
-			jQuery.event.trigger( "ajaxStart" );
-		}
-
-		// Uppercase the type
-		s.type = s.type.toUpperCase();
-
-		// Determine if request has content
-		s.hasContent = !rnoContent.test( s.type );
-
-		// Save the URL in case we're toying with the If-Modified-Since
-		// and/or If-None-Match header later on
-		// Remove hash to simplify url manipulation
-		cacheURL = s.url.replace( rhash, "" );
-
-		// More options handling for requests with no content
-		if ( !s.hasContent ) {
-
-			// Remember the hash so we can put it back
-			uncached = s.url.slice( cacheURL.length );
-
-			// If data is available and should be processed, append data to url
-			if ( s.data && ( s.processData || typeof s.data === "string" ) ) {
-				cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data;
-
-				// #9682: remove data so that it's not used in an eventual retry
-				delete s.data;
-			}
-
-			// Add or update anti-cache param if needed
-			if ( s.cache === false ) {
-				cacheURL = cacheURL.replace( rantiCache, "$1" );
-				uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) +
-					uncached;
-			}
-
-			// Put hash and anti-cache on the URL that will be requested (gh-1732)
-			s.url = cacheURL + uncached;
-
-		// Change '%20' to '+' if this is encoded form body content (gh-2658)
-		} else if ( s.data && s.processData &&
-			( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) {
-			s.data = s.data.replace( r20, "+" );
-		}
-
-		// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
-		if ( s.ifModified ) {
-			if ( jQuery.lastModified cacheURL  ) {
-				jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified cacheURL  );
-			}
-			if ( jQuery.etag cacheURL  ) {
-				jqXHR.setRequestHeader( "If-None-Match", jQuery.etag cacheURL  );
-			}
-		}
-
-		// Set the correct header, if data is being sent
-		if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) {
-			jqXHR.setRequestHeader( "Content-Type", s.contentType );
-		}
-
-		// Set the Accepts header for the server, depending on the dataType
-		jqXHR.setRequestHeader(
-			"Accept",
-			s.dataTypes 0  && s.accepts s.dataTypes 0   ?
-				s.accepts s.dataTypes 0   +
-					( s.dataTypes 0  !== "*" ? ", " + allTypes + "; q=0.01" : "" ) :
-				s.accepts "*" 
-		);
-
-		// Check for headers option
-		for ( i in s.headers ) {
-			jqXHR.setRequestHeader( i, s.headers i  );
-		}
-
-		// Allow custom headers/mimetypes and early abort
-		if ( s.beforeSend &&
-			( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) {
-
-			// Abort if not done already and return
-			return jqXHR.abort();
-		}
-
-		// Aborting is no longer a cancellation
-		strAbort = "abort";
-
-		// Install callbacks on deferreds
-		completeDeferred.add( s.complete );
-		jqXHR.done( s.success );
-		jqXHR.fail( s.error );
-
-		// Get transport
-		transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR );
-
-		// If no transport, we auto-abort
-		if ( !transport ) {
-			done( -1, "No Transport" );
-		} else {
-			jqXHR.readyState = 1;
-
-			// Send global event
-			if ( fireGlobals ) {
-				globalEventContext.trigger( "ajaxSend",  jqXHR, s  );
-			}
-
-			// If request was aborted inside ajaxSend, stop there
-			if ( completed ) {
-				return jqXHR;
-			}
-
-			// Timeout
-			if ( s.async && s.timeout > 0 ) {
-				timeoutTimer = window.setTimeout( function() {
-					jqXHR.abort( "timeout" );
-				}, s.timeout );
-			}
-
-			try {
-				completed = false;
-				transport.send( requestHeaders, done );
-			} catch ( e ) {
-
-				// Rethrow post-completion exceptions
-				if ( completed ) {
-					throw e;
-				}
-
-				// Propagate others as results
-				done( -1, e );
-			}
-		}
-
-		// Callback for when everything is done
-		function done( status, nativeStatusText, responses, headers ) {
-			var isSuccess, success, error, response, modified,
-				statusText = nativeStatusText;
-
-			// Ignore repeat invocations
-			if ( completed ) {
-				return;
-			}
-
-			completed = true;
-
-			// Clear timeout if it exists
-			if ( timeoutTimer ) {
-				window.clearTimeout( timeoutTimer );
-			}
-
-			// Dereference transport for early garbage collection
-			// (no matter how long the jqXHR object will be used)
-			transport = undefined;
-
-			// Cache response headers
-			responseHeadersString = headers || "";
-
-			// Set readyState
-			jqXHR.readyState = status > 0 ? 4 : 0;
-
-			// Determine if successful
-			isSuccess = status >= 200 && status < 300 || status === 304;
-
-			// Get response data
-			if ( responses ) {
-				response = ajaxHandleResponses( s, jqXHR, responses );
-			}
-
-			// Use a noop converter for missing script
-			if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) {
-				s.converters "text script"  = function() {};
-			}
-
-			// Convert no matter what (that way responseXXX fields are always set)
-			response = ajaxConvert( s, response, jqXHR, isSuccess );
-
-			// If successful, handle type chaining
-			if ( isSuccess ) {
-
-				// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
-				if ( s.ifModified ) {
-					modified = jqXHR.getResponseHeader( "Last-Modified" );
-					if ( modified ) {
-						jQuery.lastModified cacheURL  = modified;
-					}
-					modified = jqXHR.getResponseHeader( "etag" );
-					if ( modified ) {
-						jQuery.etag cacheURL  = modified;
-					}
-				}
-
-				// if no content
-				if ( status === 204 || s.type === "HEAD" ) {
-					statusText = "nocontent";
-
-				// if not modified
-				} else if ( status === 304 ) {
-					statusText = "notmodified";
-
-				// If we have data, let's convert it
-				} else {
-					statusText = response.state;
-					success = response.data;
-					error = response.error;
-					isSuccess = !error;
-				}
-			} else {
-
-				// Extract error from statusText and normalize for non-aborts
-				error = statusText;
-				if ( status || !statusText ) {
-					statusText = "error";
-					if ( status < 0 ) {
-						status = 0;
-					}
-				}
-			}
-
-			// Set data for the fake xhr object
-			jqXHR.status = status;
-			jqXHR.statusText = ( nativeStatusText || statusText ) + "";
-
-			// Success/Error
-			if ( isSuccess ) {
-				deferred.resolveWith( callbackContext,  success, statusText, jqXHR  );
-			} else {
-				deferred.rejectWith( callbackContext,  jqXHR, statusText, error  );
-			}
-
-			// Status-dependent callbacks
-			jqXHR.statusCode( statusCode );
-			statusCode = undefined;
-
-			if ( fireGlobals ) {
-				globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError",
-					 jqXHR, s, isSuccess ? success : error  );
-			}
-
-			// Complete
-			completeDeferred.fireWith( callbackContext,  jqXHR, statusText  );
-
-			if ( fireGlobals ) {
-				globalEventContext.trigger( "ajaxComplete",  jqXHR, s  );
-
-				// Handle the global AJAX counter
-				if ( !( --jQuery.active ) ) {
-					jQuery.event.trigger( "ajaxStop" );
-				}
-			}
-		}
-
-		return jqXHR;
-	},
-
-	getJSON: function( url, data, callback ) {
-		return jQuery.get( url, data, callback, "json" );
-	},
-
-	getScript: function( url, callback ) {
-		return jQuery.get( url, undefined, callback, "script" );
-	}
-} );
-
-jQuery.each(  "get", "post" , function( _i, method ) {
-	jQuery method  = function( url, data, callback, type ) {
-
-		// Shift arguments if data argument was omitted
-		if ( isFunction( data ) ) {
-			type = type || callback;
-			callback = data;
-			data = undefined;
-		}
-
-		// The url can be an options object (which then must have .url)
-		return jQuery.ajax( jQuery.extend( {
-			url: url,
-			type: method,
-			dataType: type,
-			data: data,
-			success: callback
-		}, jQuery.isPlainObject( url ) && url ) );
-	};
-} );
-
-jQuery.ajaxPrefilter( function( s ) {
-	var i;
-	for ( i in s.headers ) {
-		if ( i.toLowerCase() === "content-type" ) {
-			s.contentType = s.headers i  || "";
-		}
-	}
-} );
-
-
-jQuery._evalUrl = function( url, options, doc ) {
-	return jQuery.ajax( {
-		url: url,
-
-		// Make this explicit, since user can override this through ajaxSetup (#11264)
-		type: "GET",
-		dataType: "script",
-		cache: true,
-		async: false,
-		global: false,
-
-		// Only evaluate the response if it is successful (gh-4126)
-		// dataFilter is not invoked for failure responses, so using it instead
-		// of the default converter is kludgy but it works.
-		converters: {
-			"text script": function() {}
-		},
-		dataFilter: function( response ) {
-			jQuery.globalEval( response, options, doc );
-		}
-	} );
-};
-
-
-jQuery.fn.extend( {
-	wrapAll: function( html ) {
-		var wrap;
-
-		if ( this 0  ) {
-			if ( isFunction( html ) ) {
-				html = html.call( this 0  );
-			}
-
-			// The elements to wrap the target around
-			wrap = jQuery( html, this 0 .ownerDocument ).eq( 0 ).clone( true );
-
-			if ( this 0 .parentNode ) {
-				wrap.insertBefore( this 0  );
-			}
-
-			wrap.map( function() {
-				var elem = this;
-
-				while ( elem.firstElementChild ) {
-					elem = elem.firstElementChild;
-				}
-
-				return elem;
-			} ).append( this );
-		}
-
-		return this;
-	},
-
-	wrapInner: function( html ) {
-		if ( isFunction( html ) ) {
-			return this.each( function( i ) {
-				jQuery( this ).wrapInner( html.call( this, i ) );
-			} );
-		}
-
-		return this.each( function() {
-			var self = jQuery( this ),
-				contents = self.contents();
-
-			if ( contents.length ) {
-				contents.wrapAll( html );
-
-			} else {
-				self.append( html );
-			}
-		} );
-	},
-
-	wrap: function( html ) {
-		var htmlIsFunction = isFunction( html );
-
-		return this.each( function( i ) {
-			jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html );
-		} );
-	},
-
-	unwrap: function( selector ) {
-		this.parent( selector ).not( "body" ).each( function() {
-			jQuery( this ).replaceWith( this.childNodes );
-		} );
-		return this;
-	}
-} );
-
-
-jQuery.expr.pseudos.hidden = function( elem ) {
-	return !jQuery.expr.pseudos.visible( elem );
-};
-jQuery.expr.pseudos.visible = function( elem ) {
-	return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length );
-};
-
-
-
-
-jQuery.ajaxSettings.xhr = function() {
-	try {
-		return new window.XMLHttpRequest();
-	} catch ( e ) {}
-};
-
-var xhrSuccessStatus = {
-
-		// File protocol always yields status code 0, assume 200
-		0: 200,
-
-		// Support: IE <=9 only
-		// #1450: sometimes IE returns 1223 when it should be 204
-		1223: 204
-	},
-	xhrSupported = jQuery.ajaxSettings.xhr();
-
-support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported );
-support.ajax = xhrSupported = !!xhrSupported;
-
-jQuery.ajaxTransport( function( options ) {
-	var callback, errorCallback;
-
-	// Cross domain only allowed if supported through XMLHttpRequest
-	if ( support.cors || xhrSupported && !options.crossDomain ) {
-		return {
-			send: function( headers, complete ) {
-				var i,
-					xhr = options.xhr();
-
-				xhr.open(
-					options.type,
-					options.url,
-					options.async,
-					options.username,
-					options.password
-				);
-
-				// Apply custom fields if provided
-				if ( options.xhrFields ) {
-					for ( i in options.xhrFields ) {
-						xhr i  = options.xhrFields i ;
-					}
-				}
-
-				// Override mime type if needed
-				if ( options.mimeType && xhr.overrideMimeType ) {
-					xhr.overrideMimeType( options.mimeType );
-				}
-
-				// X-Requested-With header
-				// For cross-domain requests, seeing as conditions for a preflight are
-				// akin to a jigsaw puzzle, we simply never set it to be sure.
-				// (it can always be set on a per-request basis or even using ajaxSetup)
-				// For same-domain requests, won't change header if already provided.
-				if ( !options.crossDomain && !headers "X-Requested-With"  ) {
-					headers "X-Requested-With"  = "XMLHttpRequest";
-				}
-
-				// Set headers
-				for ( i in headers ) {
-					xhr.setRequestHeader( i, headers i  );
-				}
-
-				// Callback
-				callback = function( type ) {
-					return function() {
-						if ( callback ) {
-							callback = errorCallback = xhr.onload =
-								xhr.onerror = xhr.onabort = xhr.ontimeout =
-									xhr.onreadystatechange = null;
-
-							if ( type === "abort" ) {
-								xhr.abort();
-							} else if ( type === "error" ) {
-
-								// Support: IE <=9 only
-								// On a manual native abort, IE9 throws
-								// errors on any property access that is not readyState
-								if ( typeof xhr.status !== "number" ) {
-									complete( 0, "error" );
-								} else {
-									complete(
-
-										// File: protocol always yields status 0; see #8605, #14207
-										xhr.status,
-										xhr.statusText
-									);
-								}
-							} else {
-								complete(
-									xhrSuccessStatus xhr.status  || xhr.status,
-									xhr.statusText,
-
-									// Support: IE <=9 only
-									// IE9 has no XHR2 but throws on binary (trac-11426)
-									// For XHR2 non-text, let the caller handle it (gh-2498)
-									( xhr.responseType || "text" ) !== "text"  ||
-									typeof xhr.responseText !== "string" ?
-										{ binary: xhr.response } :
-										{ text: xhr.responseText },
-									xhr.getAllResponseHeaders()
-								);
-							}
-						}
-					};
-				};
-
-				// Listen to events
-				xhr.onload = callback();
-				errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" );
-
-				// Support: IE 9 only
-				// Use onreadystatechange to replace onabort
-				// to handle uncaught aborts
-				if ( xhr.onabort !== undefined ) {
-					xhr.onabort = errorCallback;
-				} else {
-					xhr.onreadystatechange = function() {
-
-						// Check readyState before timeout as it changes
-						if ( xhr.readyState === 4 ) {
-
-							// Allow onerror to be called first,
-							// but that will not handle a native abort
-							// Also, save errorCallback to a variable
-							// as xhr.onerror cannot be accessed
-							window.setTimeout( function() {
-								if ( callback ) {
-									errorCallback();
-								}
-							} );
-						}
-					};
-				}
-
-				// Create the abort callback
-				callback = callback( "abort" );
-
-				try {
-
-					// Do send the request (this may raise an exception)
-					xhr.send( options.hasContent && options.data || null );
-				} catch ( e ) {
-
-					// #14683: Only rethrow if this hasn't been notified as an error yet
-					if ( callback ) {
-						throw e;
-					}
-				}
-			},
-
-			abort: function() {
-				if ( callback ) {
-					callback();
-				}
-			}
-		};
-	}
-} );
-
-
-
-
-// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432)
-jQuery.ajaxPrefilter( function( s ) {
-	if ( s.crossDomain ) {
-		s.contents.script = false;
-	}
-} );
-
-// Install script dataType
-jQuery.ajaxSetup( {
-	accepts: {
-		script: "text/javascript, application/javascript, " +
-			"application/ecmascript, application/x-ecmascript"
-	},
-	contents: {
-		script: /\b(?:java|ecma)script\b/
-	},
-	converters: {
-		"text script": function( text ) {
-			jQuery.globalEval( text );
-			return text;
-		}
-	}
-} );
-
-// Handle cache's special case and crossDomain
-jQuery.ajaxPrefilter( "script", function( s ) {
-	if ( s.cache === undefined ) {
-		s.cache = false;
-	}
-	if ( s.crossDomain ) {
-		s.type = "GET";
-	}
-} );
-
-// Bind script tag hack transport
-jQuery.ajaxTransport( "script", function( s ) {
-
-	// This transport only deals with cross domain or forced-by-attrs requests
-	if ( s.crossDomain || s.scriptAttrs ) {
-		var script, callback;
-		return {
-			send: function( _, complete ) {
-				script = jQuery( "<script>" )
-					.attr( s.scriptAttrs || {} )
-					.prop( { charset: s.scriptCharset, src: s.url } )
-					.on( "load error", callback = function( evt ) {
-						script.remove();
-						callback = null;
-						if ( evt ) {
-							complete( evt.type === "error" ? 404 : 200, evt.type );
-						}
-					} );
-
-				// Use native DOM manipulation to avoid our domManip AJAX trickery
-				document.head.appendChild( script 0  );
-			},
-			abort: function() {
-				if ( callback ) {
-					callback();
-				}
-			}
-		};
-	}
-} );
-
-
-
-
-var oldCallbacks = ,
-	rjsonp = /(=)\?(?=&|$)|\?\?/;
-
-// Default jsonp settings
-jQuery.ajaxSetup( {
-	jsonp: "callback",
-	jsonpCallback: function() {
-		var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( nonce.guid++ ) );
-		this callback  = true;
-		return callback;
-	}
-} );
-
-// Detect, normalize options and install callbacks for jsonp requests
-jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) {
-
-	var callbackName, overwritten, responseContainer,
-		jsonProp = s.jsonp !== false && ( rjsonp.test( s.url ) ?
-			"url" :
-			typeof s.data === "string" &&
-				( s.contentType || "" )
-					.indexOf( "application/x-www-form-urlencoded" ) === 0 &&
-				rjsonp.test( s.data ) && "data"
-		);
-
-	// Handle iff the expected data type is "jsonp" or we have a parameter to set
-	if ( jsonProp || s.dataTypes 0  === "jsonp" ) {
-
-		// Get callback name, remembering preexisting value associated with it
-		callbackName = s.jsonpCallback = isFunction( s.jsonpCallback ) ?
-			s.jsonpCallback() :
-			s.jsonpCallback;
-
-		// Insert callback into url or form data
-		if ( jsonProp ) {
-			s jsonProp  = s jsonProp .replace( rjsonp, "$1" + callbackName );
-		} else if ( s.jsonp !== false ) {
-			s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName;
-		}
-
-		// Use data converter to retrieve json after script execution
-		s.converters "script json"  = function() {
-			if ( !responseContainer ) {
-				jQuery.error( callbackName + " was not called" );
-			}
-			return responseContainer 0 ;
-		};
-
-		// Force json dataType
-		s.dataTypes 0  = "json";
-
-		// Install callback
-		overwritten = window callbackName ;
-		window callbackName  = function() {
-			responseContainer = arguments;
-		};
-
-		// Clean-up function (fires after converters)
-		jqXHR.always( function() {
-
-			// If previous value didn't exist - remove it
-			if ( overwritten === undefined ) {
-				jQuery( window ).removeProp( callbackName );
-
-			// Otherwise restore preexisting value
-			} else {
-				window callbackName  = overwritten;
-			}
-
-			// Save back as free
-			if ( s callbackName  ) {
-
-				// Make sure that re-using the options doesn't screw things around
-				s.jsonpCallback = originalSettings.jsonpCallback;
-
-				// Save the callback name for future use
-				oldCallbacks.push( callbackName );
-			}
-
-			// Call if it was a function and we have a response
-			if ( responseContainer && isFunction( overwritten ) ) {
-				overwritten( responseContainer 0  );
-			}
-
-			responseContainer = overwritten = undefined;
-		} );
-
-		// Delegate to script
-		return "script";
-	}
-} );
-
-
-
-
-// Support: Safari 8 only
-// In Safari 8 documents created via document.implementation.createHTMLDocument
-// collapse sibling forms: the second one becomes a child of the first one.
-// Because of that, this security measure has to be disabled in Safari 8.
-// https://bugs.webkit.org/show_bug.cgi?id=137337
-support.createHTMLDocument = ( function() {
-	var body = document.implementation.createHTMLDocument( "" ).body;
-	body.innerHTML = "<form></form><form></form>";
-	return body.childNodes.length === 2;
-} )();
-
-
-// Argument "data" should be string of html
-// context (optional): If specified, the fragment will be created in this context,
-// defaults to document
-// keepScripts (optional): If true, will include scripts passed in the html string
-jQuery.parseHTML = function( data, context, keepScripts ) {
-	if ( typeof data !== "string" ) {
-		return ;
-	}
-	if ( typeof context === "boolean" ) {
-		keepScripts = context;
-		context = false;
-	}
-
-	var base, parsed, scripts;
-
-	if ( !context ) {
-
-		// Stop scripts or inline event handlers from being executed immediately
-		// by using document.implementation
-		if ( support.createHTMLDocument ) {
-			context = document.implementation.createHTMLDocument( "" );
-
-			// Set the base href for the created document
-			// so any parsed elements with URLs
-			// are based on the document's URL (gh-2965)
-			base = context.createElement( "base" );
-			base.href = document.location.href;
-			context.head.appendChild( base );
-		} else {
-			context = document;
-		}
-	}
-
-	parsed = rsingleTag.exec( data );
-	scripts = !keepScripts && ;
-
-	// Single tag
-	if ( parsed ) {
-		return  context.createElement( parsed 1  ) ;
-	}
-
-	parsed = buildFragment(  data , context, scripts );
-
-	if ( scripts && scripts.length ) {
-		jQuery( scripts ).remove();
-	}
-
-	return jQuery.merge( , parsed.childNodes );
-};
-
-
-/**
- * Load a url into a page
- */
-jQuery.fn.load = function( url, params, callback ) {
-	var selector, type, response,
-		self = this,
-		off = url.indexOf( " " );
-
-	if ( off > -1 ) {
-		selector = stripAndCollapse( url.slice( off ) );
-		url = url.slice( 0, off );
-	}
-
-	// If it's a function
-	if ( isFunction( params ) ) {
-
-		// We assume that it's the callback
-		callback = params;
-		params = undefined;
-
-	// Otherwise, build a param string
-	} else if ( params && typeof params === "object" ) {
-		type = "POST";
-	}
-
-	// If we have elements to modify, make the request
-	if ( self.length > 0 ) {
-		jQuery.ajax( {
-			url: url,
-
-			// If "type" variable is undefined, then "GET" method will be used.
-			// Make value of this field explicit since
-			// user can override it through ajaxSetup method
-			type: type || "GET",
-			dataType: "html",
-			data: params
-		} ).done( function( responseText ) {
-
-			// Save response for use in complete callback
-			response = arguments;
-
-			self.html( selector ?
-
-				// If a selector was specified, locate the right elements in a dummy div
-				// Exclude scripts to avoid IE 'Permission Denied' errors
-				jQuery( "<div>" ).append( jQuery.parseHTML( responseText ) ).find( selector ) :
-
-				// Otherwise use the full result
-				responseText );
-
-		// If the request succeeds, this function gets "data", "status", "jqXHR"
-		// but they are ignored because response was set above.
-		// If it fails, this function gets "jqXHR", "status", "error"
-		} ).always( callback && function( jqXHR, status ) {
-			self.each( function() {
-				callback.apply( this, response ||  jqXHR.responseText, status, jqXHR  );
-			} );
-		} );
-	}
-
-	return this;
-};
-
-
-
-
-jQuery.expr.pseudos.animated = function( elem ) {
-	return jQuery.grep( jQuery.timers, function( fn ) {
-		return elem === fn.elem;
-	} ).length;
-};
-
-
-
-
-jQuery.offset = {
-	setOffset: function( elem, options, i ) {
-		var curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition,
-			position = jQuery.css( elem, "position" ),
-			curElem = jQuery( elem ),
-			props = {};
-
-		// Set position first, in-case top/left are set even on static elem
-		if ( position === "static" ) {
-			elem.style.position = "relative";
-		}
-
-		curOffset = curElem.offset();
-		curCSSTop = jQuery.css( elem, "top" );
-		curCSSLeft = jQuery.css( elem, "left" );
-		calculatePosition = ( position === "absolute" || position === "fixed" ) &&
-			( curCSSTop + curCSSLeft ).indexOf( "auto" ) > -1;
-
-		// Need to be able to calculate position if either
-		// top or left is auto and position is either absolute or fixed
-		if ( calculatePosition ) {
-			curPosition = curElem.position();
-			curTop = curPosition.top;
-			curLeft = curPosition.left;
-
-		} else {
-			curTop = parseFloat( curCSSTop ) || 0;
-			curLeft = parseFloat( curCSSLeft ) || 0;
-		}
-
-		if ( isFunction( options ) ) {
-
-			// Use jQuery.extend here to allow modification of coordinates argument (gh-1848)
-			options = options.call( elem, i, jQuery.extend( {}, curOffset ) );
-		}
-
-		if ( options.top != null ) {
-			props.top = ( options.top - curOffset.top ) + curTop;
-		}
-		if ( options.left != null ) {
-			props.left = ( options.left - curOffset.left ) + curLeft;
-		}
-
-		if ( "using" in options ) {
-			options.using.call( elem, props );
-
-		} else {
-			if ( typeof props.top === "number" ) {
-				props.top += "px";
-			}
-			if ( typeof props.left === "number" ) {
-				props.left += "px";
-			}
-			curElem.css( props );
-		}
-	}
-};
-
-jQuery.fn.extend( {
-
-	// offset() relates an element's border box to the document origin
-	offset: function( options ) {
-
-		// Preserve chaining for setter
-		if ( arguments.length ) {
-			return options === undefined ?
-				this :
-				this.each( function( i ) {
-					jQuery.offset.setOffset( this, options, i );
-				} );
-		}
-
-		var rect, win,
-			elem = this 0 ;
-
-		if ( !elem ) {
-			return;
-		}
-
-		// Return zeros for disconnected and hidden (display: none) elements (gh-2310)
-		// Support: IE <=11 only
-		// Running getBoundingClientRect on a
-		// disconnected node in IE throws an error
-		if ( !elem.getClientRects().length ) {
-			return { top: 0, left: 0 };
-		}
-
-		// Get document-relative position by adding viewport scroll to viewport-relative gBCR
-		rect = elem.getBoundingClientRect();
-		win = elem.ownerDocument.defaultView;
-		return {
-			top: rect.top + win.pageYOffset,
-			left: rect.left + win.pageXOffset
-		};
-	},
-
-	// position() relates an element's margin box to its offset parent's padding box
-	// This corresponds to the behavior of CSS absolute positioning
-	position: function() {
-		if ( !this 0  ) {
-			return;
-		}
-
-		var offsetParent, offset, doc,
-			elem = this 0 ,
-			parentOffset = { top: 0, left: 0 };
-
-		// position:fixed elements are offset from the viewport, which itself always has zero offset
-		if ( jQuery.css( elem, "position" ) === "fixed" ) {
-
-			// Assume position:fixed implies availability of getBoundingClientRect
-			offset = elem.getBoundingClientRect();
-
-		} else {
-			offset = this.offset();
-
-			// Account for the *real* offset parent, which can be the document or its root element
-			// when a statically positioned element is identified
-			doc = elem.ownerDocument;
-			offsetParent = elem.offsetParent || doc.documentElement;
-			while ( offsetParent &&
-				( offsetParent === doc.body || offsetParent === doc.documentElement ) &&
-				jQuery.css( offsetParent, "position" ) === "static" ) {
-
-				offsetParent = offsetParent.parentNode;
-			}
-			if ( offsetParent && offsetParent !== elem && offsetParent.nodeType === 1 ) {
-
-				// Incorporate borders into its offset, since they are outside its content origin
-				parentOffset = jQuery( offsetParent ).offset();
-				parentOffset.top += jQuery.css( offsetParent, "borderTopWidth", true );
-				parentOffset.left += jQuery.css( offsetParent, "borderLeftWidth", true );
-			}
-		}
-
-		// Subtract parent offsets and element margins
-		return {
-			top: offset.top - parentOffset.top - jQuery.css( elem, "marginTop", true ),
-			left: offset.left - parentOffset.left - jQuery.css( elem, "marginLeft", true )
-		};
-	},
-
-	// This method will return documentElement in the following cases:
-	// 1) For the element inside the iframe without offsetParent, this method will return
-	//    documentElement of the parent window
-	// 2) For the hidden or detached element
-	// 3) For body or html element, i.e. in case of the html node - it will return itself
-	//
-	// but those exceptions were never presented as a real life use-cases
-	// and might be considered as more preferable results.
-	//
-	// This logic, however, is not guaranteed and can change at any point in the future
-	offsetParent: function() {
-		return this.map( function() {
-			var offsetParent = this.offsetParent;
-
-			while ( offsetParent && jQuery.css( offsetParent, "position" ) === "static" ) {
-				offsetParent = offsetParent.offsetParent;
-			}
-
-			return offsetParent || documentElement;
-		} );
-	}
-} );
-
-// Create scrollLeft and scrollTop methods
-jQuery.each( { scrollLeft: "pageXOffset", scrollTop: "pageYOffset" }, function( method, prop ) {
-	var top = "pageYOffset" === prop;
-
-	jQuery.fn method  = function( val ) {
-		return access( this, function( elem, method, val ) {
-
-			// Coalesce documents and windows
-			var win;
-			if ( isWindow( elem ) ) {
-				win = elem;
-			} else if ( elem.nodeType === 9 ) {
-				win = elem.defaultView;
-			}
-
-			if ( val === undefined ) {
-				return win ? win prop  : elem method ;
-			}
-
-			if ( win ) {
-				win.scrollTo(
-					!top ? val : win.pageXOffset,
-					top ? val : win.pageYOffset
-				);
-
-			} else {
-				elem method  = val;
-			}
-		}, method, val, arguments.length );
-	};
-} );
-
-// Support: Safari <=7 - 9.1, Chrome <=37 - 49
-// Add the top/left cssHooks using jQuery.fn.position
-// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084
-// Blink bug: https://bugs.chromium.org/p/chromium/issues/detail?id=589347
-// getComputedStyle returns percent when specified for top/left/bottom/right;
-// rather than make the css module depend on the offset module, just check for it here
-jQuery.each(  "top", "left" , function( _i, prop ) {
-	jQuery.cssHooks prop  = addGetHookIf( support.pixelPosition,
-		function( elem, computed ) {
-			if ( computed ) {
-				computed = curCSS( elem, prop );
-
-				// If curCSS returns percentage, fallback to offset
-				return rnumnonpx.test( computed ) ?
-					jQuery( elem ).position() prop  + "px" :
-					computed;
-			}
-		}
-	);
-} );
-
-
-// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods
-jQuery.each( { Height: "height", Width: "width" }, function( name, type ) {
-	jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name },
-		function( defaultExtra, funcName ) {
-
-		// Margin is only for outerHeight, outerWidth
-		jQuery.fn funcName  = function( margin, value ) {
-			var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ),
-				extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" );
-
-			return access( this, function( elem, type, value ) {
-				var doc;
-
-				if ( isWindow( elem ) ) {
-
-					// $( window ).outerWidth/Height return w/h including scrollbars (gh-1729)
-					return funcName.indexOf( "outer" ) === 0 ?
-						elem "inner" + name  :
-						elem.document.documentElement "client" + name ;
-				}
-
-				// Get document width or height
-				if ( elem.nodeType === 9 ) {
-					doc = elem.documentElement;
-
-					// Either scrollWidth/Height or offsetWidth/Height or clientWidth/Height,
-					// whichever is greatest
-					return Math.max(
-						elem.body "scroll" + name , doc "scroll" + name ,
-						elem.body "offset" + name , doc "offset" + name ,
-						doc "client" + name 
-					);
-				}
-
-				return value === undefined ?
-
-					// Get width or height on the element, requesting but not forcing parseFloat
-					jQuery.css( elem, type, extra ) :
-
-					// Set width or height on the element
-					jQuery.style( elem, type, value, extra );
-			}, type, chainable ? margin : undefined, chainable );
-		};
-	} );
-} );
-
-
-jQuery.each( 
-	"ajaxStart",
-	"ajaxStop",
-	"ajaxComplete",
-	"ajaxError",
-	"ajaxSuccess",
-	"ajaxSend"
-, function( _i, type ) {
-	jQuery.fn type  = function( fn ) {
-		return this.on( type, fn );
-	};
-} );
-
-
-
-
-jQuery.fn.extend( {
-
-	bind: function( types, data, fn ) {
-		return this.on( types, null, data, fn );
-	},
-	unbind: function( types, fn ) {
-		return this.off( types, null, fn );
-	},
-
-	delegate: function( selector, types, data, fn ) {
-		return this.on( types, selector, data, fn );
-	},
-	undelegate: function( selector, types, fn ) {
-
-		// ( namespace ) or ( selector, types , fn )
-		return arguments.length === 1 ?
-			this.off( selector, "**" ) :
-			this.off( types, selector || "**", fn );
-	},
-
-	hover: function( fnOver, fnOut ) {
-		return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );
-	}
-} );
-
-jQuery.each( ( "blur focus focusin focusout resize scroll click dblclick " +
-	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
-	"change select submit keydown keypress keyup contextmenu" ).split( " " ),
-	function( _i, name ) {
-
-		// Handle event binding
-		jQuery.fn name  = function( data, fn ) {
-			return arguments.length > 0 ?
-				this.on( name, null, data, fn ) :
-				this.trigger( name );
-		};
-	} );
-
-
-
-
-// Support: Android <=4.0 only
-// Make sure we trim BOM and NBSP
-var rtrim = /^\s\uFEFF\xA0+|\s\uFEFF\xA0+$/g;
-
-// Bind a function to a context, optionally partially applying any
-// arguments.
-// jQuery.proxy is deprecated to promote standards (specifically Function#bind)
-// However, it is not slated for removal any time soon
-jQuery.proxy = function( fn, context ) {
-	var tmp, args, proxy;
-
-	if ( typeof context === "string" ) {
-		tmp = fn context ;
-		context = fn;
-		fn = tmp;
-	}
-
-	// Quick check to determine if target is callable, in the spec
-	// this throws a TypeError, but we will just return undefined.
-	if ( !isFunction( fn ) ) {
-		return undefined;
-	}
-
-	// Simulated bind
-	args = slice.call( arguments, 2 );
-	proxy = function() {
-		return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
-	};
-
-	// Set the guid of unique handler to the same of original handler, so it can be removed
-	proxy.guid = fn.guid = fn.guid || jQuery.guid++;
-
-	return proxy;
-};
-
-jQuery.holdReady = function( hold ) {
-	if ( hold ) {
-		jQuery.readyWait++;
-	} else {
-		jQuery.ready( true );
-	}
-};
-jQuery.isArray = Array.isArray;
-jQuery.parseJSON = JSON.parse;
-jQuery.nodeName = nodeName;
-jQuery.isFunction = isFunction;
-jQuery.isWindow = isWindow;
-jQuery.camelCase = camelCase;
-jQuery.type = toType;
-
-jQuery.now = Date.now;
-
-jQuery.isNumeric = function( obj ) {
-
-	// As of jQuery 3.0, isNumeric is limited to
-	// strings and numbers (primitives or objects)
-	// that can be coerced to finite numbers (gh-2662)
-	var type = jQuery.type( obj );
-	return ( type === "number" || type === "string" ) &&
-
-		// parseFloat NaNs numeric-cast false positives ("")
-		// ...but misinterprets leading-number strings, particularly hex literals ("0x...")
-		// subtraction forces infinities to NaN
-		!isNaN( obj - parseFloat( obj ) );
-};
-
-jQuery.trim = function( text ) {
-	return text == null ?
-		"" :
-		( text + "" ).replace( rtrim, "" );
-};
-
-
-
-// Register as a named AMD module, since jQuery can be concatenated with other
-// files that may use define, but not via a proper concatenation script that
-// understands anonymous AMD modules. A named AMD is safest and most robust
-// way to register. Lowercase jquery is used because AMD module names are
-// derived from file names, and jQuery is normally delivered in a lowercase
-// file name. Do this after creating the global so that if an AMD module wants
-// to call noConflict to hide this version of jQuery, it will work.
-
-// Note that for maximum portability, libraries that are not jQuery should
-// declare themselves as anonymous modules, and avoid setting a global if an
-// AMD loader is present. jQuery is a special case. For more information, see
-// https://github.com/jrburke/requirejs/wiki/Updating-existing-libraries#wiki-anon
-
-if ( typeof define === "function" && define.amd ) {
-	define( "jquery", , function() {
-		return jQuery;
-	} );
-}
-
-
-
-
-var
-
-	// Map over jQuery in case of overwrite
-	_jQuery = window.jQuery,
-
-	// Map over the $ in case of overwrite
-	_$ = window.$;
-
-jQuery.noConflict = function( deep ) {
-	if ( window.$ === jQuery ) {
-		window.$ = _$;
-	}
-
-	if ( deep && window.jQuery === jQuery ) {
-		window.jQuery = _jQuery;
-	}
-
-	return jQuery;
-};
-
-// Expose jQuery and $ identifiers, even in AMD
-// (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
-// and CommonJS for browser emulators (#13566)
-if ( typeof noGlobal === "undefined" ) {
-	window.jQuery = window.$ = jQuery;
-}
-
-
-
-
-return jQuery;
-} );

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/jquery.js Deleted

@@ -1,2 +0,0 @@
-/*! jQuery v3.5.1 | (c) JS Foundation and other contributors | jquery.org/license */
-!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=,r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply(,e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=tr||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?no.call(e)||"object":typeof e}var f="3.5.1",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0<t&&t-1 in e)}S.fn=S.prototype={jquery:f,constructor:S,length:0,toArray:function(){return s.call(this)},get:function(e){return null==e?s.call(this):e<0?thise+this.length:thise},pushStack:function(e){var t=S.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return S.each(this,e)},map:function(n){return this.pushStack(S.map(this,function(e,t){return n.call(e,t,e)}))},slice:function(){return this.pushStack(s.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},even:function(){return this.pushStack(S.grep(this,function(e,t){return(t+1)%2}))},odd:function(){return this.pushStack(S.grep(this,function(e,t){return t%2}))},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(0<=n&&n<t?thisn:)},end:function(){return this.prevObject||this.constructor()},push:u,sort:t.sort,splice:t.splice},S.extend=S.fn.extend=function(){var e,t,n,r,i,o,a=arguments0||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=argumentss||{},s++),"object"==typeof a||m(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=argumentss))for(t in e)r=et,"__proto__"!==t&&a!==r&&(l&&r&&(S.isPlainObject(r)||(i=Array.isArray(r)))?(n=at,o=i&&!Array.isArray(n)?:i||S.isPlainObject(n)?n:{},i=!1,at=S.extend(l,o,r)):void 0!==r&&(at=r));return a},S.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"object Object"!==o.call(e))&&(!(t=r(e))||"function"==typeof(n=v.call(t,"constructor")&&t.constructor)&&a.call(n)===l)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e,t,n){b(e,{nonce:t&&t.nonce},n)},each:function(e,t){var n,r=0;if(p(e)){for(n=e.length;r<n;r++)if(!1===t.call(er,r,er))break}else for(r in e)if(!1===t.call(er,r,er))break;return e},makeArray:function(e,t){var n=t||;return null!=e&&(p(Object(e))?S.merge(n,"string"==typeof e?e:e):u.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:i.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)ei++=tr;return e.length=i,e},grep:function(e,t,n){for(var r=,i=0,o=e.length,a=!n;i<o;i++)!t(ei,i)!==a&&r.push(ei);return r},map:function(e,t,n){var r,i,o=0,a=;if(p(e))for(r=e.length;o<r;o++)null!=(i=t(eo,o,n))&&a.push(i);else for(o in e)null!=(i=t(eo,o,n))&&a.push(i);return g(a)},guid:1,support:y}),"function"==typeof Symbol&&(S.fnSymbol.iterator=tSymbol.iterator),S.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){n"object "+t+""=t.toLowerCase()});var d=function(n){var e,d,b,o,i,h,f,g,w,u,l,T,C,a,E,v,s,c,y,S="sizzle"+1*new Date,p=n.document,k=0,r=0,m=ue(),x=ue(),A=ue(),N=ue(),D=function(e,t){return e===t&&(l=!0),0},j={}.hasOwnProperty,t=,q=t.pop,L=t.push,H=t.push,O=t.slice,P=function(e,t){for(var n=0,r=e.length;n<r;n++)if(en===t)return n;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="\\x20\\t\\r\\n\\f",I="(?:\\\\\\da-fA-F{1,6}"+M+"?|\\\\^\\r\\n\\f|\\w-|^\0-\\x7f)+",W="\\"+M+"*("+I+")(?:"+M+"*(*^$|!~?=)"+M+"*(?:'((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\"|("+I+"))|)"+M+"*\\",F=":("+I+")(?:\$(('((?:\\\\.|^\\\\')*)'|\"((?:\\\\.|^\\\\\")*)\")|((?:\\\\.|^\\\\()\\|"+W+")*)|.*)\$|)",B=new RegExp(M+"+","g"),$=new RegExp("^"+M+"+|((?:^|^\\\\)(?:\\\\.)*)"+M+"+$","g"),_=new RegExp("^"+M+"*,"+M+"*"),z=new RegExp("^"+M+"*(>+~|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|*)"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\$"+M+"*(even|odd|((+-|)(\\d*)n|)"+M+"*(?:(+-|)"+M+"*(\\d+)|))"+M+"*\$|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*>+~|:(even|odd|eq|gt|lt|nth|first|last)(?:\$"+M+"*((?:-\\d)?\\d*)"+M+"*\$|)(?=^-|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^^{+\{\s*\native \w/,Z=/^(?:#(\w-+)|(\w+)|\.(\w-+))$/,ee=/+~/,te=new RegExp("\\\\\\da-fA-F{1,6}"+M+"?|\\\\(^\\r\\n\\f)","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/(\0-\x1f\x7f|^-?\d)|^-$|^\0-\x1f\x7f-\uFFFF\w-/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),tp.childNodes.length.nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(en++=tr++);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||,"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u1){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u2)return H.apply(n,e.getElementsByTagName(t)),n;if((i=u3)&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!Nt+" "&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)lo=(s?"#"+s:":scope")+" "+xe(lo);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=;return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete er.shift(),et+" "=n}}function le(e){return eS=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandlenr=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a(,e.length,o),i=r.length;while(i--)en=ri&&(en=!(tn=en))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e.namespaceURI,n=(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?n:}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)returno;i=t.getElementsByName(e),r=0;while(o=ir++)if((n=o.getAttributeNode("id"))&&n.value===e)returno}return}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=,i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=oi++)1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=,v=,(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="<a id='"+S+"'></a><select id='"+S+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("msallowcapture^=''").length&&v.push("*^$="+M+"*(?:''|\"\")"),e.querySelectorAll("selected").length||v.push("\\"+M+"*(?:value|"+R+")"),e.querySelectorAll("id~="+S+"-").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("name=''").length||v.push("\\"+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.++~"),e.querySelectorAll("\\\f"),v.push("\\r\\n\\f")}),ce(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("name=d").length&&v.push("name"+M+"**^$|!~?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"s!='':x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},D=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=e,s=t;if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(ar===sr)r++;return r?pe(ar,sr):ar==p?-1:sr==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!Nt+" "&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0<se(t,C,null,e).length},se.contains=function(e,t){return(e.ownerDocument||e)!=C&&T(e),y(e,t)},se.attr=function(e,t){(e.ownerDocument||e)!=C&&T(e);var n=b.attrHandlet.toLowerCase(),r=n&&j.call(b.attrHandle,t.toLowerCase())?n(e,t,!E):void 0;return void 0!==r?r:d.attributes||!E?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},se.escape=function(e){return(e+"").replace(re,ie)},se.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},se.uniqueSort=function(e){var t,n=,r=0,i=0;if(l=!d.detectDuplicates,u=!d.sortStable&&e.slice(0),e.sort(D),l){while(t=ei++)t===ei&&(r=n.push(i));while(r--)e.splice(nr,1)}return u=null,e},o=se.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else while(t=er++)n+=o(t);return n},(b=se.selectors={cacheLength:50,createPseudo:le,match:G,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e1=e1.replace(te,ne),e3=(e3||e4||e5||"").replace(te,ne),"~="===e2&&(e3=" "+e3+" "),e.slice(0,4)},CHILD:function(e){return e1=e1.toLowerCase(),"nth"===e1.slice(0,3)?(e3||se.error(e0),e4=+(e4?e5+(e6||1):2*("even"===e3||"odd"===e3)),e5=+(e7+e8||"odd"===e3)):e3&&se.error(e0),e},PSEUDO:function(e){var t,n=!e6&&e2;return G.CHILD.test(e0)?null:(e3?e2=e4||e5||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e0=e0.slice(0,t),e2=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=me+" ";return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1<t.indexOf(i):"$="===r?i&&t.slice(-i.length)===i:"~="===r?-1<(" "+t.replace(B," ")+" ").indexOf(i):"|="===r&&(t===i||t.slice(0,i.length+1)===i+"-"))}},CHILD:function(h,e,t,g,v){var y="nth"!==h.slice(0,3),m="last"!==h.slice(-4),x="of-type"===e;return 1===g&&0===v?function(e){return!!e.parentNode}:function(e,t,n){var r,i,o,a,s,u,l=y!==m?"nextSibling":"previousSibling",c=e.parentNode,f=x&&e.nodeName.toLowerCase(),p=!n&&!x,d=!1;if(c){if(y){while(l){a=e;while(a=al)if(x?a.nodeName.toLowerCase()===f:1===a.nodeType)return!1;u=l="only"===h&&!u&&"nextSibling"}return!0}if(u=m?c.firstChild:c.lastChild,m&&p){d=(s=(r=(i=(o=(a=c)S||(aS={}))a.uniqueID||(oa.uniqueID={}))h||)0===k&&r1)&&r2,a=s&&c.childNodess;while(a=++s&&a&&al||(d=s=0)||u.pop())if(1===a.nodeType&&++d&&a===e){ih=k,s,d;break}}else if(p&&(d=s=(r=(i=(o=(a=e)S||(aS={}))a.uniqueID||(oa.uniqueID={}))h||)0===k&&r1),!1===d)while(a=++s&&a&&al||(d=s=0)||u.pop())if((x?a.nodeName.toLowerCase()===f:1===a.nodeType)&&++d&&(p&&((i=(o=aS||(aS={}))a.uniqueID||(oa.uniqueID={}))h=k,d),a===e))break;return(d-=v)===g||d%g==0&&0<=d/g}}},PSEUDO:function(e,o){var t,a=b.pseudose||b.setFilterse.toLowerCase()||se.error("unsupported pseudo: "+e);return aS?a(o):1<a.length?(t=e,e,"",o,b.setFilters.hasOwnProperty(e.toLowerCase())?le(function(e,t){var n,r=a(e,o),i=r.length;while(i--)en=P(e,ri)=!(tn=ri)}):function(e){return a(e,0,t)}):a}},pseudos:{not:le(function(e){var r=,i=,s=f(e.replace($,"$1"));return sS?le(function(e,t,n,r){var i,o=s(e,null,r,),a=e.length;while(a--)(i=oa)&&(ea=!(ta=i))}):function(e,t,n){return r0=e,s(r,null,n,i),r0=null,!i.pop()}}),has:le(function(t){return function(e){return 0<se(t,e).length}}),contains:le(function(t){return t=t.replace(te,ne),function(e){return-1<(e.textContent||o(e)).indexOf(t)}}),lang:le(function(n){return V.test(n||"")||se.error("unsupported lang: "+n),n=n.replace(te,ne).toLowerCase(),function(e){var t;do{if(t=E?e.lang:e.getAttribute("xml:lang")||e.getAttribute("lang"))return(t=t.toLowerCase())===n||0===t.indexOf(n+"-")}while((e=e.parentNode)&&1===e.nodeType);return!1}}),target:function(e){var t=n.location&&n.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===a},focus:function(e){return e===C.activeElement&&(!C.hasFocus||C.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:ge(!1),disabled:ge(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!b.pseudos.empty(e)},header:function(e){return J.test(e.nodeName)},input:function(e){return Q.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:ve(function(){return0}),last:ve(function(e,t){returnt-1}),eq:ve(function(e,t,n){returnn<0?n+t:n}),even:ve(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:ve(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:ve(function(e,t,n){for(var r=n<0?n+t:t<n?t:n;0<=--r;)e.push(r);return e}),gt:ve(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=b.pseudos.eq,{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})b.pseudose=de(e);for(e in{submit:!0,reset:!0})b.pseudose=he(e);function me(){}function xe(e){for(var t=0,n=e.length,r="";t<n;t++)r+=et.value;return r}function be(s,e,t){var u=e.dir,l=e.next,c=l||u,f=t&&"parentNode"===c,p=r++;return e.first?function(e,t,n){while(e=eu)if(1===e.nodeType||f)return s(e,t,n);return!1}:function(e,t,n){var r,i,o,a=k,p;if(n){while(e=eu)if((1===e.nodeType||f)&&s(e,t,n))return!0}else while(e=eu)if(1===e.nodeType||f)if(i=(o=eS||(eS={}))e.uniqueID||(oe.uniqueID={}),l&&l===e.nodeName.toLowerCase())e=eu||e;else{if((r=ic)&&r0===k&&r1===p)return a2=r2;if((ic=a)2=s(e,t,n))return!0}return!1}}function we(i){return 1<i.length?function(e,t,n){var r=i.length;while(r--)if(!ir(e,t,n))return!1;return!0}:i0}function Te(e,t,n,r,i){for(var o,a=,s=0,u=e.length,l=null!=t;s<u;s++)(o=es)&&(n&&!n(o,r,i)||(a.push(o),l&&t.push(s)));return a}function Ce(d,h,g,v,y,e){return v&&!vS&&(v=Ce(v)),y&&!yS&&(y=Ce(y,e)),le(function(e,t,n,r){var i,o,a,s=,u=,l=t.length,c=e||function(e,t,n){for(var r=0,i=t.length;r<i;r++)se(e,tr,n);return n}(h||"*",n.nodeType?n:n,),f=!d||!e&&h?c:Te(c,s,d,n,r),p=g?y||(e?d:l||v)?:t:f;if(g&&g(f,p,n,r),v){i=Te(p,u),v(i,,n,r),o=i.length;while(o--)(a=io)&&(puo=!(fuo=a))}if(e){if(y||d){if(y){i=,o=p.length;while(o--)(a=po)&&i.push(fo=a);y(null,p=,i,r)}o=p.length;while(o--)(a=po)&&-1<(i=y?P(e,a):so)&&(ei=!(ti=a))}}else p=Te(p===t?p.splice(l,p.length):p),y?y(null,t,p,r):H.apply(t,p)})}function Ee(e){for(var i,t,n,r=e.length,o=b.relativee0.type,a=o||b.relative" ",s=o?1:0,u=be(function(e){return e===i},a,!0),l=be(function(e){return-1<P(i,e)},a,!0),c=function(e,t,n){var r=!o&&(n||t!==w)||((i=t).nodeType?u(e,t,n):l(e,t,n));return i=null,r};s<r;s++)if(t=b.relativees.type)c=be(we(c),t);else{if((t=b.filteres.type.apply(null,es.matches))S){for(n=++s;n<r;n++)if(b.relativeen.type)break;return Ce(1<s&&we(c),1<s&&xe(e.slice(0,s-1).concat({value:" "===es-2.type?"*":""})).replace($,"$1"),t,s<n&&Ee(e.slice(s,n)),n<r&&Ee(e=e.slice(n)),n<r&&xe(e))}c.push(t)}return we(c)}return me.prototype=b.filters=b.pseudos,b.setFilters=new me,h=se.tokenize=function(e,t){var n,r,i,o,a,s,u,l=xe+" ";if(l)return t?0:l.slice(0);a=e,s=,u=b.preFilter;while(a){for(o in n&&!(r=_.exec(a))||(r&&(a=a.slice(r0.length)||a),s.push(i=)),n=!1,(r=z.exec(a))&&(n=r.shift(),i.push({value:n,type:r0.replace($," ")}),a=a.slice(n.length)),b.filter)!(r=Go.exec(a))||uo&&!(r=uo(r))||(n=r.shift(),i.push({value:n,type:o,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?se.error(e):x(e,s).slice(0)},f=se.compile=function(e,t){var n,v,y,m,x,r,i=,o=,a=Ae+" ";if(!a){t||(t=h(e)),n=t.length;while(n--)(a=Ee(tn))S?i.push(a):o.push(a);(a=A(e,(v=o,m=0<(y=i).length,x=0<v.length,r=function(e,t,n,r,i){var o,a,s,u=0,l="0",c=e&&,f=,p=w,d=e||x&&b.find.TAG("*",i),h=k+=null==p?1:Math.random()||.1,g=d.length;for(i&&(w=t==C||t||i);l!==g&&null!=(o=dl);l++){if(x&&o){a=0,t||o.ownerDocument==C||(T(o),n=!E);while(s=va++)if(s(o,t||C,n)){r.push(o);break}i&&(k=h)}m&&((o=!s&&o)&&u--,e&&c.push(o))}if(u+=l,m&&l!==u){a=0;while(s=ya++)s(c,f,t,n);if(e){if(0<u)while(l--)cl||fl||(fl=q.call(r));f=Te(f)}H.apply(r,f),i&&!e&&0<f.length&&1<u+y.length&&se.uniqueSort(r)}return i&&(k=h,w=p),c},m?le(r):r))).selector=e}return a},g=se.select=function(e,t,n,r){var i,o,a,s,u,l="function"==typeof e&&e,c=!r&&h(e=l.selector||e);if(n=n||,1===c.length){if(2<(o=c0=c0.slice(0)).length&&"ID"===(a=o0).type&&9===t.nodeType&&E&&b.relativeo1.type){if(!(t=(b.find.ID(a.matches0.replace(te,ne),t)||)0))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}i=G.needsContext.test(e)?0:o.length;while(i--){if(a=oi,b.relatives=a.type)break;if((u=b.finds)&&(r=u(a.matches0.replace(te,ne),ee.test(o0.type)&&ye(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&xe(o)))return H.apply(n,r),n;break}}}return(l||f(e,c))(r,t,!E,n,!t||ee.test(e)&&ye(t.parentNode)||t),n},d.sortStable=S.split("").sort(D).join("")===S,d.detectDuplicates=!!l,T(),d.sortDetached=ce(function(e){return 1&e.compareDocumentPosition(C.createElement("fieldset"))}),ce(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||fe("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),d.attributes&&ce(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||fe("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ce(function(e){return null==e.getAttribute("disabled")})||fe(R,function(e,t,n){var r;if(!n)return!0===et?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),se}(C);S.find=d,S.expr=d.selectors,S.expr":"=S.expr.pseudos,S.uniqueSort=S.unique=d.uniqueSort,S.text=d.getText,S.isXMLDoc=d.isXML,S.contains=d.contains,S.escapeSelector=d.escape;var h=function(e,t,n){var r=,i=void 0!==n;while((e=et)&&9!==e.nodeType)if(1===e.nodeType){if(i&&S(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=;e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},k=S.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var N=/^<(a-z^\/\0>:\x20\t\r\n\f*)\x20\t\r\n\f*\/?>(?:<\/\1>|)$/i;function D(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1<i.call(n,e)!==r}):S.filter(n,e,r)}S.filter=function(e,t,n){var r=t0;return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?S.find.matchesSelector(r,e)?r::S.find.matches(e,S.grep(t,function(e){return 1===e.nodeType}))},S.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(S(e).filter(function(){for(t=0;t<r;t++)if(S.contains(it,this))return!0}));for(n=this.pushStack(),t=0;t<r;t++)S.find(e,it,n);return 1<r?S.uniqueSort(n):n},filter:function(e){return this.pushStack(D(this,e||,!1))},not:function(e){return this.pushStack(D(this,e||,!0))},is:function(e){return!!D(this,"string"==typeof e&&k.test(e)?S(e):e||,!1).length}});var j,q=/^(?:\s*(<\w\W+>)^>*|#(\w-+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||j,"string"==typeof e){if(!(r="<"===e0&&">"===ee.length-1&&3<=e.length?null,e,null:q.exec(e))||!r1&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r1){if(t=t instanceof S?t0:t,S.merge(this,S.parseHTML(r1,t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r1)&&S.isPlainObject(t))for(r in t)m(thisr)?thisr(tr):this.attr(r,tr);return this}return(i=E.getElementById(r2))&&(this0=i,this.length=1),this}return e.nodeType?(this0=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,j=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=et)&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(S.contains(this,te))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=,a="string"!=typeof e&&S(e);if(!k.test(e))for(;r<i;r++)for(n=thisr;n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?-1<a.index(n):1===n.nodeType&&S.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(1<o.length?S.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?i.call(S(e),this0):i.call(this,e.jquery?e0:e):this0&&this0.parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(S.uniqueSort(S.merge(this.get(),S(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),S.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return h(e,"parentNode")},parentsUntil:function(e,t,n){return h(e,"parentNode",n)},next:function(e){return O(e,"nextSibling")},prev:function(e){return O(e,"previousSibling")},nextAll:function(e){return h(e,"nextSibling")},prevAll:function(e){return h(e,"previousSibling")},nextUntil:function(e,t,n){return h(e,"nextSibling",n)},prevUntil:function(e,t,n){return h(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return null!=e.contentDocument&&r(e.contentDocument)?e.contentDocument:(A(e,"template")&&(e=e.content||e),S.merge(,e.childNodes))}},function(r,i){S.fnr=function(e,t){var n=S.map(this,i,e);return"Until"!==r.slice(-5)&&(t=e),t&&"string"==typeof t&&(n=S.filter(t,n)),1<this.length&&(Hr||S.uniqueSort(n),L.test(r)&&n.reverse()),this.pushStack(n)}});var P=/^\x20\t\r\n\f+/g;function R(e){return e}function M(e){throw e}function I(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,e.slice(r))}catch(e){n.apply(void 0,e)}}S.Callbacks=function(r){var e,n;r="string"==typeof r?(e=r,n={},S.each(e.match(P)||,function(e,t){nt=!0}),n):S.extend({},r);var i,t,o,a,s=,u=,l=-1,c=function(){for(a=a||r.once,o=i=!0;u.length;l=-1){t=u.shift();while(++l<s.length)!1===sl.apply(t0,t1)&&r.stopOnFalse&&(l=s.length,t=!1)}r.memory||(t=!1),i=!1,a&&(s=t?:"")},f={add:function(){return s&&(t&&!i&&(l=s.length-1,u.push(t)),function n(e){S.each(e,function(e,t){m(t)?r.unique&&f.has(t)||s.push(t):t&&t.length&&"string"!==w(t)&&n(t)})}(arguments),t&&!i&&c()),this},remove:function(){return S.each(arguments,function(e,t){var n;while(-1<(n=S.inArray(t,s,n)))s.splice(n,1),n<=l&&l--}),this},has:function(e){return e?-1<S.inArray(e,s):0<s.length},empty:function(){return s&&(s=),this},disable:function(){return a=u=,s=t="",this},disabled:function(){return!s},lock:function(){return a=u=,t||i||(s=t=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=e,(t=t||).slice?t.slice():t,u.push(t),i||c()),this},fire:function(){return f.fireWith(this,arguments),this},fired:function(){return!!o}};return f},S.extend({Deferred:function(e){var o="notify","progress",S.Callbacks("memory"),S.Callbacks("memory"),2,"resolve","done",S.Callbacks("once memory"),S.Callbacks("once memory"),0,"resolved","reject","fail",S.Callbacks("once memory"),S.Callbacks("once memory"),1,"rejected",i="pending",a={state:function(){return i},always:function(){return s.done(arguments).fail(arguments),this},"catch":function(e){return a.then(null,e)},pipe:function(){var i=arguments;return S.Deferred(function(r){S.each(o,function(e,t){var n=m(it4)&&it4;st1(function(){var e=n&&n.apply(this,arguments);e&&m(e.promise)?e.promise().progress(r.notify).done(r.resolve).fail(r.reject):rt0+"With"(this,n?e:arguments)})}),i=null}).promise()},then:function(t,n,r){var u=0;function l(i,o,a,s){return function(){var n=this,r=arguments,e=function(){var e,t;if(!(i<u)){if((e=a.apply(n,r))===o.promise())throw new TypeError("Thenable self-resolution");t=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(t)?s?t.call(e,l(u,o,R,s),l(u,o,M,s)):(u++,t.call(e,l(u,o,R,s),l(u,o,M,s),l(u,o,R,o.notifyWith))):(a!==R&&(n=void 0,r=e),(s||o.resolveWith)(n,r))}},t=s?e:function(){try{e()}catch(e){S.Deferred.exceptionHook&&S.Deferred.exceptionHook(e,t.stackTrace),u<=i+1&&(a!==M&&(n=void 0,r=e),o.rejectWith(n,r))}};i?t():(S.Deferred.getStackHook&&(t.stackTrace=S.Deferred.getStackHook()),C.setTimeout(t))}}return S.Deferred(function(e){o03.add(l(0,e,m(r)?r:R,e.notifyWith)),o13.add(l(0,e,m(t)?t:R)),o23.add(l(0,e,m(n)?n:M))}).promise()},promise:function(e){return null!=e?S.extend(e,a):a}},s={};return S.each(o,function(e,t){var n=t2,r=t5;at1=n.add,r&&n.add(function(){i=r},o3-e2.disable,o3-e3.disable,o02.lock,o03.lock),n.add(t3.fire),st0=function(){return st0+"With"(this===s?void 0:this,arguments),this},st0+"With"=n.fireWith}),a.promise(s),e&&e.call(s,s),s},when:function(e){var n=arguments.length,t=n,r=Array(t),i=s.call(arguments),o=S.Deferred(),a=function(t){return function(e){rt=this,it=1<arguments.length?s.call(arguments):e,--n||o.resolveWith(r,i)}};if(n<=1&&(I(e,o.done(a(t)).resolve,o.reject,!n),"pending"===o.state()||m(it&&it.then)))return o.then();while(t--)I(it,a(t),o.reject);return o.promise()}});var W=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;S.Deferred.exceptionHook=function(e,t){C.console&&C.console.warn&&e&&W.test(e.name)&&C.console.warn("jQuery.Deferred exception: "+e.message,e.stack,t)},S.readyException=function(e){C.setTimeout(function(){throw e})};var F=S.Deferred();function B(){E.removeEventListener("DOMContentLoaded",B),C.removeEventListener("load",B),S.ready()}S.fn.ready=function(e){return F.then(e)"catch"(function(e){S.readyException(e)}),this},S.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--S.readyWait:S.isReady)||(S.isReady=!0)!==e&&0<--S.readyWait||F.resolveWith(E,S)}}),S.ready.then=F.then,"complete"===E.readyState||"loading"!==E.readyState&&!E.documentElement.doScroll?C.setTimeout(S.ready):(E.addEventListener("DOMContentLoaded",B),C.addEventListener("load",B));var $=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===w(n))for(s in i=!0,n)$(e,t,s,ns,!0,o,a);else if(void 0!==r&&(i=!0,m(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(S(e),n)})),t))for(;s<u;s++)t(es,n,a?r:r.call(es,s,t(es,n)));return i?e:l?t.call(e):u?t(e0,n):o},_=/^-ms-/,z=/-(a-z)/g;function U(e,t){return t.toUpperCase()}function X(e){return e.replace(_,"ms-").replace(z,U)}var V=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function G(){this.expando=S.expando+G.uid++}G.uid=1,G.prototype={cache:function(e){var t=ethis.expando;return t||(t={},V(e)&&(e.nodeType?ethis.expando=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)iX(t)=n;else for(r in t)iX(r)=tr;return i},get:function(e,t){return void 0===t?this.cache(e):ethis.expando&&ethis.expandoX(t)},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=ethis.expando;if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(X):(t=X(t))in r?t:t.match(P)||).length;while(n--)delete rtn}(void 0===t||S.isEmptyObject(r))&&(e.nodeType?ethis.expando=void 0:delete ethis.expando)}},hasData:function(e){var t=ethis.expando;return void 0!==t&&!S.isEmptyObject(t)}};var Y=new G,Q=new G,J=/^(?:\{\w\W*\}|\\w\W*\)$/,K=/A-Z/g;function Z(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}S.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),S.fn.extend({data:function(n,e){var t,r,i,o=this0,a=o&&o.attributes;if(void 0===n){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){t=a.length;while(t--)at&&0===(r=at.name).indexOf("data-")&&(r=X(r.slice(5)),Z(o,r,ir));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof n?this.each(function(){Q.set(this,n)}):$(this,function(e){var t;if(o&&void 0===e)return void 0!==(t=Q.get(o,n))?t:void 0!==(t=Z(o,n))?t:void 0;this.each(function(){Q.set(this,n,e)})},null,e,1<arguments.length,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),S.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,S.makeArray(n)):r.push(n)),r||},dequeue:function(e,t){t=t||"fx";var n=S.queue(e,t),r=n.length,i=n.shift(),o=S._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){S.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:S.Callbacks("once memory").add(function(){Y.remove(e,t+"queue",n)})})}}),S.fn.extend({queue:function(t,n){var e=2;return"string"!=typeof t&&(n=t,t="fx",e--),arguments.length<e?S.queue(this0,t):void 0===n?this:this.each(function(){var e=S.queue(this,t,n);S._queueHooks(this,t),"fx"===t&&"inprogress"!==e0&&S.dequeue(this,t)})},dequeue:function(e){return this.each(function(){S.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",)},promise:function(e,t){var n,r=1,i=S.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,o)};"string"!=typeof e&&(t=e,e=void 0),e=e||"fx";while(a--)(n=Y.get(oa,e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var ee=/+-?(?:\d*\.|)\d+(?:eE+-?\d+|)/.source,te=new RegExp("^(?:(+-)=|)("+ee+")(a-z%*)$","i"),ne="Top","Right","Bottom","Left",re=E.documentElement,ie=function(e){return S.contains(e.ownerDocument,e)},oe={composed:!0};re.getRootNode&&(ie=function(e){return S.contains(e.ownerDocument,e)||e.getRootNode(oe)===e.ownerDocument});var ae=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&ie(e)&&"none"===S.css(e,"display")};function se(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return S.css(e,t,"")},u=s(),l=n&&n3||(S.cssNumbert?"":"px"),c=e.nodeType&&(S.cssNumbert||"px"!==l&&+u)&&te.exec(S.css(e,t));if(c&&c3!==l){u/=2,l=l||c3,c=+u||1;while(a--)S.style(e,t,c+l),(1-o)*(1-(o=s()/u||.5))<=0&&(a=0),c/=o;c*=2,S.style(e,t,c+l),n=n||}return n&&(c=+c||+u||0,i=n1?c+(n1+1)*n2:+n2,r&&(r.unit=l,r.start=c,r.end=i)),i}var ue={};function le(e,t){for(var n,r,i,o,a,s,u,l=,c=0,f=e.length;c<f;c++)(r=ec).style&&(n=r.style.display,t?("none"===n&&(lc=Y.get(r,"display")||null,lc||(r.style.display="")),""===r.style.display&&ae(r)&&(lc=(u=a=o=void 0,a=(i=r).ownerDocument,s=i.nodeName,(u=ues)||(o=a.body.appendChild(a.createElement(s)),u=S.css(o,"display"),o.parentNode.removeChild(o),"none"===u&&(u="block"),ues=u)))):"none"!==n&&(lc="none",Y.set(r,"display",n)));for(c=0;c<f;c++)null!=lc&&(ec.style.display=lc);return e}S.fn.extend({show:function(){return le(this,!0)},hide:function(){return le(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ae(this)?S(this).show():S(this).hide()})}});var ce,fe,pe=/^(?:checkbox|radio)$/i,de=/<(a-z^\/\0>\x20\t\r\n\f*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="<textarea>x</textarea>",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="<option></option>",y.option=!!ce.lastChild;var ge={thead:1,"<table>","</table>",col:2,"<table><colgroup>","</colgroup></table>",tr:2,"<table><tbody>","</tbody></table>",td:3,"<table><tbody><tr>","</tr></tbody></table>",_default:0,"",""};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):,void 0===t||t&&A(e,t)?S.merge(e,n):n}function ye(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(en,"globalEval",!t||Y.get(tn,"globalEval"))}ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td,y.option||(ge.optgroup=ge.option=1,"<select multiple='multiple'>","</select>");var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=,d=0,h=e.length;d<h;d++)if((o=ed)||0===o)if("object"===w(o))S.merge(p,o.nodeType?o:o);else if(me.test(o)){a=a||f.appendChild(t.createElement("div")),s=(de.exec(o)||"","")1.toLowerCase(),u=ges||ge._default,a.innerHTML=u1+S.htmlPrefilter(o)+u2,c=u0;while(c--)a=a.lastChild;S.merge(p,a.childNodes),(a=f.firstChild).textContent=""}else p.push(t.createTextNode(o));f.textContent="",d=0;while(o=pd++)if(r&&-1<S.inArray(o,r))i&&i.push(o);else if(l=ie(o),a=ve(f.appendChild(o),"script"),l&&ye(a),n){c=0;while(o=ac++)he.test(o.type||"")&&n.push(o)}return f}var be=/^key/,we=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,Te=/^(^.*)(?:\.(.+)|)/;function Ce(){return!0}function Ee(){return!1}function Se(e,t){return e===function(){try{return E.activeElement}catch(e){}}()==("focus"===t)}function ke(e,t,n,r,i,o){var a,s;if("object"==typeof t){for(s in"string"!=typeof n&&(r=r||n,n=void 0),t)ke(e,s,n,r,ts,o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Ee;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return S().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=S.guid++)),e.each(function(){S.event.add(this,t,i,r,n)})}function Ae(e,i,o){o?(Y.set(e,i,!1),S.event.add(e,i,{namespace:!1,handler:function(e){var t,n,r=Y.get(this,i);if(1&e.isTrigger&&thisi){if(r.length)(S.event.speciali||{}).delegateType&&e.stopPropagation();else if(r=s.call(arguments),Y.set(this,i,r),t=o(this,i),thisi(),r!==(n=Y.get(this,i))||t?Y.set(this,i,!1):n={},r!==n)return e.stopImmediatePropagation(),e.preventDefault(),n.value}else r.length&&(Y.set(this,i,{value:S.event.trigger(S.extend(r0,S.Event.prototype),r.slice(1),this)}),e.stopImmediatePropagation())}})):void 0===Y.get(e,i)&&S.event.add(e,i,Ce)}S.event={global:{},add:function(t,e,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.get(t);if(V(t)){n.handler&&(n=(o=n).handler,i=o.selector),i&&S.find.matchesSelector(re,i),n.guid||(n.guid=S.guid++),(u=v.events)||(u=v.events=Object.create(null)),(a=v.handle)||(a=v.handle=function(e){return"undefined"!=typeof S&&S.event.triggered!==e.type?S.event.dispatch.apply(t,arguments):void 0}),l=(e=(e||"").match(P)||"").length;while(l--)d=g=(s=Te.exec(el)||)1,h=(s2||"").split(".").sort(),d&&(f=S.event.speciald||{},d=(i?f.delegateType:f.bindType)||d,f=S.event.speciald||{},c=S.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&S.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=ud)||((p=ud=).delegateCount=0,f.setup&&!1!==f.setup.call(t,r,h,a)||t.addEventListener&&t.addEventListener(d,a)),f.add&&(f.add.call(t,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),S.event.globald=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.hasData(e)&&Y.get(e);if(v&&(u=v.events)){l=(t=(t||"").match(P)||"").length;while(l--)if(d=g=(s=Te.exec(tl)||)1,h=(s2||"").split(".").sort(),d){f=S.event.speciald||{},p=ud=(r?f.delegateType:f.bindType)||d||,s=s2&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=po,!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,v.handle)||S.removeEvent(e,d,v.handle),delete ud)}else for(d in u)S.event.remove(e,d+tl,n,r,!0);S.isEmptyObject(u)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=new Array(arguments.length),u=S.event.fix(e),l=(Y.get(this,"events")||Object.create(null))u.type||,c=S.event.specialu.type||{};for(s0=u,t=1;t<arguments.length;t++)st=argumentst;if(u.delegateTarget=this,!c.preDispatch||!1!==c.preDispatch.call(this,u)){a=S.event.handlers.call(this,u,l),t=0;while((i=at++)&&!u.isPropagationStopped()){u.currentTarget=i.elem,n=0;while((o=i.handlersn++)&&!u.isImmediatePropagationStopped())u.rnamespace&&!1!==o.namespace&&!u.rnamespace.test(o.namespace)||(u.handleObj=o,u.data=o.data,void 0!==(r=((S.event.specialo.origType||{}).handle||o.handler).apply(i.elem,s))&&!1===(u.result=r)&&(u.preventDefault(),u.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,u),u.result}},handlers:function(e,t){var n,r,i,o,a,s=,u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&1<=e.button))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=,a={},n=0;n<u;n++)void 0===ai=(r=tn).selector+" "&&(ai=r.needsContext?-1<S(i,this).index(l):S.find(i,this,null,l).length),ai&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(t,e){Object.defineProperty(S.Event.prototype,t,{enumerable:!0,configurable:!0,get:m(e)?function(){if(this.originalEvent)return e(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEventt},set:function(e){Object.defineProperty(this,t,{enumerable:!0,configurable:!0,writable:!0,value:e})}})},fix:function(e){return eS.expando?e:new S.Event(e)},special:{load:{noBubble:!0},click:{setup:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Ae(t,"click",Ce),!1},trigger:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Ae(t,"click"),!0},_default:function(e){var t=e.target;return pe.test(t.type)&&t.click&&A(t,"input")&&Y.get(t,"click")||A(t,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},S.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},S.Event=function(e,t){if(!(this instanceof S.Event))return new S.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?Ce:Ee,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&S.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),thisS.expando=!0},S.Event.prototype={constructor:S.Event,isDefaultPrevented:Ee,isPropagationStopped:Ee,isImmediatePropagationStopped:Ee,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=Ce,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=Ce,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=Ce,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},S.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,"char":!0,code:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:function(e){var t=e.button;return null==e.which&&be.test(e.type)?null!=e.charCode?e.charCode:e.keyCode:!e.which&&void 0!==t&&we.test(e.type)?1&t?1:2&t?3:4&t?2:0:e.which}},S.event.addProp),S.each({focus:"focusin",blur:"focusout"},function(e,t){S.event.speciale={setup:function(){return Ae(this,e,Se),!1},trigger:function(){return Ae(this,e),!0},delegateType:t}}),S.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,i){S.event.speciale={delegateType:i,bindType:i,handle:function(e){var t,n=e.relatedTarget,r=e.handleObj;return n&&(n===this||S.contains(this,n))||(e.type=r.origType,t=r.handler.apply(this,arguments),e.type=i),t}}}),S.fn.extend({on:function(e,t,n,r){return ke(this,e,t,n,r)},one:function(e,t,n,r){return ke(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,S(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,ei);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Ee),this.each(function(){S.event.remove(this,e,n,t)})}});var Ne=/<script|<style|<link/i,De=/checked\s*(?:^=|=\s*.checked.)/i,je=/^\s*<!(?:\CDATA\|--)|(?:\\|--)>\s*$/g;function qe(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")0||e}function Le(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function He(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Oe(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=si.length;n<r;n++)S.event.add(t,i,sin);Q.hasData(e)&&(o=Q.access(e),a=S.extend({},o),Q.set(t,a))}}function Pe(n,r,i,o){r=g(r);var e,t,a,s,u,l,c=0,f=n.length,p=f-1,d=r0,h=m(d);if(h||1<f&&"string"==typeof d&&!y.checkClone&&De.test(d))return n.each(function(e){var t=n.eq(e);h&&(r0=d.call(this,e,t.html())),Pe(t,r,i,o)});if(f&&(t=(e=xe(r,n0.ownerDocument,!1,n,o)).firstChild,1===e.childNodes.length&&(e=t),t||o)){for(s=(a=S.map(ve(e,"script"),Le)).length;c<f;c++)u=e,c!==p&&(u=S.clone(u,!0,!0),s&&S.merge(a,ve(u,"script"))),i.call(nc,u,c);if(s)for(l=aa.length-1.ownerDocument,S.map(a,He),c=0;c<s;c++)u=ac,he.test(u.type||"")&&!Y.access(u,"globalEval")&&S.contains(l,u)&&(u.src&&"module"!==(u.type||"").toLowerCase()?S._evalUrl&&!u.noModule&&S._evalUrl(u.src,{nonce:u.nonce||u.getAttribute("nonce")},l):b(u.textContent.replace(je,""),u,l))}return n}function Re(e,t,n){for(var r,i=t?S.filter(t,e):e,o=0;null!=(r=io);o++)n||1!==r.nodeType||S.cleanData(ve(r)),r.parentNode&&(n&&ie(r)&&ye(ve(r,"script")),r.parentNode.removeChild(r));return e}S.extend({htmlPrefilter:function(e){return e},clone:function(e,t,n){var r,i,o,a,s,u,l,c=e.cloneNode(!0),f=ie(e);if(!(y.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||S.isXMLDoc(e)))for(a=ve(c),r=0,i=(o=ve(e)).length;r<i;r++)s=or,u=ar,void 0,"input"===(l=u.nodeName.toLowerCase())&&pe.test(s.type)?u.checked=s.checked:"input"!==l&&"textarea"!==l||(u.defaultValue=s.defaultValue);if(t)if(n)for(o=o||ve(e),a=a||ve(c),r=0,i=o.length;r<i;r++)Oe(or,ar);else Oe(e,c);return 0<(a=ve(c,"script")).length&&ye(a,!f&&ve(e,"script")),c},cleanData:function(e){for(var t,n,r,i=S.event.special,o=0;void 0!==(n=eo);o++)if(V(n)){if(t=nY.expando){if(t.events)for(r in t.events)ir?S.event.remove(n,r):S.removeEvent(n,r,t.handle);nY.expando=void 0}nQ.expando&&(nQ.expando=void 0)}}}),S.fn.extend({detach:function(e){return Re(this,e,!0)},remove:function(e){return Re(this,e)},text:function(e){return $(this,function(e){return void 0===e?S.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return Pe(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||qe(this,e).appendChild(e)})},prepend:function(){return Pe(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=qe(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return Pe(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return Pe(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=thist);t++)1===e.nodeType&&(S.cleanData(ve(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return S.clone(this,e,t)})},html:function(e){return $(this,function(e){var t=this0||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!Ne.test(e)&&!ge(de.exec(e)||"","")1.toLowerCase()){e=S.htmlPrefilter(e);try{for(;n<r;n++)1===(t=thisn||{}).nodeType&&(S.cleanData(ve(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var n=;return Pe(this,arguments,function(e){var t=this.parentNode;S.inArray(this,n)<0&&(S.cleanData(ve(this)),t&&t.replaceChild(e,this))},n)}}),S.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,a){S.fne=function(e){for(var t,n=,r=S(e),i=r.length-1,o=0;o<=i;o++)t=o===i?this:this.clone(!0),S(ro)a(t),u.apply(n,t.get());return this.pushStack(n)}});var Me=new RegExp("^("+ee+")(?!px)a-z%+$","i"),Ie=function(e){var t=e.ownerDocument.defaultView;return t&&t.opener||(t=C),t.getComputedStyle(e)},We=function(e,t,n){var r,i,o={};for(i in t)oi=e.stylei,e.stylei=ti;for(i in r=n.call(e),t)e.stylei=oi;return r},Fe=new RegExp(ne.join("|"),"i");function Be(e,t,n){var r,i,o,a,s=e.style;return(n=n||Ie(e))&&(""!==(a=n.getPropertyValue(t)||nt)||ie(e)||(a=S.style(e,t)),!y.pixelBoxStyles()&&Me.test(a)&&Fe.test(t)&&(r=s.width,i=s.minWidth,o=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=i,s.maxWidth=o)),void 0!==a?a+"":a}function $e(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function e(){if(l){u.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",l.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",re.appendChild(u).appendChild(l);var e=C.getComputedStyle(l);n="1%"!==e.top,s=12===t(e.marginLeft),l.style.right="60%",o=36===t(e.right),r=36===t(e.width),l.style.position="absolute",i=12===t(l.offsetWidth/3),re.removeChild(u),l=null}}function t(e){return Math.round(parseFloat(e))}var n,r,i,o,a,s,u=E.createElement("div"),l=E.createElement("div");l.style&&(l.style.backgroundClip="content-box",l.cloneNode(!0).style.backgroundClip="",y.clearCloneStyle="content-box"===l.style.backgroundClip,S.extend(y,{boxSizingReliable:function(){return e(),r},pixelBoxStyles:function(){return e(),o},pixelPosition:function(){return e(),n},reliableMarginLeft:function(){return e(),s},scrollboxSize:function(){return e(),i},reliableTrDimensions:function(){var e,t,n,r;return null==a&&(e=E.createElement("table"),t=E.createElement("tr"),n=E.createElement("div"),e.style.cssText="position:absolute;left:-11111px",t.style.height="1px",n.style.height="9px",re.appendChild(e).appendChild(t).appendChild(n),r=C.getComputedStyle(t),a=3<parseInt(r.height),re.removeChild(e)),a}}))}();var _e="Webkit","Moz","ms",ze=E.createElement("div").style,Ue={};function Xe(e){var t=S.cssPropse||Uee;return t||(e in ze?e:Uee=function(e){var t=e0.toUpperCase()+e.slice(1),n=_e.length;while(n--)if((e=_en+t)in ze)return e}(e)||e)}var Ve=/^(none|table(?!-cea).+)/,Ge=/^--/,Ye={position:"absolute",visibility:"hidden",display:"block"},Qe={letterSpacing:"0",fontWeight:"400"};function Je(e,t,n){var r=te.exec(t);return r?Math.max(0,r2-(n||0))+(r3||"px"):t}function Ke(e,t,n,r,i,o){var a="width"===t?1:0,s=0,u=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(u+=S.css(e,n+nea,!0,i)),r?("content"===n&&(u-=S.css(e,"padding"+nea,!0,i)),"margin"!==n&&(u-=S.css(e,"border"+nea+"Width",!0,i))):(u+=S.css(e,"padding"+nea,!0,i),"padding"!==n?u+=S.css(e,"border"+nea+"Width",!0,i):s+=S.css(e,"border"+nea+"Width",!0,i));return!r&&0<=o&&(u+=Math.max(0,Math.ceil(e"offset"+t0.toUpperCase()+t.slice(1)-o-u-s-.5))||0),u}function Ze(e,t,n){var r=Ie(e),i=(!y.boxSizingReliable()||n)&&"border-box"===S.css(e,"boxSizing",!1,r),o=i,a=Be(e,t,r),s="offset"+t0.toUpperCase()+t.slice(1);if(Me.test(a)){if(!n)return a;a="auto"}return(!y.boxSizingReliable()&&i||!y.reliableTrDimensions()&&A(e,"tr")||"auto"===a||!parseFloat(a)&&"inline"===S.css(e,"display",!1,r))&&e.getClientRects().length&&(i="border-box"===S.css(e,"boxSizing",!1,r),(o=s in e)&&(a=es)),(a=parseFloat(a)||0)+Ke(e,t,n||(i?"border":"content"),o,r,a)+"px"}function et(e,t,n,r,i){return new et.prototype.init(e,t,n,r,i)}S.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Be(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,gridArea:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnStart:!0,gridRow:!0,gridRowEnd:!0,gridRowStart:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=X(t),u=Ge.test(t),l=e.style;if(u||(t=Xe(s)),a=S.cssHookst||S.cssHookss,void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:lt;"string"===(o=typeof n)&&(i=te.exec(n))&&i1&&(n=se(e,t,i),o="number"),null!=n&&n==n&&("number"!==o||u||(n+=i&&i3||(S.cssNumbers?"":"px")),y.clearCloneStyle||""!==n||0!==t.indexOf("background")||(lt="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):lt=n))}},css:function(e,t,n,r){var i,o,a,s=X(t);return Ge.test(t)||(t=Xe(s)),(a=S.cssHookst||S.cssHookss)&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=Be(e,t,r)),"normal"===i&&t in Qe&&(i=Qet),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),S.each("height","width",function(e,u){S.cssHooksu={get:function(e,t,n){if(t)return!Ve.test(S.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Ze(e,u,n):We(e,Ye,function(){return Ze(e,u,n)})},set:function(e,t,n){var r,i=Ie(e),o=!y.scrollboxSize()&&"absolute"===i.position,a=(o||n)&&"border-box"===S.css(e,"boxSizing",!1,i),s=n?Ke(e,u,n,a,i):0;return a&&o&&(s-=Math.ceil(e"offset"+u0.toUpperCase()+u.slice(1)-parseFloat(iu)-Ke(e,u,"border",!1,i)-.5)),s&&(r=te.exec(t))&&"px"!==(r3||"px")&&(e.styleu=t,t=S.css(e,u)),Je(0,t,s)}}}),S.cssHooks.marginLeft=$e(y.reliableMarginLeft,function(e,t){if(t)return(parseFloat(Be(e,"marginLeft"))||e.getBoundingClientRect().left-We(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),S.each({margin:"",padding:"",border:"Width"},function(i,o){S.cssHooksi+o={expand:function(e){for(var t=0,n={},r="string"==typeof e?e.split(" "):e;t<4;t++)ni+net+o=rt||rt-2||r0;return n}},"margin"!==i&&(S.cssHooksi+o.set=Je)}),S.fn.extend({css:function(e,t){return $(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Ie(e),i=t.length;a<i;a++)ota=S.css(e,ta,!1,r);return o}return void 0!==n?S.style(e,t,n):S.css(e,t)},e,t,1<arguments.length)}}),((S.Tween=et).prototype={constructor:et,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||S.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(S.cssNumbern?"":"px")},cur:function(){var e=et.propHooksthis.prop;return e&&e.get?e.get(this):et.propHooks._default.get(this)},run:function(e){var t,n=et.propHooksthis.prop;return this.options.duration?this.pos=t=S.easingthis.easing(e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):et.propHooks._default.set(this),this}}).init.prototype=et.prototype,(et.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.eleme.prop&&null==e.elem.stylee.prop?e.eleme.prop:(t=S.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){S.fx.stepe.prop?S.fx.stepe.prop(e):1!==e.elem.nodeType||!S.cssHookse.prop&&null==e.elem.styleXe(e.prop)?e.eleme.prop=e.now:S.style(e.elem,e.prop,e.now+e.unit)}}}).scrollTop=et.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.eleme.prop=e.now)}},S.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},S.fx=et.prototype.init,S.fx.step={};var tt,nt,rt,it,ot=/^(?:toggle|show|hide)$/,at=/queueHooks$/;function st(){nt&&(!1===E.hidden&&C.requestAnimationFrame?C.requestAnimationFrame(st):C.setTimeout(st,S.fx.interval),S.fx.tick())}function ut(){return C.setTimeout(function(){tt=void 0}),tt=Date.now()}function lt(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i"margin"+(n=ner)=i"padding"+n=e;return t&&(i.opacity=i.width=e),i}function ct(e,t,n){for(var r,i=(ft.tweenerst||).concat(ft.tweeners"*"),o=0,a=i.length;o<a;o++)if(r=io.call(n,t,e))return r}function ft(o,e,t){var n,a,r=0,i=ft.prefilters.length,s=S.Deferred().always(function(){delete u.elem}),u=function(){if(a)return!1;for(var e=tt||ut(),t=Math.max(0,l.startTime+l.duration-e),n=1-(t/l.duration||0),r=0,i=l.tweens.length;r<i;r++)l.tweensr.run(n);return s.notifyWith(o,l,n,t),n<1&&i?t:(i||s.notifyWith(o,l,1,0),s.resolveWith(o,l),!1)},l=s.promise({elem:o,props:S.extend({},e),opts:S.extend(!0,{specialEasing:{},easing:S.easing._default},t),originalProperties:e,originalOptions:t,startTime:tt||ut(),duration:t.duration,tweens:,createTween:function(e,t){var n=S.Tween(o,l.opts,e,t,l.opts.specialEasinge||l.opts.easing);return l.tweens.push(n),n},stop:function(e){var t=0,n=e?l.tweens.length:0;if(a)return this;for(a=!0;t<n;t++)l.tweenst.run(1);return e?(s.notifyWith(o,l,1,0),s.resolveWith(o,l,e)):s.rejectWith(o,l,e),this}}),c=l.props;for(!function(e,t){var n,r,i,o,a;for(n in e)if(i=tr=X(n),o=en,Array.isArray(o)&&(i=o1,o=en=o0),n!==r&&(er=o,delete en),(a=S.cssHooksr)&&"expand"in a)for(n in o=a.expand(o),delete er,o)n in e||(en=on,tn=i);else tr=i}(c,l.opts.specialEasing);r<i;r++)if(n=ft.prefiltersr.call(l,o,c,l.opts))return m(n.stop)&&(S._queueHooks(l.elem,l.opts.queue).stop=n.stop.bind(n)),n;return S.map(c,ct,l),m(l.opts.start)&&l.opts.start.call(o,l),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always),S.fx.timer(S.extend(u,{elem:o,anim:l,queue:l.opts.queue})),l}S.Animation=S.extend(ft,{tweeners:{"*":function(e,t){var n=this.createTween(e,t);return se(n.elem,e,te.exec(t),n),n}},tweener:function(e,t){m(e)?(t=e,e="*"):e=e.match(P);for(var n,r=0,i=e.length;r<i;r++)n=er,ft.tweenersn=ft.tweenersn||,ft.tweenersn.unshift(t)},prefilters:function(e,t,n){var r,i,o,a,s,u,l,c,f="width"in t||"height"in t,p=this,d={},h=e.style,g=e.nodeType&&ae(e),v=Y.get(e,"fxshow");for(r in n.queue||(null==(a=S._queueHooks(e,"fx")).unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,S.queue(e,"fx").length||a.empty.fire()})})),t)if(i=tr,ot.test(i)){if(delete tr,o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!v||void 0===vr)continue;g=!0}dr=v&&vr||S.style(e,r)}if((u=!S.isEmptyObject(t))||!S.isEmptyObject(d))for(r in f&&1===e.nodeType&&(n.overflow=h.overflow,h.overflowX,h.overflowY,null==(l=v&&v.display)&&(l=Y.get(e,"display")),"none"===(c=S.css(e,"display"))&&(l?c=l:(le(e,!0),l=e.style.display||l,c=S.css(e,"display"),le(e))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===S.css(e,"float")&&(u||(p.done(function(){h.display=l}),null==l&&(c=h.display,l="none"===c?"":c)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",p.always(function(){h.overflow=n.overflow0,h.overflowX=n.overflow1,h.overflowY=n.overflow2})),u=!1,d)u||(v?"hidden"in v&&(g=v.hidden):v=Y.access(e,"fxshow",{display:l}),o&&(v.hidden=!g),g&&le(e,!0),p.done(function(){for(r in g||le(e),Y.remove(e,"fxshow"),d)S.style(e,r,dr)})),u=ct(g?vr:0,r,p),r in v||(vr=u.start,g&&(u.end=u.start,u.start=0))},prefilter:function(e,t){t?ft.prefilters.unshift(e):ft.prefilters.push(e)}}),S.speed=function(e,t,n){var r=e&&"object"==typeof e?S.extend({},e):{complete:n||!n&&t||m(e)&&e,duration:e,easing:n&&t||t&&!m(t)&&t};return S.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in S.fx.speeds?r.duration=S.fx.speedsr.duration:r.duration=S.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){m(r.old)&&r.old.call(this),r.queue&&S.dequeue(this,r.queue)},r},S.fn.extend({fadeTo:function(e,t,n,r){return this.filter(ae).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(t,e,n,r){var i=S.isEmptyObject(t),o=S.speed(e,n,r),a=function(){var e=ft(this,S.extend({},t),o);(i||Y.get(this,"finish"))&&e.stop(!0)};return a.finish=a,i||!1===o.queue?this.each(a):this.queue(o.queue,a)},stop:function(i,e,o){var a=function(e){var t=e.stop;delete e.stop,t(o)};return"string"!=typeof i&&(o=e,e=i,i=void 0),e&&this.queue(i||"fx",),this.each(function(){var e=!0,t=null!=i&&i+"queueHooks",n=S.timers,r=Y.get(this);if(t)rt&&rt.stop&&a(rt);else for(t in r)rt&&rt.stop&&at.test(t)&&a(rt);for(t=n.length;t--;)nt.elem!==this||null!=i&&nt.queue!==i||(nt.anim.stop(o),e=!1,n.splice(t,1));!e&&o||S.dequeue(this,i)})},finish:function(a){return!1!==a&&(a=a||"fx"),this.each(function(){var e,t=Y.get(this),n=ta+"queue",r=ta+"queueHooks",i=S.timers,o=n?n.length:0;for(t.finish=!0,S.queue(this,a,),r&&r.stop&&r.stop.call(this,!0),e=i.length;e--;)ie.elem===this&&ie.queue===a&&(ie.anim.stop(!0),i.splice(e,1));for(e=0;e<o;e++)ne&&ne.finish&&ne.finish.call(this);delete t.finish})}}),S.each("toggle","show","hide",function(e,r){var i=S.fnr;S.fnr=function(e,t,n){return null==e||"boolean"==typeof e?i.apply(this,arguments):this.animate(lt(r,!0),e,t,n)}}),S.each({slideDown:lt("show"),slideUp:lt("hide"),slideToggle:lt("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,r){S.fne=function(e,t,n){return this.animate(r,e,t,n)}}),S.timers=,S.fx.tick=function(){var e,t=0,n=S.timers;for(tt=Date.now();t<n.length;t++)(e=nt)()||nt!==e||n.splice(t--,1);n.length||S.fx.stop(),tt=void 0},S.fx.timer=function(e){S.timers.push(e),S.fx.start()},S.fx.interval=13,S.fx.start=function(){nt||(nt=!0,st())},S.fx.stop=function(){nt=null},S.fx.speeds={slow:600,fast:200,_default:400},S.fn.delay=function(r,e){return r=S.fx&&S.fx.speedsr||r,e=e||"fx",this.queue(e,function(e,t){var n=C.setTimeout(e,r);t.stop=function(){C.clearTimeout(n)}})},rt=E.createElement("input"),it=E.createElement("select").appendChild(E.createElement("option")),rt.type="checkbox",y.checkOn=""!==rt.value,y.optSelected=it.selected,(rt=E.createElement("input")).value="t",rt.type="radio",y.radioValue="t"===rt.value;var pt,dt=S.expr.attrHandle;S.fn.extend({attr:function(e,t){return $(this,S.attr,e,t,1<arguments.length)},removeAttr:function(e){return this.each(function(){S.removeAttr(this,e)})}}),S.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?S.prop(e,t,n):(1===o&&S.isXMLDoc(e)||(i=S.attrHookst.toLowerCase()||(S.expr.match.bool.test(t)?pt:void 0)),void 0!==n?null===n?void S.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=S.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!y.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(P);if(i&&1===e.nodeType)while(n=ir++)e.removeAttribute(n)}}),pt={set:function(e,t,n){return!1===t?S.removeAttr(e,n):e.setAttribute(n,n),n}},S.each(S.expr.match.bool.source.match(/\w+/g),function(e,t){var a=dtt||S.find.attr;dtt=function(e,t,n){var r,i,o=t.toLowerCase();return n||(i=dto,dto=r,r=null!=a(e,t,n)?o:null,dto=i),r}});var ht=/^(?:input|select|textarea|button)$/i,gt=/^(?:a|area)$/i;function vt(e){return(e.match(P)||).join(" ")}function yt(e){return e.getAttribute&&e.getAttribute("class")||""}function mt(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(P)||}S.fn.extend({prop:function(e,t){return $(this,S.prop,e,t,1<arguments.length)},removeProp:function(e){return this.each(function(){delete thisS.propFixe||e})}}),S.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&S.isXMLDoc(e)||(t=S.propFixt||t,i=S.propHookst),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:et=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:et},propHooks:{tabIndex:{get:function(e){var t=S.find.attr(e,"tabindex");return t?parseInt(t,10):ht.test(e.nodeName)||gt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),y.optSelected||(S.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),S.each("tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable",function(){S.propFixthis.toLowerCase()=this}),S.fn.extend({addClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).addClass(t.call(this,e,yt(this)))});if((e=mt(t)).length)while(n=thisu++)if(i=yt(n),r=1===n.nodeType&&" "+vt(i)+" "){a=0;while(o=ea++)r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=vt(r))&&n.setAttribute("class",s)}return this},removeClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).removeClass(t.call(this,e,yt(this)))});if(!arguments.length)return this.attr("class","");if((e=mt(t)).length)while(n=thisu++)if(i=yt(n),r=1===n.nodeType&&" "+vt(i)+" "){a=0;while(o=ea++)while(-1<r.indexOf(" "+o+" "))r=r.replace(" "+o+" "," ");i!==(s=vt(r))&&n.setAttribute("class",s)}return this},toggleClass:function(i,t){var o=typeof i,a="string"===o||Array.isArray(i);return"boolean"==typeof t&&a?t?this.addClass(i):this.removeClass(i):m(i)?this.each(function(e){S(this).toggleClass(i.call(this,e,yt(this),t),t)}):this.each(function(){var e,t,n,r;if(a){t=0,n=S(this),r=mt(i);while(e=rt++)n.hasClass(e)?n.removeClass(e):n.addClass(e)}else void 0!==i&&"boolean"!==o||((e=yt(this))&&Y.set(this,"__className__",e),this.setAttribute&&this.setAttribute("class",e||!1===i?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=thisr++)if(1===n.nodeType&&-1<(" "+vt(yt(n))+" ").indexOf(t))return!0;return!1}});var xt=/\r/g;S.fn.extend({val:function(n){var r,e,i,t=this0;return arguments.length?(i=m(n),this.each(function(e){var t;1===this.nodeType&&(null==(t=i?n.call(this,e,S(this).val()):n)?t="":"number"==typeof t?t+="":Array.isArray(t)&&(t=S.map(t,function(e){return null==e?"":e+""})),(r=S.valHooksthis.type||S.valHooksthis.nodeName.toLowerCase())&&"set"in r&&void 0!==r.set(this,t,"value")||(this.value=t))})):t?(r=S.valHookst.type||S.valHookst.nodeName.toLowerCase())&&"get"in r&&void 0!==(e=r.get(t,"value"))?e:"string"==typeof(e=t.value)?e.replace(xt,""):null==e?"":e:void 0}}),S.extend({valHooks:{option:{get:function(e){var t=S.find.attr(e,"value");return null!=t?t:vt(S.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:,u=a?o+1:i.length;for(r=o<0?u:a?o:0;r<u;r++)if(((n=ir).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=S(n).val(),a)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=S.makeArray(t),a=i.length;while(a--)((r=ia).selected=-1<S.inArray(S.valHooks.option.get(r),o))&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),S.each("radio","checkbox",function(){S.valHooksthis={set:function(e,t){if(Array.isArray(t))return e.checked=-1<S.inArray(S(e).val(),t)}},y.checkOn||(S.valHooksthis.get=function(e){return null===e.getAttribute("value")?"on":e.value})}),y.focusin="onfocusin"in C;var bt=/^(?:focusinfocus|focusoutblur)$/,wt=function(e){e.stopPropagation()};S.extend(S.event,{trigger:function(e,t,n,r){var i,o,a,s,u,l,c,f,p=n||E,d=v.call(e,"type")?e.type:e,h=v.call(e,"namespace")?e.namespace.split("."):;if(o=f=a=n=n||E,3!==n.nodeType&&8!==n.nodeType&&!bt.test(d+S.event.triggered)&&(-1<d.indexOf(".")&&(d=(h=d.split(".")).shift(),h.sort()),u=d.indexOf(":")<0&&"on"+d,(e=eS.expando?e:new S.Event(d,"object"==typeof e&&e)).isTrigger=r?2:3,e.namespace=h.join("."),e.rnamespace=e.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,e.result=void 0,e.target||(e.target=n),t=null==t?e:S.makeArray(t,e),c=S.event.speciald||{},r||!c.trigger||!1!==c.trigger.apply(n,t))){if(!r&&!c.noBubble&&!x(n)){for(s=c.delegateType||d,bt.test(s+d)||(o=o.parentNode);o;o=o.parentNode)p.push(o),a=o;a===(n.ownerDocument||E)&&p.push(a.defaultView||a.parentWindow||C)}i=0;while((o=pi++)&&!e.isPropagationStopped())f=o,e.type=1<i?s:c.bindType||d,(l=(Y.get(o,"events")||Object.create(null))e.type&&Y.get(o,"handle"))&&l.apply(o,t),(l=u&&ou)&&l.apply&&V(o)&&(e.result=l.apply(o,t),!1===e.result&&e.preventDefault());return e.type=d,r||e.isDefaultPrevented()||c._default&&!1!==c._default.apply(p.pop(),t)||!V(n)||u&&m(nd)&&!x(n)&&((a=nu)&&(nu=null),S.event.triggered=d,e.isPropagationStopped()&&f.addEventListener(d,wt),nd(),e.isPropagationStopped()&&f.removeEventListener(d,wt),S.event.triggered=void 0,a&&(nu=a)),e.result}},simulate:function(e,t,n){var r=S.extend(new S.Event,n,{type:e,isSimulated:!0});S.event.trigger(r,null,t)}}),S.fn.extend({trigger:function(e,t){return this.each(function(){S.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this0;if(n)return S.event.trigger(e,t,n,!0)}}),y.focusin||S.each({focus:"focusin",blur:"focusout"},function(n,r){var i=function(e){S.event.simulate(r,e.target,S.event.fix(e))};S.event.specialr={setup:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r);t||e.addEventListener(n,i,!0),Y.access(e,r,(t||0)+1)},teardown:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r)-1;t?Y.access(e,r,t):(e.removeEventListener(n,i,!0),Y.remove(e,r))}}});var Tt=C.location,Ct={guid:Date.now()},Et=/\?/;S.parseXML=function(e){var t;if(!e||"string"!=typeof e)return null;try{t=(new C.DOMParser).parseFromString(e,"text/xml")}catch(e){t=void 0}return t&&!t.getElementsByTagName("parsererror").length||S.error("Invalid XML: "+e),t};var St=/\\$/,kt=/\r?\n/g,At=/^(?:submit|button|image|reset|file)$/i,Nt=/^(?:input|select|textarea|keygen)/i;function Dt(n,e,r,i){var t;if(Array.isArray(e))S.each(e,function(e,t){r||St.test(n)?i(n,t):Dt(n+""+("object"==typeof t&&null!=t?e:"")+"",t,r,i)});else if(r||"object"!==w(e))i(n,e);else for(t in e)Dt(n+""+t+"",et,r,i)}S.param=function(e,t){var n,r=,i=function(e,t){var n=m(t)?t():t;rr.length=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(null==e)return"";if(Array.isArray(e)||e.jquery&&!S.isPlainObject(e))S.each(e,function(){i(this.name,this.value)});else for(n in e)Dt(n,en,t,i);return r.join("&")},S.fn.extend({serialize:function(){return S.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=S.prop(this,"elements");return e?S.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!S(this).is(":disabled")&&Nt.test(this.nodeName)&&!At.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=S(this).val();return null==n?null:Array.isArray(n)?S.map(n,function(e){return{name:t.name,value:e.replace(kt,"\r\n")}}):{name:t.name,value:n.replace(kt,"\r\n")}}).get()}});var jt=/%20/g,qt=/#.*$/,Lt=/(?&)_=^&*/,Ht=/^(.*?): \t*(^\r\n*)$/gm,Ot=/^(?:GET|HEAD)$/,Pt=/^\/\//,Rt={},Mt={},It="*/".concat("*"),Wt=E.createElement("a");function Ft(o){return function(e,t){"string"!=typeof e&&(t=e,e="*");var n,r=0,i=e.toLowerCase().match(P)||;if(m(t))while(n=ir++)"+"===n0?(n=n.slice(1)||"*",(on=on||).unshift(t)):(on=on||).push(t)}}function Bt(t,i,o,a){var s={},u=t===Mt;function l(e){var r;return se=!0,S.each(te||,function(e,t){var n=t(i,o,a);return"string"!=typeof n||u||sn?u?!(r=n):void 0:(i.dataTypes.unshift(n),l(n),!1)}),r}return l(i.dataTypes0)||!s"*"&&l("*")}function $t(e,t){var n,r,i=S.ajaxSettings.flatOptions||{};for(n in t)void 0!==tn&&((in?e:r||(r={}))n=tn);return r&&S.extend(!0,e,r),e}Wt.href=Tt.href,S.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Tt.href,type:"GET",isLocal:/^(?:about|app|app-storage|.+-extension|file|res|widget):$/.test(Tt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":It,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":S.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?$t($t(e,S.ajaxSettings),t):$t(S.ajaxSettings,e)},ajaxPrefilter:Ft(Rt),ajaxTransport:Ft(Mt),ajax:function(e,t){"object"==typeof e&&(t=e,e=void 0),t=t||{};var c,f,p,n,d,r,h,g,i,o,v=S.ajaxSetup({},t),y=v.context||v,m=v.context&&(y.nodeType||y.jquery)?S(y):S.event,x=S.Deferred(),b=S.Callbacks("once memory"),w=v.statusCode||{},a={},s={},u="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(h){if(!n){n={};while(t=Ht.exec(p))nt1.toLowerCase()+" "=(nt1.toLowerCase()+" "||).concat(t2)}t=ne.toLowerCase()+" "}return null==t?null:t.join(", ")},getAllResponseHeaders:function(){return h?p:null},setRequestHeader:function(e,t){return null==h&&(e=se.toLowerCase()=se.toLowerCase()||e,ae=t),this},overrideMimeType:function(e){return null==h&&(v.mimeType=e),this},statusCode:function(e){var t;if(e)if(h)T.always(eT.status);else for(t in e)wt=wt,et;return this},abort:function(e){var t=e||u;return c&&c.abort(t),l(0,t),this}};if(x.promise(T),v.url=((e||v.url||Tt.href)+"").replace(Pt,Tt.protocol+"//"),v.type=t.method||t.type||v.method||v.type,v.dataTypes=(v.dataType||"*").toLowerCase().match(P)||"",null==v.crossDomain){r=E.createElement("a");try{r.href=v.url,r.href=r.href,v.crossDomain=Wt.protocol+"//"+Wt.host!=r.protocol+"//"+r.host}catch(e){v.crossDomain=!0}}if(v.data&&v.processData&&"string"!=typeof v.data&&(v.data=S.param(v.data,v.traditional)),Bt(Rt,v,t,T),h)return T;for(i in(g=S.event&&v.global)&&0==S.active++&&S.event.trigger("ajaxStart"),v.type=v.type.toUpperCase(),v.hasContent=!Ot.test(v.type),f=v.url.replace(qt,""),v.hasContent?v.data&&v.processData&&0===(v.contentType||"").indexOf("application/x-www-form-urlencoded")&&(v.data=v.data.replace(jt,"+")):(o=v.url.slice(f.length),v.data&&(v.processData||"string"==typeof v.data)&&(f+=(Et.test(f)?"&":"?")+v.data,delete v.data),!1===v.cache&&(f=f.replace(Lt,"$1"),o=(Et.test(f)?"&":"?")+"_="+Ct.guid+++o),v.url=f+o),v.ifModified&&(S.lastModifiedf&&T.setRequestHeader("If-Modified-Since",S.lastModifiedf),S.etagf&&T.setRequestHeader("If-None-Match",S.etagf)),(v.data&&v.hasContent&&!1!==v.contentType||t.contentType)&&T.setRequestHeader("Content-Type",v.contentType),T.setRequestHeader("Accept",v.dataTypes0&&v.acceptsv.dataTypes0?v.acceptsv.dataTypes0+("*"!==v.dataTypes0?", "+It+"; q=0.01":""):v.accepts"*"),v.headers)T.setRequestHeader(i,v.headersi);if(v.beforeSend&&(!1===v.beforeSend.call(y,T,v)||h))return T.abort();if(u="abort",b.add(v.complete),T.done(v.success),T.fail(v.error),c=Bt(Mt,v,t,T)){if(T.readyState=1,g&&m.trigger("ajaxSend",T,v),h)return T;v.async&&0<v.timeout&&(d=C.setTimeout(function(){T.abort("timeout")},v.timeout));try{h=!1,c.send(a,l)}catch(e){if(h)throw e;l(-1,e)}}else l(-1,"No Transport");function l(e,t,n,r){var i,o,a,s,u,l=t;h||(h=!0,d&&C.clearTimeout(d),c=void 0,p=r||"",T.readyState=0<e?4:0,i=200<=e&&e<300||304===e,n&&(s=function(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u0)u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(si&&si.test(r)){u.unshift(i);break}if(u0in n)o=u0;else{for(i in n){if(!u0||e.convertersi+" "+u0){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u0&&u.unshift(o),no}(v,T,n)),!i&&-1<S.inArray("script",v.dataTypes)&&(v.converters"text script"=function(){}),s=function(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c1)for(a in e.converters)la.toLowerCase()=e.convertersa;o=c.shift();while(o)if(e.responseFieldso&&(ne.responseFieldso=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=lu+" "+o||l"* "+o))for(i in l)if((s=i.split(" "))1===o&&(a=lu+" "+s0||l"* "+s0)){!0===a?a=li:!0!==li&&(o=s0,c.unshift(s1));break}if(!0!==a)if(a&&e"throws")t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}(v,s,T,i),i?(v.ifModified&&((u=T.getResponseHeader("Last-Modified"))&&(S.lastModifiedf=u),(u=T.getResponseHeader("etag"))&&(S.etagf=u)),204===e||"HEAD"===v.type?l="nocontent":304===e?l="notmodified":(l=s.state,o=s.data,i=!(a=s.error))):(a=l,!e&&l||(l="error",e<0&&(e=0))),T.status=e,T.statusText=(t||l)+"",i?x.resolveWith(y,o,l,T):x.rejectWith(y,T,l,a),T.statusCode(w),w=void 0,g&&m.trigger(i?"ajaxSuccess":"ajaxError",T,v,i?o:a),b.fireWith(y,T,l),g&&(m.trigger("ajaxComplete",T,v),--S.active||S.event.trigger("ajaxStop")))}return T},getJSON:function(e,t,n){return S.get(e,t,n,"json")},getScript:function(e,t){return S.get(e,void 0,t,"script")}}),S.each("get","post",function(e,i){Si=function(e,t,n,r){return m(t)&&(r=r||n,n=t,t=void 0),S.ajax(S.extend({url:e,type:i,dataType:r,data:t,success:n},S.isPlainObject(e)&&e))}}),S.ajaxPrefilter(function(e){var t;for(t in e.headers)"content-type"===t.toLowerCase()&&(e.contentType=e.headerst||"")}),S._evalUrl=function(e,t,n){return S.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,converters:{"text script":function(){}},dataFilter:function(e){S.globalEval(e,t,n)}})},S.fn.extend({wrapAll:function(e){var t;return this0&&(m(e)&&(e=e.call(this0)),t=S(e,this0.ownerDocument).eq(0).clone(!0),this0.parentNode&&t.insertBefore(this0),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(n){return m(n)?this.each(function(e){S(this).wrapInner(n.call(this,e))}):this.each(function(){var e=S(this),t=e.contents();t.length?t.wrapAll(n):e.append(n)})},wrap:function(t){var n=m(t);return this.each(function(e){S(this).wrapAll(n?t.call(this,e):t)})},unwrap:function(e){return this.parent(e).not("body").each(function(){S(this).replaceWith(this.childNodes)}),this}}),S.expr.pseudos.hidden=function(e){return!S.expr.pseudos.visible(e)},S.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},S.ajaxSettings.xhr=function(){try{return new C.XMLHttpRequest}catch(e){}};var _t={0:200,1223:204},zt=S.ajaxSettings.xhr();y.cors=!!zt&&"withCredentials"in zt,y.ajax=zt=!!zt,S.ajaxTransport(function(i){var o,a;if(y.cors||zt&&!i.crossDomain)return{send:function(e,t){var n,r=i.xhr();if(r.open(i.type,i.url,i.async,i.username,i.password),i.xhrFields)for(n in i.xhrFields)rn=i.xhrFieldsn;for(n in i.mimeType&&r.overrideMimeType&&r.overrideMimeType(i.mimeType),i.crossDomain||e"X-Requested-With"||(e"X-Requested-With"="XMLHttpRequest"),e)r.setRequestHeader(n,en);o=function(e){return function(){o&&(o=a=r.onload=r.onerror=r.onabort=r.ontimeout=r.onreadystatechange=null,"abort"===e?r.abort():"error"===e?"number"!=typeof r.status?t(0,"error"):t(r.status,r.statusText):t(_tr.status||r.status,r.statusText,"text"!==(r.responseType||"text")||"string"!=typeof r.responseText?{binary:r.response}:{text:r.responseText},r.getAllResponseHeaders()))}},r.onload=o(),a=r.onerror=r.ontimeout=o("error"),void 0!==r.onabort?r.onabort=a:r.onreadystatechange=function(){4===r.readyState&&C.setTimeout(function(){o&&a()})},o=o("abort");try{r.send(i.hasContent&&i.data||null)}catch(e){if(o)throw e}},abort:function(){o&&o()}}}),S.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),S.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return S.globalEval(e),e}}}),S.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),S.ajaxTransport("script",function(n){var r,i;if(n.crossDomain||n.scriptAttrs)return{send:function(e,t){r=S("<script>").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r0)},abort:function(){i&&i()}}});var Ut,Xt=,Vt=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Xt.pop()||S.expando+"_"+Ct.guid++;return thise=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Vt.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Vt.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes0)return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?ea=ea.replace(Vt,"$1"+r):!1!==e.jsonp&&(e.url+=(Et.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters"script json"=function(){return o||S.error(r+" was not called"),o0},e.dataTypes0="json",i=Cr,Cr=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):Cr=i,er&&(e.jsonpCallback=t.jsonpCallback,Xt.push(r)),o&&m(i)&&i(o0),o=i=void 0}),"script"}),y.createHTMLDocument=((Ut=E.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===Ut.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&,(i=N.exec(e))?t.createElement(i1):(i=xe(e,t,o),o&&o.length&&S(o).remove(),S.merge(,i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1<s&&(r=vt(e.slice(s)),e=e.slice(0,s)),m(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),0<a.length&&S.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,a.html(r?S("<div>").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||e.responseText,t,e)})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):("number"==typeof f.top&&(f.top+="px"),"number"==typeof f.left&&(f.left+="px"),c.css(f))}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this0;return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this0){var e,t,n,r=this0,i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fnt=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?ri:et;r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):et=n},t,e,arguments.length)}}),S.each("top","left",function(e,n){S.cssHooksn=$e(y.pixelPosition,function(e,t){if(t)return t=Be(e,n),Me.test(t)?S(e).position()n+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fno=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e"inner"+a:e.document.documentElement"client"+a:9===e.nodeType?(r=e.documentElement,Math.max(e.body"scroll"+a,r"scroll"+a,e.body"offset"+a,r"offset"+a,r"client"+a)):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each("ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend",function(e,t){S.fnt=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fnn=function(e,t){return 0<arguments.length?this.on(n,null,e,t):this.trigger(n)}});var Gt=/^\s\uFEFF\xA0+|\s\uFEFF\xA0+$/g;S.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=et,t=e,e=n),m(e))return r=s.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(s.call(arguments)))}).guid=e.guid=e.guid||S.guid++,i},S.holdReady=function(e){e?S.readyWait++:S.ready(!0)},S.isArray=Array.isArray,S.parseJSON=JSON.parse,S.nodeName=A,S.isFunction=m,S.isWindow=x,S.camelCase=X,S.type=w,S.now=Date.now,S.isNumeric=function(e){var t=S.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},S.trim=function(e){return null==e?"":(e+"").replace(Gt,"")},"function"==typeof define&&define.amd&&define("jquery",,function(){return S});var Yt=C.jQuery,Qt=C.$;return S.noConflict=function(e){return C.$===S&&(C.$=Qt),e&&C.jQuery===S&&(C.jQuery=Yt),S},"undefined"==typeof e&&(C.jQuery=C.$=S),S});

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/underscore-1.13.1.js Deleted

@@ -1,2042 +0,0 @@
-(function (global, factory) {
-  typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
-  typeof define === 'function' && define.amd ? define('underscore', factory) :
-  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, (function () {
-    var current = global._;
-    var exports = global._ = factory();
-    exports.noConflict = function () { global._ = current; return exports; };
-  }()));
-}(this, (function () {
-  //     Underscore.js 1.13.1
-  //     https://underscorejs.org
-  //     (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors
-  //     Underscore may be freely distributed under the MIT license.
-
-  // Current version.
-  var VERSION = '1.13.1';
-
-  // Establish the root object, `window` (`self`) in the browser, `global`
-  // on the server, or `this` in some virtual machines. We use `self`
-  // instead of `window` for `WebWorker` support.
-  var root = typeof self == 'object' && self.self === self && self ||
-            typeof global == 'object' && global.global === global && global ||
-            Function('return this')() ||
-            {};
-
-  // Save bytes in the minified (but not gzipped) version:
-  var ArrayProto = Array.prototype, ObjProto = Object.prototype;
-  var SymbolProto = typeof Symbol !== 'undefined' ? Symbol.prototype : null;
-
-  // Create quick reference variables for speed access to core prototypes.
-  var push = ArrayProto.push,
-      slice = ArrayProto.slice,
-      toString = ObjProto.toString,
-      hasOwnProperty = ObjProto.hasOwnProperty;
-
-  // Modern feature detection.
-  var supportsArrayBuffer = typeof ArrayBuffer !== 'undefined',
-      supportsDataView = typeof DataView !== 'undefined';
-
-  // All **ECMAScript 5+** native function implementations that we hope to use
-  // are declared here.
-  var nativeIsArray = Array.isArray,
-      nativeKeys = Object.keys,
-      nativeCreate = Object.create,
-      nativeIsView = supportsArrayBuffer && ArrayBuffer.isView;
-
-  // Create references to these builtin functions because we override them.
-  var _isNaN = isNaN,
-      _isFinite = isFinite;
-
-  // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed.
-  var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString');
-  var nonEnumerableProps = 'valueOf', 'isPrototypeOf', 'toString',
-    'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString';
-
-  // The largest integer that can be represented exactly.
-  var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1;
-
-  // Some functions take a variable number of arguments, or a few expected
-  // arguments at the beginning and then a variable number of values to operate
-  // on. This helper accumulates all remaining arguments past the function’s
-  // argument length (or an explicit `startIndex`), into an array that becomes
-  // the last argument. Similar to ES6’s "rest parameter".
-  function restArguments(func, startIndex) {
-    startIndex = startIndex == null ? func.length - 1 : +startIndex;
-    return function() {
-      var length = Math.max(arguments.length - startIndex, 0),
-          rest = Array(length),
-          index = 0;
-      for (; index < length; index++) {
-        restindex = argumentsindex + startIndex;
-      }
-      switch (startIndex) {
-        case 0: return func.call(this, rest);
-        case 1: return func.call(this, arguments0, rest);
-        case 2: return func.call(this, arguments0, arguments1, rest);
-      }
-      var args = Array(startIndex + 1);
-      for (index = 0; index < startIndex; index++) {
-        argsindex = argumentsindex;
-      }
-      argsstartIndex = rest;
-      return func.apply(this, args);
-    };
-  }
-
-  // Is a given variable an object?
-  function isObject(obj) {
-    var type = typeof obj;
-    return type === 'function' || type === 'object' && !!obj;
-  }
-
-  // Is a given value equal to null?
-  function isNull(obj) {
-    return obj === null;
-  }
-
-  // Is a given variable undefined?
-  function isUndefined(obj) {
-    return obj === void 0;
-  }
-
-  // Is a given value a boolean?
-  function isBoolean(obj) {
-    return obj === true || obj === false || toString.call(obj) === 'object Boolean';
-  }
-
-  // Is a given value a DOM element?
-  function isElement(obj) {
-    return !!(obj && obj.nodeType === 1);
-  }
-
-  // Internal function for creating a `toString`-based type tester.
-  function tagTester(name) {
-    var tag = 'object ' + name + '';
-    return function(obj) {
-      return toString.call(obj) === tag;
-    };
-  }
-
-  var isString = tagTester('String');
-
-  var isNumber = tagTester('Number');
-
-  var isDate = tagTester('Date');
-
-  var isRegExp = tagTester('RegExp');
-
-  var isError = tagTester('Error');
-
-  var isSymbol = tagTester('Symbol');
-
-  var isArrayBuffer = tagTester('ArrayBuffer');
-
-  var isFunction = tagTester('Function');
-
-  // Optimize `isFunction` if appropriate. Work around some `typeof` bugs in old
-  // v8, IE 11 (#1621), Safari 8 (#1929), and PhantomJS (#2236).
-  var nodelist = root.document && root.document.childNodes;
-  if (typeof /./ != 'function' && typeof Int8Array != 'object' && typeof nodelist != 'function') {
-    isFunction = function(obj) {
-      return typeof obj == 'function' || false;
-    };
-  }
-
-  var isFunction$1 = isFunction;
-
-  var hasObjectTag = tagTester('Object');
-
-  // In IE 10 - Edge 13, `DataView` has string tag `'object Object'`.
-  // In IE 11, the most common among them, this problem also applies to
-  // `Map`, `WeakMap` and `Set`.
-  var hasStringTagBug = (
-        supportsDataView && hasObjectTag(new DataView(new ArrayBuffer(8)))
-      ),
-      isIE11 = (typeof Map !== 'undefined' && hasObjectTag(new Map));
-
-  var isDataView = tagTester('DataView');
-
-  // In IE 10 - Edge 13, we need a different heuristic
-  // to determine whether an object is a `DataView`.
-  function ie10IsDataView(obj) {
-    return obj != null && isFunction$1(obj.getInt8) && isArrayBuffer(obj.buffer);
-  }
-
-  var isDataView$1 = (hasStringTagBug ? ie10IsDataView : isDataView);
-
-  // Is a given value an array?
-  // Delegates to ECMA5's native `Array.isArray`.
-  var isArray = nativeIsArray || tagTester('Array');
-
-  // Internal function to check whether `key` is an own property name of `obj`.
-  function has$1(obj, key) {
-    return obj != null && hasOwnProperty.call(obj, key);
-  }
-
-  var isArguments = tagTester('Arguments');
-
-  // Define a fallback version of the method in browsers (ahem, IE < 9), where
-  // there isn't any inspectable "Arguments" type.
-  (function() {
-    if (!isArguments(arguments)) {
-      isArguments = function(obj) {
-        return has$1(obj, 'callee');
-      };
-    }
-  }());
-
-  var isArguments$1 = isArguments;
-
-  // Is a given object a finite number?
-  function isFinite$1(obj) {
-    return !isSymbol(obj) && _isFinite(obj) && !isNaN(parseFloat(obj));
-  }
-
-  // Is the given value `NaN`?
-  function isNaN$1(obj) {
-    return isNumber(obj) && _isNaN(obj);
-  }
-
-  // Predicate-generating function. Often useful outside of Underscore.
-  function constant(value) {
-    return function() {
-      return value;
-    };
-  }
-
-  // Common internal logic for `isArrayLike` and `isBufferLike`.
-  function createSizePropertyCheck(getSizeProperty) {
-    return function(collection) {
-      var sizeProperty = getSizeProperty(collection);
-      return typeof sizeProperty == 'number' && sizeProperty >= 0 && sizeProperty <= MAX_ARRAY_INDEX;
-    }
-  }
-
-  // Internal helper to generate a function to obtain property `key` from `obj`.
-  function shallowProperty(key) {
-    return function(obj) {
-      return obj == null ? void 0 : objkey;
-    };
-  }
-
-  // Internal helper to obtain the `byteLength` property of an object.
-  var getByteLength = shallowProperty('byteLength');
-
-  // Internal helper to determine whether we should spend extensive checks against
-  // `ArrayBuffer` et al.
-  var isBufferLike = createSizePropertyCheck(getByteLength);
-
-  // Is a given value a typed array?
-  var typedArrayPattern = /\object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\/;
-  function isTypedArray(obj) {
-    // `ArrayBuffer.isView` is the most future-proof, so use it when available.
-    // Otherwise, fall back on the above regular expression.
-    return nativeIsView ? (nativeIsView(obj) && !isDataView$1(obj)) :
-                  isBufferLike(obj) && typedArrayPattern.test(toString.call(obj));
-  }
-
-  var isTypedArray$1 = supportsArrayBuffer ? isTypedArray : constant(false);
-
-  // Internal helper to obtain the `length` property of an object.
-  var getLength = shallowProperty('length');
-
-  // Internal helper to create a simple lookup structure.
-  // `collectNonEnumProps` used to depend on `_.contains`, but this led to
-  // circular imports. `emulatedSet` is a one-off solution that only works for
-  // arrays of strings.
-  function emulatedSet(keys) {
-    var hash = {};
-    for (var l = keys.length, i = 0; i < l; ++i) hashkeysi = true;
-    return {
-      contains: function(key) { return hashkey; },
-      push: function(key) {
-        hashkey = true;
-        return keys.push(key);
-      }
-    };
-  }
-
-  // Internal helper. Checks `keys` for the presence of keys in IE < 9 that won't
-  // be iterated by `for key in ...` and thus missed. Extends `keys` in place if
-  // needed.
-  function collectNonEnumProps(obj, keys) {
-    keys = emulatedSet(keys);
-    var nonEnumIdx = nonEnumerableProps.length;
-    var constructor = obj.constructor;
-    var proto = isFunction$1(constructor) && constructor.prototype || ObjProto;
-
-    // Constructor is a special case.
-    var prop = 'constructor';
-    if (has$1(obj, prop) && !keys.contains(prop)) keys.push(prop);
-
-    while (nonEnumIdx--) {
-      prop = nonEnumerablePropsnonEnumIdx;
-      if (prop in obj && objprop !== protoprop && !keys.contains(prop)) {
-        keys.push(prop);
-      }
-    }
-  }
-
-  // Retrieve the names of an object's own properties.
-  // Delegates to **ECMAScript 5**'s native `Object.keys`.
-  function keys(obj) {
-    if (!isObject(obj)) return ;
-    if (nativeKeys) return nativeKeys(obj);
-    var keys = ;
-    for (var key in obj) if (has$1(obj, key)) keys.push(key);
-    // Ahem, IE < 9.
-    if (hasEnumBug) collectNonEnumProps(obj, keys);
-    return keys;
-  }
-
-  // Is a given array, string, or object empty?
-  // An "empty" object has no enumerable own-properties.
-  function isEmpty(obj) {
-    if (obj == null) return true;
-    // Skip the more expensive `toString`-based type checks if `obj` has no
-    // `.length`.
-    var length = getLength(obj);
-    if (typeof length == 'number' && (
-      isArray(obj) || isString(obj) || isArguments$1(obj)
-    )) return length === 0;
-    return getLength(keys(obj)) === 0;
-  }
-
-  // Returns whether an object has a given set of `key:value` pairs.
-  function isMatch(object, attrs) {
-    var _keys = keys(attrs), length = _keys.length;
-    if (object == null) return !length;
-    var obj = Object(object);
-    for (var i = 0; i < length; i++) {
-      var key = _keysi;
-      if (attrskey !== objkey || !(key in obj)) return false;
-    }
-    return true;
-  }
-
-  // If Underscore is called as a function, it returns a wrapped object that can
-  // be used OO-style. This wrapper holds altered versions of all functions added
-  // through `_.mixin`. Wrapped objects may be chained.
-  function _$1(obj) {
-    if (obj instanceof _$1) return obj;
-    if (!(this instanceof _$1)) return new _$1(obj);
-    this._wrapped = obj;
-  }
-
-  _$1.VERSION = VERSION;
-
-  // Extracts the result from a wrapped and chained object.
-  _$1.prototype.value = function() {
-    return this._wrapped;
-  };
-
-  // Provide unwrapping proxies for some methods used in engine operations
-  // such as arithmetic and JSON stringification.
-  _$1.prototype.valueOf = _$1.prototype.toJSON = _$1.prototype.value;
-
-  _$1.prototype.toString = function() {
-    return String(this._wrapped);
-  };
-
-  // Internal function to wrap or shallow-copy an ArrayBuffer,
-  // typed array or DataView to a new view, reusing the buffer.
-  function toBufferView(bufferSource) {
-    return new Uint8Array(
-      bufferSource.buffer || bufferSource,
-      bufferSource.byteOffset || 0,
-      getByteLength(bufferSource)
-    );
-  }
-
-  // We use this string twice, so give it a name for minification.
-  var tagDataView = 'object DataView';
-
-  // Internal recursive comparison function for `_.isEqual`.
-  function eq(a, b, aStack, bStack) {
-    // Identical objects are equal. `0 === -0`, but they aren't identical.
-    // See the Harmony `egal` proposal(https://wiki.ecmascript.org/doku.php?id=harmony:egal).
-    if (a === b) return a !== 0 || 1 / a === 1 / b;
-    // `null` or `undefined` only equal to itself (strict comparison).
-    if (a == null || b == null) return false;
-    // `NaN`s are equivalent, but non-reflexive.
-    if (a !== a) return b !== b;
-    // Exhaust primitive checks
-    var type = typeof a;
-    if (type !== 'function' && type !== 'object' && typeof b != 'object') return false;
-    return deepEq(a, b, aStack, bStack);
-  }
-
-  // Internal recursive comparison function for `_.isEqual`.
-  function deepEq(a, b, aStack, bStack) {
-    // Unwrap any wrapped objects.
-    if (a instanceof _$1) a = a._wrapped;
-    if (b instanceof _$1) b = b._wrapped;
-    // Compare `Class` names.
-    var className = toString.call(a);
-    if (className !== toString.call(b)) return false;
-    // Work around a bug in IE 10 - Edge 13.
-    if (hasStringTagBug && className == 'object Object' && isDataView$1(a)) {
-      if (!isDataView$1(b)) return false;
-      className = tagDataView;
-    }
-    switch (className) {
-      // These types are compared by value.
-      case 'object RegExp':
-        // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i')
-      case 'object String':
-        // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is
-        // equivalent to `new String("5")`.
-        return '' + a === '' + b;
-      case 'object Number':
-        // `NaN`s are equivalent, but non-reflexive.
-        // Object(NaN) is equivalent to NaN.
-        if (+a !== +a) return +b !== +b;
-        // An `egal` comparison is performed for other numeric values.
-        return +a === 0 ? 1 / +a === 1 / b : +a === +b;
-      case 'object Date':
-      case 'object Boolean':
-        // Coerce dates and booleans to numeric primitive values. Dates are compared by their
-        // millisecond representations. Note that invalid dates with millisecond representations
-        // of `NaN` are not equivalent.
-        return +a === +b;
-      case 'object Symbol':
-        return SymbolProto.valueOf.call(a) === SymbolProto.valueOf.call(b);
-      case 'object ArrayBuffer':
-      case tagDataView:
-        // Coerce to typed array so we can fall through.
-        return deepEq(toBufferView(a), toBufferView(b), aStack, bStack);
-    }
-
-    var areArrays = className === 'object Array';
-    if (!areArrays && isTypedArray$1(a)) {
-        var byteLength = getByteLength(a);
-        if (byteLength !== getByteLength(b)) return false;
-        if (a.buffer === b.buffer && a.byteOffset === b.byteOffset) return true;
-        areArrays = true;
-    }
-    if (!areArrays) {
-      if (typeof a != 'object' || typeof b != 'object') return false;
-
-      // Objects with different constructors are not equivalent, but `Object`s or `Array`s
-      // from different frames are.
-      var aCtor = a.constructor, bCtor = b.constructor;
-      if (aCtor !== bCtor && !(isFunction$1(aCtor) && aCtor instanceof aCtor &&
-                               isFunction$1(bCtor) && bCtor instanceof bCtor)
-                          && ('constructor' in a && 'constructor' in b)) {
-        return false;
-      }
-    }
-    // Assume equality for cyclic structures. The algorithm for detecting cyclic
-    // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
-
-    // Initializing stack of traversed objects.
-    // It's done here since we only need them for objects and arrays comparison.
-    aStack = aStack || ;
-    bStack = bStack || ;
-    var length = aStack.length;
-    while (length--) {
-      // Linear search. Performance is inversely proportional to the number of
-      // unique nested structures.
-      if (aStacklength === a) return bStacklength === b;
-    }
-
-    // Add the first object to the stack of traversed objects.
-    aStack.push(a);
-    bStack.push(b);
-
-    // Recursively compare objects and arrays.
-    if (areArrays) {
-      // Compare array lengths to determine if a deep comparison is necessary.
-      length = a.length;
-      if (length !== b.length) return false;
-      // Deep compare the contents, ignoring non-numeric properties.
-      while (length--) {
-        if (!eq(alength, blength, aStack, bStack)) return false;
-      }
-    } else {
-      // Deep compare objects.
-      var _keys = keys(a), key;
-      length = _keys.length;
-      // Ensure that both objects contain the same number of properties before comparing deep equality.
-      if (keys(b).length !== length) return false;
-      while (length--) {
-        // Deep compare each member
-        key = _keyslength;
-        if (!(has$1(b, key) && eq(akey, bkey, aStack, bStack))) return false;
-      }
-    }
-    // Remove the first object from the stack of traversed objects.
-    aStack.pop();
-    bStack.pop();
-    return true;
-  }
-
-  // Perform a deep comparison to check if two objects are equal.
-  function isEqual(a, b) {
-    return eq(a, b);
-  }
-
-  // Retrieve all the enumerable property names of an object.
-  function allKeys(obj) {
-    if (!isObject(obj)) return ;
-    var keys = ;
-    for (var key in obj) keys.push(key);
-    // Ahem, IE < 9.
-    if (hasEnumBug) collectNonEnumProps(obj, keys);
-    return keys;
-  }
-
-  // Since the regular `Object.prototype.toString` type tests don't work for
-  // some types in IE 11, we use a fingerprinting heuristic instead, based
-  // on the methods. It's not great, but it's the best we got.
-  // The fingerprint method lists are defined below.
-  function ie11fingerprint(methods) {
-    var length = getLength(methods);
-    return function(obj) {
-      if (obj == null) return false;
-      // `Map`, `WeakMap` and `Set` have no enumerable keys.
-      var keys = allKeys(obj);
-      if (getLength(keys)) return false;
-      for (var i = 0; i < length; i++) {
-        if (!isFunction$1(objmethodsi)) return false;
-      }
-      // If we are testing against `WeakMap`, we need to ensure that
-      // `obj` doesn't have a `forEach` method in order to distinguish
-      // it from a regular `Map`.
-      return methods !== weakMapMethods || !isFunction$1(objforEachName);
-    };
-  }
-
-  // In the interest of compact minification, we write
-  // each string in the fingerprints only once.
-  var forEachName = 'forEach',
-      hasName = 'has',
-      commonInit = 'clear', 'delete',
-      mapTail = 'get', hasName, 'set';
-
-  // `Map`, `WeakMap` and `Set` each have slightly different
-  // combinations of the above sublists.
-  var mapMethods = commonInit.concat(forEachName, mapTail),
-      weakMapMethods = commonInit.concat(mapTail),
-      setMethods = 'add'.concat(commonInit, forEachName, hasName);
-
-  var isMap = isIE11 ? ie11fingerprint(mapMethods) : tagTester('Map');
-
-  var isWeakMap = isIE11 ? ie11fingerprint(weakMapMethods) : tagTester('WeakMap');
-
-  var isSet = isIE11 ? ie11fingerprint(setMethods) : tagTester('Set');
-
-  var isWeakSet = tagTester('WeakSet');
-
-  // Retrieve the values of an object's properties.
-  function values(obj) {
-    var _keys = keys(obj);
-    var length = _keys.length;
-    var values = Array(length);
-    for (var i = 0; i < length; i++) {
-      valuesi = obj_keysi;
-    }
-    return values;
-  }
-
-  // Convert an object into a list of `key, value` pairs.
-  // The opposite of `_.object` with one argument.
-  function pairs(obj) {
-    var _keys = keys(obj);
-    var length = _keys.length;
-    var pairs = Array(length);
-    for (var i = 0; i < length; i++) {
-      pairsi = _keysi, obj_keysi;
-    }
-    return pairs;
-  }
-
-  // Invert the keys and values of an object. The values must be serializable.
-  function invert(obj) {
-    var result = {};
-    var _keys = keys(obj);
-    for (var i = 0, length = _keys.length; i < length; i++) {
-      resultobj_keysi = _keysi;
-    }
-    return result;
-  }
-
-  // Return a sorted list of the function names available on the object.
-  function functions(obj) {
-    var names = ;
-    for (var key in obj) {
-      if (isFunction$1(objkey)) names.push(key);
-    }
-    return names.sort();
-  }
-
-  // An internal function for creating assigner functions.
-  function createAssigner(keysFunc, defaults) {
-    return function(obj) {
-      var length = arguments.length;
-      if (defaults) obj = Object(obj);
-      if (length < 2 || obj == null) return obj;
-      for (var index = 1; index < length; index++) {
-        var source = argumentsindex,
-            keys = keysFunc(source),
-            l = keys.length;
-        for (var i = 0; i < l; i++) {
-          var key = keysi;
-          if (!defaults || objkey === void 0) objkey = sourcekey;
-        }
-      }
-      return obj;
-    };
-  }
-
-  // Extend a given object with all the properties in passed-in object(s).
-  var extend = createAssigner(allKeys);
-
-  // Assigns a given object with all the own properties in the passed-in
-  // object(s).
-  // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign)
-  var extendOwn = createAssigner(keys);
-
-  // Fill in a given object with default properties.
-  var defaults = createAssigner(allKeys, true);
-
-  // Create a naked function reference for surrogate-prototype-swapping.
-  function ctor() {
-    return function(){};
-  }
-
-  // An internal function for creating a new object that inherits from another.
-  function baseCreate(prototype) {
-    if (!isObject(prototype)) return {};
-    if (nativeCreate) return nativeCreate(prototype);
-    var Ctor = ctor();
-    Ctor.prototype = prototype;
-    var result = new Ctor;
-    Ctor.prototype = null;
-    return result;
-  }
-
-  // Creates an object that inherits from the given prototype object.
-  // If additional properties are provided then they will be added to the
-  // created object.
-  function create(prototype, props) {
-    var result = baseCreate(prototype);
-    if (props) extendOwn(result, props);
-    return result;
-  }
-
-  // Create a (shallow-cloned) duplicate of an object.
-  function clone(obj) {
-    if (!isObject(obj)) return obj;
-    return isArray(obj) ? obj.slice() : extend({}, obj);
-  }
-
-  // Invokes `interceptor` with the `obj` and then returns `obj`.
-  // The primary purpose of this method is to "tap into" a method chain, in
-  // order to perform operations on intermediate results within the chain.
-  function tap(obj, interceptor) {
-    interceptor(obj);
-    return obj;
-  }
-
-  // Normalize a (deep) property `path` to array.
-  // Like `_.iteratee`, this function can be customized.
-  function toPath$1(path) {
-    return isArray(path) ? path : path;
-  }
-  _$1.toPath = toPath$1;
-
-  // Internal wrapper for `_.toPath` to enable minification.
-  // Similar to `cb` for `_.iteratee`.
-  function toPath(path) {
-    return _$1.toPath(path);
-  }
-
-  // Internal function to obtain a nested property in `obj` along `path`.
-  function deepGet(obj, path) {
-    var length = path.length;
-    for (var i = 0; i < length; i++) {
-      if (obj == null) return void 0;
-      obj = objpathi;
-    }
-    return length ? obj : void 0;
-  }
-
-  // Get the value of the (deep) property on `path` from `object`.
-  // If any property in `path` does not exist or if the value is
-  // `undefined`, return `defaultValue` instead.
-  // The `path` is normalized through `_.toPath`.
-  function get(object, path, defaultValue) {
-    var value = deepGet(object, toPath(path));
-    return isUndefined(value) ? defaultValue : value;
-  }
-
-  // Shortcut function for checking if an object has a given property directly on
-  // itself (in other words, not on a prototype). Unlike the internal `has`
-  // function, this public version can also traverse nested properties.
-  function has(obj, path) {
-    path = toPath(path);
-    var length = path.length;
-    for (var i = 0; i < length; i++) {
-      var key = pathi;
-      if (!has$1(obj, key)) return false;
-      obj = objkey;
-    }
-    return !!length;
-  }
-
-  // Keep the identity function around for default iteratees.
-  function identity(value) {
-    return value;
-  }
-
-  // Returns a predicate for checking whether an object has a given set of
-  // `key:value` pairs.
-  function matcher(attrs) {
-    attrs = extendOwn({}, attrs);
-    return function(obj) {
-      return isMatch(obj, attrs);
-    };
-  }
-
-  // Creates a function that, when passed an object, will traverse that object’s
-  // properties down the given `path`, specified as an array of keys or indices.
-  function property(path) {
-    path = toPath(path);
-    return function(obj) {
-      return deepGet(obj, path);
-    };
-  }
-
-  // Internal function that returns an efficient (for current engines) version
-  // of the passed-in callback, to be repeatedly applied in other Underscore
-  // functions.
-  function optimizeCb(func, context, argCount) {
-    if (context === void 0) return func;
-    switch (argCount == null ? 3 : argCount) {
-      case 1: return function(value) {
-        return func.call(context, value);
-      };
-      // The 2-argument case is omitted because we’re not using it.
-      case 3: return function(value, index, collection) {
-        return func.call(context, value, index, collection);
-      };
-      case 4: return function(accumulator, value, index, collection) {
-        return func.call(context, accumulator, value, index, collection);
-      };
-    }
-    return function() {
-      return func.apply(context, arguments);
-    };
-  }
-
-  // An internal function to generate callbacks that can be applied to each
-  // element in a collection, returning the desired result — either `_.identity`,
-  // an arbitrary callback, a property matcher, or a property accessor.
-  function baseIteratee(value, context, argCount) {
-    if (value == null) return identity;
-    if (isFunction$1(value)) return optimizeCb(value, context, argCount);
-    if (isObject(value) && !isArray(value)) return matcher(value);
-    return property(value);
-  }
-
-  // External wrapper for our callback generator. Users may customize
-  // `_.iteratee` if they want additional predicate/iteratee shorthand styles.
-  // This abstraction hides the internal-only `argCount` argument.
-  function iteratee(value, context) {
-    return baseIteratee(value, context, Infinity);
-  }
-  _$1.iteratee = iteratee;
-
-  // The function we call internally to generate a callback. It invokes
-  // `_.iteratee` if overridden, otherwise `baseIteratee`.
-  function cb(value, context, argCount) {
-    if (_$1.iteratee !== iteratee) return _$1.iteratee(value, context);
-    return baseIteratee(value, context, argCount);
-  }
-
-  // Returns the results of applying the `iteratee` to each element of `obj`.
-  // In contrast to `_.map` it returns an object.
-  function mapObject(obj, iteratee, context) {
-    iteratee = cb(iteratee, context);
-    var _keys = keys(obj),
-        length = _keys.length,
-        results = {};
-    for (var index = 0; index < length; index++) {
-      var currentKey = _keysindex;
-      resultscurrentKey = iteratee(objcurrentKey, currentKey, obj);
-    }
-    return results;
-  }
-
-  // Predicate-generating function. Often useful outside of Underscore.
-  function noop(){}
-
-  // Generates a function for a given object that returns a given property.
-  function propertyOf(obj) {
-    if (obj == null) return noop;
-    return function(path) {
-      return get(obj, path);
-    };
-  }
-
-  // Run a function **n** times.
-  function times(n, iteratee, context) {
-    var accum = Array(Math.max(0, n));
-    iteratee = optimizeCb(iteratee, context, 1);
-    for (var i = 0; i < n; i++) accumi = iteratee(i);
-    return accum;
-  }
-
-  // Return a random integer between `min` and `max` (inclusive).
-  function random(min, max) {
-    if (max == null) {
-      max = min;
-      min = 0;
-    }
-    return min + Math.floor(Math.random() * (max - min + 1));
-  }
-
-  // A (possibly faster) way to get the current timestamp as an integer.
-  var now = Date.now || function() {
-    return new Date().getTime();
-  };
-
-  // Internal helper to generate functions for escaping and unescaping strings
-  // to/from HTML interpolation.
-  function createEscaper(map) {
-    var escaper = function(match) {
-      return mapmatch;
-    };
-    // Regexes for identifying a key that needs to be escaped.
-    var source = '(?:' + keys(map).join('|') + ')';
-    var testRegexp = RegExp(source);
-    var replaceRegexp = RegExp(source, 'g');
-    return function(string) {
-      string = string == null ? '' : '' + string;
-      return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string;
-    };
-  }
-
-  // Internal list of HTML entities for escaping.
-  var escapeMap = {
-    '&': '&amp;',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#x27;',
-    '`': '&#x60;'
-  };
-
-  // Function for escaping strings to HTML interpolation.
-  var _escape = createEscaper(escapeMap);
-
-  // Internal list of HTML entities for unescaping.
-  var unescapeMap = invert(escapeMap);
-
-  // Function for unescaping strings from HTML interpolation.
-  var _unescape = createEscaper(unescapeMap);
-
-  // By default, Underscore uses ERB-style template delimiters. Change the
-  // following template settings to use alternative delimiters.
-  var templateSettings = _$1.templateSettings = {
-    evaluate: /<%(\s\S+?)%>/g,
-    interpolate: /<%=(\s\S+?)%>/g,
-    escape: /<%-(\s\S+?)%>/g
-  };
-
-  // When customizing `_.templateSettings`, if you don't want to define an
-  // interpolation, evaluation or escaping regex, we need one that is
-  // guaranteed not to match.
-  var noMatch = /(.)^/;
-
-  // Certain characters need to be escaped so that they can be put into a
-  // string literal.
-  var escapes = {
-    "'": "'",
-    '\\': '\\',
-    '\r': 'r',
-    '\n': 'n',
-    '\u2028': 'u2028',
-    '\u2029': 'u2029'
-  };
-
-  var escapeRegExp = /\\|'|\r|\n|\u2028|\u2029/g;
-
-  function escapeChar(match) {
-    return '\\' + escapesmatch;
-  }
-
-  // In order to prevent third-party code injection through
-  // `_.templateSettings.variable`, we test it against the following regular
-  // expression. It is intentionally a bit more liberal than just matching valid
-  // identifiers, but still prevents possible loopholes through defaults or
-  // destructuring assignment.
-  var bareIdentifier = /^\s*(\w|\$)+\s*$/;
-
-  // JavaScript micro-templating, similar to John Resig's implementation.
-  // Underscore templating handles arbitrary delimiters, preserves whitespace,
-  // and correctly escapes quotes within interpolated code.
-  // NB: `oldSettings` only exists for backwards compatibility.
-  function template(text, settings, oldSettings) {
-    if (!settings && oldSettings) settings = oldSettings;
-    settings = defaults({}, settings, _$1.templateSettings);
-
-    // Combine delimiters into one regular expression via alternation.
-    var matcher = RegExp(
-      (settings.escape || noMatch).source,
-      (settings.interpolate || noMatch).source,
-      (settings.evaluate || noMatch).source
-    .join('|') + '|$', 'g');
-
-    // Compile the template source, escaping string literals appropriately.
-    var index = 0;
-    var source = "__p+='";
-    text.replace(matcher, function(match, escape, interpolate, evaluate, offset) {
-      source += text.slice(index, offset).replace(escapeRegExp, escapeChar);
-      index = offset + match.length;
-
-      if (escape) {
-        source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'";
-      } else if (interpolate) {
-        source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'";
-      } else if (evaluate) {
-        source += "';\n" + evaluate + "\n__p+='";
-      }
-
-      // Adobe VMs need the match returned to produce the correct offset.
-      return match;
-    });
-    source += "';\n";
-
-    var argument = settings.variable;
-    if (argument) {
-      // Insure against third-party code injection. (CVE-2021-23358)
-      if (!bareIdentifier.test(argument)) throw new Error(
-        'variable is not a bare identifier: ' + argument
-      );
-    } else {
-      // If a variable is not specified, place data values in local scope.
-      source = 'with(obj||{}){\n' + source + '}\n';
-      argument = 'obj';
-    }
-
-    source = "var __t,__p='',__j=Array.prototype.join," +
-      "print=function(){__p+=__j.call(arguments,'');};\n" +
-      source + 'return __p;\n';
-
-    var render;
-    try {
-      render = new Function(argument, '_', source);
-    } catch (e) {
-      e.source = source;
-      throw e;
-    }
-
-    var template = function(data) {
-      return render.call(this, data, _$1);
-    };
-
-    // Provide the compiled source as a convenience for precompilation.
-    template.source = 'function(' + argument + '){\n' + source + '}';
-
-    return template;
-  }
-
-  // Traverses the children of `obj` along `path`. If a child is a function, it
-  // is invoked with its parent as context. Returns the value of the final
-  // child, or `fallback` if any child is undefined.
-  function result(obj, path, fallback) {
-    path = toPath(path);
-    var length = path.length;
-    if (!length) {
-      return isFunction$1(fallback) ? fallback.call(obj) : fallback;
-    }
-    for (var i = 0; i < length; i++) {
-      var prop = obj == null ? void 0 : objpathi;
-      if (prop === void 0) {
-        prop = fallback;
-        i = length; // Ensure we don't continue iterating.
-      }
-      obj = isFunction$1(prop) ? prop.call(obj) : prop;
-    }
-    return obj;
-  }
-
-  // Generate a unique integer id (unique within the entire client session).
-  // Useful for temporary DOM ids.
-  var idCounter = 0;
-  function uniqueId(prefix) {
-    var id = ++idCounter + '';
-    return prefix ? prefix + id : id;
-  }
-
-  // Start chaining a wrapped Underscore object.
-  function chain(obj) {
-    var instance = _$1(obj);
-    instance._chain = true;
-    return instance;
-  }
-
-  // Internal function to execute `sourceFunc` bound to `context` with optional
-  // `args`. Determines whether to execute a function as a constructor or as a
-  // normal function.
-  function executeBound(sourceFunc, boundFunc, context, callingContext, args) {
-    if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args);
-    var self = baseCreate(sourceFunc.prototype);
-    var result = sourceFunc.apply(self, args);
-    if (isObject(result)) return result;
-    return self;
-  }
-
-  // Partially apply a function by creating a version that has had some of its
-  // arguments pre-filled, without changing its dynamic `this` context. `_` acts
-  // as a placeholder by default, allowing any combination of arguments to be
-  // pre-filled. Set `_.partial.placeholder` for a custom placeholder argument.
-  var partial = restArguments(function(func, boundArgs) {
-    var placeholder = partial.placeholder;
-    var bound = function() {
-      var position = 0, length = boundArgs.length;
-      var args = Array(length);
-      for (var i = 0; i < length; i++) {
-        argsi = boundArgsi === placeholder ? argumentsposition++ : boundArgsi;
-      }
-      while (position < arguments.length) args.push(argumentsposition++);
-      return executeBound(func, bound, this, this, args);
-    };
-    return bound;
-  });
-
-  partial.placeholder = _$1;
-
-  // Create a function bound to a given object (assigning `this`, and arguments,
-  // optionally).
-  var bind = restArguments(function(func, context, args) {
-    if (!isFunction$1(func)) throw new TypeError('Bind must be called on a function');
-    var bound = restArguments(function(callArgs) {
-      return executeBound(func, bound, context, this, args.concat(callArgs));
-    });
-    return bound;
-  });
-
-  // Internal helper for collection methods to determine whether a collection
-  // should be iterated as an array or as an object.
-  // Related: https://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength
-  // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094
-  var isArrayLike = createSizePropertyCheck(getLength);
-
-  // Internal implementation of a recursive `flatten` function.
-  function flatten$1(input, depth, strict, output) {
-    output = output || ;
-    if (!depth && depth !== 0) {
-      depth = Infinity;
-    } else if (depth <= 0) {
-      return output.concat(input);
-    }
-    var idx = output.length;
-    for (var i = 0, length = getLength(input); i < length; i++) {
-      var value = inputi;
-      if (isArrayLike(value) && (isArray(value) || isArguments$1(value))) {
-        // Flatten current level of array or arguments object.
-        if (depth > 1) {
-          flatten$1(value, depth - 1, strict, output);
-          idx = output.length;
-        } else {
-          var j = 0, len = value.length;
-          while (j < len) outputidx++ = valuej++;
-        }
-      } else if (!strict) {
-        outputidx++ = value;
-      }
-    }
-    return output;
-  }
-
-  // Bind a number of an object's methods to that object. Remaining arguments
-  // are the method names to be bound. Useful for ensuring that all callbacks
-  // defined on an object belong to it.
-  var bindAll = restArguments(function(obj, keys) {
-    keys = flatten$1(keys, false, false);
-    var index = keys.length;
-    if (index < 1) throw new Error('bindAll must be passed function names');
-    while (index--) {
-      var key = keysindex;
-      objkey = bind(objkey, obj);
-    }
-    return obj;
-  });
-
-  // Memoize an expensive function by storing its results.
-  function memoize(func, hasher) {
-    var memoize = function(key) {
-      var cache = memoize.cache;
-      var address = '' + (hasher ? hasher.apply(this, arguments) : key);
-      if (!has$1(cache, address)) cacheaddress = func.apply(this, arguments);
-      return cacheaddress;
-    };
-    memoize.cache = {};
-    return memoize;
-  }
-
-  // Delays a function for the given number of milliseconds, and then calls
-  // it with the arguments supplied.
-  var delay = restArguments(function(func, wait, args) {
-    return setTimeout(function() {
-      return func.apply(null, args);
-    }, wait);
-  });
-
-  // Defers a function, scheduling it to run after the current call stack has
-  // cleared.
-  var defer = partial(delay, _$1, 1);
-
-  // Returns a function, that, when invoked, will only be triggered at most once
-  // during a given window of time. Normally, the throttled function will run
-  // as much as it can, without ever going more than once per `wait` duration;
-  // but if you'd like to disable the execution on the leading edge, pass
-  // `{leading: false}`. To disable execution on the trailing edge, ditto.
-  function throttle(func, wait, options) {
-    var timeout, context, args, result;
-    var previous = 0;
-    if (!options) options = {};
-
-    var later = function() {
-      previous = options.leading === false ? 0 : now();
-      timeout = null;
-      result = func.apply(context, args);
-      if (!timeout) context = args = null;
-    };
-
-    var throttled = function() {
-      var _now = now();
-      if (!previous && options.leading === false) previous = _now;
-      var remaining = wait - (_now - previous);
-      context = this;
-      args = arguments;
-      if (remaining <= 0 || remaining > wait) {
-        if (timeout) {
-          clearTimeout(timeout);
-          timeout = null;
-        }
-        previous = _now;
-        result = func.apply(context, args);
-        if (!timeout) context = args = null;
-      } else if (!timeout && options.trailing !== false) {
-        timeout = setTimeout(later, remaining);
-      }
-      return result;
-    };
-
-    throttled.cancel = function() {
-      clearTimeout(timeout);
-      previous = 0;
-      timeout = context = args = null;
-    };
-
-    return throttled;
-  }
-
-  // When a sequence of calls of the returned function ends, the argument
-  // function is triggered. The end of a sequence is defined by the `wait`
-  // parameter. If `immediate` is passed, the argument function will be
-  // triggered at the beginning of the sequence instead of at the end.
-  function debounce(func, wait, immediate) {
-    var timeout, previous, args, result, context;
-
-    var later = function() {
-      var passed = now() - previous;
-      if (wait > passed) {
-        timeout = setTimeout(later, wait - passed);
-      } else {
-        timeout = null;
-        if (!immediate) result = func.apply(context, args);
-        // This check is needed because `func` can recursively invoke `debounced`.
-        if (!timeout) args = context = null;
-      }
-    };
-
-    var debounced = restArguments(function(_args) {
-      context = this;
-      args = _args;
-      previous = now();
-      if (!timeout) {
-        timeout = setTimeout(later, wait);
-        if (immediate) result = func.apply(context, args);
-      }
-      return result;
-    });
-
-    debounced.cancel = function() {
-      clearTimeout(timeout);
-      timeout = args = context = null;
-    };
-
-    return debounced;
-  }
-
-  // Returns the first function passed as an argument to the second,
-  // allowing you to adjust arguments, run code before and after, and
-  // conditionally execute the original function.
-  function wrap(func, wrapper) {
-    return partial(wrapper, func);
-  }
-
-  // Returns a negated version of the passed-in predicate.
-  function negate(predicate) {
-    return function() {
-      return !predicate.apply(this, arguments);
-    };
-  }
-
-  // Returns a function that is the composition of a list of functions, each
-  // consuming the return value of the function that follows.
-  function compose() {
-    var args = arguments;
-    var start = args.length - 1;
-    return function() {
-      var i = start;
-      var result = argsstart.apply(this, arguments);
-      while (i--) result = argsi.call(this, result);
-      return result;
-    };
-  }
-
-  // Returns a function that will only be executed on and after the Nth call.
-  function after(times, func) {
-    return function() {
-      if (--times < 1) {
-        return func.apply(this, arguments);
-      }
-    };
-  }
-
-  // Returns a function that will only be executed up to (but not including) the
-  // Nth call.
-  function before(times, func) {
-    var memo;
-    return function() {
-      if (--times > 0) {
-        memo = func.apply(this, arguments);
-      }
-      if (times <= 1) func = null;
-      return memo;
-    };
-  }
-
-  // Returns a function that will be executed at most one time, no matter how
-  // often you call it. Useful for lazy initialization.
-  var once = partial(before, 2);
-
-  // Returns the first key on an object that passes a truth test.
-  function findKey(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var _keys = keys(obj), key;
-    for (var i = 0, length = _keys.length; i < length; i++) {
-      key = _keysi;
-      if (predicate(objkey, key, obj)) return key;
-    }
-  }
-
-  // Internal function to generate `_.findIndex` and `_.findLastIndex`.
-  function createPredicateIndexFinder(dir) {
-    return function(array, predicate, context) {
-      predicate = cb(predicate, context);
-      var length = getLength(array);
-      var index = dir > 0 ? 0 : length - 1;
-      for (; index >= 0 && index < length; index += dir) {
-        if (predicate(arrayindex, index, array)) return index;
-      }
-      return -1;
-    };
-  }
-
-  // Returns the first index on an array-like that passes a truth test.
-  var findIndex = createPredicateIndexFinder(1);
-
-  // Returns the last index on an array-like that passes a truth test.
-  var findLastIndex = createPredicateIndexFinder(-1);
-
-  // Use a comparator function to figure out the smallest index at which
-  // an object should be inserted so as to maintain order. Uses binary search.
-  function sortedIndex(array, obj, iteratee, context) {
-    iteratee = cb(iteratee, context, 1);
-    var value = iteratee(obj);
-    var low = 0, high = getLength(array);
-    while (low < high) {
-      var mid = Math.floor((low + high) / 2);
-      if (iteratee(arraymid) < value) low = mid + 1; else high = mid;
-    }
-    return low;
-  }
-
-  // Internal function to generate the `_.indexOf` and `_.lastIndexOf` functions.
-  function createIndexFinder(dir, predicateFind, sortedIndex) {
-    return function(array, item, idx) {
-      var i = 0, length = getLength(array);
-      if (typeof idx == 'number') {
-        if (dir > 0) {
-          i = idx >= 0 ? idx : Math.max(idx + length, i);
-        } else {
-          length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1;
-        }
-      } else if (sortedIndex && idx && length) {
-        idx = sortedIndex(array, item);
-        return arrayidx === item ? idx : -1;
-      }
-      if (item !== item) {
-        idx = predicateFind(slice.call(array, i, length), isNaN$1);
-        return idx >= 0 ? idx + i : -1;
-      }
-      for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) {
-        if (arrayidx === item) return idx;
-      }
-      return -1;
-    };
-  }
-
-  // Return the position of the first occurrence of an item in an array,
-  // or -1 if the item is not included in the array.
-  // If the array is large and already in sort order, pass `true`
-  // for **isSorted** to use binary search.
-  var indexOf = createIndexFinder(1, findIndex, sortedIndex);
-
-  // Return the position of the last occurrence of an item in an array,
-  // or -1 if the item is not included in the array.
-  var lastIndexOf = createIndexFinder(-1, findLastIndex);
-
-  // Return the first value which passes a truth test.
-  function find(obj, predicate, context) {
-    var keyFinder = isArrayLike(obj) ? findIndex : findKey;
-    var key = keyFinder(obj, predicate, context);
-    if (key !== void 0 && key !== -1) return objkey;
-  }
-
-  // Convenience version of a common use case of `_.find`: getting the first
-  // object containing specific `key:value` pairs.
-  function findWhere(obj, attrs) {
-    return find(obj, matcher(attrs));
-  }
-
-  // The cornerstone for collection functions, an `each`
-  // implementation, aka `forEach`.
-  // Handles raw objects in addition to array-likes. Treats all
-  // sparse array-likes as if they were dense.
-  function each(obj, iteratee, context) {
-    iteratee = optimizeCb(iteratee, context);
-    var i, length;
-    if (isArrayLike(obj)) {
-      for (i = 0, length = obj.length; i < length; i++) {
-        iteratee(obji, i, obj);
-      }
-    } else {
-      var _keys = keys(obj);
-      for (i = 0, length = _keys.length; i < length; i++) {
-        iteratee(obj_keysi, _keysi, obj);
-      }
-    }
-    return obj;
-  }
-
-  // Return the results of applying the iteratee to each element.
-  function map(obj, iteratee, context) {
-    iteratee = cb(iteratee, context);
-    var _keys = !isArrayLike(obj) && keys(obj),
-        length = (_keys || obj).length,
-        results = Array(length);
-    for (var index = 0; index < length; index++) {
-      var currentKey = _keys ? _keysindex : index;
-      resultsindex = iteratee(objcurrentKey, currentKey, obj);
-    }
-    return results;
-  }
-
-  // Internal helper to create a reducing function, iterating left or right.
-  function createReduce(dir) {
-    // Wrap code that reassigns argument variables in a separate function than
-    // the one that accesses `arguments.length` to avoid a perf hit. (#1991)
-    var reducer = function(obj, iteratee, memo, initial) {
-      var _keys = !isArrayLike(obj) && keys(obj),
-          length = (_keys || obj).length,
-          index = dir > 0 ? 0 : length - 1;
-      if (!initial) {
-        memo = obj_keys ? _keysindex : index;
-        index += dir;
-      }
-      for (; index >= 0 && index < length; index += dir) {
-        var currentKey = _keys ? _keysindex : index;
-        memo = iteratee(memo, objcurrentKey, currentKey, obj);
-      }
-      return memo;
-    };
-
-    return function(obj, iteratee, memo, context) {
-      var initial = arguments.length >= 3;
-      return reducer(obj, optimizeCb(iteratee, context, 4), memo, initial);
-    };
-  }
-
-  // **Reduce** builds up a single result from a list of values, aka `inject`,
-  // or `foldl`.
-  var reduce = createReduce(1);
-
-  // The right-associative version of reduce, also known as `foldr`.
-  var reduceRight = createReduce(-1);
-
-  // Return all the elements that pass a truth test.
-  function filter(obj, predicate, context) {
-    var results = ;
-    predicate = cb(predicate, context);
-    each(obj, function(value, index, list) {
-      if (predicate(value, index, list)) results.push(value);
-    });
-    return results;
-  }
-
-  // Return all the elements for which a truth test fails.
-  function reject(obj, predicate, context) {
-    return filter(obj, negate(cb(predicate)), context);
-  }
-
-  // Determine whether all of the elements pass a truth test.
-  function every(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var _keys = !isArrayLike(obj) && keys(obj),
-        length = (_keys || obj).length;
-    for (var index = 0; index < length; index++) {
-      var currentKey = _keys ? _keysindex : index;
-      if (!predicate(objcurrentKey, currentKey, obj)) return false;
-    }
-    return true;
-  }
-
-  // Determine if at least one element in the object passes a truth test.
-  function some(obj, predicate, context) {
-    predicate = cb(predicate, context);
-    var _keys = !isArrayLike(obj) && keys(obj),
-        length = (_keys || obj).length;
-    for (var index = 0; index < length; index++) {
-      var currentKey = _keys ? _keysindex : index;
-      if (predicate(objcurrentKey, currentKey, obj)) return true;
-    }
-    return false;
-  }
-
-  // Determine if the array or object contains a given item (using `===`).
-  function contains(obj, item, fromIndex, guard) {
-    if (!isArrayLike(obj)) obj = values(obj);
-    if (typeof fromIndex != 'number' || guard) fromIndex = 0;
-    return indexOf(obj, item, fromIndex) >= 0;
-  }
-
-  // Invoke a method (with arguments) on every item in a collection.
-  var invoke = restArguments(function(obj, path, args) {
-    var contextPath, func;
-    if (isFunction$1(path)) {
-      func = path;
-    } else {
-      path = toPath(path);
-      contextPath = path.slice(0, -1);
-      path = pathpath.length - 1;
-    }
-    return map(obj, function(context) {
-      var method = func;
-      if (!method) {
-        if (contextPath && contextPath.length) {
-          context = deepGet(context, contextPath);
-        }
-        if (context == null) return void 0;
-        method = contextpath;
-      }
-      return method == null ? method : method.apply(context, args);
-    });
-  });
-
-  // Convenience version of a common use case of `_.map`: fetching a property.
-  function pluck(obj, key) {
-    return map(obj, property(key));
-  }
-
-  // Convenience version of a common use case of `_.filter`: selecting only
-  // objects containing specific `key:value` pairs.
-  function where(obj, attrs) {
-    return filter(obj, matcher(attrs));
-  }
-
-  // Return the maximum element (or element-based computation).
-  function max(obj, iteratee, context) {
-    var result = -Infinity, lastComputed = -Infinity,
-        value, computed;
-    if (iteratee == null || typeof iteratee == 'number' && typeof obj0 != 'object' && obj != null) {
-      obj = isArrayLike(obj) ? obj : values(obj);
-      for (var i = 0, length = obj.length; i < length; i++) {
-        value = obji;
-        if (value != null && value > result) {
-          result = value;
-        }
-      }
-    } else {
-      iteratee = cb(iteratee, context);
-      each(obj, function(v, index, list) {
-        computed = iteratee(v, index, list);
-        if (computed > lastComputed || computed === -Infinity && result === -Infinity) {
-          result = v;
-          lastComputed = computed;
-        }
-      });
-    }
-    return result;
-  }
-
-  // Return the minimum element (or element-based computation).
-  function min(obj, iteratee, context) {
-    var result = Infinity, lastComputed = Infinity,
-        value, computed;
-    if (iteratee == null || typeof iteratee == 'number' && typeof obj0 != 'object' && obj != null) {
-      obj = isArrayLike(obj) ? obj : values(obj);
-      for (var i = 0, length = obj.length; i < length; i++) {
-        value = obji;
-        if (value != null && value < result) {
-          result = value;
-        }
-      }
-    } else {
-      iteratee = cb(iteratee, context);
-      each(obj, function(v, index, list) {
-        computed = iteratee(v, index, list);
-        if (computed < lastComputed || computed === Infinity && result === Infinity) {
-          result = v;
-          lastComputed = computed;
-        }
-      });
-    }
-    return result;
-  }
-
-  // Sample **n** random values from a collection using the modern version of the
-  // Fisher-Yates shuffle(https://en.wikipedia.org/wiki/Fisher–Yates_shuffle).
-  // If **n** is not specified, returns a single random element.
-  // The internal `guard` argument allows it to work with `_.map`.
-  function sample(obj, n, guard) {
-    if (n == null || guard) {
-      if (!isArrayLike(obj)) obj = values(obj);
-      return objrandom(obj.length - 1);
-    }
-    var sample = isArrayLike(obj) ? clone(obj) : values(obj);
-    var length = getLength(sample);
-    n = Math.max(Math.min(n, length), 0);
-    var last = length - 1;
-    for (var index = 0; index < n; index++) {
-      var rand = random(index, last);
-      var temp = sampleindex;
-      sampleindex = samplerand;
-      samplerand = temp;
-    }
-    return sample.slice(0, n);
-  }
-
-  // Shuffle a collection.
-  function shuffle(obj) {
-    return sample(obj, Infinity);
-  }
-
-  // Sort the object's values by a criterion produced by an iteratee.
-  function sortBy(obj, iteratee, context) {
-    var index = 0;
-    iteratee = cb(iteratee, context);
-    return pluck(map(obj, function(value, key, list) {
-      return {
-        value: value,
-        index: index++,
-        criteria: iteratee(value, key, list)
-      };
-    }).sort(function(left, right) {
-      var a = left.criteria;
-      var b = right.criteria;
-      if (a !== b) {
-        if (a > b || a === void 0) return 1;
-        if (a < b || b === void 0) return -1;
-      }
-      return left.index - right.index;
-    }), 'value');
-  }
-
-  // An internal function used for aggregate "group by" operations.
-  function group(behavior, partition) {
-    return function(obj, iteratee, context) {
-      var result = partition ? ,  : {};
-      iteratee = cb(iteratee, context);
-      each(obj, function(value, index) {
-        var key = iteratee(value, index, obj);
-        behavior(result, value, key);
-      });
-      return result;
-    };
-  }
-
-  // Groups the object's values by a criterion. Pass either a string attribute
-  // to group by, or a function that returns the criterion.
-  var groupBy = group(function(result, value, key) {
-    if (has$1(result, key)) resultkey.push(value); else resultkey = value;
-  });
-
-  // Indexes the object's values by a criterion, similar to `_.groupBy`, but for
-  // when you know that your index values will be unique.
-  var indexBy = group(function(result, value, key) {
-    resultkey = value;
-  });
-
-  // Counts instances of an object that group by a certain criterion. Pass
-  // either a string attribute to count by, or a function that returns the
-  // criterion.
-  var countBy = group(function(result, value, key) {
-    if (has$1(result, key)) resultkey++; else resultkey = 1;
-  });
-
-  // Split a collection into two arrays: one whose elements all pass the given
-  // truth test, and one whose elements all do not pass the truth test.
-  var partition = group(function(result, value, pass) {
-    resultpass ? 0 : 1.push(value);
-  }, true);
-
-  // Safely create a real, live array from anything iterable.
-  var reStrSymbol = /^\ud800-\udfff|\ud800-\udbff\udc00-\udfff|\ud800-\udfff/g;
-  function toArray(obj) {
-    if (!obj) return ;
-    if (isArray(obj)) return slice.call(obj);
-    if (isString(obj)) {
-      // Keep surrogate pair characters together.
-      return obj.match(reStrSymbol);
-    }
-    if (isArrayLike(obj)) return map(obj, identity);
-    return values(obj);
-  }
-
-  // Return the number of elements in a collection.
-  function size(obj) {
-    if (obj == null) return 0;
-    return isArrayLike(obj) ? obj.length : keys(obj).length;
-  }
-
-  // Internal `_.pick` helper function to determine whether `key` is an enumerable
-  // property name of `obj`.
-  function keyInObj(value, key, obj) {
-    return key in obj;
-  }
-
-  // Return a copy of the object only containing the allowed properties.
-  var pick = restArguments(function(obj, keys) {
-    var result = {}, iteratee = keys0;
-    if (obj == null) return result;
-    if (isFunction$1(iteratee)) {
-      if (keys.length > 1) iteratee = optimizeCb(iteratee, keys1);
-      keys = allKeys(obj);
-    } else {
-      iteratee = keyInObj;
-      keys = flatten$1(keys, false, false);
-      obj = Object(obj);
-    }
-    for (var i = 0, length = keys.length; i < length; i++) {
-      var key = keysi;
-      var value = objkey;
-      if (iteratee(value, key, obj)) resultkey = value;
-    }
-    return result;
-  });
-
-  // Return a copy of the object without the disallowed properties.
-  var omit = restArguments(function(obj, keys) {
-    var iteratee = keys0, context;
-    if (isFunction$1(iteratee)) {
-      iteratee = negate(iteratee);
-      if (keys.length > 1) context = keys1;
-    } else {
-      keys = map(flatten$1(keys, false, false), String);
-      iteratee = function(value, key) {
-        return !contains(keys, key);
-      };
-    }
-    return pick(obj, iteratee, context);
-  });
-
-  // Returns everything but the last entry of the array. Especially useful on
-  // the arguments object. Passing **n** will return all the values in
-  // the array, excluding the last N.
-  function initial(array, n, guard) {
-    return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n)));
-  }
-
-  // Get the first element of an array. Passing **n** will return the first N
-  // values in the array. The **guard** check allows it to work with `_.map`.
-  function first(array, n, guard) {
-    if (array == null || array.length < 1) return n == null || guard ? void 0 : ;
-    if (n == null || guard) return array0;
-    return initial(array, array.length - n);
-  }
-
-  // Returns everything but the first entry of the `array`. Especially useful on
-  // the `arguments` object. Passing an **n** will return the rest N values in the
-  // `array`.
-  function rest(array, n, guard) {
-    return slice.call(array, n == null || guard ? 1 : n);
-  }
-
-  // Get the last element of an array. Passing **n** will return the last N
-  // values in the array.
-  function last(array, n, guard) {
-    if (array == null || array.length < 1) return n == null || guard ? void 0 : ;
-    if (n == null || guard) return arrayarray.length - 1;
-    return rest(array, Math.max(0, array.length - n));
-  }
-
-  // Trim out all falsy values from an array.
-  function compact(array) {
-    return filter(array, Boolean);
-  }
-
-  // Flatten out an array, either recursively (by default), or up to `depth`.
-  // Passing `true` or `false` as `depth` means `1` or `Infinity`, respectively.
-  function flatten(array, depth) {
-    return flatten$1(array, depth, false);
-  }
-
-  // Take the difference between one array and a number of other arrays.
-  // Only the elements present in just the first array will remain.
-  var difference = restArguments(function(array, rest) {
-    rest = flatten$1(rest, true, true);
-    return filter(array, function(value){
-      return !contains(rest, value);
-    });
-  });
-
-  // Return a version of the array that does not contain the specified value(s).
-  var without = restArguments(function(array, otherArrays) {
-    return difference(array, otherArrays);
-  });
-
-  // Produce a duplicate-free version of the array. If the array has already
-  // been sorted, you have the option of using a faster algorithm.
-  // The faster algorithm will not work with an iteratee if the iteratee
-  // is not a one-to-one function, so providing an iteratee will disable
-  // the faster algorithm.
-  function uniq(array, isSorted, iteratee, context) {
-    if (!isBoolean(isSorted)) {
-      context = iteratee;
-      iteratee = isSorted;
-      isSorted = false;
-    }
-    if (iteratee != null) iteratee = cb(iteratee, context);
-    var result = ;
-    var seen = ;
-    for (var i = 0, length = getLength(array); i < length; i++) {
-      var value = arrayi,
-          computed = iteratee ? iteratee(value, i, array) : value;
-      if (isSorted && !iteratee) {
-        if (!i || seen !== computed) result.push(value);
-        seen = computed;
-      } else if (iteratee) {
-        if (!contains(seen, computed)) {
-          seen.push(computed);
-          result.push(value);
-        }
-      } else if (!contains(result, value)) {
-        result.push(value);
-      }
-    }
-    return result;
-  }
-
-  // Produce an array that contains the union: each distinct element from all of
-  // the passed-in arrays.
-  var union = restArguments(function(arrays) {
-    return uniq(flatten$1(arrays, true, true));
-  });
-
-  // Produce an array that contains every item shared between all the
-  // passed-in arrays.
-  function intersection(array) {
-    var result = ;
-    var argsLength = arguments.length;
-    for (var i = 0, length = getLength(array); i < length; i++) {
-      var item = arrayi;
-      if (contains(result, item)) continue;
-      var j;
-      for (j = 1; j < argsLength; j++) {
-        if (!contains(argumentsj, item)) break;
-      }
-      if (j === argsLength) result.push(item);
-    }
-    return result;
-  }
-
-  // Complement of zip. Unzip accepts an array of arrays and groups
-  // each array's elements on shared indices.
-  function unzip(array) {
-    var length = array && max(array, getLength).length || 0;
-    var result = Array(length);
-
-    for (var index = 0; index < length; index++) {
-      resultindex = pluck(array, index);
-    }
-    return result;
-  }
-
-  // Zip together multiple lists into a single array -- elements that share
-  // an index go together.
-  var zip = restArguments(unzip);
-
-  // Converts lists into objects. Pass either a single array of `key, value`
-  // pairs, or two parallel arrays of the same length -- one of keys, and one of
-  // the corresponding values. Passing by pairs is the reverse of `_.pairs`.
-  function object(list, values) {
-    var result = {};
-    for (var i = 0, length = getLength(list); i < length; i++) {
-      if (values) {
-        resultlisti = valuesi;
-      } else {
-        resultlisti0 = listi1;
-      }
-    }
-    return result;
-  }
-
-  // Generate an integer Array containing an arithmetic progression. A port of
-  // the native Python `range()` function. See
-  // the Python documentation(https://docs.python.org/library/functions.html#range).
-  function range(start, stop, step) {
-    if (stop == null) {
-      stop = start || 0;
-      start = 0;
-    }
-    if (!step) {
-      step = stop < start ? -1 : 1;
-    }
-
-    var length = Math.max(Math.ceil((stop - start) / step), 0);
-    var range = Array(length);
-
-    for (var idx = 0; idx < length; idx++, start += step) {
-      rangeidx = start;
-    }
-
-    return range;
-  }
-
-  // Chunk a single array into multiple arrays, each containing `count` or fewer
-  // items.
-  function chunk(array, count) {
-    if (count == null || count < 1) return ;
-    var result = ;
-    var i = 0, length = array.length;
-    while (i < length) {
-      result.push(slice.call(array, i, i += count));
-    }
-    return result;
-  }
-
-  // Helper function to continue chaining intermediate results.
-  function chainResult(instance, obj) {
-    return instance._chain ? _$1(obj).chain() : obj;
-  }
-
-  // Add your own custom functions to the Underscore object.
-  function mixin(obj) {
-    each(functions(obj), function(name) {
-      var func = _$1name = objname;
-      _$1.prototypename = function() {
-        var args = this._wrapped;
-        push.apply(args, arguments);
-        return chainResult(this, func.apply(_$1, args));
-      };
-    });
-    return _$1;
-  }
-
-  // Add all mutator `Array` functions to the wrapper.
-  each('pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift', function(name) {
-    var method = ArrayProtoname;
-    _$1.prototypename = function() {
-      var obj = this._wrapped;
-      if (obj != null) {
-        method.apply(obj, arguments);
-        if ((name === 'shift' || name === 'splice') && obj.length === 0) {
-          delete obj0;
-        }
-      }
-      return chainResult(this, obj);
-    };
-  });
-
-  // Add all accessor `Array` functions to the wrapper.
-  each('concat', 'join', 'slice', function(name) {
-    var method = ArrayProtoname;
-    _$1.prototypename = function() {
-      var obj = this._wrapped;
-      if (obj != null) obj = method.apply(obj, arguments);
-      return chainResult(this, obj);
-    };
-  });
-
-  // Named Exports
-
-  var allExports = {
-    __proto__: null,
-    VERSION: VERSION,
-    restArguments: restArguments,
-    isObject: isObject,
-    isNull: isNull,
-    isUndefined: isUndefined,
-    isBoolean: isBoolean,
-    isElement: isElement,
-    isString: isString,
-    isNumber: isNumber,
-    isDate: isDate,
-    isRegExp: isRegExp,
-    isError: isError,
-    isSymbol: isSymbol,
-    isArrayBuffer: isArrayBuffer,
-    isDataView: isDataView$1,
-    isArray: isArray,
-    isFunction: isFunction$1,
-    isArguments: isArguments$1,
-    isFinite: isFinite$1,
-    isNaN: isNaN$1,
-    isTypedArray: isTypedArray$1,
-    isEmpty: isEmpty,
-    isMatch: isMatch,
-    isEqual: isEqual,
-    isMap: isMap,
-    isWeakMap: isWeakMap,
-    isSet: isSet,
-    isWeakSet: isWeakSet,
-    keys: keys,
-    allKeys: allKeys,
-    values: values,
-    pairs: pairs,
-    invert: invert,
-    functions: functions,
-    methods: functions,
-    extend: extend,
-    extendOwn: extendOwn,
-    assign: extendOwn,
-    defaults: defaults,
-    create: create,
-    clone: clone,
-    tap: tap,
-    get: get,
-    has: has,
-    mapObject: mapObject,
-    identity: identity,
-    constant: constant,
-    noop: noop,
-    toPath: toPath$1,
-    property: property,
-    propertyOf: propertyOf,
-    matcher: matcher,
-    matches: matcher,
-    times: times,
-    random: random,
-    now: now,
-    escape: _escape,
-    unescape: _unescape,
-    templateSettings: templateSettings,
-    template: template,
-    result: result,
-    uniqueId: uniqueId,
-    chain: chain,
-    iteratee: iteratee,
-    partial: partial,
-    bind: bind,
-    bindAll: bindAll,
-    memoize: memoize,
-    delay: delay,
-    defer: defer,
-    throttle: throttle,
-    debounce: debounce,
-    wrap: wrap,
-    negate: negate,
-    compose: compose,
-    after: after,
-    before: before,
-    once: once,
-    findKey: findKey,
-    findIndex: findIndex,
-    findLastIndex: findLastIndex,
-    sortedIndex: sortedIndex,
-    indexOf: indexOf,
-    lastIndexOf: lastIndexOf,
-    find: find,
-    detect: find,
-    findWhere: findWhere,
-    each: each,
-    forEach: each,
-    map: map,
-    collect: map,
-    reduce: reduce,
-    foldl: reduce,
-    inject: reduce,
-    reduceRight: reduceRight,
-    foldr: reduceRight,
-    filter: filter,
-    select: filter,
-    reject: reject,
-    every: every,
-    all: every,
-    some: some,
-    any: some,
-    contains: contains,
-    includes: contains,
-    include: contains,
-    invoke: invoke,
-    pluck: pluck,
-    where: where,
-    max: max,
-    min: min,
-    shuffle: shuffle,
-    sample: sample,
-    sortBy: sortBy,
-    groupBy: groupBy,
-    indexBy: indexBy,
-    countBy: countBy,
-    partition: partition,
-    toArray: toArray,
-    size: size,
-    pick: pick,
-    omit: omit,
-    first: first,
-    head: first,
-    take: first,
-    initial: initial,
-    last: last,
-    rest: rest,
-    tail: rest,
-    drop: rest,
-    compact: compact,
-    flatten: flatten,
-    without: without,
-    uniq: uniq,
-    unique: uniq,
-    union: union,
-    intersection: intersection,
-    difference: difference,
-    unzip: unzip,
-    transpose: unzip,
-    zip: zip,
-    object: object,
-    range: range,
-    chunk: chunk,
-    mixin: mixin,
-    'default': _$1
-  };
-
-  // Default Export
-
-  // Add all of the Underscore functions to the wrapper object.
-  var _ = mixin(allExports);
-  // Legacy Node.js API.
-  _._ = _;
-
-  return _;
-
-})));
-//# sourceMappingURL=underscore-umd.js.map

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/underscore.js Deleted

@@ -1,6 +0,0 @@
-!function(n,r){"object"==typeof exports&&"undefined"!=typeof module?module.exports=r():"function"==typeof define&&define.amd?define("underscore",r):(n="undefined"!=typeof globalThis?globalThis:n||self,function(){var t=n._,e=n._=r();e.noConflict=function(){return n._=t,e}}())}(this,(function(){
-//     Underscore.js 1.13.1
-//     https://underscorejs.org
-//     (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors
-//     Underscore may be freely distributed under the MIT license.
-var n="1.13.1",r="object"==typeof self&&self.self===self&&self||"object"==typeof global&&global.global===global&&global||Function("return this")()||{},t=Array.prototype,e=Object.prototype,u="undefined"!=typeof Symbol?Symbol.prototype:null,o=t.push,i=t.slice,a=e.toString,f=e.hasOwnProperty,c="undefined"!=typeof ArrayBuffer,l="undefined"!=typeof DataView,s=Array.isArray,p=Object.keys,v=Object.create,h=c&&ArrayBuffer.isView,y=isNaN,d=isFinite,g=!{toString:null}.propertyIsEnumerable("toString"),b="valueOf","isPrototypeOf","toString","propertyIsEnumerable","hasOwnProperty","toLocaleString",m=Math.pow(2,53)-1;function j(n,r){return r=null==r?n.length-1:+r,function(){for(var t=Math.max(arguments.length-r,0),e=Array(t),u=0;u<t;u++)eu=argumentsu+r;switch(r){case 0:return n.call(this,e);case 1:return n.call(this,arguments0,e);case 2:return n.call(this,arguments0,arguments1,e)}var o=Array(r+1);for(u=0;u<r;u++)ou=argumentsu;return or=e,n.apply(this,o)}}function _(n){var r=typeof n;return"function"===r||"object"===r&&!!n}function w(n){return void 0===n}function A(n){return!0===n||!1===n||"object Boolean"===a.call(n)}function x(n){var r="object "+n+"";return function(n){return a.call(n)===r}}var S=x("String"),O=x("Number"),M=x("Date"),E=x("RegExp"),B=x("Error"),N=x("Symbol"),I=x("ArrayBuffer"),T=x("Function"),k=r.document&&r.document.childNodes;"function"!=typeof/./&&"object"!=typeof Int8Array&&"function"!=typeof k&&(T=function(n){return"function"==typeof n||!1});var D=T,R=x("Object"),F=l&&R(new DataView(new ArrayBuffer(8))),V="undefined"!=typeof Map&&R(new Map),P=x("DataView");var q=F?function(n){return null!=n&&D(n.getInt8)&&I(n.buffer)}:P,U=s||x("Array");function W(n,r){return null!=n&&f.call(n,r)}var z=x("Arguments");!function(){z(arguments)||(z=function(n){return W(n,"callee")})}();var L=z;function $(n){return O(n)&&y(n)}function C(n){return function(){return n}}function K(n){return function(r){var t=n(r);return"number"==typeof t&&t>=0&&t<=m}}function J(n){return function(r){return null==r?void 0:rn}}var G=J("byteLength"),H=K(G),Q=/\object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\/;var X=c?function(n){return h?h(n)&&!q(n):H(n)&&Q.test(a.call(n))}:C(!1),Y=J("length");function Z(n,r){r=function(n){for(var r={},t=n.length,e=0;e<t;++e)rne=!0;return{contains:function(n){return rn},push:function(t){return rt=!0,n.push(t)}}}(r);var t=b.length,u=n.constructor,o=D(u)&&u.prototype||e,i="constructor";for(W(n,i)&&!r.contains(i)&&r.push(i);t--;)(i=bt)in n&&ni!==oi&&!r.contains(i)&&r.push(i)}function nn(n){if(!_(n))return;if(p)return p(n);var r=;for(var t in n)W(n,t)&&r.push(t);return g&&Z(n,r),r}function rn(n,r){var t=nn(r),e=t.length;if(null==n)return!e;for(var u=Object(n),o=0;o<e;o++){var i=to;if(ri!==ui||!(i in u))return!1}return!0}function tn(n){return n instanceof tn?n:this instanceof tn?void(this._wrapped=n):new tn(n)}function en(n){return new Uint8Array(n.buffer||n,n.byteOffset||0,G(n))}tn.VERSION=n,tn.prototype.value=function(){return this._wrapped},tn.prototype.valueOf=tn.prototype.toJSON=tn.prototype.value,tn.prototype.toString=function(){return String(this._wrapped)};var un="object DataView";function on(n,r,t,e){if(n===r)return 0!==n||1/n==1/r;if(null==n||null==r)return!1;if(n!=n)return r!=r;var o=typeof n;return("function"===o||"object"===o||"object"==typeof r)&&function n(r,t,e,o){r instanceof tn&&(r=r._wrapped);t instanceof tn&&(t=t._wrapped);var i=a.call(r);if(i!==a.call(t))return!1;if(F&&"object Object"==i&&q(r)){if(!q(t))return!1;i=un}switch(i){case"object RegExp":case"object String":return""+r==""+t;case"object Number":return+r!=+r?+t!=+t:0==+r?1/+r==1/t:+r==+t;case"object Date":case"object Boolean":return+r==+t;case"object Symbol":return u.valueOf.call(r)===u.valueOf.call(t);case"object ArrayBuffer":case un:return n(en(r),en(t),e,o)}var f="object Array"===i;if(!f&&X(r)){if(G(r)!==G(t))return!1;if(r.buffer===t.buffer&&r.byteOffset===t.byteOffset)return!0;f=!0}if(!f){if("object"!=typeof r||"object"!=typeof t)return!1;var c=r.constructor,l=t.constructor;if(c!==l&&!(D(c)&&c instanceof c&&D(l)&&l instanceof l)&&"constructor"in r&&"constructor"in t)return!1}o=o||;var s=(e=e||).length;for(;s--;)if(es===r)return os===t;if(e.push(r),o.push(t),f){if((s=r.length)!==t.length)return!1;for(;s--;)if(!on(rs,ts,e,o))return!1}else{var p,v=nn(r);if(s=v.length,nn(t).length!==s)return!1;for(;s--;)if(p=vs,!W(t,p)||!on(rp,tp,e,o))return!1}return e.pop(),o.pop(),!0}(n,r,t,e)}function an(n){if(!_(n))return;var r=;for(var t in n)r.push(t);return g&&Z(n,r),r}function fn(n){var r=Y(n);return function(t){if(null==t)return!1;var e=an(t);if(Y(e))return!1;for(var u=0;u<r;u++)if(!D(tnu))return!1;return n!==hn||!D(tcn)}}var cn="forEach",ln="has",sn="clear","delete",pn="get",ln,"set",vn=sn.concat(cn,pn),hn=sn.concat(pn),yn="add".concat(sn,cn,ln),dn=V?fn(vn):x("Map"),gn=V?fn(hn):x("WeakMap"),bn=V?fn(yn):x("Set"),mn=x("WeakSet");function jn(n){for(var r=nn(n),t=r.length,e=Array(t),u=0;u<t;u++)eu=nru;return e}function _n(n){for(var r={},t=nn(n),e=0,u=t.length;e<u;e++)rnte=te;return r}function wn(n){var r=;for(var t in n)D(nt)&&r.push(t);return r.sort()}function An(n,r){return function(t){var e=arguments.length;if(r&&(t=Object(t)),e<2||null==t)return t;for(var u=1;u<e;u++)for(var o=argumentsu,i=n(o),a=i.length,f=0;f<a;f++){var c=if;r&&void 0!==tc||(tc=oc)}return t}}var xn=An(an),Sn=An(nn),On=An(an,!0);function Mn(n){if(!_(n))return{};if(v)return v(n);var r=function(){};r.prototype=n;var t=new r;return r.prototype=null,t}function En(n){return _(n)?U(n)?n.slice():xn({},n):n}function Bn(n){return U(n)?n:n}function Nn(n){return tn.toPath(n)}function In(n,r){for(var t=r.length,e=0;e<t;e++){if(null==n)return;n=nre}return t?n:void 0}function Tn(n,r,t){var e=In(n,Nn(r));return w(e)?t:e}function kn(n){return n}function Dn(n){return n=Sn({},n),function(r){return rn(r,n)}}function Rn(n){return n=Nn(n),function(r){return In(r,n)}}function Fn(n,r,t){if(void 0===r)return n;switch(null==t?3:t){case 1:return function(t){return n.call(r,t)};case 3:return function(t,e,u){return n.call(r,t,e,u)};case 4:return function(t,e,u,o){return n.call(r,t,e,u,o)}}return function(){return n.apply(r,arguments)}}function Vn(n,r,t){return null==n?kn:D(n)?Fn(n,r,t):_(n)&&!U(n)?Dn(n):Rn(n)}function Pn(n,r){return Vn(n,r,1/0)}function qn(n,r,t){return tn.iteratee!==Pn?tn.iteratee(n,r):Vn(n,r,t)}function Un(){}function Wn(n,r){return null==r&&(r=n,n=0),n+Math.floor(Math.random()*(r-n+1))}tn.toPath=Bn,tn.iteratee=Pn;var zn=Date.now||function(){return(new Date).getTime()};function Ln(n){var r=function(r){return nr},t="(?:"+nn(n).join("|")+")",e=RegExp(t),u=RegExp(t,"g");return function(n){return n=null==n?"":""+n,e.test(n)?n.replace(u,r):n}}var $n={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;","`":"&#x60;"},Cn=Ln($n),Kn=Ln(_n($n)),Jn=tn.templateSettings={evaluate:/<%(\s\S+?)%>/g,interpolate:/<%=(\s\S+?)%>/g,escape:/<%-(\s\S+?)%>/g},Gn=/(.)^/,Hn={"'":"'","\\":"\\","\r":"r","\n":"n","\u2028":"u2028","\u2029":"u2029"},Qn=/\\|'|\r|\n|\u2028|\u2029/g;function Xn(n){return"\\"+Hnn}var Yn=/^\s*(\w|\$)+\s*$/;var Zn=0;function nr(n,r,t,e,u){if(!(e instanceof r))return n.apply(t,u);var o=Mn(n.prototype),i=n.apply(o,u);return _(i)?i:o}var rr=j((function(n,r){var t=rr.placeholder,e=function(){for(var u=0,o=r.length,i=Array(o),a=0;a<o;a++)ia=ra===t?argumentsu++:ra;for(;u<arguments.length;)i.push(argumentsu++);return nr(n,e,this,this,i)};return e}));rr.placeholder=tn;var tr=j((function(n,r,t){if(!D(n))throw new TypeError("Bind must be called on a function");var e=j((function(u){return nr(n,e,r,this,t.concat(u))}));return e})),er=K(Y);function ur(n,r,t,e){if(e=e||,r||0===r){if(r<=0)return e.concat(n)}else r=1/0;for(var u=e.length,o=0,i=Y(n);o<i;o++){var a=no;if(er(a)&&(U(a)||L(a)))if(r>1)ur(a,r-1,t,e),u=e.length;else for(var f=0,c=a.length;f<c;)eu++=af++;else t||(eu++=a)}return e}var or=j((function(n,r){var t=(r=ur(r,!1,!1)).length;if(t<1)throw new Error("bindAll must be passed function names");for(;t--;){var e=rt;ne=tr(ne,n)}return n}));var ir=j((function(n,r,t){return setTimeout((function(){return n.apply(null,t)}),r)})),ar=rr(ir,tn,1);function fr(n){return function(){return!n.apply(this,arguments)}}function cr(n,r){var t;return function(){return--n>0&&(t=r.apply(this,arguments)),n<=1&&(r=null),t}}var lr=rr(cr,2);function sr(n,r,t){r=qn(r,t);for(var e,u=nn(n),o=0,i=u.length;o<i;o++)if(r(ne=uo,e,n))return e}function pr(n){return function(r,t,e){t=qn(t,e);for(var u=Y(r),o=n>0?0:u-1;o>=0&&o<u;o+=n)if(t(ro,o,r))return o;return-1}}var vr=pr(1),hr=pr(-1);function yr(n,r,t,e){for(var u=(t=qn(t,e,1))(r),o=0,i=Y(n);o<i;){var a=Math.floor((o+i)/2);t(na)<u?o=a+1:i=a}return o}function dr(n,r,t){return function(e,u,o){var a=0,f=Y(e);if("number"==typeof o)n>0?a=o>=0?o:Math.max(o+f,a):f=o>=0?Math.min(o+1,f):o+f+1;else if(t&&o&&f)return eo=t(e,u)===u?o:-1;if(u!=u)return(o=r(i.call(e,a,f),$))>=0?o+a:-1;for(o=n>0?a:f-1;o>=0&&o<f;o+=n)if(eo===u)return o;return-1}}var gr=dr(1,vr,yr),br=dr(-1,hr);function mr(n,r,t){var e=(er(n)?vr:sr)(n,r,t);if(void 0!==e&&-1!==e)return ne}function jr(n,r,t){var e,u;if(r=Fn(r,t),er(n))for(e=0,u=n.length;e<u;e++)r(ne,e,n);else{var o=nn(n);for(e=0,u=o.length;e<u;e++)r(noe,oe,n)}return n}function _r(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=Array(u),i=0;i<u;i++){var a=e?ei:i;oi=r(na,a,n)}return o}function wr(n){var r=function(r,t,e,u){var o=!er(r)&&nn(r),i=(o||r).length,a=n>0?0:i-1;for(u||(e=ro?oa:a,a+=n);a>=0&&a<i;a+=n){var f=o?oa:a;e=t(e,rf,f,r)}return e};return function(n,t,e,u){var o=arguments.length>=3;return r(n,Fn(t,u,4),e,o)}}var Ar=wr(1),xr=wr(-1);function Sr(n,r,t){var e=;return r=qn(r,t),jr(n,(function(n,t,u){r(n,t,u)&&e.push(n)})),e}function Or(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o<u;o++){var i=e?eo:o;if(!r(ni,i,n))return!1}return!0}function Mr(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o<u;o++){var i=e?eo:o;if(r(ni,i,n))return!0}return!1}function Er(n,r,t,e){return er(n)||(n=jn(n)),("number"!=typeof t||e)&&(t=0),gr(n,r,t)>=0}var Br=j((function(n,r,t){var e,u;return D(r)?u=r:(r=Nn(r),e=r.slice(0,-1),r=rr.length-1),_r(n,(function(n){var o=u;if(!o){if(e&&e.length&&(n=In(n,e)),null==n)return;o=nr}return null==o?o:o.apply(n,t)}))}));function Nr(n,r){return _r(n,Rn(r))}function Ir(n,r,t){var e,u,o=-1/0,i=-1/0;if(null==r||"number"==typeof r&&"object"!=typeof n0&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;a<f;a++)null!=(e=na)&&e>o&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))>i||u===-1/0&&o===-1/0)&&(o=n,i=u)}));return o}function Tr(n,r,t){if(null==r||t)return er(n)||(n=jn(n)),nWn(n.length-1);var e=er(n)?En(n):jn(n),u=Y(e);r=Math.max(Math.min(r,u),0);for(var o=u-1,i=0;i<r;i++){var a=Wn(i,o),f=ei;ei=ea,ea=f}return e.slice(0,r)}function kr(n,r){return function(t,e,u){var o=r?,:{};return e=qn(e,u),jr(t,(function(r,u){var i=e(r,u,t);n(o,r,i)})),o}}var Dr=kr((function(n,r,t){W(n,t)?nt.push(r):nt=r})),Rr=kr((function(n,r,t){nt=r})),Fr=kr((function(n,r,t){W(n,t)?nt++:nt=1})),Vr=kr((function(n,r,t){nt?0:1.push(r)}),!0),Pr=/^\ud800-\udfff|\ud800-\udbff\udc00-\udfff|\ud800-\udfff/g;function qr(n,r,t){return r in t}var Ur=j((function(n,r){var t={},e=r0;if(null==n)return t;D(e)?(r.length>1&&(e=Fn(e,r1)),r=an(n)):(e=qr,r=ur(r,!1,!1),n=Object(n));for(var u=0,o=r.length;u<o;u++){var i=ru,a=ni;e(a,i,n)&&(ti=a)}return t})),Wr=j((function(n,r){var t,e=r0;return D(e)?(e=fr(e),r.length>1&&(t=r1)):(r=_r(ur(r,!1,!1),String),e=function(n,t){return!Er(r,t)}),Ur(n,e,t)}));function zr(n,r,t){return i.call(n,0,Math.max(0,n.length-(null==r||t?1:r)))}function Lr(n,r,t){return null==n||n.length<1?null==r||t?void 0::null==r||t?n0:zr(n,n.length-r)}function $r(n,r,t){return i.call(n,null==r||t?1:r)}var Cr=j((function(n,r){return r=ur(r,!0,!0),Sr(n,(function(n){return!Er(r,n)}))})),Kr=j((function(n,r){return Cr(n,r)}));function Jr(n,r,t,e){A(r)||(e=t,t=r,r=!1),null!=t&&(t=qn(t,e));for(var u=,o=,i=0,a=Y(n);i<a;i++){var f=ni,c=t?t(f,i,n):f;r&&!t?(i&&o===c||u.push(f),o=c):t?Er(o,c)||(o.push(c),u.push(f)):Er(u,f)||u.push(f)}return u}var Gr=j((function(n){return Jr(ur(n,!0,!0))}));function Hr(n){for(var r=n&&Ir(n,Y).length||0,t=Array(r),e=0;e<r;e++)te=Nr(n,e);return t}var Qr=j(Hr);function Xr(n,r){return n._chain?tn(r).chain():r}function Yr(n){return jr(wn(n),(function(r){var t=tnr=nr;tn.prototyper=function(){var n=this._wrapped;return o.apply(n,arguments),Xr(this,t.apply(tn,n))}})),tn}jr("pop","push","reverse","shift","sort","splice","unshift",(function(n){var r=tn;tn.prototypen=function(){var t=this._wrapped;return null!=t&&(r.apply(t,arguments),"shift"!==n&&"splice"!==n||0!==t.length||delete t0),Xr(this,t)}})),jr("concat","join","slice",(function(n){var r=tn;tn.prototypen=function(){var n=this._wrapped;return null!=n&&(n=r.apply(n,arguments)),Xr(this,n)}}));var Zr=Yr({__proto__:null,VERSION:n,restArguments:j,isObject:_,isNull:function(n){return null===n},isUndefined:w,isBoolean:A,isElement:function(n){return!(!n||1!==n.nodeType)},isString:S,isNumber:O,isDate:M,isRegExp:E,isError:B,isSymbol:N,isArrayBuffer:I,isDataView:q,isArray:U,isFunction:D,isArguments:L,isFinite:function(n){return!N(n)&&d(n)&&!isNaN(parseFloat(n))},isNaN:$,isTypedArray:X,isEmpty:function(n){if(null==n)return!0;var r=Y(n);return"number"==typeof r&&(U(n)||S(n)||L(n))?0===r:0===Y(nn(n))},isMatch:rn,isEqual:function(n,r){return on(n,r)},isMap:dn,isWeakMap:gn,isSet:bn,isWeakSet:mn,keys:nn,allKeys:an,values:jn,pairs:function(n){for(var r=nn(n),t=r.length,e=Array(t),u=0;u<t;u++)eu=ru,nru;return e},invert:_n,functions:wn,methods:wn,extend:xn,extendOwn:Sn,assign:Sn,defaults:On,create:function(n,r){var t=Mn(n);return r&&Sn(t,r),t},clone:En,tap:function(n,r){return r(n),n},get:Tn,has:function(n,r){for(var t=(r=Nn(r)).length,e=0;e<t;e++){var u=re;if(!W(n,u))return!1;n=nu}return!!t},mapObject:function(n,r,t){r=qn(r,t);for(var e=nn(n),u=e.length,o={},i=0;i<u;i++){var a=ei;oa=r(na,a,n)}return o},identity:kn,constant:C,noop:Un,toPath:Bn,property:Rn,propertyOf:function(n){return null==n?Un:function(r){return Tn(n,r)}},matcher:Dn,matches:Dn,times:function(n,r,t){var e=Array(Math.max(0,n));r=Fn(r,t,1);for(var u=0;u<n;u++)eu=r(u);return e},random:Wn,now:zn,escape:Cn,unescape:Kn,templateSettings:Jn,template:function(n,r,t){!r&&t&&(r=t),r=On({},r,tn.templateSettings);var e=RegExp((r.escape||Gn).source,(r.interpolate||Gn).source,(r.evaluate||Gn).source.join("|")+"|$","g"),u=0,o="__p+='";n.replace(e,(function(r,t,e,i,a){return o+=n.slice(u,a).replace(Qn,Xn),u=a+r.length,t?o+="'+\n((__t=("+t+"))==null?'':_.escape(__t))+\n'":e?o+="'+\n((__t=("+e+"))==null?'':__t)+\n'":i&&(o+="';\n"+i+"\n__p+='"),r})),o+="';\n";var i,a=r.variable;if(a){if(!Yn.test(a))throw new Error("variable is not a bare identifier: "+a)}else o="with(obj||{}){\n"+o+"}\n",a="obj";o="var __t,__p='',__j=Array.prototype.join,"+"print=function(){__p+=__j.call(arguments,'');};\n"+o+"return __p;\n";try{i=new Function(a,"_",o)}catch(n){throw n.source=o,n}var f=function(n){return i.call(this,n,tn)};return f.source="function("+a+"){\n"+o+"}",f},result:function(n,r,t){var e=(r=Nn(r)).length;if(!e)return D(t)?t.call(n):t;for(var u=0;u<e;u++){var o=null==n?void 0:nru;void 0===o&&(o=t,u=e),n=D(o)?o.call(n):o}return n},uniqueId:function(n){var r=++Zn+"";return n?n+r:r},chain:function(n){var r=tn(n);return r._chain=!0,r},iteratee:Pn,partial:rr,bind:tr,bindAll:or,memoize:function(n,r){var t=function(e){var u=t.cache,o=""+(r?r.apply(this,arguments):e);return W(u,o)||(uo=n.apply(this,arguments)),uo};return t.cache={},t},delay:ir,defer:ar,throttle:function(n,r,t){var e,u,o,i,a=0;t||(t={});var f=function(){a=!1===t.leading?0:zn(),e=null,i=n.apply(u,o),e||(u=o=null)},c=function(){var c=zn();a||!1!==t.leading||(a=c);var l=r-(c-a);return u=this,o=arguments,l<=0||l>r?(e&&(clearTimeout(e),e=null),a=c,i=n.apply(u,o),e||(u=o=null)):e||!1===t.trailing||(e=setTimeout(f,l)),i};return c.cancel=function(){clearTimeout(e),a=0,e=u=o=null},c},debounce:function(n,r,t){var e,u,o,i,a,f=function(){var c=zn()-u;r>c?e=setTimeout(f,r-c):(e=null,t||(i=n.apply(a,o)),e||(o=a=null))},c=j((function(c){return a=this,o=c,u=zn(),e||(e=setTimeout(f,r),t&&(i=n.apply(a,o))),i}));return c.cancel=function(){clearTimeout(e),e=o=a=null},c},wrap:function(n,r){return rr(r,n)},negate:fr,compose:function(){var n=arguments,r=n.length-1;return function(){for(var t=r,e=nr.apply(this,arguments);t--;)e=nt.call(this,e);return e}},after:function(n,r){return function(){if(--n<1)return r.apply(this,arguments)}},before:cr,once:lr,findKey:sr,findIndex:vr,findLastIndex:hr,sortedIndex:yr,indexOf:gr,lastIndexOf:br,find:mr,detect:mr,findWhere:function(n,r){return mr(n,Dn(r))},each:jr,forEach:jr,map:_r,collect:_r,reduce:Ar,foldl:Ar,inject:Ar,reduceRight:xr,foldr:xr,filter:Sr,select:Sr,reject:function(n,r,t){return Sr(n,fr(qn(r)),t)},every:Or,all:Or,some:Mr,any:Mr,contains:Er,includes:Er,include:Er,invoke:Br,pluck:Nr,where:function(n,r){return Sr(n,Dn(r))},max:Ir,min:function(n,r,t){var e,u,o=1/0,i=1/0;if(null==r||"number"==typeof r&&"object"!=typeof n0&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;a<f;a++)null!=(e=na)&&e<o&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))<i||u===1/0&&o===1/0)&&(o=n,i=u)}));return o},shuffle:function(n){return Tr(n,1/0)},sample:Tr,sortBy:function(n,r,t){var e=0;return r=qn(r,t),Nr(_r(n,(function(n,t,u){return{value:n,index:e++,criteria:r(n,t,u)}})).sort((function(n,r){var t=n.criteria,e=r.criteria;if(t!==e){if(t>e||void 0===t)return 1;if(t<e||void 0===e)return-1}return n.index-r.index})),"value")},groupBy:Dr,indexBy:Rr,countBy:Fr,partition:Vr,toArray:function(n){return n?U(n)?i.call(n):S(n)?n.match(Pr):er(n)?_r(n,kn):jn(n):},size:function(n){return null==n?0:er(n)?n.length:nn(n).length},pick:Ur,omit:Wr,first:Lr,head:Lr,take:Lr,initial:zr,last:function(n,r,t){return null==n||n.length<1?null==r||t?void 0::null==r||t?nn.length-1:$r(n,Math.max(0,n.length-r))},rest:$r,tail:$r,drop:$r,compact:function(n){return Sr(n,Boolean)},flatten:function(n,r){return ur(n,r,!1)},without:Kr,uniq:Jr,unique:Jr,union:Gr,intersection:function(n){for(var r=,t=arguments.length,e=0,u=Y(n);e<u;e++){var o=ne;if(!Er(r,o)){var i;for(i=1;i<t&&Er(argumentsi,o);i++);i===t&&r.push(o)}}return r},difference:Cr,unzip:Hr,transpose:Hr,zip:Qr,object:function(n,r){for(var t={},e=0,u=Y(n);e<u;e++)r?tne=re:tne0=ne1;return t},range:function(n,r,t){null==r&&(r=n||0,n=0),t||(t=r<n?-1:1);for(var e=Math.max(Math.ceil((r-n)/t),0),u=Array(e),o=0;o<e;o++,n+=t)uo=n;return u},chunk:function(n,r){if(null==r||r<1)return;for(var t=,e=0,u=n.length;e<u;)t.push(i.call(n,e,e+=r));return t},mixin:Yr,default:tn});return Zr._=Zr,Zr}));
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/bizstyle Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/bizstyle/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/classic Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/classic/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/default Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/default/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/epub Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/epub/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/haiku Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/haiku/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nature Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nature/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nonav Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nonav/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nonav/static/nonav.css Deleted

@@ -1,582 +0,0 @@
-/*
- * nonav.css
- * ~~~~~~~~~~
- *
- * Sphinx stylesheet -- nonav theme.
- *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/* -- main layout ----------------------------------------------------------- */
-
-div.clearer {
-    clear: both;
-}
-
-a:link, a:visited {
-    color: #3333ff;
-    text-decoration: underline;
-}
-
-img {
-    border: 0;
-    max-width: 100%;
-}
-
-/* -- relbar ---------------------------------------------------------------- */
-
-div.related {
-    width: 100%;
-    font-family: sans-serif;
-    font-size: 90%;
-}
-
-div.related h3 {
-    display: none;
-}
-
-div.related ul {
-    margin: 0;
-    padding: 0 0 0 10px;
-    list-style: none;
-}
-
-div.related li {
-    display: inline;
-}
-
-div.related li.right {
-    float: right;
-    margin-right: 5px;
-}
-
-/* -- sidebar --------------------------------------------------------------- */
-
-div.sphinxsidebarwrapper {
-    padding: 10px 5px 0 10px;
-}
-
-div.sphinxsidebar {
-    float: left;
-    width: 230px;
-    margin-left: -100%;
-    font-size: 90%;
-}
-
-div.sphinxsidebar ul {
-    list-style: none;
-}
-
-div.sphinxsidebar ul ul,
-div.sphinxsidebar ul.want-points {
-    margin-left: 20px;
-    list-style: square;
-}
-
-div.sphinxsidebar ul ul {
-    margin-top: 0;
-    margin-bottom: 0;
-}
-
-div.sphinxsidebar form {
-    margin-top: 10px;
-}
-
-div.sphinxsidebar input {
-    border: 1px solid #98dbcc;
-    font-family: sans-serif;
-    font-size: 100%;
-}
-
-img {
-    border: 0;
-    max-width: 100%;
-}
-
-/* -- search page ----------------------------------------------------------- */
-
-ul.search {
-    margin: 10px 0 0 20px;
-    padding: 0;
-}
-
-ul.search li {
-    padding: 5px 0 5px 20px;
-    background-image: url(file.png);
-    background-repeat: no-repeat;
-    background-position: 0 7px;
-}
-
-ul.search li a {
-    font-weight: bold;
-}
-
-ul.search li div.context {
-    color: #888;
-    margin: 2px 0 0 30px;
-    text-align: left;
-}
-
-ul.keywordmatches li.goodmatch a {
-    font-weight: bold;
-}
-
-/* -- index page ------------------------------------------------------------ */
-
-table.contentstable {
-    width: 90%;
-}
-
-table.contentstable p.biglink {
-    line-height: 150%;
-}
-
-a.biglink {
-    font-size: 130%;
-}
-
-span.linkdescr {
-    font-style: italic;
-    padding-top: 5px;
-    font-size: 90%;
-}
-
-/* -- general index --------------------------------------------------------- */
-
-table.indextable td {
-    text-align: left;
-    vertical-align: top;
-}
-
-table.indextable ul {
-    margin-top: 0;
-    margin-bottom: 0;
-    list-style-type: none;
-}
-
-table.indextable > tbody > tr > td > ul {
-    padding-left: 0em;
-}
-
-table.indextable tr.pcap {
-    height: 10px;
-}
-
-table.indextable tr.cap {
-    margin-top: 10px;
-    background-color: #f2f2f2;
-}
-
-img.toggler {
-    margin-right: 3px;
-    margin-top: 3px;
-    cursor: pointer;
-}
-
-/* -- domain module index --------------------------------------------------- */
-
-table.modindextable td {
-    padding: 2px;
-    border-collapse: collapse;
-}
-
-/* -- general body styles --------------------------------------------------- */
-
-a.headerlink {
-    visibility: hidden;
-}
-
-div.body p.caption {
-    text-align: inherit;
-}
-
-div.body td {
-    text-align: left;
-}
-
-.first {
-    margin-top: 0 !important;
-}
-
-p.rubric {
-    margin-top: 30px;
-    font-weight: bold;
-}
-
-.align-left {
-    text-align: left;
-}
-
-.align-center {
-    text-align: center;
-}
-
-.align-right {
-    text-align: right;
-}
-
-/* -- sidebars -------------------------------------------------------------- */
-
-div.sidebar {
-    margin: 0 0 0.5em 1em;
-    border: 1px solid #ddb;
-    padding: 7px 7px 0 7px;
-    background-color: #ffe;
-    width: 40%;
-    float: right;
-}
-
-p.sidebar-title {
-    font-weight: bold;
-}
-
-/* -- topics ---------------------------------------------------------------- */
-
-div.topic {
-    border: 1px solid #ccc;
-    padding: 7px 7px 0 7px;
-    margin: 10px 0 10px 0;
-}
-
-p.topic-title {
-    font-size: 110%;
-    font-weight: bold;
-    margin-top: 10px;
-}
-
-/* -- admonitions ----------------------------------------------------------- */
-
-div.admonition {
-    margin-top: 10px;
-    margin-bottom: 10px;
-    padding: 7px;
-}
-
-div.admonition dt {
-    font-weight: bold;
-}
-
-div.admonition dl {
-    margin-bottom: 0;
-}
-
-p.admonition-title {
-    margin: 0px 10px 5px 0px;
-    font-weight: bold;
-}
-
-div.body p.centered {
-    text-align: center;
-    margin-top: 25px;
-}
-
-/* -- tables ---------------------------------------------------------------- */
-
-table.docutils {
-    border: 0;
-    border-collapse: collapse;
-}
-
-table caption span.caption-number {
-    font-style: italic;
-}
-
-table caption span.caption-text {
-}
-
-table.docutils td, table.docutils th {
-    padding: 1px 8px 1px 5px;
-    border-top: 0;
-    border-left: 0;
-    border-right: 0;
-    border-bottom: 1px solid #aaa;
-}
-
-table.footnote td, table.footnote th {
-    border: 0 !important;
-}
-
-th {
-    text-align: left;
-    padding-right: 5px;
-}
-
-table.citation {
-    border-left: solid 1px gray;
-    margin-left: 1px;
-}
-
-table.citation td {
-    border-bottom: none;
-}
-
-/* -- figures --------------------------------------------------------------- */
-
-div.figure p.caption span.caption-number,
-figcaption span.caption-number {
-    font-style: italic;
-}
-
-div.figure p.caption span.caption-text,
-figcaption span.caption-text {
-}
-
-/* -- field list styles ----------------------------------------------------- */
-
-table.field-list td, table.field-list th {
-    border: 0 !important;
-}
-
-.field-list ul {
-    margin: 0;
-    padding-left: 1em;
-}
-
-.field-list p {
-    margin: 0;
-}
-
-/* -- other body styles ----------------------------------------------------- */
-
-ol.arabic {
-    list-style: decimal;
-}
-
-ol.loweralpha {
-    list-style: lower-alpha;
-}
-
-ol.upperalpha {
-    list-style: upper-alpha;
-}
-
-ol.lowerroman {
-    list-style: lower-roman;
-}
-
-ol.upperroman {
-    list-style: upper-roman;
-}
-
-dl {
-    margin-bottom: 15px;
-}
-
-dd p {
-    margin-top: 0px;
-}
-
-dd ul, dd table {
-    margin-bottom: 10px;
-}
-
-dd {
-    margin-top: 3px;
-    margin-bottom: 10px;
-    margin-left: 30px;
-}
-
-dt:target, .highlighted {
-    background-color: #ddd;
-}
-
-dl.glossary dt {
-    font-weight: bold;
-    font-size: 110%;
-}
-
-.optional {
-    font-size: 130%;
-}
-
-.sig-paren {
-    font-size: larger;
-}
-
-.versionmodified {
-    font-style: italic;
-}
-
-.system-message {
-    background-color: #fda;
-    padding: 5px;
-    border: 3px solid red;
-}
-
-.footnote:target  {
-    background-color: #dddddd;
-}
-
-.line-block {
-    display: block;
-    margin-top: 1em;
-    margin-bottom: 1em;
-}
-
-.line-block .line-block {
-    margin-top: 0;
-    margin-bottom: 0;
-    margin-left: 1.5em;
-}
-
-.guilabel, .menuselection {
-    font-style: italic;
-}
-
-.accelerator {
-    text-decoration: underline;
-}
-
-.classifier {
-    font-style: oblique;
-}
-
-abbr, acronym {
-    border-bottom: dotted 1px;
-    cursor: help;
-}
-
-/* -- code displays --------------------------------------------------------- */
-
-pre {
-    font-family: monospace;
-    overflow: auto;
-    overflow-y: hidden;
-}
-
-td.linenos pre {
-    padding: 5px 0px;
-    border: 0;
-    background-color: transparent;
-    color: #aaa;
-}
-
-table.highlighttable {
-    margin-left: 0.5em;
-}
-
-table.highlighttable td {
-    padding: 0 0.5em 0 0.5em;
-}
-
-code {
-    font-family: monospace;
-}
-
-div.code-block-caption span.caption-number {
-    padding: 0.1em 0.3em;
-    font-style: italic;
-}
-
-div.code-block-caption span.caption-text {
-}
-
-div.literal-block-wrapper {
-    padding: 1em 1em 0;
-}
-
-div.literal-block-wrapper div.highlight {
-    margin: 0;
-}
-
-code.descname {
-    background-color: transparent;
-    font-weight: bold;
-    font-size: 1.2em;
-}
-
-code.descclassname {
-    background-color: transparent;
-}
-
-code.xref, a code {
-    background-color: transparent;
-    font-weight: bold;
-}
-
-h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
-    background-color: transparent;
-}
-
-/* -- math display ---------------------------------------------------------- */
-
-img.math {
-    vertical-align: middle;
-}
-
-div.body div.math p {
-    text-align: center;
-}
-
-span.eqno {
-    float: right;
-}
-
-/* -- special divs  --------------------------------------------------------- */
-
-div.quotebar {
-    background-color: #e3eff1;
-    max-width: 250px;
-    float: right;
-    font-family: sans-serif;
-    padding: 7px 7px;
-    border: 1px solid #ccc;
-}
-div.footer {
-    background-color: #e3eff1;
-    padding: 3px 8px 3px 0;
-    clear: both;
-    font-family: sans-serif;
-    font-size: 80%;
-    text-align: right;
-}
-
-div.footer a {
-    text-decoration: underline;
-}
-
-/* -- link-target ----------------------------------------------------------- */
-
-.link-target {
-    font-size: 80%;
-}
-
-table .link-target {
-    /* Do not show links in tables, there is not enough space */
-    display: none;
-}
-
-/* -- font-face ------------------------------------------------------------- */
-
-/*
-@font-face {
-    font-family: "LiberationNarrow";
-    font-style: normal;
-    font-weight: normal;
-    src: url("res:///Data/fonts/LiberationNarrow-Regular.otf")
-        format("opentype");
-}
-@font-face {
-    font-family: "LiberationNarrow";
-    font-style: oblique, italic;
-    font-weight: normal;
-    src: url("res:///Data/fonts/LiberationNarrow-Italic.otf")
-        format("opentype");
-}
-@font-face {
-    font-family: "LiberationNarrow";
-    font-style: normal;
-    font-weight: bold;
-    src: url("res:///Data/fonts/LiberationNarrow-Bold.otf")
-        format("opentype");
-}
-@font-face {
-    font-family: "LiberationNarrow";
-    font-style: oblique, italic;
-    font-weight: bold;
-    src: url("res:///Data/fonts/LiberationNarrow-BoldItalic.otf")
-        format("opentype");
-}
-*/

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/pyramid Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/pyramid/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/pyramid/static/epub.css Deleted

@@ -1,310 +0,0 @@
-/*
- * default.css_t
- * ~~~~~~~~~~~~~
- *
- * Sphinx stylesheet -- default theme.
- *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-@import url("basic.css");
-
-/* -- page layout ----------------------------------------------------------- */
-
-body {
-    font-family: {{ theme_bodyfont }};
-    font-size: 100%;
-    background-color: {{ theme_footerbgcolor }};
-    color: #000;
-    margin: 0;
-    padding: 0;
-}
-
-div.document {
-    background-color: {{ theme_sidebarbgcolor }};
-}
-
-div.documentwrapper {
-    float: left;
-    width: 100%;
-}
-
-div.bodywrapper {
-    margin: 0 0 0 230px;
-}
-
-div.body {
-    background-color: {{ theme_bgcolor }};
-    color: {{ theme_textcolor }};
-    padding: 0 20px 30px 20px;
-}
-
-{%- if theme_rightsidebar|tobool %}
-div.bodywrapper {
-    margin: 0 230px 0 0;
-}
-{%- endif %}
-
-div.footer {
-    color: {{ theme_footertextcolor }};
-    width: 100%;
-    padding: 9px 0 9px 0;
-    text-align: center;
-    font-size: 75%;
-}
-
-div.footer a {
-    color: {{ theme_footertextcolor }};
-    text-decoration: underline;
-}
-
-div.related {
-    background-color: {{ theme_relbarbgcolor }};
-    line-height: 30px;
-    color: {{ theme_relbartextcolor }};
-}
-
-div.related a {
-    color: {{ theme_relbarlinkcolor }};
-}
-
-div.sphinxsidebar {
-    {%- if theme_stickysidebar|tobool %}
-    top: 30px;
-    bottom: 0;
-    margin: 0;
-    position: fixed;
-    overflow: auto;
-    height: auto;
-    {%- endif %}
-    {%- if theme_rightsidebar|tobool %}
-    float: right;
-    {%- if theme_stickysidebar|tobool %}
-    right: 0;
-    {%- endif %}
-    {%- endif %}
-}
-
-{%- if theme_stickysidebar|tobool %}
-/* this is nice, but it it leads to hidden headings when jumping
-   to an anchor */
-/*
-div.related {
-    position: fixed;
-}
-
-div.documentwrapper {
-    margin-top: 30px;
-}
-*/
-{%- endif %}
-
-div.sphinxsidebar h3 {
-    font-family: {{ theme_headfont }};
-    color: {{ theme_sidebartextcolor }};
-    font-size: 1.4em;
-    font-weight: normal;
-    margin: 0;
-    padding: 0;
-}
-
-div.sphinxsidebar h3 a {
-    color: {{ theme_sidebartextcolor }};
-}
-
-div.sphinxsidebar h4 {
-    font-family: {{ theme_headfont }};
-    color: {{ theme_sidebartextcolor }};
-    font-size: 1.3em;
-    font-weight: normal;
-    margin: 5px 0 0 0;
-    padding: 0;
-}
-
-div.sphinxsidebar p {
-    color: {{ theme_sidebartextcolor }};
-}
-
-div.sphinxsidebar p.topless {
-    margin: 5px 10px 10px 10px;
-}
-
-div.sphinxsidebar ul {
-    margin: 10px;
-    padding: 0;
-    color: {{ theme_sidebartextcolor }};
-}
-
-div.sphinxsidebar a {
-    color: {{ theme_sidebarlinkcolor }};
-}
-
-div.sphinxsidebar input {
-    border: 1px solid {{ theme_sidebarlinkcolor }};
-    font-family: sans-serif;
-    font-size: 1em;
-}
-
-{% if theme_collapsiblesidebar|tobool %}
-/* for collapsible sidebar */
-div#sidebarbutton {
-    background-color: {{ theme_sidebarbtncolor }};
-}
-{% endif %}
-
-/* -- hyperlink styles ------------------------------------------------------ */
-
-a {
-    color: {{ theme_linkcolor }};
-    text-decoration: none;
-}
-
-a:visited {
-    color: {{ theme_visitedlinkcolor }};
-    text-decoration: none;
-}
-
-a:hover {
-    text-decoration: underline;
-}
-
-{% if theme_externalrefs|tobool %}
-a.external {
-   text-decoration: none;
-   border-bottom: 1px dashed {{ theme_linkcolor }};
-}
-
-a.external:hover {
-   text-decoration: none;
-   border-bottom: none;
-}
-
-a.external:visited {
-    text-decoration: none;
-    border-bottom: 1px dashed {{ theme_visitedlinkcolor }};
-}
-{% endif %}
-
-/* -- body styles ----------------------------------------------------------- */
-
-div.body h1,
-div.body h2,
-div.body h3,
-div.body h4,
-div.body h5,
-div.body h6 {
-    font-family: {{ theme_headfont }};
-    background-color: {{ theme_headbgcolor }};
-    font-weight: normal;
-    color: {{ theme_headtextcolor }};
-    border-bottom: 1px solid #ccc;
-    margin: 20px -20px 10px -20px;
-    padding: 3px 0 3px 10px;
-}
-
-div.body h1 { margin-top: 0; font-size: 200%; }
-div.body h2 { font-size: 160%; }
-div.body h3 { font-size: 140%; }
-div.body h4 { font-size: 120%; }
-div.body h5 { font-size: 110%; }
-div.body h6 { font-size: 100%; }
-
-a.headerlink {
-    color: {{ theme_headlinkcolor }};
-    font-size: 0.8em;
-    padding: 0 4px 0 4px;
-    text-decoration: none;
-}
-
-a.headerlink:hover {
-    background-color: {{ theme_headlinkcolor }};
-    color: white;
-}
-
-div.body p, div.body dd, div.body li {
-    text-align: justify;
-    line-height: 130%;
-}
-
-div.admonition p.admonition-title + p {
-    display: inline;
-}
-
-div.admonition p {
-    margin-bottom: 5px;
-}
-
-div.admonition pre {
-    margin-bottom: 5px;
-}
-
-div.admonition ul, div.admonition ol {
-    margin-bottom: 5px;
-}
-
-div.note {
-    background-color: #eee;
-    border: 1px solid #ccc;
-}
-
-div.seealso {
-    background-color: #ffc;
-    border: 1px solid #ff6;
-}
-
-div.topic {
-    background-color: #eee;
-}
-
-div.warning {
-    background-color: #ffe4e4;
-    border: 1px solid #f66;
-}
-
-p.admonition-title {
-    display: inline;
-}
-
-p.admonition-title:after {
-    content: ":";
-}
-
-pre {
-    padding: 5px;
-    background-color: {{ theme_codebgcolor }};
-    color: {{ theme_codetextcolor }};
-    line-height: 120%;
-    border: 1px solid #ac9;
-    border-left: none;
-    border-right: none;
-}
-
-code {
-    background-color: #ecf0f3;
-    padding: 0 1px 0 1px;
-    font-size: 0.95em;
-}
-
-th {
-    background-color: #ede;
-}
-
-.warning code {
-    background: #efc2c2;
-}
-
-.note code {
-    background: #d6d6d6;
-}
-
-.viewcode-back {
-    font-family: {{ theme_bodyfont }};
-}
-
-div.viewcode-block:target {
-    background-color: #f4debf;
-    border-top: 1px solid #ac9;
-    border-bottom: 1px solid #ac9;
-}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/scrolls Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/scrolls/artwork Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/scrolls/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/sphinxdoc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/sphinxdoc/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/traditional Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/traditional/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/post_transforms Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/compat.py Deleted

@@ -1,41 +0,0 @@
-"""
-    sphinx.util.compat
-    ~~~~~~~~~~~~~~~~~~
-
-    modules for backward compatibility
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import sys
-from typing import TYPE_CHECKING, Any, Dict
-
-if TYPE_CHECKING:
-    from sphinx.application import Sphinx
-
-
-def register_application_for_autosummary(app: "Sphinx") -> None:
-    """Register application object to autosummary module.
-
-    Since Sphinx-1.7, documenters and attrgetters are registered into
-    application object.  As a result, the arguments of
-    ``get_documenter()`` has been changed.  To keep compatibility,
-    this handler registers application object to the module.
-    """
-    if 'sphinx.ext.autosummary' in sys.modules:
-        from sphinx.ext import autosummary
-        if hasattr(autosummary, '_objects'):
-            autosummary._objects'_app' = app  # type: ignore
-        else:
-            autosummary._app = app  # type: ignore
-
-
-def setup(app: "Sphinx") -> Dictstr, Any:
-    app.connect('builder-inited', register_application_for_autosummary, priority=100)
-
-    return {
-        'version': 'builtin',
-        'parallel_read_safe': True,
-        'parallel_write_safe': True,
-    }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/jsdump.py Deleted

@@ -1,200 +0,0 @@
-"""
-    sphinx.util.jsdump
-    ~~~~~~~~~~~~~~~~~~
-
-    This module implements a simple JavaScript serializer.
-    Uses the basestring encode function from simplejson by Bob Ippolito.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import re
-from typing import IO, Any, Dict, List, Match, Union
-
-_str_re = re.compile(r'"(\\\\|\\"|^")*"')
-_int_re = re.compile(r'\d+')
-_name_re = re.compile(r'a-zA-Z_\w*')
-_nameonly_re = re.compile(r'a-zA-Z_a-zA-Z0-9_*$')
-
-# escape \, ", control characters and everything outside ASCII
-ESCAPE_ASCII = re.compile(r'(\\"|^\ -~)')
-ESCAPE_DICT = {
-    '\\': '\\\\',
-    '"': '\\"',
-    '\b': '\\b',
-    '\f': '\\f',
-    '\n': '\\n',
-    '\r': '\\r',
-    '\t': '\\t',
-}
-
-ESCAPED = re.compile(r'\\u.{4}|\\.')
-
-
-def encode_string(s: str) -> str:
-    def replace(match: Match) -> str:
-        s = match.group(0)
-        try:
-            return ESCAPE_DICTs
-        except KeyError:
-            n = ord(s)
-            if n < 0x10000:
-                return '\\u%04x' % (n,)
-            else:
-                # surrogate pair
-                n -= 0x10000
-                s1 = 0xd800 | ((n >> 10) & 0x3ff)
-                s2 = 0xdc00 | (n & 0x3ff)
-                return '\\u%04x\\u%04x' % (s1, s2)
-    return '"' + str(ESCAPE_ASCII.sub(replace, s)) + '"'
-
-
-def decode_string(s: str) -> str:
-    return ESCAPED.sub(lambda m: eval('"' + m.group() + '"'), s)
-
-
-reswords = set("""\
-abstract   else   instanceof   switch
-boolean   enum   int   synchronized
-break   export   interface   this
-byte   extends   long   throw
-case   false   native   throws
-catch   final   new   transient
-char   finally   null   true
-class   float   package   try
-const   for   private   typeof
-continue   function   protected   var
-debugger   goto   public   void
-default   if   return   volatile
-delete   implements   short   while
-do   import   static   with
-double   in   super""".split())
-
-
-def dumps(obj: Any, key: bool = False) -> str:
-    if key:
-        if not isinstance(obj, str):
-            obj = str(obj)
-        if _nameonly_re.match(obj) and obj not in reswords:
-            return obj  # return it as a bare word
-        else:
-            return encode_string(obj)
-    if obj is None:
-        return 'null'
-    elif obj is True or obj is False:
-        return 'true' if obj else 'false'
-    elif isinstance(obj, (int, float)):
-        return str(obj)
-    elif isinstance(obj, dict):
-        return '{%s}' % ','.join(sorted('%s:%s' % (
-            dumps(key, True),
-            dumps(value)
-        ) for key, value in obj.items()))
-    elif isinstance(obj, set):
-        return '%s' % ','.join(sorted(dumps(x) for x in obj))
-    elif isinstance(obj, (tuple, list)):
-        return '%s' % ','.join(dumps(x) for x in obj)
-    elif isinstance(obj, str):
-        return encode_string(obj)
-    raise TypeError(type(obj))
-
-
-def dump(obj: Any, f: IO) -> None:
-    f.write(dumps(obj))
-
-
-def loads(x: str) -> Any:
-    """Loader that can read the JS subset the indexer produces."""
-    nothing = object()
-    i = 0
-    n = len(x)
-    stack: ListUnionList, Dict = 
-    obj: Any = nothing
-    key = False
-    keys = 
-    while i < n:
-        c = xi
-        if c == '{':
-            obj = {}
-            stack.append(obj)
-            key = True
-            keys.append(nothing)
-            i += 1
-        elif c == '':
-            obj = 
-            stack.append(obj)
-            key = False
-            keys.append(nothing)
-            i += 1
-        elif c in '}':
-            if key:
-                if keys-1 is not nothing:
-                    raise ValueError("unfinished dict")
-                # empty dict
-                key = False
-            oldobj = stack.pop()
-            keys.pop()
-            if stack:
-                obj = stack-1
-                if isinstance(obj, dict):
-                    if keys-1 is nothing:
-                        raise ValueError("invalid key object", oldobj)
-                    objkeys-1 = oldobj
-                else:
-                    obj.append(oldobj)
-            else:
-                break
-            i += 1
-        elif c == ',':
-            if key:
-                raise ValueError("multiple keys")
-            if isinstance(obj, dict):
-                key = True
-            i += 1
-        elif c == ':':
-            if not isinstance(obj, dict):
-                raise ValueError("colon in list")
-            i += 1
-            if not key:
-                raise ValueError("multiple values")
-            key = False
-        else:
-            y: Any = None
-            m = _str_re.match(x, i)
-            if m:
-                y = decode_string(m.group()1:-1)
-            else:
-                m = _int_re.match(x, i)
-                if m:
-                    y = int(m.group())
-                else:
-                    m = _name_re.match(x, i)
-                    if m:
-                        y = m.group()
-                        if y == 'true':
-                            y = True
-                        elif y == 'false':
-                            y = False
-                        elif y == 'null':
-                            y = None
-                        elif not key:
-                            raise ValueError("bareword as value")
-                    else:
-                        raise ValueError("read error at pos %d" % i)
-            i = m.end()
-            if isinstance(obj, dict):
-                if key:
-                    keys-1 = y
-                else:
-                    objkeys-1 = y
-                    key = False
-            else:
-                obj.append(y)
-    if obj is nothing:
-        raise ValueError("nothing loaded from string")
-    return obj
-
-
-def load(f: IO) -> Any:
-    return loads(f.read())

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/pycompat.py Deleted

@@ -1,59 +0,0 @@
-"""
-    sphinx.util.pycompat
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Stuff for Python version compatibility.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Callable
-
-from sphinx.deprecation import RemovedInSphinx60Warning
-
-# ------------------------------------------------------------------------------
-# Python 2/3 compatibility
-
-
-# convert_with_2to3():
-# support for running 2to3 over config files
-def convert_with_2to3(filepath: str) -> str:
-    warnings.warn('convert_with_2to3() is deprecated',
-                  RemovedInSphinx60Warning, stacklevel=2)
-
-    try:
-        from lib2to3.pgen2.parse import ParseError
-        from lib2to3.refactor import RefactoringTool, get_fixers_from_package
-    except ImportError as exc:
-        # python 3.9.0a6+ emits PendingDeprecationWarning for lib2to3.
-        # Additionally, removal of the module is still discussed at PEP-594.
-        # To support future python, this catches ImportError for lib2to3.
-        raise SyntaxError from exc
-
-    fixers = get_fixers_from_package('lib2to3.fixes')
-    refactoring_tool = RefactoringTool(fixers)
-    source = refactoring_tool._read_python_source(filepath)0
-    try:
-        tree = refactoring_tool.refactor_string(source, 'conf.py')
-    except ParseError as err:
-        # do not propagate lib2to3 exceptions
-        lineno, offset = err.context1
-        # try to match ParseError details with SyntaxError details
-
-        raise SyntaxError(err.msg, (filepath, lineno, offset, err.value)) from err
-    return str(tree)
-
-
-def execfile_(filepath: str, _globals: Any, open: Callable = open) -> None:
-    warnings.warn('execfile_() is deprecated',
-                  RemovedInSphinx60Warning, stacklevel=2)
-    from sphinx.util.osutil import fs_encoding
-    with open(filepath, 'rb') as f:
-        source = f.read()
-
-    # compile to a code object, handle syntax errors
-    filepath_enc = filepath.encode(fs_encoding)
-    code = compile(source, filepath_enc, 'exec')
-    exec(code, _globals)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/smartypants.py Deleted

@@ -1,391 +0,0 @@
-"""
-    sphinx.util.smartypants
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    This is extracted (with minor adaptations for flake8 compliance) from
-    docutils’ docutils/utils/smartquotes.py as of revision 8097 (30 May 2017),
-    in order to backport for Sphinx usage with Docutils < 0.14 extra language
-    configurations and fixes. Replaces earlier smartypants version as used up
-    to Sphinx 1.5.6.
-
-    :copyright: © 2010 Günter Milde,
-                original `SmartyPants`_: © 2003 John Gruber
-                smartypants.py:          © 2004, 2007 Chad Miller
-    :license: Released under the terms of the `2-Clause BSD license`_, in short:
-
-       Copying and distribution of this file, with or without modification,
-       are permitted in any medium without royalty provided the copyright
-       notices and this notice are preserved.
-       This file is offered as-is, without any warranty.
-
-    .. _SmartyPants: https://daringfireball.net/projects/smartypants/
-    .. _2-Clause BSD license: https://spdx.org/licenses/BSD-2-Clause
-
-    See the LICENSE file and the original docutils code for details.
-
-"""
-
-import re
-import warnings
-from typing import Generator, Iterable, Tuple
-
-from docutils.utils import smartquotes
-
-from sphinx.deprecation import RemovedInSphinx60Warning
-from sphinx.util.docutils import __version_info__ as docutils_version
-
-warnings.warn('sphinx.util.smartypants is deprecated.',
-              RemovedInSphinx60Warning)
-
-langquotes = {'af':           '“”‘’',
-              'af-x-altquot': '„”‚’',
-              'bg':           '„“‚‘',  # Bulgarian, https://bg.wikipedia.org/wiki/Кавички
-              'ca':           '«»“”',
-              'ca-x-altquot': '“”‘’',
-              'cs':           '„“‚‘',
-              'cs-x-altquot': '»«›‹',
-              'da':           '»«›‹',
-              'da-x-altquot': '„“‚‘',
-              # 'da-x-altquot2': '””’’',
-              'de':           '„“‚‘',
-              'de-x-altquot': '»«›‹',
-              'de-ch':        '«»‹›',
-              'el':           '«»“”',
-              'en':           '“”‘’',
-              'en-uk-x-altquot': '‘’“”',  # Attention: " → ‘ and ' → “ !
-              'eo':           '“”‘’',
-              'es':           '«»“”',
-              'es-x-altquot': '“”‘’',
-              'et':           '„“‚‘',  # no secondary quote listed in
-              'et-x-altquot': '«»‹›',  # the sources above (wikipedia.org)
-              'eu':           '«»‹›',
-              'fi':           '””’’',
-              'fi-x-altquot': '»»››',
-              'fr':           ('« ', ' »', '“', '”'),  # full no-break space
-              'fr-x-altquot': ('« ', ' »', '“', '”'),  # narrow no-break space
-              'fr-ch':        '«»‹›',
-              'fr-ch-x-altquot': ('« ',  ' »', '‹ ', ' ›'),  # narrow no-break space
-              # http://typoguide.ch/
-              'gl':           '«»“”',
-              'he':           '”“»«',  # Hebrew is RTL, test position:
-              'he-x-altquot': '„”‚’',  # low quotation marks are opening.
-              # 'he-x-altquot': '“„‘‚',  # RTL: low quotation marks opening
-              'hr':           '„”‘’',  # https://hrvatska-tipografija.com/polunavodnici/
-              'hr-x-altquot': '»«›‹',
-              'hsb':          '„“‚‘',
-              'hsb-x-altquot': '»«›‹',
-              'hu':           '„”«»',
-              'is':           '„“‚‘',
-              'it':           '«»“”',
-              'it-ch':        '«»‹›',
-              'it-x-altquot': '“”‘’',
-              # 'it-x-altquot2': '“„‘‚',  # 7 in headlines
-              'ja':           '「」『』',
-              'lt':           '„“‚‘',
-              'lv':           '„“‚‘',
-              'mk':           '„“‚‘',  # Macedonian,
-              # https://mk.wikipedia.org/wiki/Правопис_и_правоговор_на_македонскиот_јазик
-              'nl':           '“”‘’',
-              'nl-x-altquot': '„”‚’',
-              # 'nl-x-altquot2': '””’’',
-              'nb':           '«»’’',  # Norsk bokmål (canonical form 'no')
-              'nn':           '«»’’',  # Nynorsk 10
-              'nn-x-altquot': '«»‘’',  # 8, 10
-              # 'nn-x-altquot2': '«»«»',  # 9, 10
-              # 'nn-x-altquot3': '„“‚‘',  # 10
-              'no':           '«»’’',  # Norsk bokmål 10
-              'no-x-altquot': '«»‘’',  # 8, 10
-              # 'no-x-altquot2': '«»«»',  # 9, 10
-              # 'no-x-altquot3': '„“‚‘',  # 10
-              'pl':           '„”«»',
-              'pl-x-altquot': '«»‚’',
-              # 'pl-x-altquot2': '„”‚’',
-              # https://pl.wikipedia.org/wiki/Cudzys%C5%82%C3%B3w
-              'pt':           '«»“”',
-              'pt-br':        '“”‘’',
-              'ro':           '„”«»',
-              'ru':           '«»„“',
-              'sh':           '„”‚’',  # Serbo-Croatian
-              'sh-x-altquot': '»«›‹',
-              'sk':           '„“‚‘',  # Slovak
-              'sk-x-altquot': '»«›‹',
-              'sl':           '„“‚‘',  # Slovenian
-              'sl-x-altquot': '»«›‹',
-              'sq':           '«»‹›',  # Albanian
-              'sq-x-altquot': '“„‘‚',
-              'sr':           '„”’’',
-              'sr-x-altquot': '»«›‹',
-              'sv':           '””’’',
-              'sv-x-altquot': '»»››',
-              'tr':           '“”‘’',
-              'tr-x-altquot': '«»‹›',
-              # 'tr-x-altquot2': '“„‘‚',  # 7 antiquated?
-              'uk':           '«»„“',
-              'uk-x-altquot': '„“‚‘',
-              'zh-cn':        '“”‘’',
-              'zh-tw':        '「」『』',
-              }
-
-
-def educateQuotes(text: str, language: str = 'en') -> str:
-    """
-    Parameter:  - text string (unicode or bytes).
-                - language (`BCP 47` language tag.)
-    Returns:    The `text`, with "educated" curly quote characters.
-
-    Example input:  "Isn't this fun?"
-    Example output: “Isn’t this fun?“;
-    """
-
-    smart = smartquotes.smartchars(language)
-    try:
-        apostrophe = smart.apostrophe
-    except Exception:
-        apostrophe = '’'
-
-    # oldtext = text
-    punct_class = r"""!"#\$\%'()*+,-.\/:;<=>?\@\\\\\^_`{|}~"""
-
-    # Special case if the very first character is a quote
-    # followed by punctuation at a non-word-break.
-    # Close the quotes by brute force:
-    text = re.sub(r"""^'(?=%s\\B)""" % (punct_class,), smart.csquote, text)
-    text = re.sub(r"""^"(?=%s\\B)""" % (punct_class,), smart.cpquote, text)
-
-    # Special case for double sets of quotes, e.g.:
-    #   <p>He said, "'Quoted' words in a larger quote."</p>
-    text = re.sub(r""""'(?=\w)""", smart.opquote + smart.osquote, text)
-    text = re.sub(r"""'"(?=\w)""", smart.osquote + smart.opquote, text)
-
-    # Special case for decade abbreviations (the '80s):
-    if language.startswith('en'):  # TODO similar cases in other languages?
-        text = re.sub(r"""'(?=\d{2}s)""", apostrophe, text, flags=re.UNICODE)
-
-    close_class = r"""^\ \t\r\n\\{\(\-"""
-    dec_dashes = r"""&#8211;|&#8212;"""
-
-    # Get most opening single quotes:
-    opening_single_quotes_regex = re.compile(r"""
-                    (
-                            \s          |   # a whitespace char, or
-                            &nbsp;      |   # a non-breaking space entity, or
-                            --          |   # dashes, or
-                            &mndash;  |   # named dash entities
-                            %s          |   # or decimal entities
-                            &\#x20134;    # or hex
-                    )
-                    '                 # the quote
-                    (?=\w)            # followed by a word character
-                    """ % (dec_dashes,), re.VERBOSE | re.UNICODE)
-    text = opening_single_quotes_regex.sub(r'\1' + smart.osquote, text)
-
-    # In many locales, single closing quotes are different from apostrophe:
-    if smart.csquote != apostrophe:
-        apostrophe_regex = re.compile(r"(?<=(\w|\d))'(?=\w)", re.UNICODE)
-        text = apostrophe_regex.sub(apostrophe, text)
-    # TODO: keep track of quoting level to recognize apostrophe in, e.g.,
-    # "Ich fass' es nicht."
-
-    closing_single_quotes_regex = re.compile(r"""
-                    (%s)
-                    '
-                    (?!\s  |       # whitespace
-                       s\b |
-                        \d         # digits   ('80s)
-                    )
-                    """ % (close_class,), re.VERBOSE | re.UNICODE)
-    text = closing_single_quotes_regex.sub(r'\1' + smart.csquote, text)
-
-    closing_single_quotes_regex = re.compile(r"""
-                    (%s)
-                    '
-                    (\s | s\b)
-                    """ % (close_class,), re.VERBOSE | re.UNICODE)
-    text = closing_single_quotes_regex.sub(r'\1%s\2' % smart.csquote, text)
-
-    # Any remaining single quotes should be opening ones:
-    text = re.sub(r"""'""", smart.osquote, text)
-
-    # Get most opening double quotes:
-    opening_double_quotes_regex = re.compile(r"""
-                    (
-                            \s          |   # a whitespace char, or
-                            &nbsp;      |   # a non-breaking space entity, or
-                            --          |   # dashes, or
-                            &mndash;  |   # named dash entities
-                            %s          |   # or decimal entities
-                            &\#x20134;    # or hex
-                    )
-                    "                 # the quote
-                    (?=\w)            # followed by a word character
-                    """ % (dec_dashes,), re.VERBOSE)
-    text = opening_double_quotes_regex.sub(r'\1' + smart.opquote, text)
-
-    # Double closing quotes:
-    closing_double_quotes_regex = re.compile(r"""
-                    #(%s)?   # character that indicates the quote should be closing
-                    "
-                    (?=\s)
-                    """ % (close_class,), re.VERBOSE)
-    text = closing_double_quotes_regex.sub(smart.cpquote, text)
-
-    closing_double_quotes_regex = re.compile(r"""
-                    (%s)   # character that indicates the quote should be closing
-                    "
-                    """ % (close_class,), re.VERBOSE)
-    text = closing_double_quotes_regex.sub(r'\1' + smart.cpquote, text)
-
-    # Any remaining quotes should be opening ones.
-    text = re.sub(r'"', smart.opquote, text)
-
-    return text
-
-
-def educate_tokens(text_tokens: IterableTuplestr, str,
-                   attr: str = smartquotes.default_smartypants_attr,
-                   language: str = 'en'
-                   ) -> Generatorstr, None, None:
-    """Return iterator that "educates" the items of `text_tokens`.
-
-    This is modified to intercept the ``attr='2'`` as it was used by the
-    Docutils 0.13.1 SmartQuotes transform in a hard coded way. Docutils 0.14
-    uses ``'qDe'``` and is configurable, and its choice is backported here
-    for use by Sphinx with earlier Docutils releases. Similarly ``'1'`` is
-    replaced by ``'qde'``.
-
-    Use ``attr='qDbe'``, resp. ``'qdbe'`` to recover Docutils effect of ``'2'``,
-    resp. ``'1'``.
-
-    refs: https://sourceforge.net/p/docutils/mailman/message/35869025/
-    """
-
-    # Parse attributes:
-    # 0 : do nothing
-    # 1 : set all (but backticks)
-    # 2 : set all (but backticks), using old school en- and em- dash shortcuts
-    # 3 : set all, using inverted old school en and em- dash shortcuts
-    #
-    # q : quotes
-    # b : backtick quotes (``double'' only)
-    # B : backtick quotes (``double'' and `single')
-    # d : dashes
-    # D : old school dashes
-    # i : inverted old school dashes
-    # e : ellipses
-    # w : convert &quot; entities to " for Dreamweaver users
-
-    convert_quot = False  # translate &quot; entities into normal quotes?
-    do_dashes = 0
-    do_backticks = 0
-    do_quotes = False
-    do_ellipses = False
-    do_stupefy = False
-
-    if attr == "1":  # Do everything, turn all options on.
-        do_quotes = True
-        # do_backticks = 1
-        do_dashes = 1
-        do_ellipses = True
-    elif attr == "2":
-        # Do everything, turn all options on, use old school dash shorthand.
-        do_quotes = True
-        # do_backticks = 1
-        do_dashes = 2
-        do_ellipses = True
-    elif attr == "3":
-        # Do everything, use inverted old school dash shorthand.
-        do_quotes = True
-        do_backticks = 1
-        do_dashes = 3
-        do_ellipses = True
-    elif attr == "-1":  # Special "stupefy" mode.
-        do_stupefy = True
-    else:
-        if "q" in attr:
-            do_quotes = True
-        if "b" in attr:
-            do_backticks = 1
-        if "B" in attr:
-            do_backticks = 2
-        if "d" in attr:
-            do_dashes = 1
-        if "D" in attr:
-            do_dashes = 2
-        if "i" in attr:
-            do_dashes = 3
-        if "e" in attr:
-            do_ellipses = True
-        if "w" in attr:
-            convert_quot = True
-
-    prev_token_last_char = " "
-    # Last character of the previous text token. Used as
-    # context to curl leading quote characters correctly.
-
-    for (ttype, text) in text_tokens:
-
-        # skip HTML and/or XML tags as well as empty text tokens
-        # without updating the last character
-        if ttype == 'tag' or not text:
-            yield text
-            continue
-
-        # skip literal text (math, literal, raw, ...)
-        if ttype == 'literal':
-            prev_token_last_char = text-1:
-            yield text
-            continue
-
-        last_char = text-1:  # Remember last char before processing.
-
-        text = smartquotes.processEscapes(text)
-
-        if convert_quot:
-            text = re.sub('&quot;', '"', text)
-
-        if do_dashes == 1:
-            text = smartquotes.educateDashes(text)
-        elif do_dashes == 2:
-            text = smartquotes.educateDashesOldSchool(text)
-        elif do_dashes == 3:
-            text = smartquotes.educateDashesOldSchoolInverted(text)
-
-        if do_ellipses:
-            text = smartquotes.educateEllipses(text)
-
-        # Note: backticks need to be processed before quotes.
-        if do_backticks:
-            text = smartquotes.educateBackticks(text, language)
-
-        if do_backticks == 2:
-            text = smartquotes.educateSingleBackticks(text, language)
-
-        if do_quotes:
-            # Replace plain quotes to prevent conversion to
-            # 2-character sequence in French.
-            context = prev_token_last_char.replace('"', ';').replace("'", ';')
-            text = educateQuotes(context + text, language)1:
-
-        if do_stupefy:
-            text = smartquotes.stupefyEntities(text, language)
-
-        # Remember last char as context for the next token
-        prev_token_last_char = last_char
-
-        text = smartquotes.processEscapes(text, restore=True)
-
-        yield text
-
-
-if docutils_version < (0, 13, 2):
-    # Monkey patch the old docutils versions to fix the issues mentioned
-    # at https://sourceforge.net/p/docutils/bugs/313/
-    # at https://sourceforge.net/p/docutils/bugs/317/
-    # and more
-    smartquotes.educateQuotes = educateQuotes
-    smartquotes.educate_tokens = educate_tokens
-
-    # Fix the issue with French quotes mentioned at
-    # https://sourceforge.net/p/docutils/mailman/message/35760696/
-    # Add/fix other languages as well
-    smartquotes.smartchars.quotes = langquotes

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/stemmer Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/stemmer/__init__.py Deleted

@@ -1,45 +0,0 @@
-"""
-    sphinx.util.stemmer
-    ~~~~~~~~~~~~~~~~~~~
-
-    Word stemming utilities for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from sphinx.util.stemmer.porter import PorterStemmer
-
-try:
-    from Stemmer import Stemmer as _PyStemmer
-    PYSTEMMER = True
-except ImportError:
-    PYSTEMMER = False
-
-
-class BaseStemmer:
-    def stem(self, word: str) -> str:
-        raise NotImplementedError()
-
-
-class PyStemmer(BaseStemmer):
-    def __init__(self) -> None:
-        self.stemmer = _PyStemmer('porter')
-
-    def stem(self, word: str) -> str:
-        return self.stemmer.stemWord(word)
-
-
-class StandardStemmer(PorterStemmer, BaseStemmer):
-    """All those porter stemmer implementations look hideous;
-    make at least the stem method nicer.
-    """
-    def stem(self, word: str) -> str:  # type: ignore
-        return super().stem(word, 0, len(word) - 1)
-
-
-def get_stemmer() -> BaseStemmer:
-    if PYSTEMMER:
-        return PyStemmer()
-    else:
-        return StandardStemmer()

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/stemmer/porter.py Deleted

@@ -1,410 +0,0 @@
-"""
-    sphinx.util.stemmer.porter
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Porter Stemming Algorithm
-
-    This is the Porter stemming algorithm, ported to Python from the
-    version coded up in ANSI C by the author. It may be be regarded
-    as canonical, in that it follows the algorithm presented in
-
-    Porter, 1980, An algorithm for suffix stripping, Program, Vol. 14,
-    no. 3, pp 130-137,
-
-    only differing from it at the points made --DEPARTURE-- below.
-
-    See also https://tartarus.org/martin/PorterStemmer/
-
-    The algorithm as described in the paper could be exactly replicated
-    by adjusting the points of DEPARTURE, but this is barely necessary,
-    because (a) the points of DEPARTURE are definitely improvements, and
-    (b) no encoding of the Porter stemmer I have seen is anything like
-    as exact as this version, even with the points of DEPARTURE!
-
-    Release 1: January 2001
-
-    :copyright: Copyright 2001 by Vivake Gupta <v@nano.com>.
-    :license: Public Domain ("can be used free of charge for any purpose").
-"""
-
-
-class PorterStemmer:
-
-    def __init__(self) -> None:
-        """The main part of the stemming algorithm starts here.
-        b is a buffer holding a word to be stemmed. The letters are in bk0,
-        bk0+1 ... ending at bk. In fact k0 = 0 in this demo program. k is
-        readjusted downwards as the stemming progresses. Zero termination is
-        not in fact used in the algorithm.
-
-        Note that only lower case sequences are stemmed. Forcing to lower case
-        should be done before stem(...) is called.
-        """
-
-        self.b = ""     # buffer for word to be stemmed
-        self.k = 0
-        self.k0 = 0
-        self.j = 0      # j is a general offset into the string
-
-    def cons(self, i: int) -> int:
-        """cons(i) is TRUE <=> bi is a consonant."""
-        if self.bi == 'a' or self.bi == 'e' or self.bi == 'i' \
-           or self.bi == 'o' or self.bi == 'u':
-            return 0
-        if self.bi == 'y':
-            if i == self.k0:
-                return 1
-            else:
-                return (not self.cons(i - 1))
-        return 1
-
-    def m(self) -> int:
-        """m() measures the number of consonant sequences between k0 and j.
-        if c is a consonant sequence and v a vowel sequence, and <..>
-        indicates arbitrary presence,
-
-           <c><v>       gives 0
-           <c>vc<v>     gives 1
-           <c>vcvc<v>   gives 2
-           <c>vcvcvc<v> gives 3
-           ....
-        """
-        n = 0
-        i = self.k0
-        while 1:
-            if i > self.j:
-                return n
-            if not self.cons(i):
-                break
-            i = i + 1
-        i = i + 1
-        while 1:
-            while 1:
-                if i > self.j:
-                    return n
-                if self.cons(i):
-                    break
-                i = i + 1
-            i = i + 1
-            n = n + 1
-            while 1:
-                if i > self.j:
-                    return n
-                if not self.cons(i):
-                    break
-                i = i + 1
-            i = i + 1
-
-    def vowelinstem(self) -> int:
-        """vowelinstem() is TRUE <=> k0,...j contains a vowel"""
-        for i in range(self.k0, self.j + 1):
-            if not self.cons(i):
-                return 1
-        return 0
-
-    def doublec(self, j: int) -> int:
-        """doublec(j) is TRUE <=> j,(j-1) contain a double consonant."""
-        if j < (self.k0 + 1):
-            return 0
-        if (self.bj != self.bj - 1):
-            return 0
-        return self.cons(j)
-
-    def cvc(self, i: int) -> int:
-        """cvc(i) is TRUE <=> i-2,i-1,i has the form
-             consonant - vowel - consonant
-        and also if the second c is not w,x or y. this is used when trying to
-        restore an e at the end of a short  e.g.
-
-           cav(e), lov(e), hop(e), crim(e), but
-           snow, box, tray.
-        """
-        if i < (self.k0 + 2) or not self.cons(i) or self.cons(i - 1) \
-           or not self.cons(i - 2):
-            return 0
-        ch = self.bi
-        if ch in ('w', 'x', 'y'):
-            return 0
-        return 1
-
-    def ends(self, s: str) -> int:
-        """ends(s) is TRUE <=> k0,...k ends with the string s."""
-        length = len(s)
-        if slength - 1 != self.bself.k:  # tiny speed-up
-            return 0
-        if length > (self.k - self.k0 + 1):
-            return 0
-        if self.bself.k - length + 1:self.k + 1 != s:
-            return 0
-        self.j = self.k - length
-        return 1
-
-    def setto(self, s: str) -> None:
-        """setto(s) sets (j+1),...k to the characters in the string s,
-        readjusting k."""
-        length = len(s)
-        self.b = self.b:self.j + 1 + s + self.bself.j + length + 1:
-        self.k = self.j + length
-
-    def r(self, s: str) -> None:
-        """r(s) is used further down."""
-        if self.m() > 0:
-            self.setto(s)
-
-    def step1ab(self) -> None:
-        """step1ab() gets rid of plurals and -ed or -ing. e.g.
-
-           caresses  ->  caress
-           ponies    ->  poni
-           ties      ->  ti
-           caress    ->  caress
-           cats      ->  cat
-
-           feed      ->  feed
-           agreed    ->  agree
-           disabled  ->  disable
-
-           matting   ->  mat
-           mating    ->  mate
-           meeting   ->  meet
-           milling   ->  mill
-           messing   ->  mess
-
-           meetings  ->  meet
-        """
-        if self.bself.k == 's':
-            if self.ends("sses"):
-                self.k = self.k - 2
-            elif self.ends("ies"):
-                self.setto("i")
-            elif self.bself.k - 1 != 's':
-                self.k = self.k - 1
-        if self.ends("eed"):
-            if self.m() > 0:
-                self.k = self.k - 1
-        elif (self.ends("ed") or self.ends("ing")) and self.vowelinstem():
-            self.k = self.j
-            if self.ends("at"):
-                self.setto("ate")
-            elif self.ends("bl"):
-                self.setto("ble")
-            elif self.ends("iz"):
-                self.setto("ize")
-            elif self.doublec(self.k):
-                self.k = self.k - 1
-                ch = self.bself.k
-                if ch in ('l', 's', 'z'):
-                    self.k = self.k + 1
-            elif (self.m() == 1 and self.cvc(self.k)):
-                self.setto("e")
-
-    def step1c(self) -> None:
-        """step1c() turns terminal y to i when there is another vowel in
-        the stem."""
-        if (self.ends("y") and self.vowelinstem()):
-            self.b = self.b:self.k + 'i' + self.bself.k + 1:
-
-    def step2(self) -> None:
-        """step2() maps double suffices to single ones.
-        so -ization ( = -ize plus -ation) maps to -ize etc. note that the
-        string before the suffix must give m() > 0.
-        """
-        if self.bself.k - 1 == 'a':
-            if self.ends("ational"):
-                self.r("ate")
-            elif self.ends("tional"):
-                self.r("tion")
-        elif self.bself.k - 1 == 'c':
-            if self.ends("enci"):
-                self.r("ence")
-            elif self.ends("anci"):
-                self.r("ance")
-        elif self.bself.k - 1 == 'e':
-            if self.ends("izer"):
-                self.r("ize")
-        elif self.bself.k - 1 == 'l':
-            if self.ends("bli"):
-                self.r("ble")  # --DEPARTURE--
-            # To match the published algorithm, replace this phrase with
-            #   if self.ends("abli"):      self.r("able")
-            elif self.ends("alli"):
-                self.r("al")
-            elif self.ends("entli"):
-                self.r("ent")
-            elif self.ends("eli"):
-                self.r("e")
-            elif self.ends("ousli"):
-                self.r("ous")
-        elif self.bself.k - 1 == 'o':
-            if self.ends("ization"):
-                self.r("ize")
-            elif self.ends("ation"):
-                self.r("ate")
-            elif self.ends("ator"):
-                self.r("ate")
-        elif self.bself.k - 1 == 's':
-            if self.ends("alism"):
-                self.r("al")
-            elif self.ends("iveness"):
-                self.r("ive")
-            elif self.ends("fulness"):
-                self.r("ful")
-            elif self.ends("ousness"):
-                self.r("ous")
-        elif self.bself.k - 1 == 't':
-            if self.ends("aliti"):
-                self.r("al")
-            elif self.ends("iviti"):
-                self.r("ive")
-            elif self.ends("biliti"):
-                self.r("ble")
-        elif self.bself.k - 1 == 'g':  # --DEPARTURE--
-            if self.ends("logi"):
-                self.r("log")
-        # To match the published algorithm, delete this phrase
-
-    def step3(self) -> None:
-        """step3() dels with -ic-, -full, -ness etc. similar strategy
-        to step2."""
-        if self.bself.k == 'e':
-            if self.ends("icate"):
-                self.r("ic")
-            elif self.ends("ative"):
-                self.r("")
-            elif self.ends("alize"):
-                self.r("al")
-        elif self.bself.k == 'i':
-            if self.ends("iciti"):
-                self.r("ic")
-        elif self.bself.k == 'l':
-            if self.ends("ical"):
-                self.r("ic")
-            elif self.ends("ful"):
-                self.r("")
-        elif self.bself.k == 's':
-            if self.ends("ness"):
-                self.r("")
-
-    def step4(self) -> None:
-        """step4() takes off -ant, -ence etc., in context <c>vcvc<v>."""
-        if self.bself.k - 1 == 'a':
-            if self.ends("al"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'c':
-            if self.ends("ance"):
-                pass
-            elif self.ends("ence"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'e':
-            if self.ends("er"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'i':
-            if self.ends("ic"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'l':
-            if self.ends("able"):
-                pass
-            elif self.ends("ible"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'n':
-            if self.ends("ant"):
-                pass
-            elif self.ends("ement"):
-                pass
-            elif self.ends("ment"):
-                pass
-            elif self.ends("ent"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'o':
-            if self.ends("ion") and (self.bself.j == 's' or
-                                     self.bself.j == 't'):
-                pass
-            elif self.ends("ou"):
-                pass
-            # takes care of -ous
-            else:
-                return
-        elif self.bself.k - 1 == 's':
-            if self.ends("ism"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 't':
-            if self.ends("ate"):
-                pass
-            elif self.ends("iti"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'u':
-            if self.ends("ous"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'v':
-            if self.ends("ive"):
-                pass
-            else:
-                return
-        elif self.bself.k - 1 == 'z':
-            if self.ends("ize"):
-                pass
-            else:
-                return
-        else:
-            return
-        if self.m() > 1:
-            self.k = self.j
-
-    def step5(self) -> None:
-        """step5() removes a final -e if m() > 1, and changes -ll to -l if
-        m() > 1.
-        """
-        self.j = self.k
-        if self.bself.k == 'e':
-            a = self.m()
-            if a > 1 or (a == 1 and not self.cvc(self.k - 1)):
-                self.k = self.k - 1
-        if self.bself.k == 'l' and self.doublec(self.k) and self.m() > 1:
-            self.k = self.k - 1
-
-    def stem(self, p: str, i: int, j: int) -> str:
-        """In stem(p,i,j), p is a char pointer, and the string to be stemmed
-        is from pi to pj inclusive. Typically i is zero and j is the
-        offset to the last character of a string, (pj+1 == '\0'). The
-        stemmer adjusts the characters pi ... pj and returns the new
-        end-point of the string, k. Stemming never increases word length, so
-        i <= k <= j. To turn the stemmer into a module, declare 'stem' as
-        extern, and delete the remainder of this file.
-        """
-        # copy the parameters into statics
-        self.b = p
-        self.k = j
-        self.k0 = i
-        if self.k <= self.k0 + 1:
-            return self.b  # --DEPARTURE--
-
-        # With this line, strings of length 1 or 2 don't go through the
-        # stemming process, although no mention is made of this in the
-        # published algorithm. Remove the line to match the published
-        # algorithm.
-
-        self.step1ab()
-        self.step1c()
-        self.step2()
-        self.step3()
-        self.step4()
-        self.step5()
-        return self.bself.k0:self.k + 1

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/certs Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/js Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/js/doctools.js Deleted

@@ -1,91 +0,0 @@
-var DOCUMENTATION_OPTIONS = {};
-
-
-describe('jQuery extensions', function() {
-
-  describe('urldecode', function() {
-
-    it('should correctly decode URLs and replace `+`s with a spaces', function() {
-      var test_encoded_string =
-        '%D1%88%D0%B5%D0%BB%D0%BB%D1%8B+%D1%88%D0%B5%D0%BB%D0%BB%D1%8B';
-      var test_decoded_string = 'шеллы шеллы';
-      expect(jQuery.urldecode(test_encoded_string)).toEqual(test_decoded_string);
-    });
-
-    it('+ should result in " "', function() {
-      expect(jQuery.urldecode('+')).toEqual(' ');
-    });
-
-  });
-
-  describe('getQueryParameters', function() {
-    var paramString = '?q=test+this&check_keywords=yes&area=default';
-    var queryParamObject = {
-      area: 'default',
-      check_keywords: 'yes',
-      q: 'test this'
-    };
-
-    it('should correctly create query parameter object from string', function() {
-      expect(jQuery.getQueryParameters(paramString)).toEqual(queryParamObject);
-    });
-
-    it('should correctly create query param object from URL params', function() {
-      history.pushState({}, '_', window.location + paramString);
-      expect(jQuery.getQueryParameters()).toEqual(queryParamObject);
-    });
-
-  });
-
-  describe('highlightText', function() {
-
-    var cyrillicTerm = 'шеллы';
-    var umlautTerm = 'gänsefüßchen';
-
-    it('should highlight text incl. special characters correctly in HTML', function() {
-      var highlightTestSpan =
-        jQuery('<span>This is the шеллы and Gänsefüßchen test!</span>');
-      jQuery(document.body).append(highlightTestSpan);
-      highlightTestSpan.highlightText(cyrillicTerm, 'highlighted');
-      highlightTestSpan.highlightText(umlautTerm, 'highlighted');
-      var expectedHtmlString =
-        'This is the <span class=\"highlighted\">шеллы</span> and ' +
-        '<span class=\"highlighted\">Gänsefüßchen</span> test!';
-      expect(highlightTestSpan.html()).toEqual(expectedHtmlString);
-    });
-
-    it('should highlight text incl. special characters correctly in SVG', function() {
-      var highlightTestSvg = jQuery(
-        '<span id="svg-highlight-test">' +
-          '<svg xmlns="http://www.w3.org/2000/svg" height="50" width="500">' +
-            '<text x="0" y="15">' +
-              'This is the шеллы and Gänsefüßchen test!' +
-            '</text>' +
-          '</svg>' +
-        '</span>');
-      jQuery(document.body).append(highlightTestSvg);
-      highlightTestSvg.highlightText(cyrillicTerm, 'highlighted');
-      highlightTestSvg.highlightText(umlautTerm, 'highlighted');
-      /* Note wild cards and ``toMatch``; allowing for some variability
-         seems to be necessary, even between different FF versions */
-      var expectedSvgString =
-        '<svg xmlns="http://www.w3.org/2000/svg" height="50" width="500">' +
-          '<rect x=".*" y=".*" width=".*" height=".*" class="highlighted">' +
-          '</rect>' +
-          '<rect x=".*" y=".*" width=".*" height=".*" class="highlighted">' +
-          '</rect>' +
-          '<text x=".*" y=".*">' +
-            'This is the ' +
-            '<tspan>шеллы</tspan> and ' +
-            '<tspan>Gänsefüßchen</tspan> test!' +
-          '</text>' +
-        '</svg>';
-      expect(highlightTestSvg.html()).toMatch(new RegExp(expectedSvgString));
-    });
-
-  });
-
-
-});
-
-

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-add_enumerable_node Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-add_source_parser Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-add_source_parser-conflicts-with-users-setting Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-api-set-translator Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-api-set-translator/nonext Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-pep420 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-pep420/a Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-pep420/a/b Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-pep420/a/b/c Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-pep420/a/b/e Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-pep420/a/b/x Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-subpackage-in-toc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-subpackage-in-toc/parent Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-subpackage-in-toc/parent/child Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-toc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-toc/mypackage Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-toc/mypackage/no_init Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-toc/mypackage/resource Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-toc/mypackage/something Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-trailing-underscore Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-trailing-underscore/package_ Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-autosummary Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-basic Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-build-html-translator Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-build-text Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-builder-dirhtml Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-builder-dirhtml/foo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-builder-gettext-dont-rebuild-mo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-builder-gettext-dont-rebuild-mo/xx Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-builder-gettext-dont-rebuild-mo/xx/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-changes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-changes/library Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-circular Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-config Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-correct-year Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-default_role Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directive-code Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directive-csv-table Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directive-csv-table/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directive-only Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directives-raw Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-docutilsconf Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-c Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-c-intersphinx Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-cpp Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-cpp-intersphinx Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-js Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-py-python_use_unqualified_type_names Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-py-xref-warning Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-double-inheriting-theme Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-double-inheriting-theme/base_themes_dir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-double-inheriting-theme/base_themes_dir/base_theme1 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-double-inheriting-theme/base_themes_dir/base_theme2 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-epub-anchor-id Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/bug2437 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/canonical Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/name_conflict Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosectionlabel Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosectionlabel-prefix-document Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-filename-map Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-imported_members Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-imported_members/autosummary_dummy_package Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-mock_imports Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package/package Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package2 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-skip-member Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-template Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-template/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-coverage Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-doctest Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-doctest-skipif Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-doctest-with-autodoc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-doctest-with-autodoc/dir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-githubpages Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-graphviz Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-ifconfig Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-imgconverter Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-inheritance_diagram Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-inheritance_diagram/example Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-intersphinx-cppdomain Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-intersphinx-role Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-math Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-math-compat Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-math-simple Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-todo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode-find Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode-find/not_a_package Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode/spam Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-extensions Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-footnotes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-gettext-template Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-gettext-template/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-glossary Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-highlight_options Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/extra Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/extra/css Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/extra/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/static/css Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/static/js Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/static/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_assets/subdir/_build Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_entity Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_scaled_image_link Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_signaturereturn_icon Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_style Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-html_style/_static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-image-in-parsed-literal Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-image-in-section Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-images Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-images/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-index_on_title Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-inheritance Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-inheritance/dummy Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/xx Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/xx/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-keep_warnings Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-babel Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-container Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-equations Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-equations/expects Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-figure-in-admonition Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-includegraphics Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-index Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-labels Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-numfig Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/_mytemplates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/_mytemplates/latex Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-theme Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-theme/theme Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-theme/theme/custom Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-title Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-unicode Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-documents_exclude Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-anchor Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-https Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-warn-redirects Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck/links.txt Deleted

@@ -1,19 +0,0 @@
-This is from CPython documentation.
-
-* Also, if there is a `default namespace <https://www.w3.org/TR/2006/REC-xml-names-20060816/#defaulting>`__, that full URI gets prepended to all of the non-prefixed tags.
-
-* The URL having anchor: `https://www.sphinx-doc.org/en/master/usage/installation.html#overview`_
-
-Some additional anchors to exercise ignore code
-
-* `Example Bar invalid <https://www.google.com/#!bar>`_
-* `Example Bar invalid <https://www.google.com#!bar>`_ tests that default ignore anchor of #! does not need to be prefixed with /
-* `Example Bar invalid <https://www.google.com/#top>`_
-* `Example anchor invalid <http://www.sphinx-doc.org/en/master/index.html#does-not-exist>`_
-* `Complete nonsense <https://localhost:7777/doesnotexist>`_
-* `Example valid local file <conf.py>`_
-* `Example invalid local file <path/to/notfound>`_
-* https://github.com/sphinx-doc/sphinx/blob/4.x/sphinx/__init__.py#L2
-
-.. image:: https://www.google.com/image.png
-.. figure:: https://www.google.com/image2.png

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-local-logo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-local-logo/images Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale/locale1 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale/locale1/en Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale/locale1/en/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale/locale2 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale/locale2/en Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-locale/locale2/en/LC_MESSAGES Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-manpage_url Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-markup-citation Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-markup-rubric Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-maxlistdepth Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-metadata Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-need-escaped Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-nested-enumerated-list Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-nested-tables Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-nitpicky-warnings Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-numbered-circular Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-numfig Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-productionlist Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-prolog Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg/conf.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg/index.rst Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg/sample-0.0.0-py3.7.egg Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg/src Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg/src/sample.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-pycode-egg/src/setup.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-reST-code-block Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-refonly_bullet_list Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-remote-logo Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-roles-download Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-roles-download/another Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/special Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/subdir Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-search Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-setup Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-setup/doc Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-setup/doc/conf.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-setup/doc/index.txt Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-setup/setup.cfg Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-setup/setup.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-smartquotes Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-stylesheets Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-stylesheets/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-templating Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-templating/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-templating/_templates/autosummary Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming/MANIFEST.in Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming/setup.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming/test_theme Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming/test_theme/staticfiles Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming/test_theme/staticfiles/static Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-theming/test_theme/test-theme Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-tocdepth Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-duplicated Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-empty Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-empty/_templates Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-glob Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-glob/bar Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-glob/bar/bar_4 Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-glob/qux Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-toctree-maxdepth Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-transforms-post_transforms-missing-reference Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-trim_doctest_flags Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-versioning Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-warnings Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_napoleon_iterators.py Deleted

@@ -1,346 +0,0 @@
-"""
-    test_napoleon_iterators
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    Tests for :mod:`sphinx.ext.napoleon.iterators` module.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from unittest import TestCase
-
-from sphinx.ext.napoleon.iterators import modify_iter, peek_iter
-
-
-class BaseIteratorsTest(TestCase):
-    def assertEqualTwice(self, expected, func, *args):
-        self.assertEqual(expected, func(*args))
-        self.assertEqual(expected, func(*args))
-
-    def assertFalseTwice(self, func, *args):
-        self.assertFalse(func(*args))
-        self.assertFalse(func(*args))
-
-    def assertNext(self, it, expected, is_last):
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(expected, it.peek)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(expected, it.peek)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual(expected, next(it))
-        if is_last:
-            self.assertFalseTwice(it.has_next)
-            self.assertRaisesTwice(StopIteration, it.next)
-        else:
-            self.assertTrueTwice(it.has_next)
-
-    def assertRaisesTwice(self, exc, func, *args):
-        self.assertRaises(exc, func, *args)
-        self.assertRaises(exc, func, *args)
-
-    def assertTrueTwice(self, func, *args):
-        self.assertTrue(func(*args))
-        self.assertTrue(func(*args))
-
-
-class PeekIterTest(BaseIteratorsTest):
-    def test_init_with_sentinel(self):
-        a = iter('1', '2', 'DONE')
-        sentinel = 'DONE'
-        self.assertRaises(TypeError, peek_iter, a, sentinel)
-
-        def get_next():
-            return next(a)
-        it = peek_iter(get_next, sentinel)
-        self.assertEqual(it.sentinel, sentinel)
-        self.assertNext(it, '1', is_last=False)
-        self.assertNext(it, '2', is_last=True)
-
-    def test_iter(self):
-        a = '1', '2', '3'
-        it = peek_iter(a)
-        self.assertTrue(it is it.__iter__())
-
-        a = 
-        b = i for i in peek_iter(a)
-        self.assertEqual(, b)
-
-        a = '1'
-        b = i for i in peek_iter(a)
-        self.assertEqual('1', b)
-
-        a = '1', '2'
-        b = i for i in peek_iter(a)
-        self.assertEqual('1', '2', b)
-
-        a = '1', '2', '3'
-        b = i for i in peek_iter(a)
-        self.assertEqual('1', '2', '3', b)
-
-    def test_next_with_multi(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 2)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 2)
-        self.assertTrueTwice(it.has_next)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('1', '2', it.next(2))
-        self.assertFalseTwice(it.has_next)
-
-        a = '1', '2', '3'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('1', '2', it.next(2))
-        self.assertTrueTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 2)
-        self.assertTrueTwice(it.has_next)
-
-        a = '1', '2', '3', '4'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('1', '2', it.next(2))
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('3', '4', it.next(2))
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 2)
-        self.assertFalseTwice(it.has_next)
-
-    def test_next_with_none(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next)
-        self.assertFalseTwice(it.has_next)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertEqual('1', it.__next__())
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertNext(it, '1', is_last=True)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertNext(it, '1', is_last=False)
-        self.assertNext(it, '2', is_last=True)
-
-        a = '1', '2', '3'
-        it = peek_iter(a)
-        self.assertNext(it, '1', is_last=False)
-        self.assertNext(it, '2', is_last=False)
-        self.assertNext(it, '3', is_last=True)
-
-    def test_next_with_one(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 1)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('1', it.next(1))
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 1)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('1', it.next(1))
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('2', it.next(1))
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 1)
-
-    def test_next_with_zero(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertRaisesTwice(StopIteration, it.next, 0)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.next, 0)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.next, 0)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.next, 0)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.next, 0)
-
-    def test_peek_with_multi(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.sentinel, it.peek, 2)
-        self.assertFalseTwice(it.has_next)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', it.sentinel, it.peek, 2)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', it.sentinel, it.sentinel, it.peek, 3)
-        self.assertTrueTwice(it.has_next)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', '2', it.peek, 2)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', '2', it.sentinel, it.peek, 3)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', '2', it.sentinel, it.sentinel, it.peek, 4)
-        self.assertTrueTwice(it.has_next)
-
-        a = '1', '2', '3'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', '2', it.peek, 2)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', '2', '3', it.peek, 3)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', '2', '3', it.sentinel, it.peek, 4)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqual('1', next(it))
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('2', '3', it.peek, 2)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('2', '3', it.sentinel, it.peek, 3)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('2', '3', it.sentinel, it.sentinel, it.peek, 4)
-        self.assertTrueTwice(it.has_next)
-
-    def test_peek_with_none(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.peek)
-        self.assertFalseTwice(it.has_next)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', it.peek)
-        self.assertEqual('1', next(it))
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.peek)
-        self.assertFalseTwice(it.has_next)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', it.peek)
-        self.assertEqual('1', next(it))
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('2', it.peek)
-        self.assertEqual('2', next(it))
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.peek)
-        self.assertFalseTwice(it.has_next)
-
-    def test_peek_with_one(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.peek, 1)
-        self.assertFalseTwice(it.has_next)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', it.peek, 1)
-        self.assertEqual('1', next(it))
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.peek, 1)
-        self.assertFalseTwice(it.has_next)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('1', it.peek, 1)
-        self.assertEqual('1', next(it))
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice('2', it.peek, 1)
-        self.assertEqual('2', next(it))
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(it.sentinel, it.peek, 1)
-        self.assertFalseTwice(it.has_next)
-
-    def test_peek_with_zero(self):
-        a = 
-        it = peek_iter(a)
-        self.assertFalseTwice(it.has_next)
-        self.assertEqualTwice(, it.peek, 0)
-
-        a = '1'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.peek, 0)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.peek, 0)
-
-        a = '1', '2'
-        it = peek_iter(a)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.peek, 0)
-        self.assertTrueTwice(it.has_next)
-        self.assertEqualTwice(, it.peek, 0)
-
-
-class ModifyIterTest(BaseIteratorsTest):
-    def test_init_with_sentinel_args(self):
-        a = iter('1', '2', '3', 'DONE')
-        sentinel = 'DONE'
-
-        def get_next():
-            return next(a)
-        it = modify_iter(get_next, sentinel, int)
-        expected = 1, 2, 3
-        self.assertEqual(expected, i for i in it)
-
-    def test_init_with_sentinel_kwargs(self):
-        a = iter(1, 2, 3, 4)
-        sentinel = 4
-
-        def get_next():
-            return next(a)
-        it = modify_iter(get_next, sentinel, modifier=str)
-        expected = '1', '2', '3'
-        self.assertEqual(expected, i for i in it)
-
-    def test_modifier_default(self):
-        a = '', '  ', '  a  ', 'b  ', '  c', '  ', ''
-        it = modify_iter(a)
-        expected = '', '  ', '  a  ', 'b  ', '  c', '  ', ''
-        self.assertEqual(expected, i for i in it)
-
-    def test_modifier_not_callable(self):
-        self.assertRaises(TypeError, modify_iter, 1, modifier='not_callable')
-
-    def test_modifier_rstrip(self):
-        a = '', '  ', '  a  ', 'b  ', '  c', '  ', ''
-        it = modify_iter(a, modifier=lambda s: s.rstrip())
-        expected = '', '', '  a', 'b', '  c', '', ''
-        self.assertEqual(expected, i for i in it)
-
-    def test_modifier_rstrip_unicode(self):
-        a = '', '  ', '  a  ', 'b  ', '  c', '  ', ''
-        it = modify_iter(a, modifier=lambda s: s.rstrip())
-        expected = '', '', '  a', 'b', '  c', '', ''
-        self.assertEqual(expected, i for i in it)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_setup_command.py Deleted

@@ -1,145 +0,0 @@
-"""
-    test_setup_command
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test setup_command for distutils.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import os
-import subprocess
-import sys
-from collections import namedtuple
-from textwrap import dedent
-
-import pytest
-
-import sphinx
-from sphinx.util.osutil import cd
-
-
-@pytest.fixture
-def setup_command(request, tempdir, rootdir):
-    """
-    Run `setup.py build_sphinx` with args and kwargs,
-    pass it to the test and clean up properly.
-    """
-    if hasattr(request.node, 'get_closest_marker'):  # pytest-3.6.0 or newer
-        marker = request.node.get_closest_marker('setup_command')
-    else:
-        marker = request.node.get_marker('setup_command')
-    args = marker.args if marker else 
-
-    pkgrootdir = tempdir / 'test-setup'
-    (rootdir / 'test-setup').copytree(pkgrootdir)
-
-    with cd(pkgrootdir):
-        pythonpath = os.path.dirname(os.path.dirname(sphinx.__file__))
-        if os.getenv('PYTHONPATH'):
-            pythonpath = os.getenv('PYTHONPATH') + os.pathsep + pythonpath
-        command = sys.executable, 'setup.py', 'build_sphinx'
-        command.extend(args)
-
-        proc = subprocess.Popen(
-            command,
-            env=dict(os.environ, PYTHONPATH=pythonpath),
-            stdout=subprocess.PIPE,
-            stderr=subprocess.PIPE)
-        yield namedtuple('setup', 'pkgroot,proc')(pkgrootdir, proc)
-
-
-def test_build_sphinx(setup_command):
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode == 0
-
-
-@pytest.mark.setup_command('-b', 'html,man')
-def test_build_sphinx_multiple_builders(setup_command):
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode == 0
-
-
-@pytest.mark.setup_command('-b', 'html,bar')
-def test_build_sphinx_multiple_invalid_builders(setup_command):
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode == 1
-
-
-@pytest.fixture
-def nonascii_srcdir(request, setup_command):
-    mb_name = '\u65e5\u672c\u8a9e'
-    srcdir = (setup_command.pkgroot / 'doc')
-    try:
-        (srcdir / mb_name).makedirs()
-    except UnicodeEncodeError:
-        from sphinx.testing.path import FILESYSTEMENCODING
-        pytest.skip(
-            'non-ASCII filename not supported on this filesystem encoding: '
-            '%s' % FILESYSTEMENCODING)
-
-    (srcdir / mb_name / (mb_name + '.txt')).write_text(dedent("""
-        multi byte file name page
-        ==========================
-        """))
-
-    root_doc = srcdir / 'index.txt'
-    root_doc.write_bytes((root_doc.read_text() + dedent("""
-                          .. toctree::
-
-                             %(mb_name)s/%(mb_name)s
-                          """ % locals())).encode())
-
-
-@pytest.mark.usefixtures('nonascii_srcdir')
-def test_build_sphinx_with_nonascii_path(setup_command):
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode == 0
-
-
-@pytest.mark.setup_command('-b', 'linkcheck')
-def test_build_sphinx_return_nonzero_status(setup_command):
-    srcdir = (setup_command.pkgroot / 'doc')
-    (srcdir / 'contents.txt').write_text(
-        'http://localhost.unexistentdomain/index.html')
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode != 0, 'expect non-zero status for setup.py'
-
-
-def test_build_sphinx_warning_return_zero_status(setup_command):
-    srcdir = (setup_command.pkgroot / 'doc')
-    (srcdir / 'contents.txt').write_text(
-        'See :ref:`unexisting-reference-label`')
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode == 0
-
-
-@pytest.mark.setup_command('--warning-is-error')
-def test_build_sphinx_warning_is_error_return_nonzero_status(setup_command):
-    srcdir = (setup_command.pkgroot / 'doc')
-    (srcdir / 'contents.txt').write_text(
-        'See :ref:`unexisting-reference-label`')
-    proc = setup_command.proc
-    out, err = proc.communicate()
-    print(out.decode())
-    print(err.decode())
-    assert proc.returncode != 0, 'expect non-zero status for setup.py'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_jsdump.py Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/utils Deleted

_service:tar_scm:Sphinx-4.4.0.tar.gz/utils/checks.py Deleted

@@ -1,108 +0,0 @@
-"""
-    utils.checks
-    ~~~~~~~~~~~~
-
-    Custom, Sphinx-only flake8 plugins.
-
-    :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import os
-import re
-
-import sphinx
-
-name_mail_re = r'\w +(<.*?>)?'
-copyright_re = re.compile(r'^    :copyright: Copyright 200\d(-20\d\d)? '
-                          r'by %s(, %s)*,.$' % (name_mail_re, name_mail_re))
-copyright_2_re = re.compile(r'^                %s(, %s)*,.$' %
-                            (name_mail_re, name_mail_re))
-license_re = re.compile(r'    :license: (.*?).\n')
-
-
-def flake8ext(_func):
-    """Decorate flake8_asserts functions"""
-    _func.name = _func.__name__
-    _func.version = sphinx.__version__
-    _func.code = _func.__name__.upper()
-
-    return _func
-
-
-@flake8ext
-def sphinx_has_header(physical_line, filename, lines, line_number):
-    """Check for correct headers.
-
-    Make sure each Python file has a correct file header including
-    copyright and license information.
-
-    X101 invalid header found
-    """
-    # we have a state machine of sorts so we need to start on line 1. Also,
-    # there's no point checking really short files
-    if line_number != 1 or len(lines) < 10:
-        return
-
-    # this file uses a funky license but unfortunately it's not possible to
-    # ignore specific errors on a file-level basis yet 1. Simply skip it.
-    #
-    # 1 https://gitlab.com/pycqa/flake8/issues/347
-    if os.path.samefile(filename, './sphinx/util/smartypants.py'):
-        return
-
-    # if the top-level package or not inside the package, ignore
-    mod_name = os.path.splitext(filename)0.strip('./\\').replace(
-        '/', '.').replace('.__init__', '')
-    if mod_name == 'sphinx' or not mod_name.startswith('sphinx.'):
-        return
-
-    # line number correction
-    offset = 1
-    if lines0:1 == '#!/usr/bin/env python3\n':
-        lines = lines1:
-        offset = 2
-
-    llist = 
-    doc_open = False
-
-    for lno, line in enumerate(lines):
-        llist.append(line)
-        if lno == 0:
-            if line != '"""\n' and line != 'r"""\n':
-                return 0, 'X101 missing docstring begin (""")'
-            else:
-                doc_open = True
-        elif doc_open:
-            if line == '"""\n':
-                # end of docstring
-                if lno <= 3:
-                    return 0, 'X101 missing module name in docstring'
-                break
-
-            if line != '\n' and line:4 != '    ' and doc_open:
-                return 0, 'X101 missing correct docstring indentation'
-
-            if lno == 1:
-                mod_name_len = len(line.strip())
-                if line.strip() != mod_name:
-                    return 2, 'X101 wrong module name in docstring heading'
-            elif lno == 2:
-                if line.strip() != mod_name_len * '~':
-                    return (3, 'X101 wrong module name underline, should be '
-                            '~~~...~')
-    else:
-        return 0, 'X101 missing end and/or start of docstring...'
-
-    # check for copyright and license fields
-    license = llist-2:-1
-    if not license or not license_re.match(license0):
-        return 0, 'X101 no correct license info'
-
-    offset = -3
-    copyright = llistoffset:offset + 1
-    while copyright and copyright_2_re.match(copyright0):
-        offset -= 1
-        copyright = llistoffset:offset + 1
-    if not copyright or not copyright_re.match(copyright0):
-        return 0, 'X101 no correct copyright info'

_service:tar_scm:Sphinx-4.4.0.tar.gz/utils/doclinter.py Deleted

@@ -1,85 +0,0 @@
-"""
-    utils.doclinter
-    ~~~~~~~~~~~~~~~
-
-    A linter for Sphinx docs
-
-    :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import os
-import re
-import sys
-from typing import List
-
-MAX_LINE_LENGTH = 85
-LONG_INTERPRETED_TEXT = re.compile(r'^\s*\W*(:(\w+:)+)?`.*`\W*$')
-CODE_BLOCK_DIRECTIVE = re.compile(r'^(\s*)\.\. code-block::')
-LEADING_SPACES = re.compile(r'^(\s*)')
-
-
-def lint(path: str) -> int:
-    with open(path) as f:
-        document = f.readlines()
-
-    errors = 0
-    in_code_block = False
-    code_block_depth = 0
-    for i, line in enumerate(document):
-        if line.endswith(' '):
-            print('%s:%d: the line ends with whitespace.' %
-                  (path, i + 1))
-            errors += 1
-
-        matched = CODE_BLOCK_DIRECTIVE.match(line)
-        if matched:
-            in_code_block = True
-            code_block_depth = len(matched.group(1))
-        elif in_code_block:
-            if line.strip() == '':
-                pass
-            else:
-                spaces = LEADING_SPACES.match(line).group(1)
-                if len(spaces) <= code_block_depth:
-                    in_code_block = False
-        elif LONG_INTERPRETED_TEXT.match(line):
-            pass
-        elif len(line) > MAX_LINE_LENGTH:
-            if re.match(r'^\s*\.\. ', line):
-                # ignore directives and hyperlink targets
-                pass
-            elif re.match(r'^\s*__ ', line):
-                # ignore anonymous hyperlink targets
-                pass
-            elif re.match(r'^\s*``^`+``$', line):
-                # ignore a very long literal string
-                pass
-            else:
-                print('%s:%d: the line is too long (%d > %d).' %
-                      (path, i + 1, len(line), MAX_LINE_LENGTH))
-                errors += 1
-
-    return errors
-
-
-def main(args: Liststr) -> int:
-    errors = 0
-    for path in args:
-        if os.path.isfile(path):
-            errors += lint(path)
-        elif os.path.isdir(path):
-            for root, _dirs, files in os.walk(path):
-                for filename in files:
-                    if filename.endswith('.rst'):
-                        path = os.path.join(root, filename)
-                        errors += lint(path)
-
-    if errors:
-        return 1
-    else:
-        return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main(sys.argv1:))

_service:tar_scm:Sphinx-4.4.0.tar.gz/utils/jssplitter_generator.py Deleted

@@ -1,140 +0,0 @@
-import json
-import re
-import subprocess
-import sys
-
-# find char codes they are matched with Python's (?u)\\w
-
-match = re.compile(r'(?u)\w')
-begin = -1
-
-ranges = 
-singles = 
-
-for i in range(65536):
-    # 0xd800-0xdfff is surrogate pair area. skip this.
-    if not match.match(chr(i)) and not (0xd800 <= i <= 0xdfff):
-        if begin == -1:
-            begin = i
-    elif begin != -1:
-        if begin + 1 == i:
-            singles.append(begin)
-        else:
-            ranges.append((begin, i - 1))
-        begin = -1
-
-
-# fold json within almost 80 chars per line
-def fold(jsonData, splitter):
-    code = json.dumps(jsonData)
-    lines = 
-    while True:
-        if len(code) < 71:
-            lines.append('        ' + code)
-            break
-        index = code.index(splitter, 70)
-        lines.append('        ' + code:index + len(splitter))
-        code = codeindex + len(splitter):
-    lines0 = lines08:
-    return '\n'.join(lines)
-
-
-# JavaScript code
-js_src = '''
-var splitChars = (function() {
-    var result = {};
-    var singles = %s;
-    var i, j, start, end;
-    for (i = 0; i < singles.length; i++) {
-        resultsinglesi = true;
-    }
-    var ranges = %s;
-    for (i = 0; i < ranges.length; i++) {
-        start = rangesi0;
-        end = rangesi1;
-        for (j = start; j <= end; j++) {
-            resultj = true;
-        }
-    }
-    return result;
-})();
-
-function splitQuery(query) {
-    var result = ;
-    var start = -1;
-    for (var i = 0; i < query.length; i++) {
-        if (splitCharsquery.charCodeAt(i)) {
-            if (start !== -1) {
-                result.push(query.slice(start, i));
-                start = -1;
-            }
-        } else if (start === -1) {
-            start = i;
-        }
-    }
-    if (start !== -1) {
-        result.push(query.slice(start));
-    }
-    return result;
-}
-''' % (fold(singles, ','), fold(ranges, ','))
-
-js_test_src = '''
-// This is regression test for https://github.com/sphinx-doc/sphinx/issues/3150
-// generated by compat_regexp_generator.py
-// it needs node.js for testing
-var assert = require('assert');
-
-%s
-
-console.log("test splitting English words")
-assert.deepEqual('Hello', 'World', splitQuery('   Hello    World   '));
-console.log('   ... ok\\n')
-
-console.log("test splitting special characters")
-assert.deepEqual('Pin', 'Code', splitQuery('Pin-Code'));
-console.log('   ... ok\\n')
-
-console.log("test splitting Chinese characters")
-assert.deepEqual('Hello', 'from', '中国', '上海', splitQuery('Hello from 中国 上海'));
-console.log('   ... ok\\n')
-
-console.log("test splitting Emoji(surrogate pair) characters. It should keep emojis.")
-assert.deepEqual('😁😁', splitQuery('😁😁'));
-console.log('   ... ok\\n')
-
-console.log("test splitting umlauts. It should keep umlauts.")
-assert.deepEqual(
-    'Löschen', 'Prüfung', 'Abändern', 'ærlig', 'spørsmål',
-    splitQuery('Löschen Prüfung Abändern ærlig spørsmål'));
-console.log('   ... ok\\n')
-
-''' % js_src
-
-python_src = '''\
-"""
-    sphinx.search.jssplitter
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Provides Python compatible word splitter to JavaScript
-
-    DO NOT EDIT. This is generated by utils/jssplitter_generator.py
-
-    :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-splitter_code = """
-%s
-"""
-''' % js_src
-
-with open('../sphinx/search/jssplitter.py', 'w') as f:
-    f.write(python_src)
-
-with open('./regression_test.js', 'w') as f:
-    f.write(js_test_src)
-
-print("starting test...")
-result = subprocess.call('node', './regression_test.js')
-sys.exit(result)

_service:tar_scm:Sphinx-4.4.0.tar.gz/AUTHORS -> _service:tar_scm:Sphinx-7.0.1.tar.gz/AUTHORS Changed

@@ -1,98 +1,95 @@
-Sphinx is written and maintained by Georg Brandl <georg@python.org>.
+Maintainers
+===========
 
-Substantial parts of the templates were written by Armin Ronacher
-<armin.ronacher@active-4.com>.
+*Listed alphabetically in forename, surname order*
 
-Other co-maintainers:
-
-* Takayuki Shimizukawa <shimizukawa@gmail.com>
+* Adam Turner <@AA-Turner>
+* Armin Ronacher <armin.ronacher@active-4.com>
 * Daniel Neuhäuser <@DasIch>
-* Jon Waltman <@jonwaltman>
+* François Freitag <@francoisfreitag>
+* Georg Brandl <georg@python.org>
+* Jakob Lykke Andersen <@jakobandersen>
+* Jean-François Burnol <@jfbu>
 * Rob Ruana <@RobRuana>
 * Robert Lehmann <@lehmannro>
-* Roland Meister <@rolmei>
+* Stephen Finucane <@stephenfin>
+* Takayuki Shimizukawa <shimizukawa@gmail.com>
 * Takeshi Komiya <@tk0miya>
-* Jean-François Burnol <@jfbu>
-* Yoshiki Shibukawa <@shibu_jp>
-* Timotheus Kampik - <@TimKam>
+* Timotheus Kampik <@TimKam>
+* Yoshiki Shibukawa <@shibukawa>
+
+Contributors
+============
 
-Other contributors, listed alphabetically, are:
+*Listed alphabetically in forename, surname order*
 
+* Adrián Chaves (Gallaecio) -- coverage builder improvements
 * Alastair Houghton -- Apple Help builder
 * Alexander Todorov -- inheritance_diagram tests and improvements
 * Andi Albrecht -- agogo theme
-* Jakob Lykke Andersen -- Rewritten C++ domain
-* Henrique Bastos -- SVG support for graphviz extension
+* Antonio Valentino -- qthelp builder, docstring inheritance
+* Antti Kaihola -- doctest extension (skipif option)
+* Barry Warsaw -- setup command improvements
+* Ben Egan -- Napoleon improvements
+* Benjamin Peterson -- unittests
+* Blaise Laflamme -- pyramid theme
+* Bruce Mitchener -- Minor epub improvement
+* Buck Evan -- dummy builder
+* Charles Duffy -- original graphviz extension
+* Chris Lamb -- reproducibility fixes
+* Christopher Perkins -- autosummary integration
+* Dan MacKinlay -- metadata fixes
 * Daniel Bültmann -- todo extension
-* Marco Buttu -- doctest extension (pyversion option)
-* Nathan Damon -- bugfix in validation of static paths in html builders
+* Daniel Neuhäuser -- JavaScript domain, Python 3 support (GSOC)
+* Daniel Pizetta -- inheritance diagram improvements
+* Dave Kuhlman -- original LaTeX writer
+* Doug Hellmann -- graphviz improvements
+* Eric N. Vander Weele -- autodoc improvements
 * Etienne Desautels -- apidoc module
-* Michael Droettboom -- inheritance_diagram extension
-* Charles Duffy -- original graphviz extension
-* Kevin Dunn -- MathJax extension
-* Josip Dzolonga -- coverage builder
-* Buck Evan -- dummy builder
-* Matthew Fernandez -- todo extension fix
+* Ezio Melotti -- collapsible sidebar JavaScript
+* Filip Vavera -- napoleon todo directive
+* Glenn Matthews -- python domain signature improvements
+* Gregory Szorc -- performance improvements
+* Henrique Bastos -- SVG support for graphviz extension
 * Hernan Grecco -- search improvements
+* Hong Xu -- svg support in imgmath extension and various bug fixes
 * Horst Gutmann -- internationalization support
-* Martin Hans -- autodoc improvements
-* Zac Hatfield-Dodds -- doctest reporting improvements, intersphinx performance
-* Doug Hellmann -- graphviz improvements
-* Tim Hoffmann -- theme improvements
-* Antti Kaihola -- doctest extension (skipif option)
-* Dave Kuhlman -- original LaTeX writer
-* Blaise Laflamme -- pyramid theme
-* Chris Lamb -- reproducibility fixes
-* Thomas Lamb -- linkcheck builder
-* Łukasz Langa -- partial support for autodoc
-* Martin Larralde -- additional napoleon admonitions
+* Hugo van Kemenade -- support FORCE_COLOR and NO_COLOR
 * Ian Lee -- quickstart improvements
-* Robert Lehmann -- gettext builder (GSOC project)
-* Dan MacKinlay -- metadata fixes
-* Martin Mahner -- nature theme
-* Will Maier -- directory HTML builder
 * Jacob Mason -- websupport library (GSOC project)
-* Glenn Matthews -- python domain signature improvements
-* Kurt McKee -- documentation updates
-* Roland Meister -- epub builder
-* Ezio Melotti -- collapsible sidebar JavaScript
-* Bruce Mitchener -- Minor epub improvement
-* Daniel Neuhäuser -- JavaScript domain, Python 3 support (GSOC)
-* Julien Palard -- Colspan and rowspan in text builder
-* Christopher Perkins -- autosummary integration
-* Benjamin Peterson -- unittests
-* \T. Powers -- HTML output improvements
 * Jeppe Pihl -- literalinclude improvements
+* Joel Wurtz -- cellspanning support in LaTeX
+* John Waltman -- Texinfo builder
+* Josip Dzolonga -- coverage builder
+* Julien Palard -- Colspan and rowspan in text builder
+* Kevin Dunn -- MathJax extension
+* KINEBUCHI Tomohiko -- typing Sphinx as well as docutils
+* Kurt McKee -- documentation updates
+* Lars Hupfeldt Nielsen - OpenSSL FIPS mode md5 bug fix
+* Łukasz Langa -- partial support for autodoc
+* Marco Buttu -- doctest extension (pyversion option)
+* Martin Hans -- autodoc improvements
+* Martin Larralde -- additional napoleon admonitions
+* Martin Mahner -- nature theme
+* Matthew Fernandez -- todo extension fix
+* Matthew Woodcraft -- text output improvements
+* Michael Droettboom -- inheritance_diagram extension
+* Michael Wilson -- Intersphinx HTTP basic auth support
+* Nathan Damon -- bugfix in validation of static paths in html builders
+* Pauli Virtanen -- autodoc improvements, autosummary extension
 * Rob Ruana -- napoleon extension
-* Vince Salvino -- JavaScript search improvements
+* Robert Lehmann -- gettext builder (GSOC project)
+* Roland Meister -- epub builder
+* Sebastian Wiesner -- image handling, distutils support
 * Stefan Seefeld -- toctree improvements
-* Gregory Szorc -- performance improvements
-* Taku Shimizu -- epub3 builder
-* Antonio Valentino -- qthelp builder, docstring inheritance
-* Filip Vavera -- napoleon todo directive
-* Pauli Virtanen -- autodoc improvements, autosummary extension
-* Eric N. Vander Weele -- autodoc improvements
 * Stefan van der Walt -- autosummary extension
+* T. Powers -- HTML output improvements
+* Taku Shimizu -- epub3 builder
+* Thomas Lamb -- linkcheck builder
 * Thomas Waldmann -- apidoc module fixes
-* John Waltman -- Texinfo builder
-* Barry Warsaw -- setup command improvements
-* Sebastian Wiesner -- image handling, distutils support
-* Michael Wilson -- Intersphinx HTTP basic auth support
-* Matthew Woodcraft -- text output improvements
-* Joel Wurtz -- cellspanning support in LaTeX
-* Hong Xu -- svg support in imgmath extension and various bug fixes
-* Stephen Finucane -- setup command improvements and documentation
-* Daniel Pizetta -- inheritance diagram improvements
-* KINEBUCHI Tomohiko -- typing Sphinx as well as docutils
-* Adrián Chaves (Gallaecio) -- coverage builder improvements
-* Lars Hupfeldt Nielsen - OpenSSL FIPS mode md5 bug fix
+* Tim Hoffmann -- theme improvements
+* Vince Salvino -- JavaScript search improvements
+* Will Maier -- directory HTML builder
+* Zac Hatfield-Dodds -- doctest reporting improvements, intersphinx performance
 
 Many thanks for all contributions!
-
-There are also a few modules or functions incorporated from other
-authors and projects:
-
-* sphinx.util.jsdump uses the basestring encoding from simplejson,
-  written by Bob Ippolito, released under the MIT license
-* sphinx.util.stemmer was written by Vivake Gupta, placed in the
-  Public Domain

_service:tar_scm:Sphinx-4.4.0.tar.gz/CHANGES -> _service:tar_scm:Sphinx-7.0.1.tar.gz/CHANGES Changed

@@ -1,3 +1,757 @@
+Release 7.0.1 (released May 12, 2023)
+=====================================
+
+Dependencies
+------------
+
+* #11411: Support `Docutils 0.20`_. Patch by Adam Turner.
+
+.. _Docutils 0.20: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-20-2023-05-04
+
+Bugs fixed
+----------
+
+* #11418: Clean up remaining references to ``sphinx.setup_command``
+  following the removal of support for setuptools.
+  Patch by Willem Mulder.
+
+Release 7.0.0 (released Apr 29, 2023)
+=====================================
+
+Incompatible changes
+--------------------
+
+* #11359: Remove long-deprecated aliases for ``MecabSplitter`` and
+  ``DefaultSplitter`` in ``sphinx.search.ja``.
+* #11360: Remove deprecated ``make_old_id`` functions in domain object
+  description classes.
+* #11363: Remove the Setuptools integration (``build_sphinx`` hook in
+  ``setup.py``).
+* #11364: Remove deprecated ``sphinx.ext.napoleon.iterators`` module.
+* #11365: Remove support for the ``jsdump`` format in ``sphinx.search``.
+* #11366: Make ``locale`` a required argument to
+  ``sphinx.util.i18n.format_date()``.
+* #11370: Remove deprecated ``sphinx.util.stemmer`` module.
+* #11371: Remove deprecated ``sphinx.pycode.ast.parse()`` function.
+* #11372: Remove deprecated ``sphinx.io.read_doc()`` function.
+* #11373: Removed deprecated ``sphinx.util.get_matching_files()`` function.
+* #11378: Remove deprecated ``sphinx.util.docutils.is_html5_writer_available()``
+  function.
+* #11379: Make the ``env`` argument to ``Builder`` subclasses required.
+* #11380: autosummary: Always emit grouped import exceptions.
+* #11381: Remove deprecated ``style`` key for HTML templates.
+* #11382: Remove deprecated ``sphinx.writers.latex.LaTeXTranslator.docclasses``
+  attribute.
+* #11383: Remove deprecated ``sphinx.builders.html.html5_ready`` and
+  ``sphinx.builders.html.HTMLTranslator`` attributes.
+* #11385: Remove support for HTML 4 output.
+
+Release 6.2.1 (released Apr 25, 2023)
+=====================================
+
+Bugs fixed
+----------
+
+* #11355: Revert the default type of :confval:`nitpick_ignore` and
+  :confval:`nitpick_ignore_regex` to ``list``.
+
+Release 6.2.0 (released Apr 23, 2023)
+=====================================
+
+Dependencies
+------------
+
+* Require Docutils 0.18.1 or greater.
+
+Incompatible changes
+--------------------
+
+* LaTeX: removal of some internal TeX ``\dimen`` registers (not previously
+  publicly documented) as per 5.1.0 code comments in ``sphinx.sty``:
+  ``\sphinxverbatimsep``, ``\sphinxverbatimborder``, ``\sphinxshadowsep``,
+  ``\sphinxshadowsize``, and ``\sphinxshadowrule``. (refs: #11105)
+* Remove ``.egg`` support from pycode ``ModuleAnalyser``; Python eggs are a
+  now-obsolete binary distribution format
+* #11089: Remove deprecated code in ``sphinx.builders.linkcheck``.
+  Patch by Daniel Eades
+* Remove internal-only ``sphinx.locale.setlocale``
+
+Deprecated
+----------
+
+* #11247: Deprecate the legacy ``intersphinx_mapping`` format
+* ``sphinx.util.osutil.cd`` is deprecated in favour of ``contextlib.chdir``.
+
+Features added
+--------------
+
+* #11277: :rst:dir:`autoproperty` allows the return type to be specified as
+  a type comment (e.g., ``# type: () -> int``). Patch by Bénédikt Tran
+* #10811: Autosummary: extend ``__all__`` to imported members for template rendering
+  when option ``autosummary_ignore_module_all`` is set to ``False``. Patch by
+  Clement Pinard
+* #11147: Add a ``content_offset`` parameter to ``nested_parse_with_titles()``,
+  allowing for correct line numbers during nested parsing.
+  Patch by Jeremy Maitin-Shepard
+* Update to Unicode CLDR 42
+* Add a ``--jobs`` synonym for ``-j``. Patch by Hugo van Kemenade
+* LaTeX: a command ``\sphinxbox`` for styling text elements with a (possibly
+  rounded) box, optional background color and shadow, has been added.
+  See :ref:`sphinxbox`. (refs: #11224)
+* LaTeX: add ``\sphinxstylenotetitle``, ..., ``\sphinxstylewarningtitle``, ...,
+  for an extra layer of mark-up freeing up ``\sphinxstrong`` for other uses.
+  See :ref:`latex-macros`. (refs: #11267)
+* LaTeX: :dudir:`note`, :dudir:`hint`, :dudir:`important` and :dudir:`tip` can
+  now each be styled as the other admonitions, i.e. possibly with a background
+  color, individual border widths and paddings, possibly rounded corners, and
+  optional shadow.  See :ref:`additionalcss`. (refs: #11234)
+* LaTeX: admonitions and :dudir:`topic` (and
+  :dudir:`contents <table-of-contents>`) directives, and not only
+  :rst:dir:`code-block`, support ``box-decoration-break=slice``.
+* LaTeX: let rounded boxes support up to 4 distinct border-widths (refs: #11243)
+* LaTeX: new options ``noteTextColor``, ``noteTeXextras`` et al.
+  See :ref:`additionalcss`.
+* LaTeX: support elliptical corners in rounded boxes. (refs: #11254)
+* #11150: Include source location in highlighting warnings, when lexing fails.
+  Patch by Jeremy Maitin-Shepard
+* #11281: Support for :confval:`imgmath_latex` ``= 'tectonic'`` or
+  ``= 'xelatex'``.  Patch by Dimitar Dimitrov
+* #11109, #9643: Add :confval:`python_display_short_literal_types` option for
+  condensed rendering of ``Literal`` types.
+
+Bugs fixed
+----------
+
+* #11079: LaTeX: figures with align attribute may disappear and strangely impact
+  following lists
+* #11093: LaTeX: fix "multiply-defined references" PDF build warnings when one or
+  more reST labels directly precede an :rst:dir:`py:module` or :rst:dir:`automodule`
+  directive. Patch by Bénédikt Tran (picnixz)
+* #11110: LaTeX: Figures go missing from latex pdf if their files have the same
+  base name and they use a post transform.  Patch by aaron-cooper
+* LaTeX: fix potential color leak from shadow to border of rounded boxes, if
+  shadow color is set but border color is not
+* LaTeX: fix unintended 1pt upwards vertical shift of code blocks frames
+  respective to contents (when using rounded corners)
+* #11235: LaTeX: added ``\color`` in topic (or admonition) contents may cause color
+  leak to the shadow and border at a page break
+* #11264: LaTeX: missing space before colon after "Voir aussi" for :rst:dir:`seealso`
+  directive in French
+* #11268: LaTeX: longtable with left alignment breaks out of current list
+  indentation context in PDF.  Thanks to picnixz.
+* #11274: LaTeX: external links are not properly escaped for ``\sphinxupquote``
+  compatibility
+* #11147: Fix source file/line number info in object description content and in
+  other uses of ``nested_parse_with_titles``.  Patch by Jeremy Maitin-Shepard.
+* #11192: Restore correct parallel search index building.
+  Patch by Jeremy Maitin-Shepard
+* Use the new Transifex ``tx`` client
+
+Testing
+--------
+
+* Fail testing when any Python warnings are emitted
+* Migrate remaining ``unittest.TestCase`` style test functions to pytest style
+* Remove tests that rely on setuptools
+
+Release 6.1.3 (released Jan 10, 2023)
+=====================================
+
+Bugs fixed
+----------
+
+* #11116: Reverted to previous Sphinx 5 node copying method
+* #11117: Reverted changes to parallel image processing from Sphinx 6.1.0
+* #11119: Supress ``ValueError`` in the ``linkcheck`` builder
+
+Release 6.1.2 (released Jan 07, 2023)
+=====================================
+
+Bugs fixed
+----------
+
+* #11101: LaTeX: ``div.topic_padding`` key of sphinxsetup documented at 5.1.0 was
+  implemented with name ``topic_padding``
+* #11099: LaTeX: ``shadowrule`` key of sphinxsetup causes PDF build to crash
+  since Sphinx 5.1.0
+* #11096: LaTeX: ``shadowsize`` key of sphinxsetup causes PDF build to crash
+  since Sphinx 5.1.0
+* #11095: LaTeX: shadow of :dudir:`topic` and :dudir:`contents <table-of-contents>`
+  boxes not in page margin since Sphinx 5.1.0
+* #11100: Fix copying images when running under parallel mode.
+
+Release 6.1.1 (released Jan 05, 2023)
+=====================================
+
+Bugs fixed
+----------
+
+* #11091: Fix ``util.nodes.apply_source_workaround`` for ``literal_block`` nodes
+  with no source information in the node or the node's parents.
+
+Release 6.1.0 (released Jan 05, 2023)
+=====================================
+
+Dependencies
+------------
+
+* Adopted the `Ruff`_ code linter.
+
+  .. _Ruff: https://github.com/charliermarsh/ruff
+
+Incompatible changes
+--------------------
+
+* #10979: gettext: Removed support for pluralisation in ``get_translation``.
+  This was unused and complicated other changes to ``sphinx.locale``.
+
+Deprecated
+----------
+
+* ``sphinx.util`` functions:
+
+   * Renamed ``sphinx.util.typing.stringify()``
+     to ``sphinx.util.typing.stringify_annotation()``
+   * Moved ``sphinx.util.xmlname_checker()``
+     to ``sphinx.builders.epub3._XML_NAME_PATTERN``
+
+   Moved to ``sphinx.util.display``:
+
+   * ``sphinx.util.status_iterator``
+   * ``sphinx.util.display_chunk``
+   * ``sphinx.util.SkipProgressMessage``
+   * ``sphinx.util.progress_message``
+
+   Moved to ``sphinx.util.http_date``:
+
+   * ``sphinx.util.epoch_to_rfc1123``
+   * ``sphinx.util.rfc1123_to_epoch``
+
+   Moved to ``sphinx.util.exceptions``:
+
+   * ``sphinx.util.save_traceback``
+   * ``sphinx.util.format_exception_cut_frames``
+
+Features added
+--------------
+
+* Cache doctrees in the build environment during the writing phase.
+* Make all writing phase tasks support parallel execution.
+* #11072: Use PEP 604 (``X | Y``) display conventions for ``typing.Optional``
+  and ``typing.Optional`` types within the Python domain and autodoc.
+* #10700: autodoc: Document ``typing.NewType()`` types as classes rather than
+  'data'.
+* Cache doctrees between the reading and writing phases.
+
+Bugs fixed
+----------
+
+* #10962: HTML: Fix the multi-word key name lookup table.
+* Fixed support for Python 3.12 alpha 3 (changes in the ``enum`` module).
+* #11069: HTML Theme: Removed outdated "shortcut" link relation keyword.
+* #10952: Properly terminate parallel processes on programme interuption.
+* #10988: Speed up ``TocTree.resolve()`` through more efficient copying.
+* #6744: LaTeX: support for seealso directive should be via an environment
+  to allow styling.
+* #11074: LaTeX: Can't change sphinxnote to use sphinxheavybox starting with
+  5.1.0
+
+Release 6.0.1 (released Jan 05, 2023)
+=====================================
+
+Dependencies
+------------
+
+* Require Pygments 2.13 or later.
+
+Bugs fixed
+----------
+
+* #10944: imgmath:  Fix resolving image paths for files in nested folders.
+
+Release 6.0.0 (released Dec 29, 2022)
+=====================================
+
+Dependencies
+------------
+
+* #10468: Drop Python 3.6 support
+* #10470: Drop Python 3.7, Docutils 0.14, Docutils 0.15, Docutils 0.16, and
+  Docutils 0.17 support. Patch by Adam Turner
+
+Incompatible changes
+--------------------
+
+* #7405: Removed the jQuery and underscore.js JavaScript frameworks.
+
+  These frameworks are no longer be automatically injected into themes from
+  Sphinx 6.0. If you develop a theme or extension that uses the
+  ``jQuery``, ``$``, or ``$u`` global objects, you need to update your
+  JavaScript to modern standards, or use the mitigation below.
+
+  The first option is to use the sphinxcontrib.jquery_ extension, which has been
+  developed by the Sphinx team and contributors. To use this, add
+  ``sphinxcontrib.jquery`` to the ``extensions`` list in ``conf.py``, or call
+  ``app.setup_extension("sphinxcontrib.jquery")`` if you develop a Sphinx theme
+  or extension.
+
+  The second option is to manually ensure that the frameworks are present.
+  To re-add jQuery and underscore.js, you will need to copy ``jquery.js`` and
+  ``underscore.js`` from `the Sphinx repository`_ to your ``static`` directory,
+  and add the following to your ``layout.html``:
+
+  .. code-block:: html+jinja
+
+     {%- block scripts %}
+         <script src="{{ pathto('_static/jquery.js', resource=True) }}"></script>
+         <script src="{{ pathto('_static/underscore.js', resource=True) }}"></script>
+         {{ super() }}
+     {%- endblock %}
+
+  .. _sphinxcontrib.jquery: https://github.com/sphinx-contrib/jquery/
+
+  Patch by Adam Turner.
+* #10471, #10565: Removed deprecated APIs scheduled for removal in Sphinx 6.0. See
+  :ref:`dev-deprecated-apis` for details. Patch by Adam Turner.
+* #10901: C Domain: Remove support for parsing pre-v3 style type directives and
+  roles. Also remove associated configuration variables ``c_allow_pre_v3`` and
+  ``c_warn_on_allowed_pre_v3``. Patch by Adam Turner.
+
+Features added
+--------------
+
+* #10924: LaTeX: adopt better looking defaults for tables and code-blocks.
+  See :confval:`latex_table_style` and the ``pre_border-radius`` and
+  ``pre_background-TeXcolor`` :ref:`additionalcss` for the former defaults
+  and how to re-enact them if desired.
+
+Bugs fixed
+----------
+
+* #10984: LaTeX: Document :confval:`latex_additional_files` behavior for files
+  with ``.tex`` extension.
+
+Release 5.3.0 (released Oct 16, 2022)
+=====================================
+
+* #10759: LaTeX: add :confval:`latex_table_style` and support the
+  ``'booktabs'``, ``'borderless'``, and ``'colorrows'`` styles.
+  (thanks to Stefan Wiehler for initial pull requests #6666, #6671)
+* #10840: One can cross-reference including an option value like ``:option:`--module=foobar```,
+  ``:option:`--module=foobar``` or ``:option:`--module foobar```.
+  Patch by Martin Liska.
+* #10881: autosectionlabel: Record the generated section label to the debug log.
+* #10268: Correctly URI-escape image filenames.
+* #10887: domains: Allow sections in all the content of all object description
+  directives (e.g. :rst:dir:`py:function`). Patch by Adam Turner
+
+Release 5.2.3 (released Sep 30, 2022)
+=====================================
+
+* #10878: Fix base64 image embedding in ``sphinx.ext.imgmath``
+* #10886: Add ``:nocontentsentry:`` flag and global domain table of contents
+  entry control option. Patch by Adam Turner
+
+Release 5.2.2 (released Sep 27, 2022)
+=====================================
+
+* #10872: Restore link targets for autodoc modules to the top of content.
+  Patch by Dominic Davis-Foster.
+
+Release 5.2.1 (released Sep 25, 2022)
+=====================================
+
+Bugs fixed
+----------
+
+* #10861: Always normalise the ``pycon3`` lexer to ``pycon``.
+* Fix using ``sphinx.ext.autosummary`` with modules containing titles in the
+  module-level docstring.
+
+Release 5.2.0.post0 (released Sep 24, 2022)
+===========================================
+
+* Recreated source tarballs for Debian maintainers.
+
+Release 5.2.0 (released Sep 24, 2022)
+=====================================
+
+Dependencies
+------------
+
+* #10356: Sphinx now uses declarative metadata with ``pyproject.toml`` to
+  create packages, using PyPA's ``flit`` project as a build backend. Patch by
+  Adam Turner.
+
+Deprecated
+----------
+
+* #10843: Support for HTML 4 output. Patch by Adam Turner.
+
+Features added
+--------------
+
+* #10738: napoleon: Add support for docstring types using 'of', like
+  ``type of type``. Example: ``tuple of int``.
+* #10286: C++, support requires clauses not just between the template
+  parameter lists and the declaration.
+* #10755: linkcheck: Check the source URL of raw directives that use the ``url``
+  option.
+* #10781: Allow :rst:role:`ref` role to be used with definitions and fields.
+* #10717: HTML Search: Increase priority for full title and
+  subtitle matches in search results
+* #10718: HTML Search: Save search result score to the HTML element for debugging
+* #10673: Make toctree accept 'genindex', 'modindex' and 'search' docnames
+* #6316, #10804: Add domain objects to the table of contents. Patch by Adam Turner
+* #6692: HTML Search: Include explicit :rst:dir:`index` directive index entries
+  in the search index and search results. Patch by Adam Turner
+* #10816: imgmath: Allow embedding images in HTML as base64
+* #10854: HTML Search: Use browser localstorage for highlight control, stop
+  storing highlight parameters in URL query strings. Patch by Adam Turner.
+
+Bugs fixed
+----------
+
+* #10723: LaTeX: 5.1.0 has made the 'sphinxsetup' ``verbatimwithframe=false``
+  become without effect.
+* #10257: C++, ensure consistent non-specialization template argument
+  representation.
+* #10729: C++, fix parsing of certain non-type template parameter packs.
+* #10715: Revert #10520: "Fix" use of sidebar classes in ``agogo.css_t``
+
+Release 5.1.1 (released Jul 26, 2022)
+=====================================
+
+Bugs fixed
+----------
+
+* #10701: Fix ValueError in the new ``deque`` based ``sphinx.ext.napolean``
+  iterator implementation.
+* #10702: Restore compatability with third-party builders.
+
+Release 5.1.0 (released Jul 24, 2022)
+=====================================
+
+Dependencies
+------------
+
+* #10656: Support `Docutils 0.19`_. Patch by Adam Turner.
+
+.. _Docutils 0.19: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-19-2022-07-05
+
+Deprecated
+----------
+
+* #10467: Deprecated ``sphinx.util.stemmer`` in favour of ``snowballstemmer``.
+  Patch by Adam Turner.
+* #9856: Deprecated ``sphinx.ext.napoleon.iterators``.
+
+Features added
+--------------
+
+* #10444: html theme: Allow specifying multiple CSS files through the ``stylesheet``
+  setting in ``theme.conf`` or by setting ``html_style`` to an iterable of strings.
+* #10366: std domain: Add support for emphasising placeholders in :rst:dir:`option`
+  directives through a new :confval:`option_emphasise_placeholders` configuration
+  option.
+* #10439: std domain: Use the repr of some variables when displaying warnings,
+  making whitespace issues easier to identify.
+* #10571: quickstart: Reduce content in the generated ``conf.py`` file. Patch by
+  Pradyun Gedam.
+* #10648: LaTeX: CSS-named-alike additional :ref:`'sphinxsetup' <latexsphinxsetup>`
+  keys allow to configure four separate border-widths, four paddings, four
+  corner radii, a shadow (possibly inset), colours for border, background, shadow
+  for each of the code-block, topic, attention, caution, danger, error and warning
+  directives.
+* #10655: LaTeX: Explain non-standard encoding in LatinRules.xdy
+* #10599: HTML Theme: Wrap consecutive footnotes in an ``<aside>`` element when
+  using Docutils 0.18 or later, to allow for easier styling. This matches the
+  behaviour introduced in Docutils 0.19. Patch by Adam Turner.
+* #10518: config: Add ``include_patterns`` as the opposite of ``exclude_patterns``.
+  Patch by Adam Turner.
+
+Bugs fixed
+----------
+
+* #10594: HTML Theme: field term colons are doubled if using Docutils 0.18+
+* #10596: Build failure if Docutils version is 0.18 (not 0.18.1) due
+  to missing ``Node.findall()``
+* #10506: LaTeX: build error if highlighting inline code role in figure caption
+  (refs: #10251)
+* #10634: Make -P (pdb) option work better with exceptions triggered from events
+* #10550: py domain: Fix spurious whitespace in unparsing various operators (``+``,
+  ``-``, ``~``, and ``**``). Patch by Adam Turner (refs: #10551).
+* #10460: logging: Always show node source locations as absolute paths.
+* HTML Search: HTML tags are displayed as a part of object name
+* HTML Search: search snipets should not be folded
+* HTML Search: Minor errors are emitted on fetching search snipets
+* HTML Search: The markers for header links are shown in the search result
+* #10520: HTML Theme: Fix use of sidebar classes in ``agogo.css_t``.
+* #6679: HTML Theme: Fix inclusion of hidden toctrees in the agogo theme.
+* #10566: HTML Theme: Fix enable_search_shortcuts does not work
+* #8686: LaTeX: Text can fall out of code-block at end of page and leave artifact
+  on next page
+* #10633: LaTeX: user injected ``\color`` commands in topic or admonition boxes may
+  cause color leaks in PDF due to upstream `framed.sty <https://ctan.org/pkg/framed>`_
+  bug
+* #10638: LaTeX: framed coloured boxes in highlighted code (e.g. highlighted
+  diffs using Pygments style ``'manni'``) inherit thickness of code-block frame
+* #10647: LaTeX: Only one ``\label`` is generated for ``desc_signature`` node
+  even if it has multiple node IDs
+* #10579: i18n: UnboundLocalError is raised on translating raw directive
+* #9577, #10088: py domain: Fix warning for duplicate Python references when
+  using ``:any:`` and autodoc.
+* #10548: HTML Search: fix minor summary issues.
+
+Release 5.0.2 (released Jun 17, 2022)
+=====================================
+
+Features added
+--------------
+
+* #10523: HTML Theme: Expose the Docutils's version info tuple as a template
+  variable, ``docutils_version_info``. Patch by Adam Turner.
+
+Bugs fixed
+----------
+
+* #10538: autodoc: Inherited class attribute having docstring is documented even
+  if :confval:`autodoc_inherit_docstring` is disabled
+* #10509: autosummary: autosummary fails with a shared library
+* #10497: py domain: Failed to resolve strings in Literal. Patch by Adam Turner.
+* #10523: HTML Theme: Fix double brackets on citation references in Docutils 0.18+.
+  Patch by Adam Turner.
+* #10534: Missing CSS for nav.contents in Docutils 0.18+. Patch by Adam Turner.
+
+Release 5.0.1 (released Jun 03, 2022)
+=====================================
+
+Bugs fixed
+----------
+
+* #10498: gettext: TypeError is raised when sorting warning messages if a node
+  has no line number. Patch by Adam Turner.
+* #10493: HTML Theme: :dudir:`topic` directive is rendered incorrectly with
+  Docutils 0.18. Patch by Adam Turner.
+* #10495: IndexError is raised for a :rst:role:`kbd` role having a separator.
+  Patch by Adam Turner.
+
+Release 5.0.0 (released May 30, 2022)
+=====================================
+
+Dependencies
+------------
+
+5.0.0 b1
+
+* #10164: Support `Docutils 0.18`_. Patch by Adam Turner.
+
+.. _Docutils 0.18:  https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-18-2021-10-26
+
+Incompatible changes
+--------------------
+
+5.0.0 b1
+
+* #10031: autosummary: ``sphinx.ext.autosummary.import_by_name()`` now raises
+  ``ImportExceptionGroup`` instead of ``ImportError`` when it failed to import
+  target object.  Please handle the exception if your extension uses the
+  function to import Python object.  As a workaround, you can disable the
+  behavior via ``grouped_exception=False`` keyword argument until v7.0.
+* #9962: texinfo: Customizing styles of emphasized text via ``@definfoenclose``
+  command was not supported because the command was deprecated since texinfo 6.8
+* #2068: :confval:`intersphinx_disabled_reftypes` has changed default value
+  from an empty list to ``'std:doc'`` as avoid too surprising silent
+  intersphinx resolutions.
+  To migrate: either add an explicit inventory name to the references
+  intersphinx should resolve, or explicitly set the value of this configuration
+  variable to an empty list.
+* #10197: html theme: Reduce ``body_min_width`` setting in basic theme to 360px
+* #9999: LaTeX: separate terms from their definitions by a CR (refs: #9985)
+* #10062: Change the default language to ``'en'`` if any language is not set in
+  ``conf.py``
+
+5.0.0 final
+
+* #10474: :confval:`language` does not accept ``None`` as it value.  The default
+  value of ``language`` becomes to ``'en'`` now.
+  Patch by Adam Turner and Takeshi KOMIYA.
+
+Deprecated
+----------
+
+5.0.0 b1
+
+* #10028: jQuery and underscore.js will no longer be automatically injected into
+  themes from Sphinx 6.0. If you develop a theme or extension that uses the
+  ``jQuery``, ``$``, or ``$u`` global objects, you need to update your
+  JavaScript or use the mitigation below.
+
+  To re-add jQuery and underscore.js, you will need to copy ``jquery.js`` and
+  ``underscore.js`` from `the Sphinx repository`_ to your ``static`` directory,
+  and add the following to your ``layout.html``:
+
+  .. _the Sphinx repository: https://github.com/sphinx-doc/sphinx/tree/v5.3.0/sphinx/themes/basic/static
+  .. code-block:: html+jinja
+
+     {%- block scripts %}
+         <script src="{{ pathto('_static/jquery.js', resource=True) }}"></script>
+         <script src="{{ pathto('_static/underscore.js', resource=True) }}"></script>
+         {{ super() }}
+     {%- endblock %}
+
+  Patch by Adam Turner.
+* setuptools integration.  The ``build_sphinx`` sub-command for setup.py is
+  marked as deprecated to follow the policy of setuptools team.
+* The ``locale`` argument of ``sphinx.util.i18n:babel_format_date()`` becomes
+  required
+* The ``language`` argument of ``sphinx.util.i18n:format_date()`` becomes
+  required
+* ``sphinx.builders.html.html5_ready``
+* ``sphinx.io.read_doc()``
+* ``sphinx.util.docutils.__version_info__``
+* ``sphinx.util.docutils.is_html5_writer_available()``
+* ``sphinx.writers.latex.LaTeXWriter.docclasses``
+
+Features added
+--------------
+
+5.0.0 b1
+
+* #9075: autodoc: The default value of :confval:`autodoc_typehints_format` is
+  changed to ``'smart'``.  It will suppress the leading module names of
+  typehints (ex. ``io.StringIO`` -> ``StringIO``).
+* #8417: autodoc: ``:inherited-members:`` option now takes multiple classes.  It
+  allows to suppress inherited members of several classes on the module at once
+  by specifying the option to :rst:dir:`automodule` directive
+* #9792: autodoc: Add new option for ``autodoc_typehints_description_target`` to
+  include undocumented return values but not undocumented parameters.
+* #10285: autodoc: singledispatch functions having typehints are not documented
+* autodoc: :confval:`autodoc_typehints_format` now also applies to attributes,
+  data, properties, and type variable bounds.
+* #10258: autosummary: Recognize a documented attribute of a module as
+  non-imported
+* #10028: Removed internal usages of JavaScript frameworks (jQuery and
+  underscore.js) and modernised ``doctools.js`` and ``searchtools.js`` to
+  EMCAScript 2018. Patch by Adam Turner.
+* #10302: C++, add support for conditional expressions (``?:``).
+* #5157, #10251: Inline code is able to be highlighted via :dudir:`role`
+  directive
+* #10337: Make sphinx-build faster by caching Publisher object during build.
+  Patch by Adam Turner.
+
+Bugs fixed
+----------
+
+5.0.0 b1
+
+* #10200: apidoc: Duplicated submodules are shown for modules having both .pyx
+  and .so files. Patch by Adam Turner and Takeshi KOMIYA.
+* #10279: autodoc: Default values for keyword only arguments in overloaded
+  functions are rendered as a string literal
+* #10280: autodoc: :confval:`autodoc_docstring_signature` unexpectedly generates
+  return value typehint for constructors if docstring has multiple signatures
+* #10266: autodoc: :confval:`autodoc_preserve_defaults` does not work for
+  mixture of keyword only arguments with/without defaults
+* #10310: autodoc: class methods are not documented when decorated with mocked
+  function
+* #10305: autodoc: Failed to extract optional forward-ref'ed typehints correctly
+  via :confval:`autodoc_type_aliases`
+* #10421: autodoc: :confval:`autodoc_preserve_defaults` doesn't work on class
+  methods
+* #10214: html: invalid language tag was generated if :confval:`language`
+  contains a country code (ex. zh_CN)
+* #9974: html: Updated jQuery version from 3.5.1 to 3.6.0
+* #10236: html search: objects are duplicated in search result
+* #9962: texinfo: Deprecation message for ``@definfoenclose`` command on
+  bulding texinfo document
+* #10000: LaTeX: glossary terms with common definition are rendered with
+  too much vertical whitespace
+* #10188: LaTeX: alternating multiply referred footnotes produce a ``?`` in
+  pdf output
+* #10363: LaTeX: make ``'howto'`` title page rule use ``\linewidth`` for
+  compatibility with usage of a ``twocolumn`` class option
+* #10318: ``:prepend:`` option of :rst:dir:`literalinclude` directive does not
+  work with ``:dedent:`` option
+
+5.0.0 final
+
+* #9575: autodoc: The annotation of return value should not be shown when
+  ``autodoc_typehints="description"``
+* #9648: autodoc: ``*args`` and ``**kwargs`` entries are duplicated when
+  ``autodoc_typehints="description"``
+* #8180: autodoc: Docstring metadata ignored for attributes
+* #10443: epub: EPUB builder can't detect the mimetype of .webp file
+* #10104: gettext: Duplicated locations are shown if 3rd party extension does
+  not provide correct information
+* #10456: py domain: ``:meta:`` fields are displayed if docstring contains two
+  or more meta-field
+* #9096: sphinx-build: the value of progress bar for paralle build is wrong
+* #10110: sphinx-build: exit code is not changed when error is raised on
+  builder-finished event
+
+Release 4.5.0 (released Mar 28, 2022)
+=====================================
+
+Incompatible changes
+--------------------
+
+* #10112: extlinks: Disable hardcoded links detector by default
+* #9993, #10177: std domain: Disallow to refer an inline target via
+  :rst:role:`ref` role
+
+Deprecated
+----------
+
+* ``sphinx.ext.napoleon.docstring.GoogleDocstring._qualify_name()``
+
+Features added
+--------------
+
+* #10260: Enable ``FORCE_COLOR`` and ``NO_COLOR`` for terminal colouring
+* #10234: autosummary: Add "autosummary" CSS class to summary tables
+* #10125: extlinks: Improve suggestion message for a reference having title
+* #10112: extlinks: Add :confval:`extlinks_detect_hardcoded_links` to enable
+  hardcoded links detector feature
+* #9494, #9456: html search: Add a config variable
+  :confval:`html_show_search_summary` to enable/disable the search summaries
+* #9337: HTML theme, add option ``enable_search_shortcuts`` that enables :kbd:`/` as
+  a Quick search shortcut and :kbd:`Esc` shortcut that
+  removes search highlighting.
+* #10107: i18n: Allow to suppress translation warnings by adding ``#noqa``
+  comment to the tail of each translation message
+* #10252: C++, support attributes on classes, unions, and enums.
+* #10253: :rst:role:`pep` role now generates URLs based on `peps.python.org
+  <https://peps.python.org>`_
+
+Bugs fixed
+----------
+
+* #9876: autodoc: Failed to document an imported class that is built from native
+  binary module
+* #10133: autodoc: Crashed when mocked module is used for type annotation
+* #10146: autodoc: :confval:`autodoc_default_options` does not support
+  ``no-value`` option
+* #9971: autodoc: TypeError is raised when the target object is annotated by
+  unhashable object
+* #10205: extlinks: Failed to compile regexp on checking hardcoded links
+* #10277: html search: Could not search short words (ex. "use")
+* #9529: LaTeX: named auto numbered footnote (ex. ``#named``) that is referred
+  multiple times was rendered to a question mark
+* #9924: LaTeX: multi-line :rst:dir:`cpp:function` directive has big vertical
+  spacing in Latexpdf
+* #10158: LaTeX: excessive whitespace since v4.4.0 for undocumented
+  variables/structure members
+* #10175: LaTeX: named footnote reference is linked to an incorrect footnote if
+  the name is also used in the different document
+* #10269: manpage: Failed to resolve the title of :rst:role:`ref` cross references
+* #10179: i18n: suppress "rST localization" warning
+* #10118: imgconverter: Unnecessary availablity check is called for remote URIs
+* #10181: napoleon: attributes are displayed like class attributes for google
+  style docstrings when :confval:`napoleon_use_ivar` is enabled
+* #10122: sphinx-build: make.bat does not check the installation of sphinx-build
+  command before showing help
+
 Release 4.4.0 (released Jan 17, 2022)
 =====================================
 
@@ -22,7 +776,7 @@
   by an extlink, suggesting a replacement.
 * #9961: html: Support nested <kbd> HTML elements in other HTML builders
 * #10013: html: Allow to change the loading method of JS via ``loading_method``
-  parameter for :meth:`Sphinx.add_js_file()`
+  parameter for :meth:`.Sphinx.add_js_file()`
 * #9551: html search: "Hide Search Matches" link removes "highlight" parameter
   from URL
 * #9815: html theme: Wrap sidebar components in div to allow customizing their
@@ -129,7 +883,7 @@
   with more docutils nodes to allow better CSS styling.
   It may break existing styling.
 * #9672: the signature of
-  :py:meth:`domains.py.PyObject.get_signature_prefix` has changed to
+  ``domains.python.PyObject.get_signature_prefix`` has changed to
   return a list of nodes instead of a plain string.
 * #9695: ``domains.js.JSObject.display_prefix`` has been changed into a method
   ``get_display_prefix`` which now returns a list of nodes
@@ -162,7 +916,7 @@
 * #9672: More CSS classes on Python domain descriptions
 * #9695: More CSS classes on Javascript domain descriptions
 * #9683: Revert the removal of ``add_stylesheet()`` API.  It will be kept until
-  the Sphinx-6.0 release
+  the Sphinx 6.0 release
 * #2068, add :confval:`intersphinx_disabled_reftypes` for disabling
   interphinx resolution of cross-references that do not have an explicit
   inventory specification. Specific types of cross-references can be disabled,
@@ -204,9 +958,9 @@
 * #9697: py domain: An index entry with parens was registered for ``py:method``
   directive with ``:property:`` option
 * #9775: py domain: Literal typehint was converted to a cross reference when
-  :confval:`autodoc_typehints='description'`
+  :confval:`autodoc_typehints`\ ``='description'``
 * #9708: needs_extension failed to check double-digit version correctly
-* #9688: Fix :rst:dir:`code`` does not recognize ``:class:`` option
+* #9688: Fix Sphinx patched :dudir:`code` does not recognize ``:class:`` option
 * #9733: Fix for logging handler flushing warnings in the middle of the docs
   build
 * #9656: Fix warnings without subtype being incorrectly suppressed
@@ -226,7 +980,7 @@
 * #9447: html theme: Expose the version of Sphinx in the form of tuple as a
   template variable ``sphinx_version_tuple``
 * #9594: manpage: Suppress the title of man page if description is empty
-* #9445: py domain: ``:py:property:`` directive supports ``:classmethod:``
+* #9445: py domain: :rst:dir:`py:property` directive supports ``:classmethod:``
   option to describe the class property
 * #9524: test: SphinxTestApp can take ``builddir`` as an argument
 * #9535: C and C++, support more fundamental types, including GNU extensions.
@@ -497,7 +1251,8 @@
 4.0.0b1
 
 * #8539: autodoc: info-field-list is generated into the class description when
-  ``autodoc_typehints='description'`` and ``autoclass_content='class'`` set
+  :confval:`autodoc_typehints`\ ``='description'`` and
+  :confval:`autoclass_content`\ ``='class'`` set
 * #8898: extlinks: "%s" becomes required keyword in the link caption string
 * domain: The ``Index`` class becomes subclasses of ``abc.ABC`` to indicate
   methods that must be overridden in the concrete classes
@@ -759,7 +1514,7 @@
   functions in source code and keep them not evaluated for readability.
 * #8619: html: kbd role generates customizable HTML tags for compound keys
 * #8634: html: Allow to change the order of JS/CSS via ``priority`` parameter
-  for :meth:`Sphinx.add_js_file()` and :meth:`Sphinx.add_css_file()`
+  for :meth:`.Sphinx.add_js_file()` and :meth:`.Sphinx.add_css_file()`
 * #6241: html: Allow to add JS/CSS files to the specific page when an extension
   calls ``app.add_js_file()`` or ``app.add_css_file()`` on
   :event:`html-page-context` event
@@ -773,7 +1528,7 @@
 * #8649: imgconverter: Skip availability check if builder supports the image
   type
 * #8573: napoleon: Allow to change the style of custom sections using
-  :confval:`napoleon_custom_styles`
+  :confval:`napoleon_custom_sections`
 * #8004: napoleon: Type definitions in Google style docstrings are rendered as
   references when :confval:`napoleon_preprocess_types` enabled
 * #6241: mathjax: Include mathjax.js only on the document using equations
@@ -860,7 +1615,7 @@
   inside function type signatures
 * #8780: LaTeX: long words in narrow columns may not be hyphenated
 * #8788: LaTeX: ``\titleformat`` last argument in sphinx.sty should be
-  bracketed, not braced (and is anyhow not needed) 
+  bracketed, not braced (and is anyhow not needed)
 * #8849: LaTex: code-block printed out of margin (see the opt-in LaTeX syntax
   boolean :ref:`verbatimforcewraps <latexsphinxsetupforcewraps>` for use via
   the :ref:`'sphinxsetup' <latexsphinxsetup>` key of ``latex_elements``)
@@ -960,7 +1715,7 @@
   messages when failed to resolve a cross-reference
 * #6914: Emit a detailed warning when failed to resolve a ``:ref:`` reference
 * #6629: linkcheck: The builder now handles rate limits. See
-  :confval:`linkcheck_retry_on_rate_limit` for details.
+  :confval:`linkcheck_rate_limit_timeout` for details.
 
 Bugs fixed
 ----------
@@ -1016,7 +1771,7 @@
 Bugs fixed
 ----------
 
-* #8372: autodoc: autoclass directive became slower than Sphinx-3.2
+* #8372: autodoc: autoclass directive became slower than Sphinx 3.2
 * #7727: autosummary: raise PycodeError when documenting python package
   without __init__.py
 * #8350: autosummary: autosummary_mock_imports causes slow down builds
@@ -1143,7 +1898,7 @@
 * ``sphinx.ext.autodoc.merge_special_members_option()``
 * ``sphinx.writers.texinfo.TexinfoWriter.desc``
 * C, parsing of pre-v3 style type directives and roles, along with the options
-  :confval:`c_allow_pre_v3` and :confval:`c_warn_on_allowed_pre_v3`.
+  :confval:`!c_allow_pre_v3` and :confval:`!c_warn_on_allowed_pre_v3`.
 
 Features added
 --------------
@@ -1162,7 +1917,7 @@
 * #7690: napoleon: parse type strings and make them hyperlinks as possible.  The
   conversion rule can be updated via :confval:`napoleon_type_aliases`
 * #8049: napoleon: Create a hyperlink for each the type of parameter when
-  :confval:`napoleon_use_params` is False
+  :confval:`napoleon_use_param` is False
 * C, added :rst:dir:`c:alias` directive for inserting copies
   of existing declarations.
 * #7745: html: inventory is broken if the docname contains a space
@@ -1180,9 +1935,9 @@
   and the ``:noindex:`` option.
 * #7899: C, add possibility of parsing of some pre-v3 style type directives and
   roles and try to convert them to equivalent v3 directives/roles.
-  Set the new option :confval:`c_allow_pre_v3` to ``True`` to enable this.
+  Set the new option :confval:`!c_allow_pre_v3` to ``True`` to enable this.
   The warnings printed from this functionality can be suppressed by setting
-  :confval:`c_warn_on_allowed_pre_v3`` to ``True``.
+  :confval:`!c_warn_on_allowed_pre_v3` to ``True``.
   The functionality is immediately deprecated.
 * #7999: C, add support for named variadic macro arguments.
 * #8071: Allow to suppress "self referenced toctrees" warning
@@ -1213,7 +1968,7 @@
 * #4258: napoleon: decorated special methods are not shown
 * #7799: napoleon: parameters are not escaped for combined params in numpydoc
 * #7780: napoleon: multiple parameters declaration in numpydoc was wrongly
-  recognized when napoleon_use_params=True
+  recognized when ``napoleon_use_param=True``
 * #7715: LaTeX: ``numfig_secnum_depth > 1`` leads to wrong figure links
 * #7846: html theme: XML-invalid files were generated
 * #7894: gettext: Wrong source info is shown when using rst_epilog
@@ -1381,8 +2136,8 @@
 * C++, parse parameterized noexcept specifiers.
 * #7294: C++, parse expressions with user-defined literals.
 * C++, parse trailing return types.
-* #7143: py domain: Add ``:final:`` option to :rst:dir:`py:class:`,
-  :rst:dir:`py:exception:` and :rst:dir:`py:method:` directives
+* #7143: py domain: Add ``:final:`` option to :rst:dir:`py:class`,
+  :rst:dir:`py:exception` and :rst:dir:`py:method` directives
 * #7596: py domain: Change a type annotation for variables to a hyperlink
 * #7770: std domain: :rst:dir:`option` directive support arguments in the form
   of ``foo=bar``
@@ -1406,7 +2161,7 @@
 * #7559: autodoc: misdetects a sync function is async
 * #6857: autodoc: failed to detect a classmethod on Enum class
 * #7562: autodoc: a typehint contains spaces is wrongly rendered under
-  autodoc_typehints='description' mode
+  :confval:`autodoc_typehints`\ ``='description'`` mode
 * #7551: autodoc: failed to import nested class
 * #7362: autodoc: does not render correct signatures for built-in functions
 * #7654: autodoc: ``OptionalUnionfoo, bar`` is presented as
@@ -1509,7 +2264,7 @@
 Incompatible changes
 --------------------
 
-* #7418: std domain: :rst:dir:`term` role becomes case sensitive
+* #7418: std domain: :rst:role:`term` role becomes case sensitive
 
 Bugs fixed
 ----------
@@ -1520,8 +2275,8 @@
 * #7418: std domain: duplication warning for glossary terms is case insensitive
 * #7438: C++, fix merging overloaded functions in parallel builds.
 * #7422: autodoc: fails with ValueError when using autodoc_mock_imports
-* #7435: autodoc: ``autodoc_typehints='description'`` doesn't suppress typehints
-  in signature for classes/methods
+* #7435: autodoc: :confval:`autodoc_typehints`\ ``='description'`` doesn't
+  suppress typehints in signature for classes/methods
 * #7451: autodoc: fails with AttributeError when an object returns non-string
   object as a ``__doc__`` member
 * #7423: crashed when giving a non-string object to logger
@@ -1830,7 +2585,7 @@
 * #6418: autodoc: Add a new extension ``sphinx.ext.autodoc.typehints``. It shows
   typehints as object description if ``autodoc_typehints = "description"`` set.
   This is an experimental extension and it will be integrated into autodoc core
-  in Sphinx-3.0
+  in Sphinx 3.0
 * SphinxTranslator now calls visitor/departure method for super node class if
   visitor/departure method for original node class not found
 * #6418: Add new event: :event:`object-description-transform`
@@ -1932,7 +2687,7 @@
   authentication information when doing ``linkcheck`` builds
 * #6872: linkcheck: Handles HTTP 308 Permanent Redirect
 * #6613: html: Wrap section number in span tag
-* #6781: gettext: Add :confval:`gettext_last_translator' and
+* #6781: gettext: Add :confval:`gettext_last_translator` and
   :confval:`gettext_language_team` to customize headers of POT file
 
 Bugs fixed
@@ -2071,7 +2826,7 @@
   since Sphinx 1.8.0 (refs: #6533)
 * #6531: Failed to load last environment object when extension added
 * #736: Invalid sort in pair index
-* #6527: :confval:`last_updated` wrongly assumes timezone as UTC
+* #6527: :data:`last_updated` wrongly assumes timezone as UTC
 * #5592: std domain: :rst:dir:`option` directive registers an index entry for
   each comma separated option
 * #6549: sphinx-build: Escaped characters in error messages
@@ -2125,7 +2880,7 @@
 * #4550: html: Centering tables by default using CSS
 * #6239: latex: xelatex and xeCJK are used for Chinese documents by default
 * ``Sphinx.add_lexer()`` now takes a Lexer class instead of instance.  An
-  instance of lexers are still supported until Sphinx-3.x.
+  instance of lexers are still supported until Sphinx 3.x.
 
 Deprecated
 ----------
@@ -2186,7 +2941,7 @@
   - ``PythonDomain.note_object()``
   - ``SphinxDirective.set_source_info()``
 
-* #6180: Support ``--keep-going`` with BuildDoc setup command
+* #6180: Support ``--keep-going`` with ``BuildDoc`` setup command
 * ``math`` directive now supports ``:class:`` option
 * todo: ``todo`` directive now supports ``:name:`` option
 * Enable override via environment of ``SPHINXOPTS`` and ``SPHINXBUILD`` Makefile
@@ -2216,7 +2971,7 @@
   - ``:property:``
   - ``:staticmethod:``
 
-* rst domain: Add :rst:dir:`directive:option` directive to describe the option
+* rst domain: Add :rst:dir:`rst:directive:option` directive to describe the option
   for directive
 * #6306: html: Add a label to search form for accessability purposes
 * #4390: html: Consistent and semantic CSS for signatures
@@ -2263,9 +3018,9 @@
 * RemovedInSphinx30Warning is marked as pending
 * deprecation warnings are not emitted
 
-  - sphinx.application.CONFIG_FILENAME
-  - sphinx.builders.htmlhelp
-  - :confval:`viewcode_import`
+  - ``sphinx.application.CONFIG_FILENAME``
+  - ``sphinx.builders.htmlhelp``
+  - :confval:`!viewcode_import`
 
 * #6208: C++, properly parse full xrefs that happen to have a short xref as
   prefix
@@ -2748,7 +3503,7 @@
 
 1.8.0b1
 
-* #5156: the :py:mod:`sphinx.ext.graphviz: extension runs `dot` in the
+* #5156: the :py:mod:`sphinx.ext.graphviz` extension runs ``dot`` in the
   directory of the document being built instead of in the root directory of
   the documentation.
 * #4460: extensions which stores any data to environment should return the
@@ -2773,7 +3528,7 @@
 * #4811: The files under :confval:`html_static_path` are excluded from source
   files.
 * latex: Use ``\sphinxcite`` for citation references instead ``\hyperref``
-* The config value ``viewcode_import`` is renamed to
+* The config value :confval:`!viewcode_import` is renamed to
   :confval:`viewcode_follow_imported_members` (refs: #4035)
 * #1857: latex: :confval:`latex_show_pagerefs` does not add pagerefs for
   citations
@@ -2814,7 +3569,7 @@
 * :confval:`autodoc_default_flags` is deprecated
 * quickstart: ``--epub`` option becomes default, so it is deprecated
 * Drop function based directive support.  For now, Sphinx only supports class
-  based directives (see :class:`~Directive`)
+  based directives (see :class:`~docutils.parsers.rst.Directive`)
 * ``sphinx.util.docutils.directive_helper()`` is deprecated
 * ``sphinx.cmdline`` is deprecated
 * ``sphinx.make_mode`` is deprecated
@@ -3317,7 +4072,7 @@
 * ``format_annotation()`` and ``formatargspec()`` is deprecated.  Please use
   ``sphinx.util.inspect.Signature`` instead.
 * ``sphinx.ext.autodoc.AutodocReporter`` is replaced by ``sphinx.util.docutils.
-  switch_source_input()`` and now deprecated.  It will be removed in Sphinx-2.0.
+  switch_source_input()`` and now deprecated.  It will be removed in Sphinx 2.0.
 * ``sphinx.ext.autodoc.add_documenter()`` and ``AutoDirective._register`` is now
   deprecated.  Please use ``app.add_autodocumenter()`` instead.
 * ``AutoDirective._special_attrgetters`` is now deprecated.  Please use
@@ -3390,8 +4145,8 @@
 
 * Configuration variables
 
-  - html_use_smartypants
-  - latex_keep_old_macro_names
+  - :confval:`!html_use_smartypants`
+  - :confval:`!latex_keep_old_macro_names`
   - latex_elements'footer'
 
 * utility methods of ``sphinx.application.Sphinx`` class
@@ -3533,7 +4288,7 @@
 * #4281: Race conditions when creating output directory
 * #4315: For PDF 'howto' documents, ``latex_toplevel_sectioning='part'``
   generates ``\chapter`` commands
-* #4214: Two todolist directives break sphinx-1.6.5
+* #4214: Two todolist directives break Sphinx 1.6.5
 * Fix links to external option docs with intersphinx (refs: #3769)
 * #4091: Private members not documented without :undoc-members:
 
@@ -3717,7 +4472,7 @@
   option and other options (refs: #3416)
 * LuaLaTeX engine uses ``fontspec`` like XeLaTeX. It is advised ``latex_engine
   = 'lualatex'`` be used only on up-to-date TeX installs (refs #3070, #3466)
-* :confval:`latex_keep_old_macro_names` default value has been changed from
+* :confval:`!latex_keep_old_macro_names` default value has been changed from
   ``True`` to ``False``. This means that some LaTeX macros for styling are
   by default defined only with ``\sphinx..`` prefixed names. (refs: #3429)
 * Footer "Continued on next page" of LaTeX longtable's now not framed (refs:
@@ -3923,13 +4678,13 @@
 * latex package  ``footnote`` is not loaded anymore by its bundled replacement
   ``footnotehyper-sphinx``. The redefined macros keep the same names as in the
   original package.
-* #3429: deprecate config setting ``latex_keep_old_macro_names``. It will be
-  removed at 1.7, and already its default value has changed from ``True`` to
+* #3429: deprecate config setting :confval:`!latex_keep_old_macro_names`. It will
+  be removed at 1.7, and already its default value has changed from ``True`` to
   ``False``.
 * #3221: epub2 builder is deprecated
 * #3254: ``sphinx.websupport`` is now separated into independent package;
   ``sphinxcontrib-websupport``.  ``sphinx.websupport`` will be removed in
-  Sphinx-2.0.
+  Sphinx 2.0.
 * #3628: ``sphinx_themes`` entry_point is deprecated.  Please use
   ``sphinx.html_themes`` instead.
 
@@ -4190,7 +4945,7 @@
 * Fix ``epub`` and ``epub3`` builders that contained links to ``genindex`` even
   if ``epub_use_index = False``.
 * ``html_translator_class`` is now deprecated.
-  Use `Sphinx.set_translator()` API instead.
+  Use :meth:`~sphinx.application.Sphinx.set_translator` API instead.
 * Drop python 2.6 and 3.3 support
 * Drop epub3 builder's ``epub3_page_progression_direction`` option (use
   ``epub3_writing_mode``).
@@ -4224,7 +4979,7 @@
 Deprecated
 ----------
 
-These features are removed in Sphinx-1.6:
+These features are removed in Sphinx 1.6:
 
 * LDML format  support in i18n feature
 * ``sphinx.addnodes.termsep``
@@ -4549,7 +5304,7 @@
 Features added
 --------------
 
-* new config option ``latex_keep_old_macro_names``, defaults to True. If False,
+* new config option :confval:`!latex_keep_old_macro_names`, defaults to True. If False,
   lets macros (for text styling) be defined only with ``\sphinx``-prefixed names
 * latex writer allows user customization of "shadowed" boxes (topics), via
   three length variables.
@@ -4573,7 +5328,7 @@
   namespaces.
 * latex, images (from image directive) in lists or quoted blocks did not obey
   indentation (fixed together with #2671)
-* #2733: since Sphinx-1.4.4 ``make latexpdf`` generates lots of hyperref
+* #2733: since Sphinx 1.4.4 ``make latexpdf`` generates lots of hyperref
   warnings
 * #2731: `sphinx.ext.autodoc` does not access propertymethods which raises any
   exceptions
@@ -4733,7 +5488,7 @@
 
 * The default format of `today_fmt` and `html_last_updated_fmt` is back to
   strftime format again.  Locale Date Markup Language is also supported for
-  backward compatibility until Sphinx-1.5.
+  backward compatibility until Sphinx 1.5.
 
 Translations
 ------------
@@ -4799,8 +5554,8 @@
   <https://unicode.org/reports/tr35/tr35-dates.html#Date_Format_Patterns>`_ like
   ``"MMMM dd, YYYY"`` is default format for `today_fmt` and
   `html_last_updated_fmt`.  However strftime format like ``"%B %d, %Y"`` is also
-  supported for backward compatibility until Sphinx-1.5. Later format will be
-  disabled from Sphinx-1.5.
+  supported for backward compatibility until Sphinx 1.5. Later format will be
+  disabled from Sphinx 1.5.
 * #2327: ``latex_use_parts`` is deprecated now. Use `latex_toplevel_sectioning`
   instead.
 * #2337: Use ``\url{URL}`` macro instead of ``\href{URL}{URL}`` in LaTeX writer.
@@ -5097,7 +5852,7 @@
 * Fix a crash when setting up extensions which do not support metadata.
 * #1784: Provide non-minified JS code in ``sphinx/search/non-minified-js/*.js``
 * #1822, #1892: Fix regression for #1061. autosummary can't generate doc for
-  imported members since sphinx-1.3b3. Thanks to Eric Larson.
+  imported members since Sphinx 1.3b3. Thanks to Eric Larson.
 * #1793, #1819: "see also" misses a linebreak in text output. Thanks to Takayuki
   Hirai.
 * #1780, #1866: "make text" shows "class" keyword twice. Thanks to Takayuki
@@ -5130,7 +5885,7 @@
   node.astext() during docutils transforming.
 * #1989: "make blahblah" on Windows indicate help messages for sphinx-build
   every time.  It was caused by wrong make.bat that generated by
-  Sphinx-1.3.0/1.3.1.
+  Sphinx 1.3.0/1.3.1.
 * On Py2 environment, conf.py that is generated by sphinx-quickstart should have
   u prefixed config value for 'version' and 'release'.
 * #2102: On Windows + Py3, using ``|today|`` and non-ASCII date format will
@@ -5503,7 +6258,7 @@
 * PR#297, #1571: Add imgpath property to all builders. It make easier to
   develop builder extensions. Thanks to Takeshi Komiya.
 * #1584: Point to master doc in HTML "top" link.
-* #1585: Autosummary of modules broken in Sphinx-1.2.3.
+* #1585: Autosummary of modules broken in Sphinx 1.2.3.
 * #1610: Sphinx cause AttributeError when MeCab search option is enabled and
   python-mecab is not installed.
 * #1674: Do not crash if a module's ``__all__`` is not a list of strings.
@@ -5532,7 +6287,7 @@
 
 * #636: Keep straight single quotes in literal blocks in the LaTeX build.
 * #1419: Generated i18n sphinx.js files are missing message catalog entries
-  from '.js_t' and '.html'. The issue was introduced from Sphinx-1.1
+  from '.js_t' and '.html'. The issue was introduced from Sphinx 1.1
 * #1363: Fix i18n: missing python domain's cross-references with currentmodule
   directive or currentclass directive.
 * #1444: autosummary does not create the description from attributes docstring.
@@ -5560,7 +6315,7 @@
 * #1477: gettext does not extract nodes.line in a table or list.
 * #1544: ``make text`` generates wrong table when it has empty table cells.
 * #1522: Footnotes from table get displayed twice in LaTeX. This problem has
-  been appeared from Sphinx-1.2.1 by #949.
+  been appeared from Sphinx 1.2.1 by #949.
 * #508: Sphinx every time exit with zero when is invoked from setup.py command.
   ex. ``python setup.py build_sphinx -b doctest`` return zero even if doctest
   failed.
@@ -5937,7 +6692,8 @@
 * Other builders:
 
   - Added the Docutils-native XML and pseudo-XML builders.  See
-    :class:`XMLBuilder` and :class:`PseudoXMLBuilder`.
+    :class:`~sphinx.builders.xml.XMLBuilder` and
+    :class:`~sphinx.builders.xml.PseudoXMLBuilder`.
   - PR#45: The linkcheck builder now checks ``#anchor``\ s for existence.
   - PR#123, #1106: Add `epub_use_index` configuration value.  If
     provided, it will be used instead of `html_use_index` for epub
@@ -6085,7 +6841,7 @@
 * #860: Do not crash when encountering invalid doctest examples, just
   emit a warning.
 
-* #864: Fix crash with some settings of `modindex_common_prefix`.
+* #864: Fix crash with some settings of :confval:`modindex_common_prefix`.
 
 * #862: Fix handling of ``-D`` and ``-A`` options on Python 3.
 
@@ -6196,7 +6952,7 @@
 * HTML builder:
 
   - Added ``pyramid`` theme.
-  - #559: `html_add_permalinks` is now a string giving the
+  - #559: ``html_add_permalinks`` is now a string giving the
     text to display in permalinks.
   - #259: HTML table rows now have even/odd CSS classes to enable
     "Zebra styling".
@@ -6204,26 +6960,26 @@
 
 * Other builders:
 
-  - #516: Added new value of the `latex_show_urls` option to
+  - #516: Added new value of the :confval:`latex_show_urls` option to
     show the URLs in footnotes.
-  - #209: Added `text_newlines` and `text_sectionchars`
+  - #209: Added :confval:`text_newlines` and :confval:`text_sectionchars`
     config values.
-  - Added `man_show_urls` config value.
+  - Added :confval:`man_show_urls` config value.
   - #472: linkcheck builder: Check links in parallel, use HTTP HEAD
     requests and allow configuring the timeout.  New config values:
-    `linkcheck_timeout` and `linkcheck_workers`.
-  - #521: Added `linkcheck_ignore` config value.
+    :confval:`linkcheck_timeout` and :confval:`linkcheck_workers`.
+  - #521: Added :confval:`linkcheck_ignore` config value.
   - #28: Support row/colspans in tables in the LaTeX builder.
 
 * Configuration and extensibility:
 
-  - #537: Added `nitpick_ignore`.
+  - #537: Added :confval:`nitpick_ignore`.
   - #306: Added :event:`env-get-outdated` event.
-  - :meth:`.Application.add_stylesheet` now accepts full URIs.
+  - :meth:`!Application.add_stylesheet` now accepts full URIs.
 
 * Autodoc:
 
-  - #564: Add `autodoc_docstring_signature`.  When enabled (the
+  - #564: Add :confval:`autodoc_docstring_signature`.  When enabled (the
     default), autodoc retrieves the signature from the first line of the
     docstring, if it is found there.
   - #176: Provide ``private-members`` option for autodoc directives.
@@ -6483,7 +7239,7 @@
 ============================
 
 * #490: Fix cross-references to objects of types added by the
-  :func:`~.Sphinx.add_object_type` API function.
+  :func:`~sphinx.application.Sphinx.add_object_type` API function.
 
 * Fix handling of doc field types for different directive types.
 
@@ -6555,7 +7311,7 @@
 
 * The old markup for defining and linking to C directives is now
   deprecated.  It will not work anymore in future versions without
-  activating the :mod:`~sphinx.ext.oldcmarkup` extension; in Sphinx
+  activating the ``oldcmarkup`` extension; in Sphinx
   1.0, it is activated by default.
 
 * Removed support for old dependency versions; requirements are now:
@@ -6664,7 +7420,7 @@
   - Added `needs_sphinx` config value and
     :meth:`~sphinx.application.Sphinx.require_sphinx` application API
     method.
-  - #200: Added :meth:`~sphinx.application.Sphinx.add_stylesheet`
+  - #200: Added :meth:`!add_stylesheet`
     application API method.
 
 * Extensions:
@@ -6704,9 +7460,1250 @@
     "striptags" Jinja filter.
 
 
-Previous versions
-=================
+Release 0.6.7 (Jun 05, 2010)
+============================
+
+* #440: Remove usage of a Python >= 2.5 API in the ``literalinclude``
+  directive.
+
+* Fix a bug that prevented some references being generated in the
+  LaTeX builder.
+
+* #428: Add some missing CSS styles for standard docutils classes.
+
+* #432: Fix UnicodeErrors while building LaTeX in translated locale.
+
+
+Release 0.6.6 (May 25, 2010)
+============================
+
+* Handle raw nodes in the ``text`` writer.
+
+* Fix a problem the Qt help project generated by the ``qthelp``
+  builder that would lead to no content being displayed in the Qt
+  Assistant.
+
+* #393: Fix the usage of Unicode characters in mathematic formulas
+  when using the ``pngmath`` extension.
+
+* #404: Make ``\and`` work properly in the author field of the
+  ``latex_documents`` setting.
+
+* #409: Make the ``highlight_language`` config value work properly
+  in the LaTeX builder.
+
+* #418: Allow relocation of the translation JavaScript files to
+  the system directory on Unix systems.
+
+* #414: Fix handling of Windows newlines in files included with
+  the ``literalinclude`` directive.
+
+* #377: Fix crash in linkcheck builder.
+
+* #387: Fix the display of search results in ``dirhtml`` output.
+
+* #376: In autodoc, fix display of parameter defaults containing
+  backslashes.
+
+* #370: Fix handling of complex list item labels in LaTeX output.
+
+* #374: Make the ``doctest_path`` config value of the doctest
+  extension actually work.
+
+* Fix the handling of multiple toctrees when creating the global
+  TOC for the ``toctree()`` template function.
+
+* Fix the handling of hidden toctrees when creating the global TOC
+  for the ``toctree()`` template function.
+
+* Fix the handling of nested lists in the text writer.
+
+* #362: In autodoc, check for the existence of ``__self__`` on
+  function objects before accessing it.
+
+* #353: Strip leading and trailing whitespace when extracting
+  search words in the search function.
+
+
+Release 0.6.5 (Mar 01, 2010)
+============================
+
+* In autodoc, fix the omission of some module members explicitly
+  documented using documentation comments.
+
+* #345: Fix cropping of sidebar scroll bar with ``stickysidebar``
+  option of the default theme.
+
+* #341: Always generate UNIX newlines in the quickstart Makefile.
+
+* #338: Fix running with ``-C`` under Windows.
+
+* In autodoc, allow customizing the signature of an object where
+  the built-in mechanism fails.
+
+* #331: Fix output for enumerated lists with start values in LaTeX.
+
+* Make the ``start-after`` and ``end-before`` options to the
+  ``literalinclude`` directive work correctly if not used together.
+
+* #321: Fix link generation in the LaTeX builder.
+
+
+Release 0.6.4 (Jan 12, 2010)
+============================
+
+* Improve the handling of non-Unicode strings in the configuration.
+
+* #316: Catch OSErrors occurring when calling graphviz with
+  arguments it doesn't understand.
+
+* Restore compatibility with Pygments >= 1.2.
+
+* #295: Fix escaping of hyperref targets in LaTeX output.
+
+* #302: Fix links generated by the ``:doc:`` role for LaTeX output.
+
+* #286: collect todo nodes after the whole document has been read;
+  this allows placing substitution references in todo items.
+
+* #294: do not ignore an explicit ``today`` config value in a
+  LaTeX build.
+
+* The ``alt`` text of inheritance diagrams is now much cleaner.
+
+* Ignore images in section titles when generating link captions.
+
+* #310: support exception messages in the ``testoutput`` blocks of
+  the ``doctest`` extension.
+
+* #293: line blocks are styled properly in HTML output.
+
+* #285: make the ``locale_dirs`` config value work again.
+
+* #303: ``html_context`` values given on the command line via ``-A``
+  should not override other values given in conf.py.
+
+* Fix a bug preventing incremental rebuilds for the ``dirhtml``
+  builder.
+
+* #299: Fix the mangling of quotes in some literal blocks.
+
+* #292: Fix path to the search index for the ``dirhtml`` builder.
+
+* Fix a Jython compatibility issue: make the dependence on the
+  ``parser`` module optional.
+
+* #238: In autodoc, catch all errors that occur on module import,
+  not just ``ImportError``.
+
+* Fix the handling of non-data, but non-method descriptors in autodoc.
+
+* When copying file times, ignore OSErrors raised by ``os.utime()``.
+
+
+Release 0.6.3 (Sep 03, 2009)
+============================
+
+* Properly add C module filenames as dependencies in autodoc.
+
+* #253: Ignore graphviz directives without content instead of
+  raising an unhandled exception.
+
+* #241: Fix a crash building LaTeX output for documents that contain
+  a todolist directive.
+
+* #252: Make it easier to change the build dir in the Makefiles
+  generated by quickstart.
+
+* #220: Fix CSS so that displaymath really is centered.
+
+* #222: Allow the "Footnotes" header to be translated.
+
+* #225: Don't add whitespace in generated HTML after inline tags.
+
+* #227: Make ``literalinclude`` work when the document's path
+  name contains non-ASCII characters.
+
+* #229: Fix autodoc failures with members that raise errors
+  on ``getattr()``.
+
+* #205: When copying files, don't copy full stat info, only
+  modification times.
+
+* #232: Support non-ASCII metadata in Qt help builder.
+
+* Properly format bullet lists nested in definition lists for LaTeX.
+
+* Section titles are now allowed inside ``only`` directives.
+
+* #201: Make ``centered`` directive work in LaTeX output.
+
+* #206: Refuse to overwrite an existing master document in
+  sphinx-quickstart.
+
+* #208: Use MS-sanctioned locale settings, determined by the
+  ``language`` config option, in the HTML help builder.
+
+* #210: Fix nesting of HTML tags for displayed math from pngmath
+  extension.
+
+* #213: Fix centering of images in LaTeX output.
+
+* #211: Fix compatibility with docutils 0.5.
+
+
+Release 0.6.2 (Jun 16, 2009)
+============================
+
+* #130: Fix obscure IndexError in doctest extension.
+
+* #167: Make glossary sorting case-independent.
+
+* #196: Add a warning if an extension module doesn't have a
+  ``setup()`` function.
+
+* #158: Allow '..' in template names, and absolute template paths;
+  Jinja 2 by default disables both.
+
+* When highlighting Python code, ignore extra indentation before
+  trying to parse it as Python.
+
+* #191: Don't escape the tilde in URIs in LaTeX.
+
+* Don't consider contents of source comments for the search index.
+
+* Set the default encoding to ``utf-8-sig`` to handle files with a
+  UTF-8 BOM correctly.
+
+* #178: apply ``add_function_parentheses`` config value to C
+  functions as promised.
+
+* #173: Respect the docutils ``title`` directive.
+
+* #172: The ``obj`` role now links to modules as promised.
+
+* #19: Tables now can have a "longtable" class, in order to get
+  correctly broken into pages in LaTeX output.
+
+* Look for Sphinx message catalogs in the system default path before
+  trying ``sphinx/locale``.
+
+* Fix the search for methods via "classname.methodname".
+
+* #155: Fix Python 2.4 compatibility: exceptions are old-style
+  classes there.
+
+* #150: Fix display of the "sphinxdoc" theme on Internet Explorer
+  versions 6 and 7.
+
+* #146: Don't fail to generate LaTeX when the user has an active
+  ``.docutils`` configuration.
+
+* #29: Don't generate visible "-{-}" in option lists in LaTeX.
+
+* Fix cross-reference roles when put into substitutions.
+
+* Don't put image "alt" text into table-of-contents entries.
+
+* In the LaTeX writer, do not raise an exception on too many section
+  levels, just use the "subparagraph" level for all of them.
+
+* #145: Fix autodoc problem with automatic members that refuse to be
+  getattr()'d from their parent.
+
+* If specific filenames to build are given on the command line,
+  check that they are within the source directory.
+
+* Fix autodoc crash for objects without a ``__name__``.
+
+* Fix intersphinx for installations without urllib2.HTTPSHandler.
+
+* #134: Fix pending_xref leftover nodes when using the todolist
+  directive from the todo extension.
+
+
+Release 0.6.1 (Mar 26, 2009)
+============================
+
+* #135: Fix problems with LaTeX output and the graphviz extension.
+
+* #132: Include the autosummary "module" template in the distribution.
+
+
+Release 0.6 (Mar 24, 2009)
+==========================
+
+New features added
+------------------
+
+* Incompatible changes:
+
+  - Templating now requires the Jinja2 library, which is an enhanced
+    version of the old Jinja1 engine.  Since the syntax and semantic
+    is largely the same, very few fixes should be necessary in
+    custom templates.
+
+  - The "document" div tag has been moved out of the ``layout.html``
+    template's "document" block, because the closing tag was already
+    outside.  If you overwrite this block, you need to remove your
+    "document" div tag as well.
+
+  - The ``autodoc_skip_member`` event now also gets to decide
+    whether to skip members whose name starts with underscores.
+    Previously, these members were always automatically skipped.
+    Therefore, if you handle this event, add something like this
+    to your event handler to restore the old behavior::
+
+       if name.startswith('_'):
+           return True
+
+* Theming support, see the new section in the documentation.
+
+* Markup:
+
+  - Due to popular demand, added a ``:doc:`` role which directly
+    links to another document without the need of creating a
+    label to which a ``:ref:`` could link to.
+
+  - #4: Added a ``:download:`` role that marks a non-document file
+    for inclusion into the HTML output and links to it.
+
+  - Added an ``only`` directive that can selectively include text
+    based on enabled "tags".  Tags can be given on the command
+    line.  Also, the current builder output format (e.g. "html" or
+    "latex") is always a defined tag.
+
+  - #10: Added HTML section numbers, enabled by giving a
+    ``:numbered:`` flag to the ``toctree`` directive.
+
+  - #114: Added an ``abbr`` role to markup abbreviations and
+    acronyms.
+
+  - The ``literalinclude`` directive now supports several more
+    options, to include only parts of a file.
+
+  - The ``toctree`` directive now supports a ``:hidden:`` flag,
+    which will prevent links from being generated in place of
+    the directive -- this allows you to define your document
+    structure, but place the links yourself.
+
+  - #123: The ``glossary`` directive now supports a ``:sorted:``
+    flag that sorts glossary entries alphabetically.
+
+  - Paths to images, literal include files and download files
+    can now be absolute (like ``/images/foo.png``).  They are
+    treated as relative to the top source directory.
+
+  - #52: There is now a ``hlist`` directive, creating a compact
+    list by placing distributing items into multiple columns.
+
+  - #77: If a description environment with info field list only
+    contains one ``:param:`` entry, no bullet list is generated.
+
+  - #6: Don't generate redundant ``<ul>`` for top-level TOC tree
+    items, which leads to a visual separation of TOC entries.
+
+  - #23: Added a ``classmethod`` directive along with ``method``
+    and ``staticmethod``.
+
+  - Scaled images now get a link to the unscaled version.
+
+  - SVG images are now supported in HTML (via ``<object>`` and
+    ``<embed>`` tags).
+
+  - Added a ``toctree`` callable to the templates, and the ability
+    to include external links in toctrees. The 'collapse' keyword
+    argument indicates whether or not to only display subitems of
+    the current page.  (Defaults to True.)
+
+* Configuration:
+
+  - The new config value ``rst_epilog`` can contain reST that is
+    appended to each source file that is read.  This is the right
+    place for global substitutions.
+
+  - The new ``html_add_permalinks`` config value can be used to
+    switch off the generated "paragraph sign" permalinks for each
+    heading and definition environment.
+
+  - The new ``html_show_sourcelink`` config value can be used to
+    switch off the links to the reST sources in the sidebar.
+
+  - The default value for ``htmlhelp_basename`` is now the project
+    title, cleaned up as a filename.
+
+  - The new ``modindex_common_prefix`` config value can be used to
+    ignore certain package names for module index sorting.
+
+  - The new ``trim_footnote_reference_space`` config value mirrors
+    the docutils config value of the same name and removes the
+    space before a footnote reference that is necessary for reST
+    to recognize the reference.
+
+  - The new ``latex_additional_files`` config value can be used to
+    copy files (that Sphinx doesn't copy automatically, e.g. if they
+    are referenced in custom LaTeX added in ``latex_elements``) to
+    the build directory.
+
+* Builders:
+
+  - The HTML builder now stores a small file named ``.buildinfo`` in
+    its output directory.  It stores a hash of config values that
+    can be used to determine if a full rebuild needs to be done (e.g.
+    after changing ``html_theme``).
+
+  - New builder for Qt help collections, by Antonio Valentino.
+
+  - The new ``DirectoryHTMLBuilder`` (short name ``dirhtml``) creates
+    a separate directory for every page, and places the page there
+    in a file called ``index.html``.  Therefore, page URLs and links
+    don't need to contain ``.html``.
+
+  - The new ``html_link_suffix`` config value can be used to select
+    the suffix of generated links between HTML files.
+
+  - #96: The LaTeX builder now supports figures wrapped by text, when
+    using the ``figwidth`` option and right/left alignment.
+
+* New translations:
+
+  - Italian by Sandro Dentella.
+  - Ukrainian by Petro Sasnyk.
+  - Finnish by Jukka Inkeri.
+  - Russian by Alexander Smishlajev.
+
+* Extensions and API:
+
+  - New ``graphviz`` extension to embed graphviz graphs.
+
+  - New ``inheritance_diagram`` extension to embed... inheritance
+    diagrams!
+
+  - New ``autosummary`` extension that generates summaries of
+    modules and automatic documentation of modules.
+
+  - Autodoc now has a reusable Python API, which can be used to
+    create custom types of objects to auto-document (e.g. Zope
+    interfaces).  See also ``Sphinx.add_autodocumenter()``.
+
+  - Autodoc now handles documented attributes.
+
+  - Autodoc now handles inner classes and their methods.
+
+  - Autodoc can document classes as functions now if explicitly
+    marked with ``autofunction``.
+
+  - Autodoc can now exclude single members from documentation
+    via the ``exclude-members`` option.
+
+  - Autodoc can now order members either alphabetically (like
+    previously) or by member type; configurable either with the
+    config value ``autodoc_member_order`` or a ``member-order``
+    option per directive.
+
+  - The function ``Sphinx.add_directive()`` now also supports
+    docutils 0.5-style directive classes.  If they inherit from
+    ``sphinx.util.compat.Directive``, they also work with
+    docutils 0.4.
+
+  - There is now a ``Sphinx.add_lexer()`` method to be able to use
+    custom Pygments lexers easily.
+
+  - There is now ``Sphinx.add_generic_role()`` to mirror the
+    docutils' own function.
+
+* Other changes:
+
+  - Config overrides for single dict keys can now be given on the
+    command line.
+
+  - There is now a ``doctest_global_setup`` config value that can
+    be used to give setup code for all doctests in the documentation.
+
+  - Source links in HTML are now generated with ``rel="nofollow"``.
+
+  - Quickstart can now generate a Windows ``make.bat`` file.
+
+  - #62: There is now a ``-w`` option for sphinx-build that writes
+    warnings to a file, in addition to stderr.
+
+  - There is now a ``-W`` option for sphinx-build that turns warnings
+    into errors.
+
+
+Release 0.5.2 (Mar 24, 2009)
+============================
+
+* Properly escape ``|`` in LaTeX output.
+
+* #71: If a decoding error occurs in source files, print a
+  warning and replace the characters by "?".
+
+* Fix a problem in the HTML search if the index takes too long
+  to load.
+
+* Don't output system messages while resolving, because they
+  would stay in the doctrees even if keep_warnings is false.
+
+* #82: Determine the correct path for dependencies noted by
+  docutils.  This fixes behavior where a source with dependent
+  files was always reported as changed.
+
+* Recognize toctree directives that are not on section toplevel,
+  but within block items, such as tables.
+
+* Use a new RFC base URL, since rfc.org seems down.
+
+* Fix a crash in the todolist directive when no todo items are
+  defined.
+
+* Don't call LaTeX or dvipng over and over again if it was not
+  found once, and use text-only latex as a substitute in that case.
+
+* Fix problems with footnotes in the LaTeX output.
+
+* Prevent double hyphens becoming en-dashes in literal code in
+  the LaTeX output.
+
+* Open literalinclude files in universal newline mode to allow
+  arbitrary newline conventions.
+
+* Actually make the ``-Q`` option work.
+
+* #86: Fix explicit document titles in toctrees.
+
+* #81: Write environment and search index in a manner that is safe
+  from exceptions that occur during dumping.
+
+* #80: Fix UnicodeErrors when a locale is set with setlocale().
+
+
+Release 0.5.1 (Dec 15, 2008)
+============================
+
+* #67: Output warnings about failed doctests in the doctest extension
+  even when running in quiet mode.
+
+* #72: In pngmath, make it possible to give a full path to LaTeX and
+  dvipng on Windows.  For that to work, the ``pngmath_latex`` and
+  ``pngmath_dvipng`` options are no longer split into command and
+  additional arguments; use ``pngmath_latex_args`` and
+  ``pngmath_dvipng_args`` to give additional arguments.
+
+* Don't crash on failing doctests with non-ASCII characters.
+
+* Don't crash on writing status messages and warnings containing
+  unencodable characters.
+
+* Warn if a doctest extension block doesn't contain any code.
+
+* Fix the handling of ``:param:`` and ``:type:`` doc fields when
+  they contain markup (especially cross-referencing roles).
+
+* #65: Fix storage of depth information for PNGs generated by the
+  pngmath extension.
+
+* Fix autodoc crash when automethod is used outside a class context.
+
+* #68: Fix LaTeX writer output for images with specified height.
+
+* #60: Fix wrong generated image path when including images in sources
+  in subdirectories.
+
+* Fix the JavaScript search when html_copy_source is off.
+
+* Fix an indentation problem in autodoc when documenting classes
+  with the option ``autoclass_content = "both"`` set.
+
+* Don't crash on empty index entries, only emit a warning.
+
+* Fix a typo in the search JavaScript code, leading to unusable
+  search function in some setups.
+
+
+Release 0.5 (Nov 23, 2008) -- Birthday release!
+===============================================
+
+New features added
+------------------
+
+* Markup features:
+
+  - Citations are now global: all citation defined in any file can be
+    referenced from any file.  Citations are collected in a bibliography
+    for LaTeX output.
+
+  - Footnotes are now properly handled in the LaTeX builder: they appear
+    at the location of the footnote reference in text, not at the end of
+    a section.  Thanks to Andrew McNamara for the initial patch.
+
+  - "System Message" warnings are now automatically removed from the
+    built documentation, and only written to stderr.  If you want the
+    old behavior, set the new config value ``keep_warnings`` to True.
+
+  - Glossary entries are now automatically added to the index.
+
+  - Figures with captions can now be referred to like section titles,
+    using the ``:ref:`` role without an explicit link text.
+
+  - Added ``cmember`` role for consistency.
+
+  - Lists enumerated by letters or roman numerals are now handled like in
+    standard reST.
+
+  - The ``seealso`` directive can now also be given arguments, as a short
+    form.
+
+  - You can now document several programs and their options with the
+    new ``program`` directive.
+
+* HTML output and templates:
+
+  - Incompatible change: The "root" relation link (top left in the
+    relbar) now points to the ``master_doc`` by default, no longer to a
+    document called "index".  The old behavior, while useful in some
+    situations, was somewhat unexpected.  Override the "rootrellink"
+    block in the template to customize where it refers to.
+
+  - The JavaScript search now searches for objects before searching in
+    the full text.
+
+  - TOC tree entries now have CSS classes that make it possible to
+    style them depending on their depth.
+
+  - Highlighted code blocks now have CSS classes that make it possible
+    to style them depending on their language.
+
+  - HTML ``<meta>`` tags via the docutils :dudir:`meta` directive are now
+    supported.
+
+  - ``SerializingHTMLBuilder`` was added as new abstract builder that
+    can be subclassed to serialize build HTML in a specific format.  The
+    ``PickleHTMLBuilder`` is a concrete subclass of it that uses pickle
+    as serialization implementation.
+
+  - ``JSONHTMLBuilder`` was added as another ``SerializingHTMLBuilder``
+    subclass that dumps the generated HTML into JSON files for further
+    processing.
+
+  - The ``rellinks`` block in the layout template is now called
+    ``linktags`` to avoid confusion with the relbar links.
+
+  - The HTML builders have two additional attributes now that can be
+    used to disable the anchor-link creation after headlines and
+    definition links.
+
+  - Only generate a module index if there are some modules in the
+    documentation.
+
+* New and changed config values:
+
+  - Added support for internationalization in generated text with the
+    ``language`` and ``locale_dirs`` config values.  Many thanks to
+    language contributors:
+
+    * Horst Gutmann -- German
+    * Pavel Kosina -- Czech
+    * David Larlet -- French
+    * Michał Kandulski -- Polish
+    * Yasushi Masuda -- Japanese
+    * Guillem Borrell -- Spanish
+    * Luc Saffre and Peter Bertels -- Dutch
+    * Fred Lin -- Traditional Chinese
+    * Roger Demetrescu -- Brazilian Portuguese
+    * Rok Garbas -- Slovenian
+
+  - The new config value ``highlight_language`` set a global default for
+    highlighting.  When ``'python3'`` is selected, console output blocks
+    are recognized like for ``'python'``.
+
+  - Exposed Pygments' lexer guessing as a highlight "language" ``guess``.
+
+  - The new config value ``latex_elements`` allows to override all LaTeX
+    snippets that Sphinx puts into the generated .tex file by default.
+
+  - Added ``exclude_dirnames`` config value that can be used to exclude
+    e.g. CVS directories from source file search.
+
+  - Added ``source_encoding`` config value to select input encoding.
+
+* Extensions:
+
+  - The new extensions ``sphinx.ext.jsmath`` and ``sphinx.ext.pngmath``
+    provide math support for both HTML and LaTeX builders.
+
+  - The new extension ``sphinx.ext.intersphinx`` half-automatically
+    creates links to Sphinx documentation of Python objects in other
+    projects.
+
+  - The new extension ``sphinx.ext.todo`` allows the insertion of
+    "To do" directives whose visibility in the output can be toggled.
+    It also adds a directive to compile a list of all todo items.
+
+  - sphinx.ext.autodoc has a new event ``autodoc-process-signature``
+    that allows tuning function signature introspection.
+
+  - sphinx.ext.autodoc has a new event ``autodoc-skip-member`` that allows
+    tuning which members are included in the generated content.
+
+  - Respect __all__ when autodocumenting module members.
+
+  - The ``automodule`` directive now supports the ``synopsis``,
+    ``deprecated`` and ``platform`` options.
+
+* Extension API:
+
+  - ``Sphinx.add_node()`` now takes optional visitor methods for the
+    HTML, LaTeX and text translators; this prevents having to manually
+    patch the classes.
+
+  - Added ``Sphinx.add_javascript()`` that adds scripts to load in the
+    default HTML template.
+
+  - Added new events: ``source-read``, ``env-updated``,
+    ``env-purge-doc``, ``missing-reference``, ``build-finished``.
+
+* Other changes:
+
+  - Added a command-line switch ``-Q``: it will suppress warnings.
+
+  - Added a command-line switch ``-A``: it can be used to supply
+    additional values into the HTML templates.
+
+  - Added a command-line switch ``-C``: if it is given, no configuration
+    file ``conf.py`` is required.
+
+  - Added a distutils command ``build_sphinx``: When Sphinx is installed,
+    you can call ``python setup.py build_sphinx`` for projects that have
+    Sphinx documentation, which will build the docs and place them in
+    the standard distutils build directory.
+
+  - In quickstart, if the selected root path already contains a Sphinx
+    project, complain and abort.
+
+Bugs fixed
+----------
+
+* #51: Escape configuration values placed in HTML templates.
+
+* #44: Fix small problems in HTML help index generation.
+
+* Fix LaTeX output for line blocks in tables.
+
+* #38: Fix "illegal unit" error when using pixel image widths/heights.
+
+* Support table captions in LaTeX output.
+
+* #39: Work around a bug in Jinja that caused "<generator ...>" to be
+  emitted in HTML output.
+
+* Fix a problem with module links not being generated in LaTeX output.
+
+* Fix the handling of images in different directories.
+
+* #29: Support option lists in the text writer.  Make sure that dashes
+  introducing long option names are not contracted to en-dashes.
+
+* Support the "scale" option for images in HTML output.
+
+* #25: Properly escape quotes in HTML help attribute values.
+
+* Fix LaTeX build for some description environments with ``:noindex:``.
+
+* #24: Don't crash on uncommon casing of role names (like ``:Class:``).
+
+* Only output ANSI colors on color terminals.
+
+* Update to newest fncychap.sty, to fix problems with non-ASCII
+  characters at the start of chapter titles.
+
+* Fix a problem with index generation in LaTeX output, caused by
+  hyperref not being included last.
+
+* Don't disregard return annotations for functions without any parameters.
+
+* Don't throw away labels for code blocks.
+
+
+Release 0.4.3 (Oct 8, 2008)
+===========================
+
+* Fix a bug in autodoc with directly given autodoc members.
+
+* Fix a bug in autodoc that would import a module twice, once as
+  "module", once as "module.".
+
+* Fix a bug in the HTML writer that created duplicate ``id``
+  attributes for section titles with docutils 0.5.
+
+* Properly call ``super()`` in overridden blocks in templates.
+
+* Add a fix when using XeTeX.
+
+* Unify handling of LaTeX escaping.
+
+* Rebuild everything when the ``extensions`` config value changes.
+
+* Don't try to remove a nonexisting static directory.
+
+* Fix an indentation problem in production lists.
+
+* Fix encoding handling for literal include files: ``literalinclude``
+  now has an ``encoding`` option that defaults to UTF-8.
+
+* Fix the handling of non-ASCII characters entered in quickstart.
+
+* Fix a crash with nonexisting image URIs.
+
+
+Release 0.4.2 (Jul 29, 2008)
+============================
+
+* Fix rendering of the ``samp`` role in HTML.
+
+* Fix a bug with LaTeX links to headings leading to a wrong page.
+
+* Reread documents with globbed toctrees when source files are
+  added or removed.
+
+* Add a missing parameter to PickleHTMLBuilder.handle_page().
+
+* Put inheritance info always on its own line.
+
+* Don't automatically enclose code with whitespace in it in quotes;
+  only do this for the ``samp`` role.
+
+* autodoc now emits a more precise error message when a module
+  can't be imported or an attribute can't be found.
+
+* The JavaScript search now uses the correct file name suffix when
+  referring to found items.
+
+* The automodule directive now accepts the ``inherited-members``
+  and ``show-inheritance`` options again.
+
+* You can now rebuild the docs normally after relocating the source
+  and/or doctree directory.
+
+
+Release 0.4.1 (Jul 5, 2008)
+===========================
+
+* Added sub-/superscript node handling to TextBuilder.
+
+* Label names in references are now case-insensitive, since reST
+  label names are always lowercased.
+
+* Fix linkcheck builder crash for malformed URLs.
+
+* Add compatibility for admonitions and docutils 0.5.
+
+* Remove the silly restriction on "rubric" in the LaTeX writer: you
+  can now write arbitrary "rubric" directives, and only those with
+  a title of "Footnotes" will be ignored.
+
+* Copy the HTML logo to the output ``_static`` directory.
+
+* Fix LaTeX code for modules with underscores in names and platforms.
+
+* Fix a crash with nonlocal image URIs.
+
+* Allow the usage of :noindex: in ``automodule`` directives, as
+  documented.
+
+* Fix the ``delete()`` docstring processor function in autodoc.
+
+* Fix warning message for nonexisting images.
+
+* Fix JavaScript search in Internet Explorer.
+
+
+Release 0.4 (Jun 23, 2008)
+==========================
+
+New features added
+------------------
+
+* ``tocdepth`` can be given as a file-wide metadata entry, and
+  specifies the maximum depth of a TOC of this file.
+
+* The new config value ``default_role`` can be used to select the
+  default role for all documents.
+
+* Sphinx now interprets field lists with fields like ``:param foo:``
+  in description units.
+
+* The new ``staticmethod`` directive can be used to mark methods as
+  static methods.
+
+* HTML output:
+
+  - The "previous" and "next" links have a more logical structure, so
+    that by following "next" links you can traverse the entire TOC
+    tree.
+
+  - The new event ``html-page-context`` can be used to include custom
+    values into the context used when rendering an HTML template.
+
+  - Document metadata is now in the default template context, under
+    the name ``metadata``.
+
+  - The new config value ``html_favicon`` can be used to set a favicon
+    for the HTML output.  Thanks to Sebastian Wiesner.
+
+  - The new config value ``html_use_index`` can be used to switch index
+    generation in HTML documents off.
+
+  - The new config value ``html_split_index`` can be used to create
+    separate index pages for each letter, to be used when the complete
+    index is too large for one page.
+
+  - The new config value ``html_short_title`` can be used to set a
+    shorter title for the documentation which is then used in the
+    navigation bar.
+
+  - The new config value ``html_show_sphinx`` can be used to control
+    whether a link to Sphinx is added to the HTML footer.
+
+  - The new config value ``html_file_suffix`` can be used to set the
+    HTML file suffix to e.g. ``.xhtml``.
+
+  - The directories in the ``html_static_path`` can now contain
+    subdirectories.
+
+  - The module index now isn't collapsed if the number of submodules
+    is larger than the number of toplevel modules.
+
+* The image directive now supports specifying the extension as ``.*``,
+  which makes the builder select the one that matches best.  Thanks to
+  Sebastian Wiesner.
+
+* The new config value ``exclude_trees`` can be used to exclude whole
+  subtrees from the search for source files.
+
+* Defaults for configuration values can now be callables, which allows
+  dynamic defaults.
+
+* The new TextBuilder creates plain-text output.
+
+* Python 3-style signatures, giving a return annotation via ``->``,
+  are now supported.
+
+* Extensions:
+
+  - The autodoc extension now offers a much more flexible way to
+    manipulate docstrings before including them into the output, via
+    the new ``autodoc-process-docstring`` event.
+
+  - The ``autodoc`` extension accepts signatures for functions, methods
+    and classes now that override the signature got via introspection
+    from Python code.
+
+  - The ``autodoc`` extension now offers a ``show-inheritance`` option
+    for autoclass that inserts a list of bases after the signature.
+
+  - The autodoc directives now support the ``noindex`` flag option.
+
+
+Bugs fixed
+----------
+
+* Correctly report the source location for docstrings included with
+  autodoc.
+
+* Fix the LaTeX output of description units with multiple signatures.
+
+* Handle the figure directive in LaTeX output.
+
+* Handle raw admonitions in LaTeX output.
+
+* Fix determination of the title in HTML help output.
+
+* Handle project names containing spaces.
+
+* Don't write SSI-like comments in HTML output.
+
+* Rename the "sidebar" class to "sphinxsidebar" in order to stay different
+  from reST sidebars.
+
+* Use a binary TOC in HTML help generation to fix issues links without
+  explicit anchors.
+
+* Fix behavior of references to functions/methods with an explicit title.
+
+* Support citation, subscript and superscript nodes in LaTeX writer.
+
+* Provide the standard "class" directive as "cssclass"; else it is
+  shadowed by the Sphinx-defined directive.
+
+* Fix the handling of explicit module names given to autoclass directives.
+  They now show up with the correct module name in the generated docs.
+
+* Enable autodoc to process Unicode docstrings.
+
+* The LaTeX writer now translates line blocks with ``\raggedright``,
+  which plays nicer with tables.
+
+* Fix bug with directories in the HTML builder static path.
+
+
+Release 0.3 (May 6, 2008)
+=========================
+
+New features added
+------------------
+
+* The ``toctree`` directive now supports a ``glob`` option that allows
+  glob-style entries in the content.
+
+* If the ``pygments_style`` config value contains a dot it's treated as the
+  import path of a custom Pygments style class.
+
+* A new config value, ``exclude_dirs``, can be used to exclude whole
+  directories from the search for source files.
+
+* The configuration directory (containing ``conf.py``) can now be set
+  independently from the source directory.  For that, a new command-line
+  option ``-c`` has been added.
+
+* A new directive ``tabularcolumns`` can be used to give a tabular column
+  specification for LaTeX output.  Tables now use the ``tabulary`` package.
+  Literal blocks can now be placed in tables, with several caveats.
+
+* A new config value, ``latex_use_parts``, can be used to enable parts in LaTeX
+  documents.
+
+* Autodoc now skips inherited members for classes, unless you give the
+  new ``inherited-members`` option.
+
+* A new config value, ``autoclass_content``, selects if the docstring of the
+  class' ``__init__`` method is added to the directive's body.
+
+* Support for C++ class names (in the style ``Class::Function``) in C function
+  descriptions.
+
+* Support for a ``toctree_only`` item in items for the ``latex_documents``
+  config value.  This only includes the documents referenced by TOC trees in the
+  output, not the rest of the file containing the directive.
+
+Bugs fixed
+----------
+
+* sphinx.htmlwriter: Correctly write the TOC file for any structure of the
+  master document.  Also encode non-ASCII characters as entities in TOC
+  and index file.  Remove two remaining instances of hard-coded
+  "documentation".
+
+* sphinx.ext.autodoc: descriptors are detected properly now.
+
+* sphinx.latexwriter: implement all reST admonitions, not just ``note``
+  and ``warning``.
+
+* Lots of little fixes to the LaTeX output and style.
+
+* Fix OpenSearch template and make template URL absolute.  The
+  ``html_use_opensearch`` config value now must give the base URL.
+
+* Some unused files are now stripped from the HTML help file build.
+
+
+Release 0.2 (Apr 27, 2008)
+==========================
+
+Incompatible changes
+--------------------
+
+* Jinja, the template engine used for the default HTML templates, is now
+  no longer shipped with Sphinx.  If it is not installed automatically for
+  you (it is now listed as a dependency in ``setup.py``), install it manually
+  from PyPI.  This will also be needed if you're using Sphinx from a SVN
+  checkout; in that case please also remove the ``sphinx/jinja`` directory
+  that may be left over from old revisions.
+
+* The clumsy handling of the ``index.html`` template was removed.  The config
+  value ``html_index`` is gone, and ``html_additional_pages`` should be used
+  instead.  If you need it, the old ``index.html`` template is still there,
+  called ``defindex.html``, and you can port your html_index template, using
+  Jinja inheritance, by changing your template::
+
+     {% extends "defindex.html" %}
+     {% block tables %}
+     ... old html_index template content ...
+     {% endblock %}
+
+  and putting ``'index': name of your template`` in ``html_additional_pages``.
+
+* In the layout template, redundant ``block``\s were removed; you should use
+  Jinja's standard ``{{ super() }}`` mechanism instead, as explained in the
+  (newly written) templating docs.
+
+New features added
+------------------
+
+* Extension API (Application object):
+
+  - Support a new method, ``add_crossref_type``.  It works like
+    ``add_description_unit`` but the directive will only create a target
+    and no output.
+  - Support a new method, ``add_transform``.  It takes a standard docutils
+    ``Transform`` subclass which is then applied by Sphinx' reader on
+    parsing reST document trees.
+  - Add support for other template engines than Jinja, by adding an
+    abstraction called a "template bridge".  This class handles rendering
+    of templates and can be changed using the new configuration value
+    "template_bridge".
+  - The config file itself can be an extension (if it provides a ``setup()``
+    function).
+
+* Markup:
+
+  - New directive, ``currentmodule``.  It can be used to indicate the module
+    name of the following documented things without creating index entries.
+  - Allow giving a different title to documents in the toctree.
+  - Allow giving multiple options in a ``cmdoption`` directive.
+  - Fix display of class members without explicit class name given.
+
+* Templates (HTML output):
+
+  - ``index.html`` renamed to ``defindex.html``, see above.
+  - There's a new config value, ``html_title``, that controls the overall
+    "title" of the set of Sphinx docs.  It is used instead everywhere instead of
+    "Projectname vX.Y documentation" now.
+  - All references to "documentation" in the templates have been removed, so
+    that it is now easier to use Sphinx for non-documentation documents with
+    the default templates.
+  - Templates now have an XHTML doctype, to be consistent with docutils'
+    HTML output.
+  - You can now create an OpenSearch description file with the
+    ``html_use_opensearch`` config value.
+  - You can now quickly include a logo in the sidebar, using the ``html_logo``
+    config value.
+  - There are new blocks in the sidebar, so that you can easily insert content
+    into the sidebar.
+
+* LaTeX output:
+
+  - The ``sphinx.sty`` package was cleaned of unused stuff.
+  - You can include a logo in the title page with the ``latex_logo`` config
+    value.
+  - You can define the link colors and a border and background color for
+    verbatim environments.
+
+Thanks to Jacob Kaplan-Moss, Talin, Jeroen Ruigrok van der Werven and Sebastian
+Wiesner for suggestions.
+
+Bugs fixed
+----------
+
+* sphinx.ext.autodoc: Don't check ``__module__`` for explicitly given
+  members.  Remove "self" in class constructor argument list.
+
+* sphinx.htmlwriter: Don't use os.path for joining image HREFs.
+
+* sphinx.htmlwriter: Don't use SmartyPants for HTML attribute values.
+
+* sphinx.latexwriter: Implement option lists.  Also, some other changes
+  were made to ``sphinx.sty`` in order to enhance compatibility and
+  remove old unused stuff.  Thanks to Gael Varoquaux for that!
+
+* sphinx.roles: Fix referencing glossary terms with explicit targets.
+
+* sphinx.environment: Don't swallow TOC entries when resolving subtrees.
+
+* sphinx.quickstart: Create a sensible default latex_documents setting.
+
+* sphinx.builder, sphinx.environment: Gracefully handle some user error
+  cases.
+
+* sphinx.util: Follow symbolic links when searching for documents.
+
+
+Release 0.1.61950 (Mar 26, 2008)
+================================
+
+* sphinx.quickstart: Fix format string for Makefile.
+
+
+Release 0.1.61945 (Mar 26, 2008)
+================================
+
+* sphinx.htmlwriter, sphinx.latexwriter: Support the ``.. image::``
+  directive by copying image files to the output directory.
+
+* sphinx.builder: Consistently name "special" HTML output directories
+  with a leading underscore; this means ``_sources`` and ``_static``.
+
+* sphinx.environment: Take dependent files into account when collecting
+  the set of outdated sources.
+
+* sphinx.directives: Record files included with ``.. literalinclude::``
+  as dependencies.
+
+* sphinx.ext.autodoc: Record files from which docstrings are included
+  as dependencies.
+
+* sphinx.builder: Rebuild all HTML files in case of a template change.
+
+* sphinx.builder: Handle unavailability of TOC relations (previous/
+  next chapter) more gracefully in the HTML builder.
+
+* sphinx.latexwriter: Include fncychap.sty which doesn't seem to be
+  very common in TeX distributions.  Add a ``clean`` target in the
+  latex Makefile.  Really pass the correct paper and size options
+  to the LaTeX document class.
+
+* setup: On Python 2.4, don't egg-depend on docutils if a docutils is
+  already installed -- else it will be overwritten.
+
+
+Release 0.1.61843 (Mar 24, 2008)
+================================
+
+* sphinx.quickstart: Really don't create a makefile if the user
+  doesn't want one.
+
+* setup: Don't install scripts twice, via setuptools entry points
+  and distutils scripts.  Only install via entry points.
+
+* sphinx.builder: Don't recognize the HTML builder's copied source
+  files (under ``_sources``) as input files if the source suffix is
+  ``.txt``.
+
+* sphinx.highlighting: Generate correct markup for LaTeX Verbatim
+  environment escapes even if Pygments is not installed.
+
+* sphinx.builder: The WebHTMLBuilder is now called PickleHTMLBuilder.
+
+* sphinx.htmlwriter: Make parsed-literal blocks work as expected,
+  not highlighting them via Pygments.
+
+* sphinx.environment: Don't error out on reading an empty source file.
+
+
+Release 0.1.61798 (Mar 23, 2008)
+================================
+
+* sphinx: Work with docutils SVN snapshots as well as 0.4.
+
+* sphinx.ext.doctest: Make the group in which doctest blocks are
+  placed selectable, and default to ``'default'``.
+
+* sphinx.ext.doctest: Replace ``<BLANKLINE>`` in doctest blocks by
+  real blank lines for presentation output, and remove doctest
+  options given inline.
+
+* sphinx.environment: Move doctest_blocks out of block_quotes to
+  support indented doctest blocks.
+
+* sphinx.ext.autodoc: Render ``.. automodule::`` docstrings in a
+  section node, so that module docstrings can contain proper
+  sectioning.
+
+* sphinx.ext.autodoc: Use the module's encoding for decoding
+  docstrings, rather than requiring ASCII.
+
+
+Release 0.1.61611 (Mar 21, 2008)
+================================
 
-The changelog for versions before 1.0 can be found in the file ``CHANGES.old``
-in the source distribution or `at GitHub
-<https://github.com/sphinx-doc/sphinx/raw/master/CHANGES.old>`__.
+* First public release.

_service:tar_scm:Sphinx-4.4.0.tar.gz/EXAMPLES -> _service:tar_scm:Sphinx-7.0.1.tar.gz/EXAMPLES Changed

@@ -15,9 +15,11 @@
 * `Alabaster <https://alabaster.readthedocs.io/>`__
 * `Blinker <https://pythonhosted.org/blinker/>`__
 * `Calibre <https://manual.calibre-ebook.com/>`__
+* `CherryPy <https://cherrypy.readthedocs.io/>`__
 * `Click <https://click.palletsprojects.com/>`__ (customized)
 * `coala <https://docs.coala.io/>`__ (customized)
 * `CodePy <https://documen.tician.de/codepy/>`__
+* `Django Q <https://django-q.readthedocs.io/>`__
 * `Eve <https://docs.python-eve.org/>`__ (Python REST API framework)
 * `Fabric <https://docs.fabfile.org/>`__
 * `Fityk <https://fityk.nieto.pl/>`__
@@ -30,19 +32,21 @@
 * `MDAnalysis <https://www.mdanalysis.org/docs/>`__ (customized)
 * `MeshPy <https://documen.tician.de/meshpy/>`__
 * `Molecule <https://molecule.readthedocs.io/>`__
+* `Momotor LTI <https://momotor.org/doc/lti/canvas/>`__
+* `Podman <https://docs.podman.io/>`__
 * `PyCUDA <https://documen.tician.de/pycuda/>`__
 * `PyOpenCL <https://documen.tician.de/pyopencl/>`__
 * `PyLangAcq <https://pylangacq.org/>`__
 * `pytest <https://docs.pytest.org/>`__ (customized)
-* `python-apt <https://apt.alioth.debian.org/python-apt-doc/>`__
+* `python-apt <https://apt-team.pages.debian.net/python-apt/>`__
 * `PyVisfile <https://documen.tician.de/pyvisfile/>`__
-* `Requests <http://www.python-requests.org/>`__
+* `Requests <https://requests.readthedocs.io/>`__
 * `searx <https://asciimoo.github.io/searx/>`__
 * `Spyder <https://docs.spyder-ide.org/>`__ (customized)
 * `Tablib <http://docs.python-tablib.org/>`__
 * `urllib3 <https://urllib3.readthedocs.io/>`__ (customized)
 * `Werkzeug <https://werkzeug.palletsprojects.com/>`__
-* `Write the Docs <https://writethedocs-www.readthedocs.io/>`__
+* `Write the Docs <https://www.writethedocs.org/>`__
 
 Documentation using the classic theme
 -------------------------------------
@@ -58,8 +62,6 @@
 * `Buildbot <https://docs.buildbot.net/latest/>`__
 * `CMake <https://cmake.org/documentation/>`__ (customized)
 * `Chaco <https://docs.enthought.com/chaco/>`__ (customized)
-* `CORE <https://downloads.pf.itd.nrl.navy.mil/docs/core/core-html/>`__
-* `CORE Python modules <https://downloads.pf.itd.nrl.navy.mil/docs/core/core-python-html/>`__
 * `Cormoran <http://cormoran.nhopkg.org/docs/>`__
 * `DEAP <https://deap.readthedocs.io/>`__ (customized)
 * `Director <https://pythonhosted.org/director/>`__
@@ -67,27 +69,26 @@
 * `F2py <http://f2py.sourceforge.net/docs/>`__
 * `Generic Mapping Tools (GMT) <https://gmt.soest.hawaii.edu/doc/latest/>`__ (customized)
 * `Genomedata <https://noble.gs.washington.edu/proj/genomedata/doc/1.3.3/>`__
-* `GetFEM++ <http://getfem.org/>`__ (customized)
+* `GetFEM++ <https://getfem.org/>`__ (customized)
 * `Glasgow Haskell Compiler <https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/>`__ (customized)
 * `Grok <http://grok.zope.org/doc/current/>`__ (customized)
 * `GROMACS <https://manual.gromacs.org/documentation/>`__
 * `GSL Shell <https://www.nongnu.org/gsl-shell/>`__
-* `Hands-on Python Tutorial <https://anh.cs.luc.edu/python/hands-on/3.1/handsonHtml/>`__
-* `Kaa <https://api.freevo.org/kaa-base/>`__ (customized)
-* `Leo <https://leoeditor.com/>`__
-* `LEPL <http://www.acooke.org/lepl/>`__ (customized)
+* `Hands-on Python Tutorial <http://anh.cs.luc.edu/python/hands-on/3.1/handsonHtml/>`__
+* `Kaa <https://freevo.github.io/kaa-base/>`__ (customized)
+* `Leo <https://leoeditor.com/>`__ (customized)
 * `Mayavi <https://docs.enthought.com/mayavi/mayavi/>`__ (customized)
 * `MediaGoblin <https://mediagoblin.readthedocs.io/>`__ (customized)
 * `mpmath <https://mpmath.org/doc/current/>`__
 * `OpenCV <https://docs.opencv.org/>`__ (customized)
 * `OpenEXR <https://excamera.com/articles/26/doc/index.html>`__
-* `OpenGDA <http://www.opengda.org/gdadoc/html/>`__
-* `Peach^3 <https://peach3.nl/doc/latest/userdoc/>`__ (customized)
+* `OpenGDA <http://www.opengda.org/documentation/>`__
+* `phpDocumentor <https://docs.phpdoc.org/>`__ (customized)
 * `Plone <https://docs.plone.org/>`__ (customized)
 * `PyEMD <https://pyemd.readthedocs.io/>`__
 * `Pyevolve <http://pyevolve.sourceforge.net/>`__
 * `Pygame <https://www.pygame.org/docs/>`__ (customized)
-* `PyMQI <https://pythonhosted.org/pymqi/>`__
+* `PyMQI <https://dsuch.github.io/pymqi/>`__
 * `PyQt4 <http://pyqt.sourceforge.net/Docs/PyQt4/>`__ (customized)
 * `PyQt5 <http://pyqt.sourceforge.net/Docs/PyQt5/>`__ (customized)
 * `Python 2 <https://docs.python.org/2/>`__
@@ -116,11 +117,10 @@
 * `cartopy <https://scitools.org.uk/cartopy/docs/latest/>`__
 * `Jython <http://www.jython.org/docs/>`__
 * `LLVM <https://llvm.org/docs/>`__
-* `Matplotlib <https://matplotlib.org/>`__
 * `MDAnalysis Tutorial <https://www.mdanalysis.org/MDAnalysisTutorial/>`__
-* `NetworkX <https://networkx.github.io/>`__
 * `PyCantonese <https://pycantonese.org/>`__
-* `Pyre <https://docs.danse.us/pyre/sphinx/>`__
+* `PyRe <https://hackl.science/pyre/>`__
+* `Pyre <https://pyre.readthedocs.io/>`__
 * `pySPACE <https://pyspace.github.io/pyspace/>`__
 * `Pysparse <http://pysparse.sourceforge.net/>`__
 * `PyTango <https://www.esrf.eu/computing/cs/tango/tango_doc/kernel_doc/pytango/latest/>`__
@@ -136,11 +136,9 @@
 * `Alembic <https://alembic.sqlalchemy.org/>`__
 * `Cython <https://docs.cython.org/>`__
 * `easybuild <https://easybuild.readthedocs.io/>`__
-* `jsFiddle <http://doc.jsfiddle.net/>`__
-* `libLAS <https://www.liblas.org/>`__ (customized)
+* `libLAS <https://liblas.org/>`__ (customized)
 * `Lmod <https://lmod.readthedocs.io/>`__
 * `MapServer <https://mapserver.org/>`__ (customized)
-* `Pandas <https://pandas.pydata.org/pandas-docs/stable/>`__
 * `pyglet <https://pyglet.readthedocs.io/>`__ (customized)
 * `PyWavelets <https://pywavelets.readthedocs.io/>`__
 * `Setuptools <https://setuptools.readthedocs.io/>`__
@@ -154,11 +152,10 @@
 * `Breathe <https://breathe.readthedocs.io/>`__ (haiku)
 * `MPipe <https://vmlaker.github.io/mpipe/>`__ (sphinx13)
 * `NLTK <https://www.nltk.org/>`__ (agogo)
-* `Programmieren mit PyGTK und Glade (German) <https://www.florian-diesch.de/doc/python-und-glade/online/>`__ (agogo, customized)
 * `PyPubSub <https://pypubsub.readthedocs.io/>`__ (bizstyle)
 * `Pylons <https://docs.pylonsproject.org/projects/pylons-webframework/>`__ (pyramid)
 * `Pyramid web framework <https://docs.pylonsproject.org/projects/pyramid/>`__ (pyramid)
-* `RxDock <https://www.rxdock.org/documentation/html/devel/>`__
+* `RxDock <https://www.rxdock.org/documentation/devel/html/>`__
 * `Sphinx <https://www.sphinx-doc.org/>`__ (sphinx13) :-)
 * `Valence <https://docs.valence.desire2learn.com/>`__ (haiku, customized)
 
@@ -176,9 +173,12 @@
 * `Blender Reference Manual <https://docs.blender.org/manual/>`__
 * `Blocks <https://blocks.readthedocs.io/>`__
 * `bootstrap-datepicker <https://bootstrap-datepicker.readthedocs.io/>`__
-* `Certbot <https://letsencrypt.readthedocs.io/>`__
+* `Certbot <https://certbot.eff.org/docs/>`__
+* `CKAN <https://docs.ckan.org/>`__
+* `Copr Buildsystem <https://docs.pagure.org/copr.copr/>`__ (customized)
+* `Coreboot <https://doc.coreboot.org/>`__
 * `Chainer <https://docs.chainer.org/>`__ (customized)
-* `CherryPy <https://docs.cherrypy.org/>`__
+* `citeproc-js <https://citeproc-js.readthedocs.io/>`__
 * `cloud-init <https://cloudinit.readthedocs.io/>`__
 * `CodeIgniter <https://www.codeigniter.com/user_guide/>`__
 * `Conda <https://conda.io/docs/>`__
@@ -187,7 +187,9 @@
 * `Databricks <https://docs.databricks.com/>`__ (customized)
 * `Dataiku DSS <https://doc.dataiku.com/>`__
 * `DNF <https://dnf.readthedocs.io/>`__
+* `Distro Tracker <https://qa.pages.debian.net/distro-tracker/>`__
 * `Django-cas-ng <https://djangocas.dev/docs/>`__
+* `dj-stripe <https://dj-stripe.readthedocs.io/>`__
 * `edX <https://docs.edx.org/>`__
 * `Electrum <https://docs.electrum.org/>`__
 * `Elemental <https://libelemental.org/documentation/dev/>`__
@@ -207,13 +209,15 @@
 * `Graylog <https://docs.graylog.org/>`__
 * `GPAW <https://wiki.fysik.dtu.dk/gpaw/>`__ (customized)
 * `HDF5 for Python (h5py) <https://docs.h5py.org/>`__
+* `HyperKitty <https://hyperkitty.readthedocs.io/>`__
 * `Hyperledger Fabric <https://hyperledger-fabric.readthedocs.io/>`__
-* `Hyperledger Sawtooth <https://intelledger.github.io/>`__
+* `Hyperledger Sawtooth <https://sawtooth.hyperledger.org/docs/>`__
 * `IdentityServer <https://docs.identityserver.io/>`__
 * `Idris <https://docs.idris-lang.org/>`__
+* `Inkscape <https://inkscape-manuals.readthedocs.io/>`__ (customized)
 * `javasphinx <https://bronto-javasphinx.readthedocs.io/>`__
-* `Julia <https://julia.readthedocs.io/>`__
 * `Jupyter Notebook <https://jupyter-notebook.readthedocs.io/>`__
+* `Kanboard <https://docs.kanboard.org/>`__
 * `Lasagne <https://lasagne.readthedocs.io/>`__
 * `latexindent.pl <https://latexindentpl.readthedocs.io/>`__
 * `Learning Apache Spark with Python <https://runawayhorse001.github.io/LearningApacheSpark>`__
@@ -226,7 +230,6 @@
 * `Mesa 3D <https://docs.mesa3d.org/>`__
 * `micca - MICrobial Community Analysis <https://micca.readthedocs.io/>`__
 * `MicroPython <https://docs.micropython.org/>`__
-* `Minds <https://www.minds.org/docs/>`__ (customized)
 * `Mink <https://mink.behat.org/>`__
 * `Mockery <https://docs.mockery.io/>`__
 * `mod_wsgi <https://modwsgi.readthedocs.io/>`__
@@ -234,9 +237,14 @@
 * `Mopidy <https://docs.mopidy.com/>`__
 * `mpi4py <https://mpi4py.readthedocs.io/>`__
 * `MyHDL <https://docs.myhdl.org/>`__
+* `Mypy <https://mypy.readthedocs.io/>`__
+* `Netgate Docs <https://docs.netgate.com/>`__
+* `Nextcloud Server <https://docs.nextcloud.com/#server>`__
 * `Nextflow <https://www.nextflow.io/docs/latest/index.html>`__
+* `nghttp2 <https://nghttp2.org/documentation/>`__
 * `NICOS <https://forge.frm2.tum.de/nicos/doc/nicos-master/>`__ (customized)
-* `OpenFAST <https://openfast.readthedocs.io/>`__ 
+* `OpenFAST <https://openfast.readthedocs.io/>`__
+* `Panda3D <https://docs.panda3d.org/>`__ (customized)
 * `Pelican <https://docs.getpelican.com/>`__
 * `picamera <https://picamera.readthedocs.io/>`__
 * `Pillow <https://pillow.readthedocs.io/>`__
@@ -245,15 +253,20 @@
 * `peewee <https://docs.peewee-orm.com/>`__
 * `Phinx <https://docs.phinx.org/>`__
 * `phpMyAdmin <https://docs.phpmyadmin.net/>`__
+* `PHPUnit <https://phpunit.readthedocs.io/>`__
+* `PHPWord <https://phpword.readthedocs.io/>`__
 * `PROS <https://pros.cs.purdue.edu/v5/>`__ (customized)
 * `Pushkin <http://docs.pushkin.io/>`__
 * `Pweave <https://mpastell.com/pweave/>`__
+* `pyca/cryptograhpy <https://cryptography.io/>`__
+* `PyNaCl <https://pynacl.readthedocs.io/>`__
+* `pyOpenSSL <https://www.pyopenssl.org/>`__
 * `PyPy <https://doc.pypy.org/>`__
 * `python-sqlparse <https://sqlparse.readthedocs.io/>`__
 * `PyVISA <https://pyvisa.readthedocs.io/>`__
-* `pyvista <https://docs.pyvista.org/>`__
 * `Read The Docs <https://docs.readthedocs.io/>`__
-* `ROCm Platform <https://rocm-documentation.readthedocs.io/>`__
+* `RenderDoc <https://renderdoc.org/docs/>`__
+* `ROCm Platform <https://rocmdocs.amd.com/>`__
 * `Free your information from their silos (French) <https://redaction-technique.org/>`__ (customized)
 * `Releases Sphinx extension <https://releases.readthedocs.io/>`__
 * `Qtile <https://docs.qtile.org/>`__
@@ -269,6 +282,7 @@
 * `Sonos Controller (SoCo) <https://docs.python-soco.com/>`__
 * `Sphinx AutoAPI <https://sphinx-autoapi.readthedocs.io/>`__
 * `sphinx-argparse <https://sphinx-argparse.readthedocs.io/>`__
+* `sphinx-tabs <https://sphinx-tabs.readthedocs.io/>`__
 * `Sphinx-Gallery <https://sphinx-gallery.readthedocs.io/>`__ (customized)
 * `Sphinx with Github Webpages <https://runawayhorse001.github.io/SphinxGithub>`__
 * `SpotBugs <https://spotbugs.readthedocs.io/>`__
@@ -281,15 +295,18 @@
 * `Topshelf <https://docs.topshelf-project.com/>`__
 * `Theano <http://www.deeplearning.net/software/theano/>`__
 * `ThreatConnect <https://docs.threatconnect.com/>`__
+* `TrueNAS <https://www.ixsystems.com/documentation/truenas/>`__ (customized)
 * `Tuleap <https://tuleap.net/doc/en/>`__
 * `TYPO3 <https://docs.typo3.org/>`__ (customized)
 * `Veyon <https://docs.veyon.io/>`__
+* `Ubiquity <https://micro-framework.readthedocs.io/>`__
 * `uWSGI <https://uwsgi-docs.readthedocs.io/>`__
 * `virtualenv <https://virtualenv.readthedocs.io/>`__
 * `Wagtail <https://docs.wagtail.io/>`__
 * `Web Application Attack and Audit Framework (w3af) <https://docs.w3af.org/>`__
 * `Weblate <https://docs.weblate.org/>`__
 * `x265 <https://x265.readthedocs.io/>`__
+* `Zeek <https://docs.zeek.org/>`__
 * `Zulip <https://zulip.readthedocs.io/>`__
 
 Documentation using sphinx_bootstrap_theme
@@ -308,21 +325,42 @@
 * `PyUblas <https://documen.tician.de/pyublas/>`__
 * `seaborn <https://seaborn.pydata.org/>`__
 
+Documentation using pydata_sphinx_theme
+---------------------------------------
+
+* `Arviz <https://python.arviz.org/en/stable/>`__
+* `Binder <https://mybinder.readthedocs.io/en/latest/>`__
+* `Bokeh <https://docs.bokeh.org/en/latest/>`__
+* `CuPy <https://docs.cupy.dev/en/stable/>`__
+* `EnOSlib <https://discovery.gitlabpages.inria.fr/enoslib/>`__
+* `Fairlearn <https://fairlearn.org/main/>`__
+* `Feature-engine <https://feature-engine.readthedocs.io/en/latest/>`__
+* `Jupyter <https://docs.jupyter.org/en/latest/>`__
+* `Jupyter Book <https://jupyterbook.org/en/stable/intro.html>`__
+* `Matplotlib <https://matplotlib.org/stable/index.html>`__
+* `MegEngine <https://megengine.org.cn/doc/stable/en/>`__
+* `MNE-Python <https://mne.tools/stable/>`__
+* `NetworkX <https://networkx.org/documentation/stable/>`__
+* `Numpy <https://numpy.org/doc/stable/>`__
+* `Pandas <https://pandas.pydata.org/docs/>`__
+* `PyVista <https://docs.pyvista.org/>`__
+* `SciPy <https://docs.scipy.org/doc/scipy/>`__
+* `SEPAL <https://docs.sepal.io/en/latest/index.html>`__
+
 Documentation using a custom theme or integrated in a website
 -------------------------------------------------------------
 
 * `AIOHTTP <https://docs.aiohttp.org/>`__
 * `Apache Cassandra <https://cassandra.apache.org/doc/>`__
 * `Astropy <https://docs.astropy.org/>`__
-* `Bokeh <https://bokeh.pydata.org/>`__
 * `Boto 3 <https://boto3.readthedocs.io/>`__
 * `CakePHP <https://book.cakephp.org/>`__
-* `CasperJS <http://docs.casperjs.org/>`__
 * `Ceph <https://docs.ceph.com/docs/master/>`__
 * `Chef <https://docs.chef.io/>`__
 * `CKAN <https://docs.ckan.org/>`__
 * `Confluent Platform <https://docs.confluent.io/>`__
 * `Django <https://docs.djangoproject.com/>`__
+* `django CMS <https://docs.django-cms.org/>`__
 * `Doctrine <https://www.doctrine-project.org/>`__
 * `Enterprise Toolkit for Acrobat products <https://www.adobe.com/devnet-docs/acrobatetk/>`__
 * `FreeFEM <https://doc.freefem.org/introduction/>`__
@@ -335,7 +373,7 @@
 * `Guzzle <https://docs.guzzlephp.org/>`__
 * `H2O.ai <https://docs.h2o.ai/>`__
 * `Heka <https://hekad.readthedocs.io/>`__
-* `Istihza (Turkish Python documentation project) <https://belgeler.yazbel.com/python-istihza/>`__
+* `Istihza (Turkish Python documentation project) <https://python-istihza.yazbel.com/>`__
 * `JupyterHub <https://jupyterhub.readthedocs.io/>`__
 * `Kombu <http://docs.kombu.me/>`__
 * `Lasso <https://lassoguide.com/>`__
@@ -348,7 +386,6 @@
 * `ndnSIM <https://ndnsim.net/current/>`__
 * `nose <https://nose.readthedocs.io/>`__
 * `ns-3 <https://www.nsnam.org/documentation/>`__
-* `NumPy <https://docs.scipy.org/doc/numpy/reference/>`__
 * `ObjectListView <http://objectlistview.sourceforge.net/python/>`__
 * `OpenERP <https://doc.odoo.com/>`__
 * `OpenCV <https://docs.opencv.org/>`__
@@ -356,6 +393,7 @@
 * `OpenTURNS <https://openturns.github.io/openturns/master/>`__
 * `Open vSwitch <https://docs.openvswitch.org/>`__
 * `PlatformIO <https://docs.platformio.org/>`__
+* `Psycopg <https://www.psycopg.org/docs/>`__
 * `PyEphem <https://rhodesmill.org/pyephem/>`__
 * `Pygments <https://pygments.org/docs/>`__
 * `Plone User Manual (German) <https://www.hasecke.com/plone-benutzerhandbuch/4.0/>`__
@@ -367,7 +405,6 @@
 * `Roundup <https://www.roundup-tracker.org/>`__
 * `SaltStack <https://docs.saltstack.com/>`__
 * `scikit-learn <https://scikit-learn.org/stable/>`__
-* `SciPy <https://docs.scipy.org/doc/scipy/reference/>`__
 * `Scrapy <https://doc.scrapy.org/>`__
 * `Seaborn <https://seaborn.pydata.org/>`__
 * `Selenium <https://docs.seleniumhq.org/docs/>`__
@@ -384,14 +421,16 @@
 Homepages and other non-documentation sites
 -------------------------------------------
 
+* `Alan Crosswell's Using the Django REST Framework and DRF-JSONAPI <http://www.columbia.edu/~alan/django-jsonapi-training/>`__
 * `Arizona State University PHY494/PHY598/CHM598 Simulation approaches to Bio-and Nanophysics <https://becksteinlab.physics.asu.edu/pages/courses/2013/SimBioNano/>`__ (classic)
 * `Benoit Boissinot <https://bboissin.appspot.com/>`__ (classic, customized)
-* `Computer Networks, Parallelization, and Simulation Laboratory (CNPSLab) <https://lab.miletic.net/>`__ (sphinx_rtd_theme)
-* `Deep Learning Tutorials <http://www.deeplearning.net/tutorial/>`__ (sphinxdoc)
+* `EBI Cloud Consultancy Team <https://tsi-ccdoc.readthedocs.io/>`__ (sphinx_rtd_theme)
 * `Eric Holscher <https://ericholscher.com/>`__ (alabaster)
+* `Florian Diesch <https://www.florian-diesch.de/>`__
+* `Institute for the Design of Advanced Energy Systems (IDAES) <https://idaes-pse.readthedocs.io/>`__ (sphinx_rtd_theme)
+* `IDAES Examples <https://idaes.github.io/examples-pse/>`__ (sphinx_rtd_theme)
 * `Lei Ma's Statistical Mechanics lecture notes <http://statisticalphysics.openmetric.org/>`__ (sphinx_bootstrap_theme)
-* `Loyola University Chicago COMP 339-439 Distributed Systems course <https://books.cs.luc.edu/distributedsystems/>`__ (sphinx_bootstrap_theme)
-* `Pylearn2 <http://www.deeplearning.net/software/pylearn2/>`__ (sphinxdoc, customized)
+* `Loyola University Chicago CS Academic Programs <https://academics.cs.luc.edu/index.html>`__ (sphinx_rtd_theme, customized)
 * `PyXLL <https://www.pyxll.com/>`__ (sphinx_bootstrap_theme, customized)
 * `SciPy Cookbook <https://scipy-cookbook.readthedocs.io/>`__ (sphinx_rtd_theme)
 * `Tech writer at work blog <https://blog.documatt.com/>`__ (custom theme)
@@ -430,7 +469,7 @@
 * `"Theoretical Physics Reference" <https://www.theoretical-physics.net/>`__
 * `"The Varnish Book" <https://info.varnish-software.com/the-varnish-book>`__
 
-These produced using Sphinx
+Theses produced using Sphinx
 ----------------------------
 
 * `"A Web-Based System for Comparative Analysis of OpenStreetMap Data by the Use
@@ -444,6 +483,6 @@
 * `Read the Docs <https://readthedocs.org/>`__, a software-as-a-service documentation hosting platform, uses
   Sphinx to automatically build documentation updates that are pushed to GitHub.
 
-* `Spyder <https://docs.spyder-ide.org/help.html>`__, the Scientific Python Development Environment, uses Sphinx in its
-  help pane to render rich documentation for functions, classes and methods
+* `Spyder <https://docs.spyder-ide.org/current/panes/help.html>`__, the Scientific Python Development
+  Environment, uses Sphinx in its help pane to render rich documentation for functions, classes and methods
   automatically or on-demand.

_service:tar_scm:Sphinx-4.4.0.tar.gz/LICENSE -> _service:tar_scm:Sphinx-7.0.1.tar.gz/LICENSE Changed

@@ -1,7 +1,10 @@
 License for Sphinx
 ==================
 
-Copyright (c) 2007-2022 by the Sphinx team (see AUTHORS file).
+Unless otherwise indicated, all code in the Sphinx project is licenced under the
+two clause BSD licence below.
+
+Copyright (c) 2007-2023 by the Sphinx team (see AUTHORS file).
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
@@ -31,134 +34,6 @@
 Licenses for incorporated software
 ==================================
 
-The included smartypants module, included as sphinx.util.smartypants,
-is available under the following license:
-
-----------------------------------------------------------------------
-SmartyPants_ license::
-
-    Copyright (c) 2003 John Gruber
-    (https://daringfireball.net/projects/smartypants/)
-    All rights reserved.
-
-    Redistribution and use in source and binary forms, with or without
-    modification, are permitted provided that the following conditions
-    are met:
-
-    *   Redistributions of source code must retain the above copyright
-        notice, this list of conditions and the following disclaimer.
-
-    *   Redistributions in binary form must reproduce the above
-        copyright notice, this list of conditions and the following
-        disclaimer in the documentation and/or other materials
-        provided with the distribution.
-
-    *   Neither the name "SmartyPants" nor the names of its
-        contributors may be used to endorse or promote products
-        derived from this software without specific prior written
-        permission.
-
-    This software is provided by the copyright holders and
-    contributors "as is" and any express or implied warranties,
-    including, but not limited to, the implied warranties of
-    merchantability and fitness for a particular purpose are
-    disclaimed. In no event shall the copyright owner or contributors
-    be liable for any direct, indirect, incidental, special,
-    exemplary, or consequential damages (including, but not limited
-    to, procurement of substitute goods or services; loss of use,
-    data, or profits; or business interruption) however caused and on
-    any theory of liability, whether in contract, strict liability, or
-    tort (including negligence or otherwise) arising in any way out of
-    the use of this software, even if advised of the possibility of
-    such damage.
-
-
-smartypants.py license::
-
-    smartypants.py is a derivative work of SmartyPants.
-
-    Redistribution and use in source and binary forms, with or without
-    modification, are permitted provided that the following conditions
-    are met:
-
-    *   Redistributions of source code must retain the above copyright
-        notice, this list of conditions and the following disclaimer.
-
-    *   Redistributions in binary form must reproduce the above
-        copyright notice, this list of conditions and the following
-        disclaimer in the documentation and/or other materials
-        provided with the distribution.
-
-    This software is provided by the copyright holders and
-    contributors "as is" and any express or implied warranties,
-    including, but not limited to, the implied warranties of
-    merchantability and fitness for a particular purpose are
-    disclaimed. In no event shall the copyright owner or contributors
-    be liable for any direct, indirect, incidental, special,
-    exemplary, or consequential damages (including, but not limited
-    to, procurement of substitute goods or services; loss of use,
-    data, or profits; or business interruption) however caused and on
-    any theory of liability, whether in contract, strict liability, or
-    tort (including negligence or otherwise) arising in any way out of
-    the use of this software, even if advised of the possibility of
-    such damage.
-----------------------------------------------------------------------
-
-The included JQuery JavaScript library is available under the MIT
-license:
-
-----------------------------------------------------------------------
-Copyright (c) 2008 John Resig, https://jquery.com/
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-----------------------------------------------------------------------
-
-The included Underscore JavaScript library is available under the MIT
-license:
-
-----------------------------------------------------------------------
-Copyright (c) 2009 Jeremy Ashkenas, DocumentCloud
-
-Permission is hereby granted, free of charge, to any person
-obtaining a copy of this software and associated documentation
-files (the "Software"), to deal in the Software without
-restriction, including without limitation the rights to use,
-copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the
-Software is furnished to do so, subject to the following
-conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
-OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
-
--------------------------------------------------------------------------------
-
 The included implementation of NumpyDocstring._parse_numpydoc_see_also_section
 was derived from code under the following license:

_service:tar_scm:Sphinx-4.4.0.tar.gz/PKG-INFO -> _service:tar_scm:Sphinx-7.0.1.tar.gz/PKG-INFO Changed

@@ -1,15 +1,10 @@
 Metadata-Version: 2.1
 Name: Sphinx
-Version: 4.4.0
+Version: 7.0.1
 Summary: Python documentation generator
-Home-page: https://www.sphinx-doc.org/
-Author: Georg Brandl
-Author-email: georg@python.org
-License: BSD
-Download-URL: https://pypi.org/project/Sphinx/
-Project-URL: Code, https://github.com/sphinx-doc/sphinx
-Project-URL: Issue tracker, https://github.com/sphinx-doc/sphinx/issues
-Platform: any
+Author-email: Georg Brandl <georg@python.org>
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Environment :: Web Environment
@@ -23,14 +18,12 @@
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Framework :: Setuptools Plugin
 Classifier: Framework :: Sphinx
 Classifier: Framework :: Sphinx :: Extension
 Classifier: Framework :: Sphinx :: Theme
@@ -47,12 +40,44 @@
 Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Topic :: Text Processing :: Markup :: LaTeX
 Classifier: Topic :: Utilities
-Requires-Python: >=3.6
-Description-Content-Type: text/x-rst
+Requires-Dist: sphinxcontrib-applehelp
+Requires-Dist: sphinxcontrib-devhelp
+Requires-Dist: sphinxcontrib-jsmath
+Requires-Dist: sphinxcontrib-htmlhelp>=2.0.0
+Requires-Dist: sphinxcontrib-serializinghtml>=1.1.5
+Requires-Dist: sphinxcontrib-qthelp
+Requires-Dist: Jinja2>=3.0
+Requires-Dist: Pygments>=2.13
+Requires-Dist: docutils>=0.18.1,<0.21
+Requires-Dist: snowballstemmer>=2.0
+Requires-Dist: babel>=2.9
+Requires-Dist: alabaster>=0.7,<0.8
+Requires-Dist: imagesize>=1.3
+Requires-Dist: requests>=2.25.0
+Requires-Dist: packaging>=21.0
+Requires-Dist: importlib-metadata>=4.8; python_version < '3.10'
+Requires-Dist: colorama>=0.4.5; sys_platform == 'win32'
+Requires-Dist: sphinxcontrib-websupport ; extra == "docs"
+Requires-Dist: flake8>=3.5.0 ; extra == "lint"
+Requires-Dist: flake8-simplify ; extra == "lint"
+Requires-Dist: isort ; extra == "lint"
+Requires-Dist: ruff ; extra == "lint"
+Requires-Dist: mypy>=0.990 ; extra == "lint"
+Requires-Dist: sphinx-lint ; extra == "lint"
+Requires-Dist: docutils-stubs ; extra == "lint"
+Requires-Dist: types-requests ; extra == "lint"
+Requires-Dist: pytest>=4.6 ; extra == "test"
+Requires-Dist: html5lib ; extra == "test"
+Requires-Dist: cython ; extra == "test"
+Requires-Dist: filelock ; extra == "test"
+Project-URL: Changelog, https://www.sphinx-doc.org/en/master/changes.html
+Project-URL: Code, https://github.com/sphinx-doc/sphinx
+Project-URL: Download, https://pypi.org/project/Sphinx/
+Project-URL: Homepage, https://www.sphinx-doc.org/
+Project-URL: Issue tracker, https://github.com/sphinx-doc/sphinx/issues
 Provides-Extra: docs
 Provides-Extra: lint
 Provides-Extra: test
-License-File: LICENSE
 
 ========
  Sphinx
@@ -62,118 +87,57 @@
    :target: https://pypi.org/project/Sphinx/
    :alt: Package on PyPI
 
+.. image:: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml/badge.svg
+   :target: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml
+   :alt: Build Status
+
 .. image:: https://readthedocs.org/projects/sphinx/badge/?version=master
-   :target: http://www.sphinx-doc.org/
+   :target: https://www.sphinx-doc.org/
    :alt: Documentation Status
 
-.. image:: https://ci.appveyor.com/api/projects/status/github/sphinx-doc/sphinx?branch=master&svg=true
-   :target: https://ci.appveyor.com/project/sphinxdoc/sphinx
-   :alt: Build Status (AppVeyor)
-
-.. image:: https://circleci.com/gh/sphinx-doc/sphinx.svg?style=shield
-   :target: https://circleci.com/gh/sphinx-doc/sphinx
-   :alt: Build Status (CircleCI)
+.. image:: https://img.shields.io/badge/License-BSD%202--Clause-blue.svg
+   :target: https://opensource.org/licenses/BSD-2-Clause
+   :alt: BSD 2 Clause
 
-.. image:: https://codecov.io/gh/sphinx-doc/sphinx/branch/master/graph/badge.svg
-   :target: https://codecov.io/gh/sphinx-doc/sphinx
-   :alt: Code Coverage Status (Codecov)
-
-.. image:: https://img.shields.io/badge/License-BSD%203--Clause-blue.svg
-   :target: https://opensource.org/licenses/BSD-3-Clause
-   :alt: BSD 3 Clause
-
-.. image:: https://codetriage.com/sphinx-doc/sphinx/badges/users.svg
-   :target: https://codetriage.com/sphinx-doc/sphinx
-   :alt: Open Source Helpers badge
-
-Sphinx is a tool that makes it easy to create intelligent and beautiful
-documentation for Python projects (or other documents consisting of multiple
-reStructuredText sources), written by Georg Brandl.  It was originally created
-for the new Python documentation, and has excellent facilities for Python
-project documentation, but C/C++ is supported as well, and more languages are
-planned.
+**Sphinx makes it easy to create intelligent and beautiful documentation.**
 
 Sphinx uses reStructuredText as its markup language, and many of its strengths
 come from the power and straightforwardness of reStructuredText and its parsing
 and translating suite, the Docutils.
 
-Among its features are the following:
+Features
+========
 
-* Output formats: HTML (including derivative formats such as HTML Help, Epub
-  and Qt Help), plain text, manual pages and LaTeX or direct PDF output
-  using rst2pdf
-* Extensive cross-references: semantic markup and automatic links
+* **Output formats**: HTML, PDF, plain text, EPUB, TeX, manual pages, and more
+* **Extensive cross-references**: semantic markup and automatic links
   for functions, classes, glossary terms and similar pieces of information
-* Hierarchical structure: easy definition of a document tree, with automatic
+* **Hierarchical structure**: easy definition of a document tree, with automatic
   links to siblings, parents and children
-* Automatic indices: general index as well as a module index
-* Code handling: automatic highlighting using the Pygments highlighter
-* Flexible HTML output using the Jinja 2 templating engine
-* Various extensions are available, e.g. for automatic testing of snippets
-  and inclusion of appropriately formatted docstrings
-* Setuptools integration
+* **Automatic indices**: general index as well as a module index
+* **Code highlighting**: automatic highlighting using the Pygments highlighter
+* **Templating**: Flexible HTML output using the Jinja 2 templating engine
+* **Extension ecosystem**: Many extensions are available, for example for
+  automatic function documentation or working with Jupyter notebooks.
+* **Language Support**: Python, C, C++, JavaScript, mathematics, and many other
+  languages through extensions.
 
-For more information, refer to the `the documentation`__.
-
-.. __: http://www.sphinx-doc.org/
+For more information, refer to the `the documentation`_.
 
 Installation
 ============
 
-Sphinx is published on `PyPI`__ and can be installed from there::
-
-   pip install -U sphinx
-
-We also publish beta releases::
-
-   pip install -U --pre sphinx
-
-If you wish to install `Sphinx` for development purposes, refer to `the
-contributors guide`__.
-
-__ https://pypi.org/project/Sphinx/
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
-
-Documentation
-=============
-
-Documentation is available from `sphinx-doc.org`__.
-
-__ http://www.sphinx-doc.org/
-
-Get in touch
-============
-
-- Report bugs, suggest features or view the source code `on GitHub`_.
-- For less well defined questions or ideas, use the `mailing list`_.
-
-.. _on GitHub: https://github.com/sphinx-doc/sphinx
-.. _mailing list: https://groups.google.com/forum/#!forum/sphinx-users
-
-Please adhere to our `code of conduct`__.
-
-__ http://www.sphinx-doc.org/en/master/code_of_conduct.html
+The following command installs Sphinx from the `Python Package Index`_. You will
+need a working installation of Python and pip.
 
-Testing
-=======
+.. code-block:: sh
 
-Continuous testing is provided by `Travis`__ (for unit tests and style checks
-on Linux), `AppVeyor`__ (for unit tests on Windows), and `CircleCI`__ (for
-large processes like TeX compilation).
-
-For information on running tests locally, refer to `the contributors guide`__.
-
-__ https://travis-ci.org/sphinx-doc/sphinx
-__ https://ci.appveyor.com/project/sphinxdoc/sphinx
-__ https://circleci.com/gh/sphinx-doc/sphinx
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
+   pip install -U sphinx
 
 Contributing
 ============
 
-Refer to `the contributors guide`__.
-
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
+We appreciate all contributions! Refer to `the contributors guide`_ for
+information.
 
 Release signatures
 ==================
@@ -182,5 +146,9 @@
 
 * `498D6B9E <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x102C2C17498D6B9E>`_
 * `5EBA0E07 <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x1425F8CE5EBA0E07>`_
+* `61F0FB52 <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x52C8F72A61F0FB52>`_
 
+.. _the documentation: https://www.sphinx-doc.org/
+.. _the contributors guide: https://www.sphinx-doc.org/en/master/internals/contributing.html
+.. _Python Package Index: https://pypi.org/project/Sphinx/

_service:tar_scm:Sphinx-4.4.0.tar.gz/README.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/README.rst Changed

@@ -6,118 +6,57 @@
    :target: https://pypi.org/project/Sphinx/
    :alt: Package on PyPI
 
+.. image:: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml/badge.svg
+   :target: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml
+   :alt: Build Status
+
 .. image:: https://readthedocs.org/projects/sphinx/badge/?version=master
-   :target: http://www.sphinx-doc.org/
+   :target: https://www.sphinx-doc.org/
    :alt: Documentation Status
 
-.. image:: https://ci.appveyor.com/api/projects/status/github/sphinx-doc/sphinx?branch=master&svg=true
-   :target: https://ci.appveyor.com/project/sphinxdoc/sphinx
-   :alt: Build Status (AppVeyor)
-
-.. image:: https://circleci.com/gh/sphinx-doc/sphinx.svg?style=shield
-   :target: https://circleci.com/gh/sphinx-doc/sphinx
-   :alt: Build Status (CircleCI)
-
-.. image:: https://codecov.io/gh/sphinx-doc/sphinx/branch/master/graph/badge.svg
-   :target: https://codecov.io/gh/sphinx-doc/sphinx
-   :alt: Code Coverage Status (Codecov)
-
-.. image:: https://img.shields.io/badge/License-BSD%203--Clause-blue.svg
-   :target: https://opensource.org/licenses/BSD-3-Clause
-   :alt: BSD 3 Clause
+.. image:: https://img.shields.io/badge/License-BSD%202--Clause-blue.svg
+   :target: https://opensource.org/licenses/BSD-2-Clause
+   :alt: BSD 2 Clause
 
-.. image:: https://codetriage.com/sphinx-doc/sphinx/badges/users.svg
-   :target: https://codetriage.com/sphinx-doc/sphinx
-   :alt: Open Source Helpers badge
-
-Sphinx is a tool that makes it easy to create intelligent and beautiful
-documentation for Python projects (or other documents consisting of multiple
-reStructuredText sources), written by Georg Brandl.  It was originally created
-for the new Python documentation, and has excellent facilities for Python
-project documentation, but C/C++ is supported as well, and more languages are
-planned.
+**Sphinx makes it easy to create intelligent and beautiful documentation.**
 
 Sphinx uses reStructuredText as its markup language, and many of its strengths
 come from the power and straightforwardness of reStructuredText and its parsing
 and translating suite, the Docutils.
 
-Among its features are the following:
+Features
+========
 
-* Output formats: HTML (including derivative formats such as HTML Help, Epub
-  and Qt Help), plain text, manual pages and LaTeX or direct PDF output
-  using rst2pdf
-* Extensive cross-references: semantic markup and automatic links
+* **Output formats**: HTML, PDF, plain text, EPUB, TeX, manual pages, and more
+* **Extensive cross-references**: semantic markup and automatic links
   for functions, classes, glossary terms and similar pieces of information
-* Hierarchical structure: easy definition of a document tree, with automatic
+* **Hierarchical structure**: easy definition of a document tree, with automatic
   links to siblings, parents and children
-* Automatic indices: general index as well as a module index
-* Code handling: automatic highlighting using the Pygments highlighter
-* Flexible HTML output using the Jinja 2 templating engine
-* Various extensions are available, e.g. for automatic testing of snippets
-  and inclusion of appropriately formatted docstrings
-* Setuptools integration
-
-For more information, refer to the `the documentation`__.
+* **Automatic indices**: general index as well as a module index
+* **Code highlighting**: automatic highlighting using the Pygments highlighter
+* **Templating**: Flexible HTML output using the Jinja 2 templating engine
+* **Extension ecosystem**: Many extensions are available, for example for
+  automatic function documentation or working with Jupyter notebooks.
+* **Language Support**: Python, C, C++, JavaScript, mathematics, and many other
+  languages through extensions.
 
-.. __: http://www.sphinx-doc.org/
+For more information, refer to the `the documentation`_.
 
 Installation
 ============
 
-Sphinx is published on `PyPI`__ and can be installed from there::
-
-   pip install -U sphinx
-
-We also publish beta releases::
-
-   pip install -U --pre sphinx
-
-If you wish to install `Sphinx` for development purposes, refer to `the
-contributors guide`__.
-
-__ https://pypi.org/project/Sphinx/
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
-
-Documentation
-=============
+The following command installs Sphinx from the `Python Package Index`_. You will
+need a working installation of Python and pip.
 
-Documentation is available from `sphinx-doc.org`__.
+.. code-block:: sh
 
-__ http://www.sphinx-doc.org/
-
-Get in touch
-============
-
-- Report bugs, suggest features or view the source code `on GitHub`_.
-- For less well defined questions or ideas, use the `mailing list`_.
-
-.. _on GitHub: https://github.com/sphinx-doc/sphinx
-.. _mailing list: https://groups.google.com/forum/#!forum/sphinx-users
-
-Please adhere to our `code of conduct`__.
-
-__ http://www.sphinx-doc.org/en/master/code_of_conduct.html
-
-Testing
-=======
-
-Continuous testing is provided by `Travis`__ (for unit tests and style checks
-on Linux), `AppVeyor`__ (for unit tests on Windows), and `CircleCI`__ (for
-large processes like TeX compilation).
-
-For information on running tests locally, refer to `the contributors guide`__.
-
-__ https://travis-ci.org/sphinx-doc/sphinx
-__ https://ci.appveyor.com/project/sphinxdoc/sphinx
-__ https://circleci.com/gh/sphinx-doc/sphinx
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
+   pip install -U sphinx
 
 Contributing
 ============
 
-Refer to `the contributors guide`__.
-
-__ http://www.sphinx-doc.org/en/master/internals/contributing.html
+We appreciate all contributions! Refer to `the contributors guide`_ for
+information.
 
 Release signatures
 ==================
@@ -126,3 +65,8 @@
 
 * `498D6B9E <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x102C2C17498D6B9E>`_
 * `5EBA0E07 <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x1425F8CE5EBA0E07>`_
+* `61F0FB52 <https://pgp.mit.edu/pks/lookup?op=vindex&search=0x52C8F72A61F0FB52>`_
+
+.. _the documentation: https://www.sphinx-doc.org/
+.. _the contributors guide: https://www.sphinx-doc.org/en/master/internals/contributing.html
+.. _Python Package Index: https://pypi.org/project/Sphinx/

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_static/conf.py.txt -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/_static/conf.py.txt Changed

@@ -46,18 +46,18 @@
 root_doc = 'index'
 
 # General information about the project.
-project = u'test'
-copyright = u'2016, test'
-author = u'test'
+project = 'test'
+copyright = '2016, test'
+author = 'test'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = u'test'
+version = 'test'
 # The full version, including alpha/beta/rc tags.
-release = u'test'
+release = 'test'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -131,7 +131,7 @@
 # The name for this set of Sphinx documents.
 # "<project> v<release> documentation" by default.
 #
-# html_title = u'test vtest'
+# html_title = 'test vtest'
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
 #
@@ -252,8 +252,8 @@
 # (source start file, target name, title,
 #  author, documentclass howto, manual, or own class).
 latex_documents = 
-    (root_doc, 'test.tex', u'test Documentation',
-     u'test', 'manual'),
+    (root_doc, 'test.tex', 'test Documentation',
+     'test', 'manual'),
 
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -283,7 +283,7 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = 
-    (root_doc, 'test', u'test Documentation',
+    (root_doc, 'test', 'test Documentation',
      author, 1)
 
 
@@ -298,7 +298,7 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = 
-    (root_doc, 'test', u'test Documentation',
+    (root_doc, 'test', 'test Documentation',
      author, 'test', 'One line description of project.',
      'Miscellaneous'),

_service:tar_scm:Sphinx-7.0.1.tar.gz/doc/_templates/contents.html Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/_themes/sphinx13/layout.html Changed

@@ -1,78 +1,60 @@
-{#
-    sphinxdoc/layout.html
-    ~~~~~~~~~~~~~~~~~~~~~
-
-    Sphinx layout template for the sphinxdoc theme.
-
-    :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
+{# Sphinx layout template for the sphinxdoc theme. #}
 {%- extends "basic/layout.html" %}
 
-{# put the sidebar before the body #}
-{% block sidebar1 %}{{ sidebar() }}{% endblock %}
-{% block sidebar2 %}{% endblock %}
-
 {% block extrahead %}
-    <link href='https://fonts.googleapis.com/css?family=Open+Sans:300,400,700'
-          rel='stylesheet' type='text/css' />
 {{ super() }}
-{%- if not embedded %}
-    <style type="text/css">
-      table.right { float: right; margin-left: 20px; }
-      table.right td { border: 1px solid #ccc; }
-      {% if pagename == 'index' %}
-      .related { display: none; }
-      {% endif %}
-    </style>
-    <script>
-      // intelligent scrolling of the sidebar content
-      $(window).scroll(function() {
-        var sb = $('.sphinxsidebarwrapper');
-        var win = $(window);
-        var sbh = sb.height();
-        var offset = $('.sphinxsidebar').position()'top';
-        var wintop = win.scrollTop();
-        var winbot = wintop + win.innerHeight();
-        var curtop = sb.position()'top';
-        var curbot = curtop + sbh;
-        // does sidebar fit in window?
-        if (sbh < win.innerHeight()) {
-          // yes: easy case -- always keep at the top
-          sb.css('top', $u.min($u.max(0, wintop - offset - 10),
-                                $(document).height() - sbh - 200));
-        } else {
-          // no: only scroll if top/bottom edge of sidebar is at
-          // top/bottom edge of window
-          if (curtop > wintop && curbot > winbot) {
-            sb.css('top', $u.max(wintop - offset - 10, 0));
-          } else if (curtop < wintop && curbot < winbot) {
-            sb.css('top', $u.min(winbot - sbh - offset - 20,
-                                  $(document).height() - sbh - 200));
-          }
-        }
-      });
-    </script>
+{%- if not embedded and pagename == 'index' %}
+<style>.related { display: none; }</style>
 {%- endif %}
 {% endblock %}
 
-{% block rootrellink %}
-        <li><a href="{{ pathto('index') }}">Sphinx home</a>&#160;|</li>
-        <li><a href="{{ pathto('contents') }}">Documentation</a> &#187;</li>
-{% endblock %}
-
 {% block header %}
 <div class="pageheader">
+<a href="{{ pathto('index') }}">
+  <img src="{{ pathto('_static/sphinxheader.png', 1) }}" alt="SPHINX" />
+</a>
+</div>
+{% endblock %}
+
+{%- block relbar1 %}
+<div class="related" role="navigation" aria-label="related navigation">
+  <h3>{{ _('Navigation') }}</h3>
   <ul>
-    <li><a href="{{ pathto('index') }}">Home</a></li>
-    <li><a href="{{ pathto('usage/installation') }}">Get it</a></li>
-    <li><a href="{{ pathto('contents') }}">Docs</a></li>
-    <li><a href="{{ pathto('development/index') }}">Extend</a></li>
+    <li><a href="{{ pathto('index') }}">Documentation</a> &raquo;</li>
+    {%- for parent in parents %}
+      <li class="nav-item nav-item-{{ loop.index }}"><a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}>{{ parent.title }}</a>{{ reldelim1 }}</li>
+    {%- endfor %}
+    <li class="nav-item nav-item-this"><a href="{{ link|e }}">{{ title }}</a></li>
   </ul>
-  <div>
-    <a href="{{ pathto('index') }}">
-      <img src="{{ pathto('_static/sphinxheader.png', 1) }}" alt="SPHINX" />
-    </a>
-  </div>
 </div>
 {% endblock %}
+
+{%- block content %}
+<div class="document">
+  <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
+    {%- include "searchfield.html" %}
+    <div class="sphinxsidebar-navigation__contents">
+      <h3>{{ _('On this page') }}</h3>
+      {{ toc }}
+    </div>
+    <div class="sphinxsidebar-navigation__pages">
+      <h3>{{ _('Site navigation') }}</h3>
+      {{ toctree(includehidden=True, maxdepth=3, titles_only=True) }}
+    </div>
+  </div>
+  {%- block document %}
+  <div class="body" role="main">
+    {% block body %}{% endblock %}
+  </div>
+  {%- endblock %}
+</div>
+{%- endblock %}
+
+{%- block relbar2 %}{% endblock %}
+
+{%- block footer %}
+<div class="footer" role="contentinfo">
+  {% trans path=pathto('copyright'), copyright=copyright|e %}&#169; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
+  {% trans sphinx_version=sphinx_version|e %}Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> {{ sphinx_version }}.{% endtrans %}
+</div>
+{%- endblock %}

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/static/sphinx13.css -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/_themes/sphinx13/static/sphinx13.css Changed

@@ -1,187 +1,80 @@
-/*
- * sphinx13.css
- * ~~~~~~~~~~~~
- *
- * Sphinx stylesheet -- sphinx13 theme.
- *
- * :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
+/* Stylesheet for Sphinx's documentation */
 
-@import url("basic.css");
-
-/* -- page layout ----------------------------------------------------------- */
+/* Set master colours */
+:root {
+    --fonts-sans-serif: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+    --colour-sphinx-blue: #0A507A;
+    --colour-text: #333;
+    --colour-links-light: #057;
+}
 
 body {
-    font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
-                 'Verdana', sans-serif;
-    font-size: 14px;
-    text-align: center;
-    background-image: url(bodybg.png);
-    color: black;
-    padding: 0;
-    border-right: 1px solid #0a507a;
-    border-left: 1px solid #0a507a;
-
+    font-family: var(--fonts-sans-serif);
     margin: 0 auto;
-    min-width: 780px;
-    max-width: 1080px;
+    color: var(--colour-text);
 }
 
 .pageheader {
-    background-image: url(headerbg.png);
-    text-align: left;
+    background-color: var(--colour-sphinx-blue);
     padding: 10px 15px;
 }
 
-.pageheader ul {
-    float: right;
-    color: white;
-    list-style-type: none;
-    padding-left: 0;
-    margin-top: 30px;
-    margin-right: 10px;
-}
-
-.pageheader li {
-    float: left;
-    margin: 0 0 0 10px;
-}
-
-.pageheader li a {
-    border-radius: 1px;
-    padding: 8px 12px;
-    color: #f9f9f0;
-    text-shadow: 0 0 5px rgba(0, 0, 0, 0.5);
-}
-
-.pageheader li a:hover {
-    background-color: #f9f9f0;
-    color: #0a507a;
-    text-shadow: none;
-}
-
 div.document {
-    background-color: white;
-    text-align: left;
-}
-
-div.bodywrapper {
-    margin: 0 240px 0 0;
-    border-right: 1px solid #0a507a;
+    display: flex;
+    margin: 0 0.5em;
 }
 
 div.body {
+    border-left: 1px solid var(--colour-sphinx-blue);
     margin: 0;
-    padding: 0.5em 20px 20px 20px;
+    padding: 0.5em 1.75em;
+    min-width: 0;
+    max-width: 800px;
 }
 
 div.related {
-    font-size: 1em;
+    display: flex;
     color: white;
-}
-
-div.related ul {
-    background-image: url(relbg.png);
-    height: 1.9em;
+    background-color: var(--colour-sphinx-blue);
     border-top: 1px solid #002e50;
-    border-bottom: 1px solid #002e50;
 }
 
 div.related ul li {
     margin: 0 5px 0 0;
-    padding: 0;
     float: left;
 }
 
-div.related ul li.right {
-    float: right;
-    margin-right: 5px;
-}
-
 div.related ul li a {
-    margin: 0;
     padding: 0 5px 0 5px;
     line-height: 1.75em;
-    color: #f9f9f0;
-    text-shadow: 0px 0px 1px rgba(0, 0, 0, 0.5);
+    color: white;
 }
 
 div.related ul li a:hover {
-    color: white;
-    /*text-decoration: underline;*/
-    text-shadow: 0px 0px 1px rgba(255, 255, 255, 0.5);
+    text-shadow: 0 0 1px rgba(255, 255, 255, 0.5);
 }
 
 div.sphinxsidebarwrapper {
-    position: relative;
-    top: 0px;
     padding: 0;
 }
 
 div.sphinxsidebar {
+    position: sticky;
+    top: 0;
+    align-self: flex-start;
+    height: 100vh;
+    width: 250px;
+    overflow-y: auto;
+    overflow-wrap: break-word;
     margin: 0;
-    padding: 0 15px 15px 0;
-    width: 210px;
-    float: right;
+    padding-right: 15px;
+    padding-top: 0.5em;
     font-size: 1em;
-    text-align: left;
-    max-height: 0px;
-}
-
-div.sphinxsidebar .logo {
-    font-size: 1.8em;
-    color: #0A507A;
-    font-weight: 300;
-    text-align: center;
-}
-
-div.sphinxsidebar .logo img {
-    vertical-align: middle;
-}
-
-div.sphinxsidebar .download a img {
-    vertical-align: middle;
-}
-
-div.subscribeformwrapper {
-    display: block;
-    overflow: auto;
-    margin-bottom: 1.2em;
-}
-
-div.sphinxsidebar input {
-    border: 1px solid #aaa;
-    font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
-                 'Verdana', sans-serif;
-}
-
-div.sphinxsidebar .subscribeform {
-    margin-top: 0;
-}
-
-div.sphinxsidebar .subscribeform input {
-    border: 1px solid #aaa;
-    font-size: 0.9em;
-    float: left;
-    padding: 0.25em 0.5em;
-    box-sizing: border-box;
-}
-
-div.sphinxsidebar .subscribeform inputtype="text" {
-    width: 60%;
-}
-
-div.sphinxsidebar .subscribeform inputtype="submit" {
-    width: 40%;
-    border-left: none;
 }
 
 div.sphinxsidebar h3 {
     font-size: 1.5em;
-    border-top: 1px solid #0a507a;
-    margin-top: 1em;
+    margin-top: 0;
     margin-bottom: 0.5em;
     padding-top: 0.5em;
 }
@@ -198,12 +91,6 @@
     padding-left: 14px;
     color: #333;
     font-weight: 300;
-    /*text-shadow: 0px 0px 0.5px rgba(0, 0, 0, 0.4);*/
-}
-
-div.sphinxsidebarwrapper > h3:first-child {
-    margin-top: 0.5em;
-    border: none;
 }
 
 div.sphinxsidebar h3 a {
@@ -218,18 +105,40 @@
 }
 
 div.sphinxsidebar ul ul {
-    margin-left: 20px;
-    list-style-image: url(listitem.png);
+    margin-left: 1rem;
+    list-style-type: none;
+    font-size: .9em;
+}
+
+/* De-dent the first list because we hide the top-level item */
+.sphinxsidebar .sphinxsidebar-navigation__contents > ul > li > ul {
+    margin-left: 0;
+}
+
+div.sphinxsidebar p.caption {
+    font-weight: 300;
+    font-size: 1.2rem;
+}
+
+div.sphinxsidebar li.current > a {
+    font-weight: 600;
+}
+
+.sphinxsidebar-navigation__contents > ul > li > a {
+    display: none;
+}
+
+div.sphinxsidebar #searchbox {
+    margin: 12px 0 20px 0;
 }
 
 div.footer {
-    background-image: url(footerbg.png);
+    background-color: var(--colour-sphinx-blue);
     color: #ccc;
     text-shadow: 0 0 .2px rgba(255, 255, 255, 0.8);
-    padding: 3px 8px 3px 0;
+    padding: 3px 8px 3px 8px;
     clear: both;
     font-size: 0.8em;
-    text-align: right;
 }
 
 /* no need to make a visible link to Sphinx on the Sphinx page */
@@ -244,14 +153,10 @@
 }
 
 a {
-    color: #A2881D;
+    color: var(--colour-links-light);
     text-decoration: none;
 }
 
-a:hover {
-    color: #E1C13F;
-}
-
 div.body a {
     text-decoration: underline;
 }
@@ -259,12 +164,18 @@
 h1 {
     margin: 10px 0 0 0;
     font-size: 2.4em;
-    color: #0A507A;
+    color: var(--colour-sphinx-blue);
     font-weight: 300;
 }
 
+h1 span.pre {
+    /* for code in titles */
+    word-break: break-all;
+    white-space: normal;
+}
+
 h2 {
-    margin: 1.em 0 0.2em 0;
+    margin: 1em 0 0.2em 0;
     font-size: 1.5em;
     font-weight: 300;
     padding: 0;
@@ -282,17 +193,16 @@
 }
 
 div.body h1 a tt, div.body h2 a tt, div.body h3 a tt, div.body h4 a tt, div.body h5 a tt, div.body h6 a tt {
-    color: #0A507A !important;
+    color: var(--colour-sphinx-blue) !important;
     font-size: inherit !important;
 }
 
 a.headerlink {
-    color: #0A507A !important;
-    font-size: 12px;
+    color: var(--colour-sphinx-blue) !important;
+    font-size: .8em;
     margin-left: 6px;
     padding: 0 4px 0 4px;
     text-decoration: none !important;
-    float: right;
 }
 
 a.headerlink:hover {
@@ -308,7 +218,7 @@
 cite, code, tt {
     font-family: 'Consolas', 'DejaVu Sans Mono',
                  'Bitstream Vera Sans Mono', monospace;
-    font-size: 14px;
+    font-size: 1em;
     letter-spacing: -0.02em;
 }
 
@@ -335,17 +245,13 @@
 
 a tt {
     border: 0;
-    color: #a2881d;
-}
-
-a tt:hover {
-    color: #e1c13f;
+    color: var(--colour-links-light);
 }
 
 pre {
     font-family: 'Consolas', 'Courier New', 'DejaVu Sans Mono',
                  'Bitstream Vera Sans Mono', monospace;
-    font-size: 13px;
+    font-size: 1em;
     letter-spacing: 0.015em;
     line-height: 120%;
     padding: 0.5em;
@@ -372,7 +278,15 @@
     margin-left: 1em;
 }
 
-div.topic {
+blockquote.epigraph {
+    font-size: 1.5em;
+    padding-left: 1rem;
+    margin-left: 0;
+}
+
+nav.contents,
+div.topic,
+aside.topic {
     background-color: #f8f8f8;
 }
 
@@ -391,11 +305,11 @@
     border: 1px solid #86989B;
     border-radius: 2px;
     background-color: #f7f7f7;
-    padding: 0;
+    padding: 1rem;
 }
 
 div.admonition > p, div.warning > p {
-    margin: 0.5em 1em 0.5em 1em;
+    margin: 0;
     padding: 0;
 }
 
@@ -405,7 +319,6 @@
 
 div.admonition > p.admonition-title,
 div.warning > p.admonition-title {
-    margin-top: 0.5em;
     font-weight: bold;
 }
 
@@ -426,8 +339,7 @@
 }
 
 .viewcode-back {
-    font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
-                 'Verdana', sans-serif;
+    font-family: var(--fonts-sans-serif);
 }
 
 div.viewcode-block:target {
@@ -436,8 +348,15 @@
     border-bottom: 1px solid #ac9;
 }
 
-.contentstable {
-    margin-left: 30px;
-    margin: 0 auto;
-    table-layout: fixed;
+
+/* media queries */
+
+/* Reduce padding & margins for smaller screens */
+@media (max-width: 750px) {
+    .sphinxsidebar {
+        display: none;
+    }
+    div.body {
+        border-left: none;
+    }
 }

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/_themes/sphinx13/theme.conf -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/_themes/sphinx13/theme.conf Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/doc/authors.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/changes.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/changes.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/conf.py Changed

@@ -1,6 +1,8 @@
 # Sphinx documentation build configuration file
 
+import os
 import re
+import time
 
 import sphinx
 
@@ -9,23 +11,25 @@
               'sphinx.ext.intersphinx',
               'sphinx.ext.viewcode', 'sphinx.ext.inheritance_diagram'
 
-root_doc = 'contents'
 templates_path = '_templates'
 exclude_patterns = '_build'
 
 project = 'Sphinx'
-copyright = '2007-2022, Georg Brandl and the Sphinx team'
+copyright = f'2007-{time.strftime("%Y")}, the Sphinx developers'
 version = sphinx.__display_version__
 release = version
 show_authors = True
 
 html_theme = 'sphinx13'
 html_theme_path = '_themes'
+html_css_files = 
+    # 'basic.css',  # included through inheritance from the basic theme
+    'sphinx13.css',
+
 modindex_common_prefix = 'sphinx.'
 html_static_path = '_static'
-html_sidebars = {'index': 'indexsidebar.html', 'searchbox.html'}
 html_title = 'Sphinx documentation'
-html_additional_pages = {'index': 'index.html'}
+html_additional_pages = {'contents': 'contents.html'}
 html_use_opensearch = 'https://www.sphinx-doc.org/en/master'
 html_baseurl = 'https://www.sphinx-doc.org/en/master/'
 html_favicon = '_static/favicon.svg'
@@ -34,7 +38,7 @@
 
 epub_theme = 'epub'
 epub_basename = 'sphinx'
-epub_author = 'Georg Brandl'
+epub_author = 'the Sphinx developers'
 epub_publisher = 'https://www.sphinx-doc.org/'
 epub_uid = 'web-site'
 epub_scheme = 'url'
@@ -43,19 +47,19 @@
 epub_post_files = ('usage/installation.xhtml', 'Installing Sphinx'),
                    ('develop.xhtml', 'Sphinx development')
 epub_exclude_files = '_static/opensearch.xml', '_static/doctools.js',
-                      '_static/jquery.js', '_static/searchtools.js',
-                      '_static/underscore.js', '_static/basic.css',
+                      '_static/searchtools.js',
+                      '_static/sphinx_highlight.js',
+                      '_static/basic.css',
                       '_static/language_data.js',
                       'search.html', '_static/websupport.js'
 epub_fix_images = False
 epub_max_image_width = 0
 epub_show_urls = 'inline'
 epub_use_index = False
-epub_guide = (('toc', 'contents.xhtml', 'Table of Contents'),)
 epub_description = 'Sphinx documentation generator system manual'
 
-latex_documents = ('contents', 'sphinx.tex', 'Sphinx Documentation',
-                    'Georg Brandl', 'manual', 1)
+latex_documents = ('index', 'sphinx.tex', 'Sphinx Documentation',
+                    'the Sphinx developers', 'manual', 1)
 latex_logo = '_static/sphinx.png'
 latex_elements = {
     'fontenc': r'\usepackageLGR,X2,T1{fontenc}',
@@ -66,6 +70,7 @@
 \DeclareUnicodeCharacter{229E}{\ensuremath{\boxplus}}
 \setcounter{tocdepth}{3}%    depth of what main TOC shows (3=subsubsection)
 \setcounter{secnumdepth}{1}% depth of section numbering
+\setlength{\tymin}{2cm}%     avoid too cramped table columns
 ''',
     # fix missing index entry due to RTD doing only once pdflatex after makeindex
     'printindex': r'''
@@ -81,15 +86,15 @@
 autosummary_generate = False
 todo_include_todos = True
 extlinks = {'duref': ('https://docutils.sourceforge.io/docs/ref/rst/'
-                      'restructuredtext.html#%s', ''),
+                      'restructuredtext.html#%s', '%s'),
             'durole': ('https://docutils.sourceforge.io/docs/ref/rst/'
-                       'roles.html#%s', ''),
+                       'roles.html#%s', '%s'),
             'dudir': ('https://docutils.sourceforge.io/docs/ref/rst/'
-                      'directives.html#%s', '')}
+                      'directives.html#%s', '%s')}
 
 man_pages = 
-    ('contents', 'sphinx-all', 'Sphinx documentation generator system manual',
-     'Georg Brandl', 1),
+    ('index', 'sphinx-all', 'Sphinx documentation generator system manual',
+     'the Sphinx developers', 1),
     ('man/sphinx-build', 'sphinx-build', 'Sphinx documentation generator tool',
      '', 1),
     ('man/sphinx-quickstart', 'sphinx-quickstart', 'Sphinx documentation '
@@ -101,14 +106,14 @@
 
 
 texinfo_documents = 
-    ('contents', 'sphinx', 'Sphinx Documentation', 'Georg Brandl',
+    ('index', 'sphinx', 'Sphinx Documentation', 'the Sphinx developers',
      'Sphinx', 'The Sphinx documentation builder.', 'Documentation tools',
      1),
 
 
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3/', None),
-    'requests': ('https://requests.readthedocs.io/en/master', None),
+    'requests': ('https://requests.readthedocs.io/en/latest/', None),
     'readthedocs': ('https://docs.readthedocs.io/en/stable', None),
 }
 
@@ -116,10 +121,67 @@
 locale_dirs = 'locale/'
 gettext_compact = False
 
+nitpick_ignore = {
+    ('cpp:class', 'template<typename TOuter> template<typename TInner> Wrapper::Outer<TOuter>::Inner'),  # NoQA: E501
+    ('cpp:identifier', 'MyContainer'),
+    ('js:func', 'SomeError'),
+    ('js:func', 'number'),
+    ('js:func', 'string'),
+    ('py:attr', 'srcline'),
+    ('py:class', 'Element'),  # sphinx.domains.Domain
+    ('py:class', 'Node'),  # sphinx.domains.Domain
+    ('py:class', 'RoleFunction'),  # sphinx.domains.Domain
+    ('py:class', 'Theme'),  # sphinx.application.TemplateBridge
+    ('py:class', 'TitleGetter'),  # sphinx.domains.Domain
+    ('py:class', 'XRefRole'),  # sphinx.domains.Domain
+    ('py:class', 'docutils.nodes.Element'),
+    ('py:class', 'docutils.nodes.Node'),
+    ('py:class', 'docutils.nodes.NodeVisitor'),
+    ('py:class', 'docutils.nodes.TextElement'),
+    ('py:class', 'docutils.nodes.document'),
+    ('py:class', 'docutils.nodes.system_message'),
+    ('py:class', 'docutils.parsers.Parser'),
+    ('py:class', 'docutils.parsers.rst.states.Inliner'),
+    ('py:class', 'docutils.transforms.Transform'),
+    ('py:class', 'nodes.NodeVisitor'),
+    ('py:class', 'nodes.document'),
+    ('py:class', 'nodes.reference'),
+    ('py:class', 'pygments.lexer.Lexer'),
+    ('py:class', 'sphinx.directives.ObjDescT'),
+    ('py:class', 'sphinx.domains.IndexEntry'),
+    ('py:class', 'sphinx.ext.autodoc.Documenter'),
+    ('py:class', 'sphinx.errors.NoUri'),
+    ('py:class', 'sphinx.roles.XRefRole'),
+    ('py:class', 'sphinx.search.SearchLanguage'),
+    ('py:class', 'sphinx.theming.Theme'),
+    ('py:class', 'sphinxcontrib.websupport.errors.DocumentNotFoundError'),
+    ('py:class', 'sphinxcontrib.websupport.errors.UserNotAuthorizedError'),
+    ('py:exc', 'docutils.nodes.SkipNode'),
+    ('py:exc', 'sphinx.environment.NoUri'),
+    ('py:func', 'setup'),
+    ('py:func', 'sphinx.util.nodes.nested_parse_with_titles'),
+    # Error in sphinxcontrib.websupport.core::WebSupport.add_comment
+    ('py:meth', 'get_comments'),
+    ('py:mod', 'autodoc'),
+    ('py:mod', 'docutils.nodes'),
+    ('py:mod', 'docutils.parsers.rst.directives'),
+    ('py:mod', 'sphinx.ext'),
+    ('py:obj', 'sphinx.util.relative_uri'),
+    ('rst:role', 'c:any'),
+    ('std:confval', 'autodoc_inherit_docstring'),
+    ('std:confval', 'automodule_skip_lines'),
+    ('std:confval', 'autossummary_imported_members'),
+    ('std:confval', 'gettext_language_team'),
+    ('std:confval', 'gettext_last_translator'),
+    ('std:confval', 'globaltoc_collapse'),
+    ('std:confval', 'globaltoc_includehidden'),
+    ('std:confval', 'globaltoc_maxdepth'),
+}
+
 
 # -- Extension interface -------------------------------------------------------
 
-from sphinx import addnodes  # noqa
+from sphinx import addnodes  # noqa: E402
 
 event_sig_re = re.compile(r'(a-zA-Z-+)\s*$(.*)$')
 
@@ -139,24 +201,37 @@
     return name
 
 
+def linkify_issues_in_changelog(app, docname, source):
+    """ Linkify issue references like #123 in changelog to GitHub. """
+
+    if docname == 'changes':
+        changelog_path = os.path.join(os.path.dirname(__file__), "../CHANGES")
+        # this path trickery is needed because this script can
+        # be invoked with different working directories:
+        # * running make in docs/
+        # * running tox -e docs in the repo root dir
+
+        with open(changelog_path, encoding="utf-8") as f:
+            changelog = f.read()
+
+        def linkify(match):
+            url = 'https://github.com/sphinx-doc/sphinx/issues/' + match1
+            return f'`{match0} <{url}>`_'
+
+        linkified_changelog = re.sub(r'(?:PR)?#(0-9+)\b', linkify, changelog)
+
+        source0 = source0.replace('.. include:: ../CHANGES', linkified_changelog)
+
+
 def setup(app):
     from sphinx.ext.autodoc import cut_lines
     from sphinx.util.docfields import GroupedField
     app.connect('autodoc-process-docstring', cut_lines(4, what='module'))
+    app.connect('source-read', linkify_issues_in_changelog)
     app.add_object_type('confval', 'confval',
                         objname='configuration value',
                         indextemplate='pair: %s; configuration value')
-    app.add_object_type('setuptools-confval', 'setuptools-confval',
-                        objname='setuptools configuration value',
-                        indextemplate='pair: %s; setuptools configuration value')
     fdesc = GroupedField('parameter', label='Parameters',
                          names='param', can_collapse=True)
     app.add_object_type('event', 'event', 'pair: %s; event', parse_event,
                         doc_field_types=fdesc)
-
-    # workaround for RTD
-    from sphinx.util import logging
-    logger = logging.getLogger(__name__)
-    app.info = lambda *args, **kwargs: logger.info(*args, **kwargs)
-    app.warn = lambda *args, **kwargs: logger.warning(*args, **kwargs)
-    app.debug = lambda *args, **kwargs: logger.debug(*args, **kwargs)

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/overview.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/overview.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/templating.rst Added

@@ -0,0 +1,478 @@
+.. highlight:: html+jinja
+
+.. _templating:
+
+==========
+Templating
+==========
+
+Sphinx uses the `Jinja <https://jinja.palletsprojects.com/>`_ templating engine
+for its HTML templates.  Jinja is a text-based engine, inspired by Django
+templates, so anyone having used Django will already be familiar with it. It
+also has excellent documentation for those who need to make themselves familiar
+with it.
+
+
+Do I need to use Sphinx's templates to produce HTML?
+----------------------------------------------------
+
+No.  You have several other options:
+
+* You can write a :class:`~sphinx.application.TemplateBridge` subclass that
+  calls your template engine of choice, and set the :confval:`template_bridge`
+  configuration value accordingly.
+
+* You can :ref:`write a custom builder <writing-builders>` that derives from
+  :class:`~sphinx.builders.html.StandaloneHTMLBuilder` and calls your template
+  engine of choice.
+
+* You can use the :class:`~sphinxcontrib.serializinghtml.PickleHTMLBuilder` that
+  produces pickle files with the page contents, and postprocess them using a
+  custom tool, or use them in your Web application.
+
+
+Jinja/Sphinx Templating Primer
+------------------------------
+
+The default templating language in Sphinx is Jinja.  It's Django/Smarty inspired
+and easy to understand.  The most important concept in Jinja is :dfn:`template
+inheritance`, which means that you can overwrite only specific blocks within a
+template, customizing it while also keeping the changes at a minimum.
+
+To customize the output of your documentation you can override all the templates
+(both the layout templates and the child templates) by adding files with the
+same name as the original filename into the template directory of the structure
+the Sphinx quickstart generated for you.
+
+Sphinx will look for templates in the folders of :confval:`templates_path`
+first, and if it can't find the template it's looking for there, it falls back
+to the selected theme's templates.
+
+A template contains **variables**, which are replaced with values when the
+template is evaluated, **tags**, which control the logic of the template and
+**blocks** which are used for template inheritance.
+
+Sphinx's *basic* theme provides base templates with a couple of blocks it will
+fill with data.  These are located in the :file:`themes/basic` subdirectory of
+the Sphinx installation directory, and used by all builtin Sphinx themes.
+Templates with the same name in the :confval:`templates_path` override templates
+supplied by the selected theme.
+
+For example, to add a new link to the template area containing related links all
+you have to do is to add a new template called ``layout.html`` with the
+following contents::
+
+    {% extends "!layout.html" %}
+    {% block rootrellink %}
+        <li><a href="https://project.invalid/">Project Homepage</a> &raquo;</li>
+        {{ super() }}
+    {% endblock %}
+
+By prefixing the name of the overridden template with an exclamation mark,
+Sphinx will load the layout template from the underlying HTML theme.
+
+.. important::
+   If you override a block, call ``{{ super() }}`` somewhere to render the
+   block's original content in the extended template -- unless you don't want
+   that content to show up.
+
+
+Working with the builtin templates
+----------------------------------
+
+The builtin **basic** theme supplies the templates that all builtin Sphinx
+themes are based on.  It has the following elements you can override or use:
+
+Blocks
+~~~~~~
+
+The following blocks exist in the ``layout.html`` template:
+
+``doctype``
+    The doctype of the output format.  By default this is XHTML 1.0 Transitional
+    as this is the closest to what Sphinx and Docutils generate and it's a good
+    idea not to change it unless you want to switch to HTML 5 or a different but
+    compatible XHTML doctype.
+
+``linktags``
+    This block adds a couple of ``<link>`` tags to the head section of the
+    template.
+
+``extrahead``
+    This block is empty by default and can be used to add extra contents into
+    the ``<head>`` tag of the generated HTML file.  This is the right place to
+    add references to JavaScript or extra CSS files.
+
+``relbar1``, ``relbar2``
+    This block contains the *relation bar*, the list of related links (the
+    parent documents on the left, and the links to index, modules etc. on the
+    right).  ``relbar1`` appears before the document, ``relbar2`` after the
+    document.  By default, both blocks are filled; to show the relbar only
+    before the document, you would override `relbar2` like this::
+
+       {% block relbar2 %}{% endblock %}
+
+``rootrellink``, ``relbaritems``
+    Inside the relbar there are three sections: The ``rootrellink``, the links
+    from the documentation and the custom ``relbaritems``.  The ``rootrellink``
+    is a block that by default contains a list item pointing to the root
+    document by default, the ``relbaritems`` is an empty block.  If you
+    override them to add extra links into the bar make sure that they are list
+    items and end with the :data:`reldelim1`.
+
+``document``
+    The contents of the document itself.  It contains the block "body" where
+    the individual content is put by subtemplates like ``page.html``.
+
+    .. note::
+        In order for the built-in JavaScript search to show a page preview on
+        the results page, the document or body content should be wrapped in an
+        HTML element containing the ``role="main"`` attribute. For example::
+
+            <div role="main">
+              {% block document %}{% endblock %}
+            </div>
+
+``sidebar1``, ``sidebar2``
+    A possible location for a sidebar.  ``sidebar1`` appears before the document
+    and is empty by default, ``sidebar2`` after the document and contains the
+    default sidebar.  If you want to swap the sidebar location override this and
+    call the ``sidebar`` helper::
+
+        {% block sidebar1 %}{{ sidebar() }}{% endblock %}
+        {% block sidebar2 %}{% endblock %}
+
+    (The ``sidebar2`` location for the sidebar is needed by the ``sphinxdoc.css``
+    stylesheet, for example.)
+
+``sidebarlogo``
+    The logo location within the sidebar.  Override this if you want to place
+    some content at the top of the sidebar.
+
+``footer``
+    The block for the footer div.  If you want a custom footer or markup before
+    or after it, override this one.
+
+The following four blocks are *only* used for pages that do not have assigned a
+list of custom sidebars in the :confval:`html_sidebars` config value.  Their use
+is deprecated in favor of separate sidebar templates, which can be included via
+:confval:`html_sidebars`.
+
+``sidebartoc``
+    The table of contents within the sidebar.
+
+    .. deprecated:: 1.0
+
+``sidebarrel``
+    The relation links (previous, next document) within the sidebar.
+
+    .. deprecated:: 1.0
+
+``sidebarsourcelink``
+    The "Show source" link within the sidebar (normally only shown if this is
+    enabled by :confval:`html_show_sourcelink`).
+
+    .. deprecated:: 1.0
+
+``sidebarsearch``
+    The search box within the sidebar.  Override this if you want to place some
+    content at the bottom of the sidebar.
+
+    .. deprecated:: 1.0
+
+
+Configuration Variables
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Inside templates you can set a couple of variables used by the layout template
+using the ``{% set %}`` tag:
+
+.. data:: reldelim1
+
+   The delimiter for the items on the left side of the related bar.  This
+   defaults to ``' &raquo;'`` Each item in the related bar ends with the value
+   of this variable.
+
+.. data:: reldelim2
+
+   The delimiter for the items on the right side of the related bar.  This
+   defaults to ``' |'``.  Each item except of the last one in the related bar
+   ends with the value of this variable.
+
+Overriding works like this::
+
+   {% extends "!layout.html" %}
+   {% set reldelim1 = ' &gt;' %}
+
+.. data:: script_files
+
+   Add additional script files here, like this::
+
+      {% set script_files = script_files + "_static/myscript.js" %}
+
+   .. deprecated:: 1.8.0
+
+      Please use ``.Sphinx.add_js_file()`` instead.
+
+Helper Functions
+~~~~~~~~~~~~~~~~
+
+Sphinx provides various Jinja functions as helpers in the template.  You can use
+them to generate links or output multiply used elements.
+
+.. function:: pathto(document)
+
+   Return the path to a Sphinx document as a URL.  Use this to refer to built
+   documents.
+
+.. function:: pathto(file, 1)
+   :noindex:
+
+   Return the path to a *file* which is a filename relative to the root of the
+   generated output.  Use this to refer to static files.
+
+.. function:: hasdoc(document)
+
+   Check if a document with the name *document* exists.
+
+.. function:: sidebar()
+
+   Return the rendered sidebar.
+
+.. function:: relbar()
+
+   Return the rendered relation bar.
+
+.. function:: warning(message)
+
+   Emit a warning message.
+
+Global Variables
+~~~~~~~~~~~~~~~~
+
+These global variables are available in every template and are safe to use.
+There are more, but most of them are an implementation detail and might change
+in the future.
+
+.. data:: builder
+
+   The name of the builder (e.g. ``html`` or ``htmlhelp``).
+
+.. data:: copyright
+
+   The value of :confval:`copyright`.
+
+.. data:: docstitle
+
+   The title of the documentation (the value of :confval:`html_title`), except
+   when the "single-file" builder is used, when it is set to ``None``.
+
+.. data:: embedded
+
+   True if the built HTML is meant to be embedded in some viewing application
+   that handles navigation, not the web browser, such as for HTML help or Qt
+   help formats.  In this case, the sidebar is not included.
+
+.. data:: favicon_url
+
+   The relative path to the HTML favicon image from the current document, or
+   URL to the favicon, or ``''``.
+
+   .. versionadded:: 4.0
+
+.. data:: file_suffix
+
+   The value of the builder's :attr:`~.SerializingHTMLBuilder.out_suffix`
+   attribute, i.e. the file name extension that the output files will get.  For
+   a standard HTML builder, this is usually ``.html``.
+
+.. data:: has_source
+
+   True if the reST document sources are copied (if :confval:`html_copy_source`
+   is ``True``).
+
+.. data:: language
+
+   The value of :confval:`language`.
+
+.. data:: last_updated
+
+   The build date.
+
+.. data:: logo_url
+
+   The relative path to the HTML logo image from the current document, or URL
+   to the logo, or ``''``.
+
+   .. versionadded:: 4.0
+
+.. data:: master_doc
+
+   Same as :data:`root_doc`.
+
+   .. versionchanged:: 4.0
+
+      Renamed to ``root_doc``.
+
+.. data:: root_doc
+
+   The value of :confval:`root_doc`, for usage with :func:`pathto`.
+
+   .. versionchanged:: 4.0
+
+      Renamed from ``master_doc``.
+
+.. data:: pagename
+
+   The "page name" of the current file, i.e. either the document name if the
+   file is generated from a reST source, or the equivalent hierarchical name
+   relative to the output directory
+   (``directory/filename_without_extension``).
+
+.. data:: project
+
+   The value of :confval:`project`.
+
+.. data:: release
+
+   The value of :confval:`release`.
+
+.. data:: rellinks
+
+   A list of links to put at the left side of the relbar, next to "next" and
+   "prev".  This usually contains links to the general index and other indices,
+   such as the Python module index.  If you add something yourself, it must be a
+   tuple ``(pagename, link title, accesskey, link text)``.
+
+.. data:: shorttitle
+
+   The value of :confval:`html_short_title`.
+
+.. data:: show_source
+
+   True if :confval:`html_show_sourcelink` is ``True``.
+
+.. data:: sphinx_version
+
+   The version of Sphinx used to build represented as a string for example "3.5.1".
+
+.. data:: sphinx_version_tuple
+
+   The version of Sphinx used to build represented as a tuple of five elements.
+   For Sphinx version 3.5.1 beta 3 this would be ``(3, 5, 1, 'beta', 3)``.
+   The fourth element can be one of: ``alpha``, ``beta``, ``rc``, ``final``.
+   ``final`` always has 0 as the last element.
+
+   .. versionadded:: 4.2
+
+.. data:: docutils_version_info
+
+   The version of Docutils used to build represented as a tuple of five elements.
+   For Docutils version 0.16.1 beta 2 this would be ``(0, 16, 1, 'beta', 2)``.
+   The fourth element can be one of: ``alpha``, ``beta``, ``candidate``, ``final``.
+   ``final`` always has 0 as the last element.
+
+   .. versionadded:: 5.0.2
+
+.. data:: styles
+
+   A list of the names of the main stylesheets as given by the theme or
+   :confval:`html_style`.
+
+   .. versionadded:: 5.1
+
+.. data:: title
+
+   The title of the current document, as used in the ``<title>`` tag.
+
+.. data:: use_opensearch
+
+   The value of :confval:`html_use_opensearch`.
+
+.. data:: version
+
+   The value of :confval:`version`.
+
+
+In addition to these values, there are also all **theme options** available
+(prefixed by ``theme_``), as well as the values given by the user in
+:confval:`html_context`.
+
+In documents that are created from source files (as opposed to
+automatically-generated files like the module index, or documents that already
+are in HTML form), these variables are also available:
+
+.. data:: body
+
+   A string containing the content of the page in HTML form as produced by the
+   HTML builder, before the theme is applied.
+
+.. data:: display_toc
+
+   A boolean that is True if the toc contains more than one entry.
+
+.. data:: meta
+
+   Document metadata (a dictionary), see :ref:`metadata`.
+
+.. data:: metatags
+
+   A string containing the page's HTML :dudir:`meta` tags.
+
+.. data:: next
+
+   The next document for the navigation.  This variable is either false or has
+   two attributes `link` and `title`.  The title contains HTML markup.  For
+   example, to generate a link to the next page, you can use this snippet::
+
+      {% if next %}
+      <a href="{{ next.link|e }}">{{ next.title }}</a>
+      {% endif %}
+
+.. data:: page_source_suffix
+
+   The suffix of the file that was rendered. Since we support a list of
+   :confval:`source_suffix`, this will allow you to properly link to the
+   original source file.
+
+.. data:: parents
+
+   A list of parent documents for navigation, structured like the :data:`next`
+   item.
+
+.. data:: prev
+
+   Like :data:`next`, but for the previous page.
+
+.. data:: sourcename
+
+   The name of the copied source file for the current document.  This is only
+   nonempty if the :confval:`html_copy_source` value is ``True``.
+   This has empty value on creating automatically-generated files.
+
+.. data:: toc
+
+   The local table of contents for the current page, rendered as HTML bullet
+   lists.
+
+.. data:: toctree
+
+   A callable yielding the global TOC tree containing the current page, rendered
+   as HTML bullet lists.  Optional keyword arguments:
+
+   ``collapse``
+     If true, all TOC entries that are not ancestors of the current page are
+     collapsed.
+     ``True`` by default.
+
+   ``maxdepth``
+     The maximum depth of the tree. Set it to ``-1`` to allow unlimited depth.
+     Defaults to the max depth selected in the toctree directive.
+
+   ``titles_only``
+     If true, put only top-level document titles in the tree.
+     ``False`` by default.
+
+   ``includehidden``
+     If true, the ToC tree will also contain hidden entries.
+     ``False`` by default.

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/theming.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/theming.rst Changed

@@ -36,7 +36,7 @@
   output static directory on build.  These can be images, styles, script files.
 
 The :file:`theme.conf` file is in INI format 1_ (readable by the standard
-Python :mod:`ConfigParser` module) and has the following structure:
+Python :mod:`configparser` module) and has the following structure:
 
 .. sourcecode:: ini
 
@@ -56,10 +56,10 @@
   want to also inherit the stylesheet, include it via CSS' ``@import`` in your
   own.
 
-* The **stylesheet** setting gives the name of a CSS file which will be
-  referenced in the HTML header.  If you need more than one CSS file, either
-  include one from the other via CSS' ``@import``, or use a custom HTML template
-  that adds ``<link rel="stylesheet">`` tags as necessary.  Setting the
+* The **stylesheet** setting gives a list of CSS filenames separated commas which
+  will be referenced in the HTML header.  You can also use CSS' ``@import``
+  technique to include one from the other, or use a custom HTML template that
+  adds ``<link rel="stylesheet">`` tags as necessary.  Setting the
   :confval:`html_style` config value will override this setting.
 
 * The **pygments_style** setting gives the name of a Pygments style to use for
@@ -69,7 +69,7 @@
 * The **pygments_dark_style** setting gives the name of a Pygments style to use
   for highlighting when the CSS media query ``(prefers-color-scheme: dark)``
   evaluates to true. It is injected into the page using
-  :meth:`~Sphinx.add_css_file()`.
+  :meth:`~sphinx.application.Sphinx.add_css_file()`.
 
 * The **sidebars** setting gives the comma separated list of sidebar templates
   for constructing sidebars.  This can be overridden by the user in the
@@ -82,14 +82,17 @@
 .. versionadded:: 1.7
    sidebar settings
 
+.. versionchanged:: 5.1
+
+   The stylesheet setting accepts multiple CSS filenames
 
 .. _distribute-your-theme:
 
 Distribute your theme as a Python package
 -----------------------------------------
 
-As a way to distribute your theme, you can use Python package.  Python package
-brings to users easy setting up ways.
+As a way to distribute your theme, you can use a Python package.  This makes it
+easier for users to set up your theme.
 
 To distribute your theme as a Python package, please define an entry point
 called ``sphinx.html_themes`` in your ``setup.py`` file, and write a ``setup()``
@@ -128,7 +131,7 @@
 Templating
 ----------
 
-The :doc:`guide to templating </templating>` is helpful if you want to write your
+The :doc:`guide to templating <templating>` is helpful if you want to write your
 own templates.  What is important to keep in mind is the order in which Sphinx
 searches for templates:
 
@@ -157,7 +160,7 @@
 template engine.  The ``_t`` will be left from the final file name.  For
 example, the *classic* theme has a file ``static/classic.css_t`` which uses
 templating to put the color options into the stylesheet.  When a documentation
-is built with the classic theme, the output directory will contain a
+project is built with the classic theme, the output directory will contain a
 ``_static/classic.css`` file where all template tags have been processed.
 
 
@@ -248,11 +251,11 @@
 Add your own static files to the build assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you are packaging your own build assets with an extension
-(e.g., a CSS or JavaScript file), you need to ensure that they are placed
-in the ``_static/`` folder of HTML outputs. To do so, you may copy them directly
-into a build's ``_static/`` folder at build time, generally via an event hook.
-Here is some sample code to accomplish this:
+By default, Sphinx copies static files on the ``static/`` directory of the template
+directory.  However, if your package needs to place static files outside of the
+``static/`` directory for some reasons, you need to copy them to the ``_static/``
+directory of HTML outputs manually at the build via an event hook.  Here is an
+example of code to accomplish this:
 
 .. code-block:: python
 
@@ -265,7 +268,7 @@
            copy_asset_file('path/to/myextension/_static/myjsfile.js', staticdir)
 
    def setup(app):
-       app.connect('builder-inited', copy_custom_files)
+       app.connect('build-finished', copy_custom_files)
 
 
 Inject JavaScript based on user configuration
@@ -303,7 +306,7 @@
 
 See :ref:`theming-static-templates` for more information.
 
-Second, you may use the :meth:`Sphinx.add_js_file` method without pointing it
+Second, you may use the :meth:`.Sphinx.add_js_file` method without pointing it
 to a file. Normally, this method is used to insert a new JavaScript file
 into your site. However, if you do *not* pass a file path, but instead pass
 a string to the "body" argument, then this text will be inserted as JavaScript
@@ -325,7 +328,7 @@
     # We connect this function to the step after the builder is initialized
     def setup(app):
         # Tell Sphinx about this configuration variable
-        app.add_config_value('my_javascript_variable')
+        app.add_config_value('my_javascript_variable', 0, 'html')
         # Run the function after the builder is initialized
         app.connect('builder-inited', add_js_variable)

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/autodoc_ext.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/autodoc_ext.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/examples/autodoc_intenum.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/examples/autodoc_intenum.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/examples/recipe.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/examples/recipe.py Changed

@@ -102,14 +102,14 @@
     name = 'recipe'
     label = 'Recipe Sample'
     roles = {
-        'ref': XRefRole()
+        'ref': XRefRole(),
     }
     directives = {
         'recipe': RecipeDirective,
     }
     indices = {
         RecipeIndex,
-        IngredientIndex
+        IngredientIndex,
     }
     initial_data = {
         'recipes': ,  # object list
@@ -117,11 +117,10 @@
     }
 
     def get_full_qualified_name(self, node):
-        return '{}.{}'.format('recipe', node.arguments0)
+        return f'recipe.{node.arguments0}'
 
     def get_objects(self):
-        for obj in self.data'recipes':
-            yield(obj)
+        yield from self.data'recipes'
 
     def resolve_xref(self, env, fromdocname, builder, typ, target, node,
                      contnode):
@@ -141,8 +140,8 @@
 
     def add_recipe(self, signature, ingredients):
         """Add a new recipe to the domain."""
-        name = '{}.{}'.format('recipe', signature)
-        anchor = 'recipe-{}'.format(signature)
+        name = f'recipe.{signature}'
+        anchor = f'recipe-{signature}'
 
         self.data'recipe_ingredients'name = ingredients
         # name, dispname, type, docname, anchor, priority

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/examples/todo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/examples/todo.py Changed

@@ -70,7 +70,7 @@
 
 def process_todo_nodes(app, doctree, fromdocname):
     if not app.config.todo_include_todos:
-        for node in doctree.traverse(todo):
+        for node in doctree.findall(todo):
             node.parent.remove(node)
 
     # Replace all todolist nodes with a list of the collected todos.
@@ -80,7 +80,7 @@
     if not hasattr(env, 'todo_all_todos'):
         env.todo_all_todos = 
 
-    for node in doctree.traverse(todolist):
+    for node in doctree.findall(todolist):
         if not app.config.todo_include_todos:
             node.replace_self()
             continue
@@ -93,7 +93,7 @@
             description = (
                 _('(The original entry is located in %s, line %d and can be found ') %
                 (filename, todo_info'lineno'))
-            para += nodes.Text(description, description)
+            para += nodes.Text(description)
 
             # Create a reference
             newnode = nodes.reference('', '')
@@ -104,7 +104,7 @@
             newnode'refuri' += '#' + todo_info'target''refid'
             newnode.append(innernode)
             para += newnode
-            para += nodes.Text('.)', '.)')
+            para += nodes.Text('.)')
 
             # Insert into the todolist
             content.append(todo_info'todo')

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/helloworld.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/helloworld.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/recipe.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/recipe.rst Changed

@@ -85,7 +85,7 @@
 for describing things like classes, functions, or, in our case, recipes. More
 specifically, ``handle_signature`` implements parsing the signature of the
 directive and passes on the object's name and type to its superclass, while
-``add_taget_and_index`` adds a target (to link to) and an entry to the index
+``add_target_and_index`` adds a target (to link to) and an entry to the index
 for this node.
 
 We also see that this directive defines ``has_content``, ``required_arguments``
@@ -122,9 +122,10 @@
 'rec-TomatoSoup',...)``. Refer to the :doc:`domain API guide
 </extdev/domainapi>` for more information on this API.
 
-These index pages can be referred by combination of domain name and its
-``name`` using :rst:role:`ref` role.  For example, ``RecipeIndex`` can be
-referred by ``:ref:`recipe-recipe```.
+These index pages can be referenced with the :rst:role:`ref` role by combining
+the domain name and the index ``name`` value. For example, ``RecipeIndex`` can be
+referenced with ``:ref:`recipe-recipe``` and ``IngredientIndex`` can be referenced
+with ``:ref:`recipe-ingredient```.
 
 .. rubric:: The domain
 
@@ -152,7 +153,7 @@
 ``initial_data`` will be copied to ``env.domaindatadomain_name`` as the
 initial data of the domain, and domain instances can access it via
 ``self.data``. We see that we have defined two items in ``initial_data``:
-``recipes`` and ``recipe2ingredient``. These contain a list of all objects
+``recipes`` and ``recipe_ingredients``. Each contains a list of all objects
 defined (i.e. all recipes) and a hash that maps a canonical ingredient name to
 the list of objects. The way we name objects is common across our extension and
 is defined in the ``get_full_qualified_name`` method. For each object created,
@@ -214,7 +215,7 @@
 
 The important things to note are the use of the ``:recipe:ref:`` role to
 cross-reference the recipe actually defined elsewhere (using the
-``:recipe:recipe:`` directive.
+``:recipe:recipe:`` directive).
 
 
 Further reading

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/development/tutorials/todo.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/development/tutorials/todo.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/appapi.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/appapi.rst Changed

@@ -278,16 +278,16 @@
    Emitted when a cross-reference to an object cannot be resolved.
    If the event handler can resolve the reference, it should return a
    new docutils node to be inserted in the document tree in place of the node
-   *node*.  Usually this node is a :class:`reference` node containing *contnode*
-   as a child.
+   *node*.  Usually this node is a :class:`~nodes.reference` node containing
+   *contnode* as a child.
    If the handler can not resolve the cross-reference,
    it can either return ``None`` to let other handlers try,
-   or raise :class:`NoUri` to prevent other handlers in trying and suppress
-   a warning about this cross-reference being unresolved.
+   or raise :class:`~sphinx.errors.NoUri` to prevent other handlers in
+   trying and suppress a warning about this cross-reference being unresolved.
 
    :param env: The build environment (``app.builder.env``).
-   :param node: The :class:`pending_xref` node to be resolved.  Its attributes
-      ``reftype``, ``reftarget``, ``modname`` and ``classname`` attributes
+   :param node: The :class:`~sphinx.addnodes.pending_xref` node to be resolved.
+      Its ``reftype``, ``reftarget``, ``modname`` and ``classname`` attributes
       determine the type and target of the reference.
    :param contnode: The node that carries the text and formatting inside the
       future reference and should be a child of the returned reference node.
@@ -298,7 +298,9 @@
 
    Emitted when a cross-reference to an object cannot be resolved even after
    :event:`missing-reference`.  If the event handler can emit warnings for
-   the missing reference, it should return ``True``.
+   the missing reference, it should return ``True``. The configuration variables
+   :confval:`nitpick_ignore` and :confval:`nitpick_ignore_regex` prevent the
+   event from being emitted for the corresponding nodes.
 
    .. versionadded:: 3.4
 
@@ -328,8 +330,8 @@
 
 .. event:: env-updated (app, env)
 
-   Emitted when the :meth:`update` method of the build environment has
-   completed, that is, the environment and all doctrees are now up-to-date.
+   Emitted after reading all documents, when the environment and all
+   doctrees are now up-to-date.
 
    You can return an iterable of docnames from the handler.  These documents
    will then be considered updated, and will be (re-)written during the writing

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/deprecated.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/deprecated.rst Changed

@@ -10,7 +10,7 @@
 
 The following is a list of deprecated interfaces.
 
-.. tabularcolumns:: |>{\raggedright}\Y{.4}|>{\centering}\Y{.1}|>{\centering}\Y{.12}|>{\raggedright\arraybackslash}\Y{.38}|
+.. tabularcolumns:: >{\raggedright}\Y{.4}>{\centering}\Y{.1}>{\sphinxcolorblend{!95!red}\centering\noindent\bfseries\color{red}}\Y{.12}>{\raggedright\arraybackslash}\Y{.38}
 
 .. list-table:: deprecated APIs
    :header-rows: 1
@@ -19,9 +19,134 @@
 
    * - Target
      - Deprecated
-     - (will be) Removed
+     - Removed
      - Alternatives
 
+   * - ``sphinx.util.osutil.cd``
+     - 6.2
+     - 8.0
+     - ``contextlib.chdir``
+
+   * - ``sphinx.util.save_traceback``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.exceptions.save_traceback``
+
+   * - ``sphinx.util.format_exception_cut_frames``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.exceptions.format_exception_cut_frames``
+
+   * - ``sphinx.util.epoch_to_rfc1123``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.http_date.epoch_to_rfc1123``
+
+   * - ``sphinx.util.rfc1123_to_epoch``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.http_date.rfc1123_to_epoch``
+
+   * - ``sphinx.util.status_iterator``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.display.status_iterator``
+
+   * - ``sphinx.util.display_chunk``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.display.display_chunk``
+
+   * - ``sphinx.util.SkipProgressMessage``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.display.SkipProgressMessage``
+
+   * - ``sphinx.util.progress_message``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.display.progress_message``
+
+   * - ``sphinx.util.typing.stringify``
+     - 6.1
+     - 8.0
+     - ``sphinx.util.typing.stringify_annotation``
+
+   * - HTML 4 support
+     - 5.2
+     - 7.0
+     - N/A
+
+   * - ``sphinx.util.path_stabilize``
+     - 5.1
+     - 7.0
+     - ``sphinx.util.osutil.path_stabilize``
+
+   * - ``sphinx.util.get_matching_files``
+     - 5.1
+     - 7.0
+     - ``sphinx.util.matching.get_matching_files``
+
+   * - ``sphinx.ext.napoleon.iterators``
+     - 5.1
+     - 7.0
+     - ``pockets.iterators``
+
+   * - ``sphinx.util.stemmer``
+     - 5.1
+     - 7.0
+     - ``snowballstemmer``
+
+   * - ``sphinx.util.jsdump``
+     - 5.0
+     - 7.0
+     - The standard library ``json`` module.
+
+   * - The Setuptools integration (``setup.py build_sphinx``)
+     - 5.0
+     - 7.0
+     - N/A
+
+   * - The ``locale`` argument of ``sphinx.util.i18n:babel_format_date()``
+     - 5.0
+     - 7.0
+     - N/A
+
+   * - The ``language`` argument of ``sphinx.util.i18n:format_date()``
+     - 5.0
+     - 7.0
+     - N/A
+
+   * - ``sphinx.builders.html.html5_ready``
+     - 5.0
+     - 7.0
+     - N/A
+
+   * - ``sphinx.io.read_doc()``
+     - 5.0
+     - 7.0
+     - ``sphinx.builders.Builder.read_doc()``
+
+   * - ``sphinx.util.docutils.__version_info__``
+     - 5.0
+     - 7.0
+     - ``docutils.__version_info__``
+
+   * - ``sphinx.util.docutils.is_html5_writer_available()``
+     - 5.0
+     - 7.0
+     - N/A
+
+   * - ``sphinx.writers.latex.LaTeXWriter.docclasses``
+     - 5.0
+     - 7.0
+     - N/A
+
+   * - ``sphinx.ext.napoleon.docstring.GoogleDocstring._qualify_name()``
+     - 4.5
+     - 6.0
+     - N/A
+
    * - ``sphinx.ext.autodoc.AttributeDocumenter._datadescriptor``
      - 4.3
      - 6.0
@@ -69,12 +194,12 @@
 
    * - ``favicon`` variable in HTML templates
      - 4.0
-     - TBD
+     - 6.0
      - ``favicon_url``
 
    * - ``logo`` variable in HTML templates
      - 4.0
-     - TBD
+     - 6.0
      - ``logo_url``
 
    * - ``sphinx.directives.patches.ListTable``
@@ -774,7 +899,7 @@
      - ``sphinx.domains.std.StandardDomain.process_doc()``
 
    * - ``sphinx.domains.js.JSObject.display_prefix``
-     - 
+     -
      - 4.3
      - ``sphinx.domains.js.JSObject.get_display_prefix()``
 
@@ -1230,17 +1355,17 @@
      - 4.0
      - N/A
 
-   * - :rst:dir:`highlightlang`
+   * - :rst:dir:`!highlightlang`
      - 1.8
      - 4.0
      - :rst:dir:`highlight`
 
-   * - :meth:`~sphinx.application.Sphinx.add_stylesheet()`
+   * - :meth:`!add_stylesheet`
      - 1.8
      - 6.0
      - :meth:`~sphinx.application.Sphinx.add_css_file()`
 
-   * - :meth:`~sphinx.application.Sphinx.add_javascript()`
+   * - :meth:`!add_javascript()`
      - 1.8
      - 4.0
      - :meth:`~sphinx.application.Sphinx.add_js_file()`
@@ -1342,7 +1467,7 @@
      - 3.0
      - ``sphinx.builders.latex.nodes.math_reference``
 
-   * - ``viewcode_import`` (config value)
+   * - :confval:`!viewcode_import` (config value)
      - 1.8
      - 3.0
      - :confval:`viewcode_follow_imported_members`
@@ -1700,7 +1825,7 @@
    * - ``StandaloneHTMLBuilder.css_files``
      - 1.6
      - 2.0
-     - :meth:`~sphinx.application.Sphinx.add_stylesheet()`
+     - :meth:`!add_stylesheet`
 
    * - ``document.settings.gettext_compact``
      - 1.8

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/domainapi.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/domainapi.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/index.rst Changed

@@ -1,7 +1,7 @@
 .. _dev-extensions:
 
-Developing extensions for Sphinx
-================================
+Sphinx Extensions API
+=====================
 
 Since many projects will need special features in their documentation, Sphinx
 is designed to be extensible on several levels.
@@ -97,49 +97,49 @@
 
 **Phase 0: Initialization**
 
-   In this phase, almost nothing of interest to us happens.  The source
-   directory is searched for source files, and extensions are initialized.
-   Should a stored build environment exist, it is loaded, otherwise a new one is
-   created.
+In this phase, almost nothing of interest to us happens.  The source
+directory is searched for source files, and extensions are initialized.
+Should a stored build environment exist, it is loaded, otherwise a new one is
+created.
 
 **Phase 1: Reading**
 
-   In Phase 1, all source files (and on subsequent builds, those that are new or
-   changed) are read and parsed.  This is the phase where directives and roles
-   are encountered by docutils, and the corresponding code is executed.  The
-   output of this phase is a *doctree* for each source file; that is a tree of
-   docutils nodes.  For document elements that aren't fully known until all
-   existing files are read, temporary nodes are created.
+In Phase 1, all source files (and on subsequent builds, those that are new or
+changed) are read and parsed.  This is the phase where directives and roles
+are encountered by docutils, and the corresponding code is executed.  The
+output of this phase is a *doctree* for each source file; that is a tree of
+docutils nodes.  For document elements that aren't fully known until all
+existing files are read, temporary nodes are created.
 
-   There are nodes provided by docutils, which are documented `in the docutils
-   documentation <https://docutils.sourceforge.io/docs/ref/doctree.html>`__.
-   Additional nodes are provided by Sphinx and :ref:`documented here <nodes>`.
+There are nodes provided by docutils, which are documented `in the docutils
+documentation <https://docutils.sourceforge.io/docs/ref/doctree.html>`__.
+Additional nodes are provided by Sphinx and :ref:`documented here <nodes>`.
 
-   During reading, the build environment is updated with all meta- and cross
-   reference data of the read documents, such as labels, the names of headings,
-   described Python objects and index entries.  This will later be used to
-   replace the temporary nodes.
+During reading, the build environment is updated with all meta- and cross
+reference data of the read documents, such as labels, the names of headings,
+described Python objects and index entries.  This will later be used to
+replace the temporary nodes.
 
-   The parsed doctrees are stored on the disk, because it is not possible to
-   hold all of them in memory.
+The parsed doctrees are stored on the disk, because it is not possible to
+hold all of them in memory.
 
 **Phase 2: Consistency checks**
 
-   Some checking is done to ensure no surprises in the built documents.
+Some checking is done to ensure no surprises in the built documents.
 
 **Phase 3: Resolving**
 
-   Now that the metadata and cross-reference data of all existing documents is
-   known, all temporary nodes are replaced by nodes that can be converted into
-   output using components called transforms.  For example, links are created
-   for object references that exist, and simple literal nodes are created for
-   those that don't.
+Now that the metadata and cross-reference data of all existing documents is
+known, all temporary nodes are replaced by nodes that can be converted into
+output using components called transforms.  For example, links are created
+for object references that exist, and simple literal nodes are created for
+those that don't.
 
 **Phase 4: Writing**
 
-   This phase converts the resolved doctrees to the desired output format, such
-   as HTML or LaTeX.  This happens via a so-called docutils writer that visits
-   the individual nodes of each doctree and produces some output in the process.
+This phase converts the resolved doctrees to the desired output format, such
+as HTML or LaTeX.  This happens via a so-called docutils writer that visits
+the individual nodes of each doctree and produces some output in the process.
 
 .. note::
 
@@ -178,7 +178,7 @@
             * The core logic of the extension is parallelly executable during
               the reading phase.
             * It has event handlers for :event:`env-merge-info` and
-              :event:`env-purge-doc` events if it stores dataa to the build
+              :event:`env-purge-doc` events if it stores data to the build
               environment object (env) during the reading phase.
 
 * ``'parallel_write_safe'``: a boolean that specifies if parallel writing of

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/markupapi.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/markupapi.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/nodes.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/nodes.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/extdev/parserapi.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/extdev/parserapi.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/faq.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/faq.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/glossary.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/glossary.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/doc/index.rst Added

@@ -0,0 +1,117 @@
+=======
+Welcome
+=======
+
+.. epigraph:: Sphinx makes it easy to create intelligent and beautiful documentation.
+
+Here are some of Sphinx's major features:
+
+* **Output formats:** HTML (including Windows HTML Help), LaTeX (for printable
+  PDF versions), ePub, Texinfo, manual pages, plain text
+* **Extensive cross-references:** semantic markup and automatic links for
+  functions, classes, citations, glossary terms and similar pieces of
+  information
+* **Hierarchical structure:** easy definition of a document tree, with automatic
+  links to siblings, parents and children
+* **Automatic indices:** general index as well as a language-specific module
+  indices
+* **Code handling:** automatic highlighting using the Pygments_ highlighter
+* **Extensions:** automatic testing of code snippets, inclusion of docstrings
+  from Python modules (API docs) via :ref:`built-in extensions
+  <builtin-extensions>`, and much more functionality via :ref:`third-party
+  extensions <third-party-extensions>`.
+* **Themes:** modify the look and feel of outputs via :doc:`creating themes
+  <development/theming>`, and re-use many :ref:`third-party themes
+  <third-party-themes>`.
+* **Contributed extensions:** dozens of extensions :ref:`contributed by users
+  <third-party-extensions>`; most of them installable from PyPI.
+
+.. _reStructuredText: https://docutils.sourceforge.io/rst.html
+.. _Docutils: https://docutils.sourceforge.io/
+.. _Pygments: https://pygments.org/
+
+Sphinx uses the reStructuredText_ markup language by default, and can read
+:ref:`MyST markdown <markdown>` via third-party extensions. Both of these
+are powerful and straightforward to use, and have functionality
+for complex documentation and publishing workflows. They both build upon
+Docutils_ to parse and write documents.
+
+See below for how to navigate Sphinx's documentation.
+
+.. seealso::
+
+   The `Sphinx documentation Table of Contents <contents.html>`_ has
+   a full list of this site's pages.
+
+.. _get-started:
+
+Get started
+===========
+
+These sections cover the basics of getting started with Sphinx, including
+creating and building your own documentation from scratch.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Get started
+
+   usage/quickstart
+   usage/installation
+   tutorial/index
+
+.. _user-guides:
+
+User Guides
+===========
+
+These sections cover various topics in using and extending Sphinx for various
+use-cases. They are a comprehensive guide to using Sphinx in many contexts and
+assume more knowledge of Sphinx. If you are new to Sphinx, we recommend
+starting with :ref:`get-started`.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: User Guides
+
+   usage/index
+   development/index
+   latex
+   extdev/index
+
+Community guide
+===============
+
+Sphinx is community supported and welcomes contributions from anybody.
+The sections below should help you get started joining the Sphinx community
+as well as contributing.
+
+See the :doc:`Sphinx contributors' guide <internals/contributing>` if you would
+like to contribute to the project.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Community
+
+   support
+   internals/index
+   faq
+   authors
+
+Reference guide
+===============
+
+Reference documentation is more complete and programmatic in nature, it is a
+collection of information that can be quickly referenced. If you would like
+usecase-driven documentation, see :ref:`get-started` or :ref:`user-guides`.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Reference
+
+   man/index
+   usage/configuration
+   usage/extensions/index
+   usage/restructuredtext/index
+   glossary
+   changes
+   examples

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/internals/contributing.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/internals/contributing.rst Changed

@@ -7,8 +7,8 @@
 fixed behavior. This guide serves to illustrate how you can get started with
 this.
 
-Getting help
-------------
+Get help
+--------
 
 The Sphinx community maintains a number of mailing lists and IRC channels.
 
@@ -46,8 +46,8 @@
 .. _`sphinx-dev`: mailto:sphinx-dev@googlegroups.com
 
 
-Writing code
-------------
+Contribute code
+---------------
 
 The Sphinx source code is managed using Git and is hosted on `GitHub`__.  The
 recommended way for new contributors to submit code to Sphinx is to fork this
@@ -57,6 +57,8 @@
 
 .. __: https://github.com/sphinx-doc/sphinx
 
+.. _contribute-get-started:
+
 Getting started
 ~~~~~~~~~~~~~~~
 
@@ -152,10 +154,10 @@
 
 * Add appropriate unit tests.
 
-Style and type checks can be run using ``tox``::
+Style and type checks can be run as follows::
 
-    tox -e mypy
-    tox -e flake8
+    ruff .
+    mypy sphinx/
 
 Unit tests
 ~~~~~~~~~~
@@ -172,19 +174,19 @@
 
       tox -av
 
-* To run unit tests for a specific Python version, such as Python 3.6::
+* To run unit tests for a specific Python version, such as Python 3.10::
 
-      tox -e py36
+      tox -e py310
 
 * To run unit tests for a specific Python version and turn on deprecation
-  warnings on so they're shown in the test output::
+  warnings so they're shown in the test output::
 
-      PYTHONWARNINGS=all tox -e py36
+      PYTHONWARNINGS=error tox -e py310
 
-* Arguments to ``pytest`` can be passed via ``tox``, e.g. in order to run a
+* Arguments to ``pytest`` can be passed via ``tox``, e.g., in order to run a
   particular test::
 
-      tox -e py36 tests/test_module.py::test_new_feature
+      tox -e py310 tests/test_module.py::test_new_feature
 
 You can also test by installing dependencies in your local environment::
 
@@ -222,7 +224,7 @@
 
 Utility functions and pytest fixtures for testing are provided in
 ``sphinx.testing``. If you are a developer of Sphinx extensions, you can write
-unit tests with using pytest. At this time, ``sphinx.testing`` will help your
+unit tests by using pytest. At this time, ``sphinx.testing`` will help your
 test implementation.
 
 How to use pytest fixtures that are provided by ``sphinx.testing``?  You can
@@ -232,17 +234,36 @@
    pytest_plugins = 'sphinx.testing.fixtures'
 
 If you want to know more detailed usage, please refer to ``tests/conftest.py``
-and other ``test_*.py`` files under ``tests`` directory.
+and other ``test_*.py`` files under the ``tests`` directory.
+
 
+Contribute documentation
+------------------------
 
-Writing documentation
----------------------
+Contributing to documentation involves modifying the source files found in the
+``doc/`` folder. To get started, you should first follow :ref:`contribute-get-started`,
+and then take the steps below to work with the documentation.
+
+The following sections describe how to get started with contributing
+documentation, as well as key aspects of a few different tools that we use.
 
 .. todo:: Add a more extensive documentation contribution guide.
 
-You can build documentation using ``tox``::
+Build the documentation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+To build the documentation, run the following command::
+
+    sphinx-build -M html ./doc ./build/sphinx -W --keep-going
+
+This will parse the Sphinx documentation's source files and generate HTML for
+you to preview in ``build/sphinx/html``.
+
+You can also build a **live version of the documentation** that you can preview
+in the browser. It will detect changes and reload the page any time you make
+edits. To do so, run the following command::
 
-    tox -e docs
+    sphinx-autobuild ./doc ./build/sphinx/
 
 Translations
 ~~~~~~~~~~~~
@@ -252,17 +273,19 @@
 master template :file:`sphinx/locale/sphinx.pot`.
 
 Sphinx uses `Babel <https://babel.pocoo.org/en/latest/>`_ to extract messages
-and maintain the catalog files.  It is integrated in ``setup.py``:
+and maintain the catalog files.  The ``utils`` directory contains a helper
+script, ``babel_runner.py``.
 
-* Use ``python setup.py extract_messages`` to update the ``.pot`` template.
-* Use ``python setup.py update_catalog`` to update all existing language
+* Use ``python babel_runner.py extract`` to update the ``.pot`` template.
+* Use ``python babel_runner.py update`` to update all existing language
   catalogs in ``sphinx/locale/*/LC_MESSAGES`` with the current messages in the
   template file.
-* Use ``python setup.py compile_catalog`` to compile the ``.po`` files to binary
+* Use ``python babel_runner.py compile`` to compile the ``.po`` files to binary
   ``.mo`` files and ``.js`` files.
 
-When an updated ``.po`` file is submitted, run compile_catalog to commit both
-the source and the compiled catalogs.
+When an updated ``.po`` file is submitted, run
+``python babel_runner.py compile`` to commit both the source and the compiled
+catalogs.
 
 When a new locale is submitted, add a new directory with the ISO 639-1 language
 identifier and put ``sphinx.po`` in there.  Don't forget to update the possible
@@ -273,9 +296,9 @@
 which is provided by the ``transifex_client`` Python package, can be used to
 pull translations in ``.po`` format from Transifex.  To do this, go to
 ``sphinx/locale`` and then run ``tx pull -f -l LANG`` where ``LANG`` is an
-existing language identifier.  It is good practice to run ``python setup.py
-update_catalog`` afterwards to make sure the ``.po`` file has the canonical
-Babel formatting.
+existing language identifier.  It is good practice to run
+``python babel_runner.py update`` afterwards to make sure the ``.po`` file has the
+canonical Babel formatting.
 
 
 Debugging tips
@@ -299,12 +322,11 @@
 * Set the debugging options in the `Docutils configuration file
   <https://docutils.sourceforge.io/docs/user/config.html>`_.
 
-* JavaScript stemming algorithms in ``sphinx/search/*.py`` (except ``en.py``)
-  are generated by this `modified snowballcode generator
-  <https://github.com/shibukawa/snowball>`_.  Generated `JSX
-  <https://jsx.github.io/>`_ files are in `this repository
-  <https://github.com/shibukawa/snowball-stemmer.jsx>`_.  You can get the
-  resulting JavaScript files using the following command::
+* JavaScript stemming algorithms in ``sphinx/search/non-minified-js/*.js``
+  are generated using `snowball <https://github.com/snowballstem/snowball>`_
+  by cloning the repository, executing ``make dist_libstemmer_js`` and then
+  unpacking the tarball which is generated in ``dist`` directory.
 
-      npm install
-      node_modules/.bin/grunt build # -> dest/*.global.js
+  Minified files in ``sphinx/search/minified-js/*.js`` are generated from
+  non-minified ones using ``uglifyjs`` (installed via npm), with ``-m``
+  option to enable mangling.

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/internals/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/internals/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/internals/organization.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/internals/organization.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/internals/release-process.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/internals/release-process.rst Changed

@@ -2,35 +2,28 @@
 Sphinx's release process
 ========================
 
-Branch Model
-------------
+Versioning
+----------
 
-Sphinx project uses following branches for developing that conforms to Semantic
-Versioning 2.0.0 (refs: https://semver.org/ ).
+Sphinx adheres to :pep:`440` versions, with a ``major.minor.micro`` scheme for
+the *release segment* (e.g. 1.2.3).
+The major, minor, and micro version parts should be altered as follows:
 
-``master``
-    Development for MAJOR version.
-    All changes including incompatible behaviors and public API updates are
-    allowed.
+* The major version part should be incremented for incompatible behavior change and
+  public API updates.
 
-``A.x`` (ex. ``2.x``)
-    Where ``A.x`` is the ``MAJOR.MINOR`` release.  Used to maintain current
-    MINOR release. All changes are allowed if the change preserves
-    backwards-compatibility of API and features.
+* The minor version part should be incremented for most releases of Sphinx, where
+  backwards-compatibility of API and features are preserves.
 
-    Only the most recent ``MAJOR.MINOR`` branch is currently retained. When a
-    new MAJOR version is released, the old ``MAJOR.MINOR`` branch will be
-    deleted and replaced by an equivalent tag.
+* The micro version part should only be incremented for urgent bugfix-only releases.
 
-``A.B.x`` (ex. ``2.4.x``)
-    Where ``A.B.x`` is the ``MAJOR.MINOR.PATCH`` release.  Only
-    backwards-compatible bug fixes are allowed. In Sphinx project, PATCH
-    version is used for urgent bug fix.
+When the major version part is incremented, the minor and micro version parts
+must be set to ``0``.
+When the minor version part is incremented, the micro version part must be set
+to ``0``.
 
-    ``MAJOR.MINOR.PATCH`` branch will be branched from the ``v`` prefixed
-    release tag (ex. make 2.3.1 that branched from v2.3.0) when a urgent
-    release is needed. When new PATCH version is released, the branch will be
-    deleted and replaced by an equivalent tag (ex. v2.3.1).
+New major versions should come with a beta-testing period before the final
+release.
 
 
 Deprecating a feature
@@ -100,6 +93,32 @@
 ``PYTHONWARNINGS=default`` (see the :ref:`Python docs on configuring warnings
 <python:describing-warning-filters>`) for more details.
 
+Python version support policy
+-----------------------------
+
+Sphinx supports at all minor versions of Python released in the past 42 months
+from the anticipated release date with a minimum of 3 minor versions of Python.
+This policy is derived from `NEP 29`_, a scientific Python domain standard.
+
+.. _NEP 29: https://numpy.org/neps/nep-0029-deprecation_policy.html
+
+For example, a version of Sphinx released in May 2024 would support Python 3.10,
+3.11, and 3.12.
+
+This is a summary table with the current policy:
+
+=========== ======
+Date        Python
+=========== ======
+26 Dec 2021 3.8+
+----------- ------
+14 Apr 2023 3.9+
+----------- ------
+05 Apr 2024 3.10+
+----------- ------
+04 Apr 2025 3.11+
+=========== ======
+
 Release procedures
 ------------------

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/latex.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/latex.rst Changed

@@ -4,22 +4,42 @@
 .. module:: latex
    :synopsis: LaTeX specifics.
 
+.. _contents: https://docutils.sourceforge.io/docs/ref/rst/directives.html#table-of-contents
+
 .. raw:: latex
 
    \begingroup
    \sphinxsetup{%
-         verbatimwithframe=false,
-         VerbatimColor={named}{OldLace},
          TitleColor={named}{DarkGoldenrod},
-         hintBorderColor={named}{LightCoral},
+         pre_border-width=2pt,
+         pre_border-right-width=8pt,
+         pre_padding=5pt,
+         pre_border-radius=5pt,
+         pre_background-TeXcolor={named}{OldLace},
+         pre_border-TeXcolor=Gold!90,
+         pre_box-shadow=6pt 6pt,
+         pre_box-shadow-TeXcolor=gray!20,
+         %
+         div.warning_border-width=3pt,
+         div.warning_padding=6pt,
+         div.warning_padding-right=18pt,
+         div.warning_padding-bottom=18pt,
+         div.warning_border-TeXcolor=DarkCyan,
+         div.warning_background-TeXcolor=LightCyan,
+         div.warning_box-shadow=-12pt -12pt inset,
+         div.warning_box-shadow-TeXcolor=Cyan,
+         %
          attentionborder=3pt,
-         attentionBorderColor={named}{Crimson},
-         attentionBgColor={named}{FloralWhite},
-         noteborder=2pt,
-         noteBorderColor={named}{Olive},
-         cautionborder=3pt,
-         cautionBorderColor={named}{Cyan},
-         cautionBgColor={named}{LightCyan}}
+         attentionBorderColor=Crimson,
+         attentionBgColor=FloralWhite,
+         %
+         noteborder=1pt,
+         noteBorderColor=Olive,
+         noteBgColor=Olive!10,
+         div.note_border-top-width=0pt,
+         div.note_border-bottom-width=0pt,
+         hintBorderColor=LightCoral,
+   }
    \relax
 
 Unlike :ref:`the HTML builders <html-themes>`, the ``latex`` builder does not
@@ -27,7 +47,7 @@
 :ref:`latex_elements <latex_elements_confval>` variable, provides much of the
 interface for customization. For example:
 
-.. code-block:: python
+.. code-block:: latex
 
    # inside conf.py
    latex_engine = 'xelatex'
@@ -62,7 +82,10 @@
 
 A dictionary that contains LaTeX snippets overriding those Sphinx usually puts
 into the generated ``.tex`` files.  Its ``'sphinxsetup'`` key is described
-:ref:`separately <latexsphinxsetup>`.
+:ref:`separately <latexsphinxsetup>`.  It allows also local configurations
+inserted in generated files, via :dudir:`raw` directives.  For example, in
+the PDF documentation this chapter is styled especially, as will be described
+later.
 
 Keys that you may want to override include:
 
@@ -121,7 +144,7 @@
 
    .. hint::
 
-      After modifiying a core LaTeX key like this one, clean up the LaTeX
+      After modifying a core LaTeX key like this one, clean up the LaTeX
       build repertory before next PDF build, else left-over auxiliary
       files are likely to break the build.
 
@@ -196,6 +219,9 @@
 
       latex_additional_files = "mystyle.sty"
 
+   Do not use ``.tex`` as suffix, else the file is submitted itself to the PDF
+   build process, use ``.tex.txt`` or ``.sty`` as in the examples above.
+
    Default: ``''``
 
 ``'figure_align'``
@@ -219,10 +245,10 @@
 ``'extrapackages'``
    Additional LaTeX packages.  For example:
 
-   .. code-block:: python
+   .. code-block:: latex
 
        latex_elements = {
-           'packages': r'\usepackage{isodate}'
+           'extrapackages': r'\usepackage{isodate}'
        }
 
    The specified LaTeX packages will be loaded before
@@ -330,7 +356,7 @@
 
    .. attention::
 
-      - Do not use this key for a :confval:`latex_engine` other than 
+      - Do not use this key for a :confval:`latex_engine` other than
         ``'pdflatex'``.
 
       - If Greek is main language, do not use this key.  Since Sphinx 2.2.1,
@@ -396,12 +422,16 @@
 ``'geometry'``
    "geometry" package inclusion, the default definition is:
 
-     ``'\\usepackage{geometry}'``
+   .. code:: latex
+
+      '\\usepackage{geometry}'
 
    with an additional ``dvipdfm`` for Japanese documents.
    The Sphinx LaTeX style file executes:
 
-     ``\PassOptionsToPackage{hmargin=1in,vmargin=1in,marginpar=0.5in}{geometry}``
+   .. code:: latex
+
+      \PassOptionsToPackage{hmargin=1in,vmargin=1in,marginpar=0.5in}{geometry}
 
    which can be customized via corresponding :ref:`'sphinxsetup' options
    <latexsphinxsetup>`.
@@ -528,7 +558,7 @@
       is adapted to the relative widths of the FreeFont family.
 
    .. versionchanged:: 4.0.0
-      Changed default for ``'pdflatex'``. Previously it was using 
+      Changed default for ``'pdflatex'``. Previously it was using
       ``'\\fvset{fontsize=\\small}'``.
 
    .. versionchanged:: 4.1.0
@@ -571,33 +601,87 @@
        'passoptionstopackages': r'\PassOptionsToPackage{svgnames}{xcolor}',
    }
 
-It is possible to insert further uses of the ``\sphinxsetup`` LaTeX macro
-directly into the body of the document, via the help of the :rst:dir:`raw`
-directive. This chapter is styled in the PDF output using the following at the
-start of the chapter::
+It is possible to insert uses of the ``\sphinxsetup`` LaTeX macro directly
+into the body of the document, via the ``raw`` directive.  This chapter is
+styled in the PDF output using the following insertion at its start.  This
+uses keys described later in :ref:`additionalcss`.
+
+.. code-block:: latex
+
+   .. raw:: latex
+
+      \begingroup
+      \sphinxsetup{%
+         TitleColor={named}{DarkGoldenrod},
+         % pre_border-width is 5.1.0 alias for verbatimborder
+         pre_border-width=2pt,
+         pre_border-right-width=8pt,
+         % pre_padding is a 5.1.0 alias for verbatimsep
+         pre_padding=5pt,
+         % Rounded boxes are new at 5.1.0
+         pre_border-radius=5pt,
+         % TeXcolor reminds that syntax must be as for LaTeX \definecolor
+         pre_background-TeXcolor={named}{OldLace},
+         % ... and since 5.3.0 also xcolor \colorlet syntax is accepted and we
+         %     can thus drop the {named}{...} thing if xcolor is available!
+         pre_border-TeXcolor=Gold,
+         % ... and even take more advantage of xcolor syntax:
+         pre_border-TeXcolor=Gold!90,
+         % add a shadow to code-blocks
+         pre_box-shadow=6pt 6pt,
+         pre_box-shadow-TeXcolor=gray!20,
+         %
+         % This 5.1.0 CSS-named option is alias for warningborder
+         div.warning_border-width=3pt,
+         % Prior to 5.1.0, padding for admonitions was not customizable
+         div.warning_padding=6pt,
+         div.warning_padding-right=18pt,
+         div.warning_padding-bottom=18pt,
+         % Assume xcolor has been loaded with its svgnames option
+         div.warning_border-TeXcolor=DarkCyan,
+         div.warning_background-TeXcolor=LightCyan,
+         % This one is the only option with space separated input:
+         div.warning_box-shadow=-12pt -12pt inset,
+         div.warning_box-shadow-TeXcolor=Cyan,
+         %
+         % The 5.1.0 new name would be div.attention_border-width
+         attentionborder=3pt,
+         % The 5.1.0 name here would be div.attention_border-TeXcolor
+         attentionBorderColor=Crimson,
+         % The 5.1.0 name would be div.attention_background-TeXcolor
+         attentionBgColor=FloralWhite,
+         %
+         % For note/hint/important/tip, the CSS syntax was added at 6.2.0
+         % Legacy syntax still works
+         noteborder=1pt,
+         noteBorderColor=Olive,
+         % But setting a background color via the new noteBgColor means that
+         % it will be rendered using the same interface as warning type
+         noteBgColor=Olive!10,
+         % We can customize separately the four border-widths, and mimic
+         % the legacy "light" rendering, but now with a background color:
+         % div.note_border-left-width=0pt,
+         % div.note_border-right-width=0pt,
+         % Let's rather for variety use lateral borders:
+         div.note_border-top-width=0pt,
+         div.note_border-bottom-width=0pt,
+         %
+         % As long as only border width and border color are set, *and* using
+         % for this the old interface, the rendering will be the "light" one
+         hintBorderColor=LightCoral,
+         % but if we had used div.hint_border-TeXcolor or *any* CSS-named
+         % option we would have triggered the more complex "heavybox" code.
+      }
 
-  .. raw:: latex
 
-     \begingroup
-     \sphinxsetup{%
-           verbatimwithframe=false,
-           VerbatimColor={named}{OldLace},
-           TitleColor={named}{DarkGoldenrod},
-           hintBorderColor={named}{LightCoral},
-           attentionborder=3pt,
-           attentionBorderColor={named}{Crimson},
-           attentionBgColor={named}{FloralWhite},
-           noteborder=2pt,
-           noteBorderColor={named}{Olive},
-           cautionborder=3pt,
-           cautionBorderColor={named}{Cyan},
-           cautionBgColor={named}{LightCyan}}
+And this is placed at the end of the chapter source to end the scope of
+the configuration:
 
-The below is included at the end of the chapter::
+.. code-block:: latex
 
-  .. raw:: latex
+   .. raw:: latex
 
-     \endgroup
+      \endgroup
 
 LaTeX syntax for boolean keys requires *lowercase* ``true`` or ``false``
 e.g ``'sphinxsetup': "verbatimwrapslines=false"``.  If setting the
@@ -655,7 +739,7 @@
 ``verbatimwithframe``
     Boolean to specify if :rst:dir:`code-block`\ s and literal includes are
     framed. Setting it to ``false`` does not deactivate use of package
-    "framed", because it is still in use for the optional background colour.
+    "framed", because it is still in use for the optional background color.
 
     Default: ``true``.
 
@@ -728,7 +812,7 @@
 
 ``verbatimhintsturnover``
     Boolean to specify if code-blocks display "continued on next page" and
-    "continued from previous page" hints in case of pagebreaks.
+    "continued from previous page" hints in case of page breaks.
 
     Default: ``true``
 
@@ -751,7 +835,7 @@
     Default: ``true``
 
     .. versionadded:: 1.5.2
-       set this option value to ``false`` to recover former behaviour.
+       set this option value to ``false`` to recover former behavior.
 
 ``inlineliteralwraps``
     Boolean to specify if line breaks are allowed inside inline literals: but
@@ -763,7 +847,7 @@
     Default: ``true``
 
     .. versionadded:: 1.5
-       set this option value to ``false`` to recover former behaviour.
+       set this option value to ``false`` to recover former behavior.
 
     .. versionchanged:: 2.3.0
        added potential breakpoint at ``\`` characters.
@@ -785,37 +869,60 @@
        definition of the continuation symbol was changed at 1.5 to accommodate
        various font sizes (e.g. code-blocks can be in footnotes).
 
-``TitleColor``
-    The colour for titles (as configured via use of package "titlesec".)
+.. note::
 
-    Default: ``{rgb}{0.126,0.263,0.361}``
+   Values for color keys must either:
+
+   - obey the syntax of the ``\definecolor`` LaTeX command, e.g. something
+     such as ``VerbatimColor={rgb}{0.2,0.3,0.5}`` or ``{RGB}{37,23,255}`` or
+     ``{gray}{0.75}`` or (only with package ``xcolor``) ``{HTML}{808080}`` or
+     ...
 
-    .. warning::
+   - or obey the syntax of the ``\colorlet`` command from package ``xcolor``
+     (which then must exist in the LaTeX installation),
+     e.g. ``VerbatimColor=red!10`` or ``red!50!green`` or ``-red!75`` or
+     ``MyPreviouslyDefinedColor`` or... Refer to xcolor_ documentation for
+     this syntax.
 
-       Colours set via ``'sphinxsetup'``  must obey the syntax of the
-       argument of the ``color/xcolor`` packages ``\definecolor`` command.
+   .. _xcolor: https://ctan.org/pkg/xcolor
+
+   .. versionchanged:: 5.3.0
+      Formerly only the ``\definecolor`` syntax was accepted.
+
+``TitleColor``
+    The color for titles (as configured via use of package "titlesec".)
+
+    Default: ``{rgb}{0.126,0.263,0.361}``
 
 ``InnerLinkColor``
-    A colour passed to ``hyperref`` as value of ``linkcolor``  and
+    A color passed to ``hyperref`` as value of ``linkcolor``  and
     ``citecolor``.
 
     Default: ``{rgb}{0.208,0.374,0.486}``.
 
 ``OuterLinkColor``
-    A colour passed to ``hyperref`` as value of ``filecolor``, ``menucolor``,
+    A color passed to ``hyperref`` as value of ``filecolor``, ``menucolor``,
     and ``urlcolor``.
 
     Default: ``{rgb}{0.216,0.439,0.388}``
 
 ``VerbatimColor``
-    The background colour for :rst:dir:`code-block`\ s.
+    The background color for :rst:dir:`code-block`\ s.
 
-    Default: ``{rgb}{1,1,1}`` (white)
+    Default: ``{gray}{0.95}``
+
+    .. versionchanged:: 6.0.0
+
+       Formerly, it was ``{rgb}{1,1,1}`` (white).
 
 ``VerbatimBorderColor``
     The frame color.
 
-    Default: ``{rgb}{0,0,0}`` (black)
+    Default: ``{RGB}{32,32,32}``
+
+    .. versionchanged:: 6.0.0
+
+       Formerly it was ``{rgb}{0,0,0}`` (black).
 
 ``VerbatimHighlightColor``
     The color for highlighted lines.
@@ -824,69 +931,163 @@
 
     .. versionadded:: 1.6.6
 
-    .. note::
+.. _tablecolors:
+
+``TableRowColorHeader``
+    Sets the background color for (all) the header rows of tables.
+
+    It will have an effect only if either the :confval:`latex_table_style`
+    contains ``'colorrows'`` or if the table is assigned the ``colorrows``
+    class.  It is ignored for tables with ``nocolorrows`` class.
+
+    As for the other ``'sphinxsetup'`` keys, it can also be set or modified
+    from a ``\sphinxsetup{...}`` LaTeX command inserted via the :dudir:`raw`
+    directive, or also from a LaTeX environment associated to a `container
+    class <latexcontainer_>`_ and using such ``\sphinxsetup{...}``.
+
+    Default: ``{gray}{0.86}``
 
-       Starting with this colour, and for all others following, the
-       names declared to "color" or "xcolor" are prefixed with "sphinx".
+    There is also ``TableMergeColorHeader``.  If used, sets a specific color
+    for merged single-row cells in the header.
+
+    .. versionadded:: 5.3.0
+
+``TableRowColorOdd``
+    Sets the background color for odd rows in tables (the row count starts at
+    ``1`` at the first non-header row).  Has an effect only if the
+    :confval:`latex_table_style` contains ``'colorrows'`` or for specific
+    tables assigned the ``colorrows`` class.
+
+    Default: ``{gray}{0.92}``
+
+    There is also ``TableMergeColorOdd``.
+
+    .. versionadded:: 5.3.0
+
+``TableRowColorEven``
+    Sets the background color for even rows in tables.
+
+    Default ``{gray}{0.98}``
+
+    There is also ``TableMergeColorEven``.
+
+    .. versionadded:: 5.3.0
 
 ``verbatimsep``
     The separation between code lines and the frame.
 
+    See :ref:`additionalcss` for its alias  ``pre_padding`` and
+    additional keys.
+
     Default: ``\fboxsep``
 
 ``verbatimborder``
-    The width of the frame around :rst:dir:`code-block`\ s.
+    The width of the frame around :rst:dir:`code-block`\ s.  See also
+    :ref:`additionalcss` for ``pre_border-width``.
 
     Default: ``\fboxrule``
 
 ``shadowsep``
-    The separation between contents and frame for :dudir:`contents` and
+    The separation between contents and frame for contents_ and
     :dudir:`topic` boxes.
 
+    See :ref:`additionalcss` for the alias ``div.topic_padding``.
+
     Default: ``5pt``
 
 ``shadowsize``
-    The width of the lateral "shadow" to the right.
+    The width of the lateral "shadow" to the right and bottom.
+
+    See :ref:`additionalcss` for ``div.topic_box-shadow`` which allows to
+    configure separately the widths of the vertical and horizontal shadows.
 
     Default: ``4pt``
 
+    .. versionchanged:: 6.1.2
+       Fixed a regression introduced at ``5.1.0`` which modified unintentionally
+       the width of topic boxes and worse had made usage of this key break PDF
+       builds.
+
 ``shadowrule``
-    The width of the frame around :dudir:`topic` boxes.
+    The width of the frame around :dudir:`topic` boxes.  See also
+    :ref:`additionalcss` for ``div.topic_border-width``.
 
     Default: ``\fboxrule``
 
 |notebdcolors|
-    The colour for the two horizontal rules used by Sphinx in LaTeX for styling
+    The color for the two horizontal rules used by Sphinx in LaTeX for styling
     a :dudir:`note` type admonition.
 
     Default: ``{rgb}{0,0,0}`` (black)
 
+|notebgcolors|
+    The optional color for the background.  It is a priori set to white, but
+    is not used, unless it has been set explicitly, and doing this triggers
+    Sphinx into switching to the more complex LaTeX code which is employed
+    also for ``warning`` type admonitions.  There are then additional options
+    which are described in :ref:`additionalcss`.
+
+    Default: ``{rgb}{1,1,1}`` (white)
+
+    .. versionadded:: 6.2.0
+
+|notetextcolors|
+    The optional color for the contents.
+
+    Default: unset (uses ambient text color, a priori black)
+
+    .. versionadded:: 6.2.0
+
+       To be considered experimental until 7.0.0.  These options have aliases
+       ``div.note_TeXcolor`` (etc) described in :ref:`additionalcss`.  Using
+       the latter will let Sphinx switch to a more complex LaTeX code,
+       which supports the customizability described in :ref:`additionalcss`.
+
+|notetexextras|
+    Some extra LaTeX code (such as ``\bfseries``  or ``\footnotesize``)
+    to be executed at start of the contents.
+
+    Default: empty
+
+    .. versionadded:: 6.2.0
+
+       To be considered experimental until 7.0.0.  These options have aliases
+       ``div.note_TeXextras`` (etc) described in :ref:`additionalcss`.
+
 ``noteborder``, ``hintborder``, ``importantborder``, ``tipborder``
     The width of the two horizontal rules.
 
+    If the background color is set, or the alternative :ref:`additionalcss`
+    syntax is used (e.g. ``div.note_border-width=1pt`` in place of
+    ``noteborder=1pt``), or *any* option with a CSS-alike name is used, then
+    the border is a full frame and this parameter sets its width also for left
+    and right.
+
     Default: ``0.5pt``
 
 .. only:: not latex
 
    |warningbdcolors|
-       The colour for the admonition frame.
+       The color for the admonition frame.
 
    Default: ``{rgb}{0,0,0}`` (black)
 
 .. only:: latex
 
    |wgbdcolorslatex|
-       The colour for the admonition frame.
+       The color for the admonition frame.
 
    Default: ``{rgb}{0,0,0}`` (black)
 
 |warningbgcolors|
-    The background colours for the respective admonitions.
+    The background colors for the respective admonitions.
 
     Default: ``{rgb}{1,1,1}`` (white)
 
 |warningborders|
-    The width of the frame.
+    The width of the frame.  See
+    :ref:`additionalcss` for keys allowing to configure separately each
+    border width.
 
     Default: ``1pt``
 
@@ -911,11 +1112,20 @@
 .. |notebdcolors| replace:: ``noteBorderColor``, ``hintBorderColor``,
                             ``importantBorderColor``, ``tipBorderColor``
 
+.. |notebgcolors| replace:: ``noteBgColor``, ``hintBgColor``,
+                            ``importantBgColor``, ``tipBgColor``
+
+.. |notetextcolors| replace:: ``noteTextColor``, ``hintTextColor``,
+                              ``importantTextColor``, ``tipTextColor``
+
+.. |notetexextras| replace:: ``noteTeXextras``, ``hintTeXextras``,
+                             ``importantTeXextras``, ``tipTeXextras``
+
 .. |warningbdcolors| replace:: ``warningBorderColor``, ``cautionBorderColor``,
                                ``attentionBorderColor``, ``dangerBorderColor``,
                                ``errorBorderColor``
 
-.. |wgbdcolorslatex| replace:: ``warningBorderColor``, and 
+.. |wgbdcolorslatex| replace:: ``warningBorderColor``, and
                                ``(caution|attention|danger|error)BorderColor``
 
 .. else latex goes into right margin, as it does not hyphenate the names
@@ -928,6 +1138,270 @@
                               ``attentionborder``, ``dangerborder``,
                               ``errorborder``
 
+.. _additionalcss:
+
+Additional  CSS-like ``'sphinxsetup'`` keys
+-------------------------------------------
+
+.. versionadded:: 5.1.0
+
+   For :rst:dir:`code-block`, :dudir:`topic` and contents_ directive,
+   and strong-type admonitions (:dudir:`warning`, :dudir:`error`, ...).
+
+.. versionadded:: 6.2.0
+
+   Also the :dudir:`note`, :dudir:`hint`, :dudir:`important` and :dudir:`tip`
+   admonitions can be styled this way.  Using for them *any* of the listed
+   options will trigger usage of a more complex LaTeX code than the one used
+   per default (``sphinxheavybox`` vs ``sphinxlightbox``).  Setting the new
+   ``noteBgColor`` (or ``hintBgColor``, ...) also triggers usage of
+   ``sphinxheavybox`` for :dudir:`note` (or :dudir:`hint`, ...).
+
+Perhaps in future these 5.1.0 (and 6.2.0) novel settings will be optionally
+imported from some genuine CSS external file, but currently they have to be used
+via the ``'sphinxsetup'`` interface (or the ``\sphinxsetup`` LaTeX command
+inserted via the :dudir:`raw` directive) and the CSS syntax is only imitated.
+
+.. important:: Low-level LaTeX errors causing a build failure can happen if
+   the input syntax is not respected.
+
+   * In particular colors must be input as for the other color related options
+     previously described, i.e. either in the ``\definecolor`` syntax or, if
+     package ``xcolor`` is available (it is then automatically used) also the
+     ``\colorlet`` syntax::
+
+       ...<other options>
+       div.warning_border-TeXcolor={rgb}{1,0,0},% (always works)
+       div.error_background-TeXcolor=red!10,% (works only if xcolor is available)
+       ...<other options>
+
+   * A colon in place of the equal sign will break LaTeX.
+
+   * ``...border-width`` or ``...padding`` expect a *single* dimension: they can not
+     be used so far with space separated dimensions.
+
+   * ``...top-right-radius`` et al. values may be either a single or *two* space
+     separated dimensions.
+
+   * Dimension specifications must use TeX units such as ``pt`` or ``cm`` or
+     ``in``.  The ``px`` unit is recognized by ``pdflatex`` and ``lualatex``
+     but not by ``xelatex`` or ``platex``.
+
+   * It is allowed for such specifications to be so-called "dimensional
+     expressions", e.g. ``\fboxsep+2pt`` or ``0.5\baselineskip`` are valid
+     inputs.  The expressions will be evaluated only at the typesetting time.
+     Be careful though if using as in these examples TeX control sequences to
+     double the backslash or to employ a raw Python string for the value of
+     the :ref:`'sphinxsetup' <latexsphinxsetup>` key.
+
+   * As a rule, avoid inserting unneeded spaces in the key values: especially
+     for the radii an input such  ``2 pt 3pt`` will break LaTeX.  Beware also
+     that ``\fboxsep \fboxsep`` will not be seen as space separated in LaTeX.
+     You must use something such as ``{\fboxsep} \fboxsep``.  Or use
+     directly ``3pt 3pt`` which is a priori equivalent and simpler.
+
+The options are all named in a similar pattern which depends on a ``prefix``,
+which is then followed by an underscore, then the property name.
+
+.. csv-table::
+   :header: Directive, Option prefix, LaTeX environment
+
+   :rst:dir:`code-block`, ``pre``, ``sphinxVerbatim``
+   :dudir:`topic`, ``div.topic``, ``sphinxShadowBox``
+   contents_, ``div.topic``, ``sphinxShadowBox``
+   :dudir:`note`, ``div.note``, ``sphinxnote`` using ``sphinxheavybox``
+   :dudir:`warning`, ``div.warning``, ``sphinxwarning`` (uses ``sphinxheavybox``)
+   admonition type, ``div.<type>``,  ``sphinx<type>`` (using ``sphinxheavybox``)
+
+Here are now these options as well as their common defaults.
+Replace below ``<prefix>`` by the actual prefix as explained above.  Don't
+forget the underscore separating the prefix from the property names.
+
+- | ``<prefix>_border-top-width``,
+  | ``<prefix>_border-right-width``,
+  | ``<prefix>_border-bottom-width``,
+  | ``<prefix>_border-left-width``,
+  | ``<prefix>_border-width``.  The latter can (currently) be only a *single*
+    dimension which then sets all four others.
+
+  The default is that all those dimensions are equal.  They are set to:
+
+  * ``\fboxrule`` (i.e. a priori ``0.4pt``) for :rst:dir:`code-block`,
+  * ``\fboxrule`` for :dudir:`topic` or contents_ directive,
+  * ``1pt`` for  :dudir:`warning` and other "strong" admonitions,
+  * ``0.5pt`` for :dudir:`note` and other "light" admonitions.  The framing
+    style of the "lighbox" used for them in absence of usage of CSS-named
+    options will be emulated by the richer "heavybox" if setting
+    ``border-left-width`` and ``border-right-width`` both to ``0pt``.
+
+- ``<prefix>_box-decoration-break`` can be set to either ``clone`` or
+  ``slice`` and configures the behavior at page breaks.
+  It defaults to ``slice`` for :rst:dir:`code-block` (i.e. for ``<prefix>=pre``)
+  since 6.0.0.  For other directives the default is ``clone``.
+- | ``<prefix>_padding-top``,
+  | ``<prefix>_padding-right``,
+  | ``<prefix>_padding-bottom``,
+  | ``<prefix>_padding-left``,
+  | ``<prefix>_padding``.  The latter can (currently) be only a *single*
+    dimension which then sets all four others.
+
+  The default is that all those dimensions are equal.  They are set to:
+
+  * ``\fboxsep`` (i.e. a priori ``3pt``) for :rst:dir:`code-block`,
+  * ``5pt`` for :dudir:`topic` or contents_ directive,
+  * a special value for  :dudir:`warning` and other "strong" admonitions,
+    which ensures a backward compatible behavior.
+
+    .. important::
+
+       Prior to 5.1.0 there was no separate customizability of
+       padding for warning-type boxes in PDF via LaTeX output.  The sum of
+       padding and border-width (as set for example for :dudir:`warning` by
+       ``warningborder``, now also named ``div.warning_border-width``) was
+       kept to a certain constant value.  This limited the border-width
+       to small values else the border could overlap the text contents.
+       This behavior is kept as default.
+
+  * the same padding behavior is obeyed per default for :dudir:`note` or
+    other "light" admonitions when using ``sphinxheavybox``.
+- | ``<prefix>_border-top-left-radius``,
+  | ``<prefix>_border-top-right-radius``,
+  | ``<prefix>_border-bottom-right-radius``,
+  | ``<prefix>_border-bottom-left-radius``,
+  | ``<prefix>_border-radius``.  This last key sets the first four to
+    its assigned value.  Each key value can be either a single, or *two*,
+    dimensions which are then space separated.
+
+  The default is that all four corners are either circular or straight,
+  with common radii:
+
+  * ``\fboxsep`` (i.e. a priori ``3pt``) for :rst:dir:`code-block` (since 6.0.0).
+  * ``0pt`` for all other directives; this means to use straight corners.
+
+  See a remark above about traps with spaces in LaTeX.
+- ``<prefix>_box-shadow`` is special in so far as it may be:
+
+  * the ``none`` keyword,
+  * or a single dimension (giving both x-offset and y-offset),
+  * or two dimensions (separated by a space),
+  * or two dimensions followed by the keyword ``inset``.
+
+  The x-offset and y-offset may be negative.  The default is ``none``,
+  *except* for the :dudir:`topic` or contents_ directives, for which it is
+  ``4pt 4pt``, i.e. the shadow has a width of ``4pt`` and extends to the right
+  and below the frame.  The lateral shadow then extends into the page right
+  margin.
+- | ``<prefix>_border-TeXcolor``,
+  | ``<prefix>_background-TeXcolor``,
+  | ``<prefix>_box-shadow-TeXcolor``,
+  | ``<prefix>_TeXcolor``.
+    These are colors.
+
+  The shadow color defaults in all cases to ``{rgb}{0,0,0}`` i.e. to black.
+
+  Since 6.0.0 the border color and background color of :rst:dir:`code-block`,
+  i.e. ``pre`` prefix, default respectively to ``{RGB}{32,32,32}`` and
+  ``{gray}{0.95}``.  They previously defaulted to black, respectively white.
+
+  For all other types, the border color defaults to black and the background
+  color to white.
+
+  The ``<prefix>_TeXcolor`` stands for the CSS property "color", i.e. it
+  influences the text color of the contents.  As for the three other options,
+  the naming ``TeXcolor`` is to stress that the input syntax is the TeX one
+  for colors not an HTML/CSS one.  If package ``xcolor`` is available in the
+  LaTeX installation, one can use directly named colors as key values.
+  Consider passing options such as ``dvipsnames``, ``svgnames`` or ``x11names``
+  to ``xcolor`` via ``'passoptionstopackages'`` key of :confval:`latex_elements`.
+
+  If ``<prefix>_TeXcolor`` is set, a ``\color`` command is inserted at
+  start of the directive contents; for admonitions, this happens after the
+  heading which reproduces the admonition type.
+
+- ``<prefix>_TeXextras``: if set, its value must be some LaTeX command or
+  commands, for example ``\itshape``.  These commands will be inserted at the
+  start of the contents; for admonitions, this happens after the heading which
+  reproduces the admonition type.
+
+.. note::
+
+   - All directives support ``box-decoration-break`` to be set to ``slice``.
+
+     .. versionchanged:: 6.2.0
+
+        Formerly, only :rst:dir:`code-block` did.  The default remains
+        ``clone`` for all other directives, but this will probably change at
+        7.0.0.
+
+   - The corners of rounded boxes may be elliptical.
+
+     .. versionchanged:: 6.2.0
+
+        Formerly, only circular rounded corners were supported and a rounded
+        corner forced the whole frame to use the same constant width from
+        ``<prefix>_border-width``.
+
+   - Inset shadows are incompatible with rounded corners.  In case
+     both are specified the inset shadow will simply be ignored.
+
+     .. versionchanged:: 6.2.0
+
+        Formerly it was to the contrary the rounded corners which were ignored
+        in case an inset shadow was specified.
+
+   - ``<prefix>_TeXcolor`` and ``<prefix>_TeXextras`` are new with 6.2.0.
+
+     Usefulness is doubtful in the case of :rst:dir:`code-block`:
+
+     - ``pre_TeXcolor`` will influence only the few non-Pygments highlighted
+       tokens; it does color the line numbers, but if one wants to color
+       *only* them one has to go through the ``fancyvrb`` interface.
+
+     - ``pre_TeXextras=\footnotesize`` for example may be replaced by usage of
+       the :confval:`latex_elements` key ``'fvset'``.  For ``'lualatex'`` or
+       ``'xelatex'`` Sphinx includes in the preamble already
+       ``\fvset{fontsize=\small}`` and this induces ``fancyvrb`` into
+       overriding a ``\footnotesize`` coming from ``pre_TeXextras``.  One has
+       to use ``pre_TeXextras=\fvset{fontsize=\footnotesize}`` syntax.
+       Simpler to set directly the :confval:`latex_elements` key
+       ``'fvset'``...
+
+     Consider these options experimental and that some implementation details
+     may change.  For example if the ``pre_TeXextras`` LaTeX commands were put
+     by Sphinx in another location it could override the ``'fvset'`` effect,
+     perhaps this is what will be done in a future release.
+
+   - Rounded boxes are done using the pict2e_ interface to some basic PDF
+     graphics operations.  If this LaTeX package can not be found the build
+     will proceed and render all boxes with straight corners.
+
+   - Elliptic corners use the ellipse_ LaTeX package which extends pict2e_.
+     If this LaTeX package can not be found rounded corners will be circular
+     arcs (or straight if pict2e_ is not available).
+
+.. _pict2e: https://ctan.org/pkg/pict2e
+.. _ellipse: https://ctan.org/pkg/ellipse
+
+
+The following legacy behavior is currently not customizable:
+
+- For :rst:dir:`code-block`, padding and border-width and shadow (if one adds
+  one) will go into the margin; the code lines remain at the same place
+  independently of the values of the padding and border-width, except for
+  being shifted vertically of course to not overwrite other text due to the
+  width of the border or external shadow.
+
+- For :dudir:`topic` (and contents_) the shadow (if on right) goes into the
+  page margin, but the border and the extra padding are kept within the text
+  area.  Same for admonitions.
+
+- The contents_ and :dudir:`topic` directives are governed by the same options
+  with ``div.topic`` prefix: the Sphinx LaTeX mark-up uses for both directives
+  the same ``sphinxShadowBox`` environment which has currently no additional
+  branching, contrarily to the ``sphinxadmonition`` environment which branches
+  according to the admonition directive name, e.g. either to ``sphinxnote``
+  or ``sphinxwarning`` etc...
+
 
 LaTeX macros and environments
 -----------------------------
@@ -970,39 +1444,78 @@
 
 - Text styling commands:
 
-  - ``\sphinxstrong``,
-  - ``\sphinxbfcode``,
-  - ``\sphinxemail``,
-  - ``\sphinxtablecontinued``,
-  - ``\sphinxtitleref``,
-  - ``\sphinxmenuselection``,
-  - ``\sphinxaccelerator``,
-  - ``\sphinxcrossref``,
-  - ``\sphinxtermref``,
-  - ``\sphinxoptional``.
+  .. csv-table::
+     :header: Name, ``maps argument #1 to:``
+     :align: left
+     :class: longtable
+     :delim: ;
+
+     ``\sphinxstrong``;         ``\textbf{#1}``
+     ``\sphinxcode``;           ``\texttt{#1}``
+     ``\sphinxbfcode``;         ``\textbf{\sphinxcode{#1}}``
+     ``\sphinxemail``;          ``\textsf{#1}``
+     ``\sphinxtablecontinued``; ``\textsf{#1}``
+     ``\sphinxtitleref``;       ``\emph{#1}``
+     ``\sphinxmenuselection``;  ``\emph{#1}``
+     ``\sphinxguilabel``;       ``\emph{#1}``
+     ``\sphinxkeyboard``;       ``\sphinxcode{#1}``
+     ``\sphinxaccelerator``;    ``\underline{#1}``
+     ``\sphinxcrossref``;       ``\emph{#1}``
+     ``\sphinxtermref``;        ``\emph{#1}``
+     ``\sphinxsamedocref``;     ``\emph{#1}``
+     ``\sphinxparam``;          ``\emph{#1}``
+     ``\sphinxoptional``; ``#1`` with larger brackets, see source
 
   .. versionadded:: 1.4.5
      Use of ``\sphinx`` prefixed macro names to limit possibilities of conflict
      with LaTeX packages.
 
+  .. versionadded:: 1.8
+     ``\sphinxguilabel``
+
+  .. versionadded:: 3.0
+     ``\sphinxkeyboard``
+
+  .. versionadded:: 6.2.0
+     ``\sphinxparam``, ``\sphinxsamedocref``
+
 - More text styling:
 
-  - ``\sphinxstyleindexentry``,
-  - ``\sphinxstyleindexextra``,
-  - ``\sphinxstyleindexpageref``,
-  - ``\sphinxstyletopictitle``,
-  - ``\sphinxstylesidebartitle``,
-  - ``\sphinxstyleothertitle``,
-  - ``\sphinxstylesidebarsubtitle``,
-  - ``\sphinxstyletheadfamily``,
-  - ``\sphinxstyleemphasis``,
-  - ``\sphinxstyleliteralemphasis``,
-  - ``\sphinxstylestrong``,
-  - ``\sphinxstyleliteralstrong``,
-  - ``\sphinxstyleabbreviation``,
-  - ``\sphinxstyleliteralintitle``,
-  - ``\sphinxstylecodecontinued``,
-  - ``\sphinxstylecodecontinues``.
+  .. csv-table::
+     :header: Name, ``maps argument #1 to:``
+     :align: left
+     :class: longtable
+     :delim: ;
+
+     ``\sphinxstyleindexentry``;       ``\texttt{#1}``
+     ``\sphinxstyleindexextra``;       ``(\emph{#1})`` (with a space upfront)
+     ``\sphinxstyleindexpageref``;     ``, \pageref{#1}``
+     ``\sphinxstyleindexpagemain``;    ``\textbf{#1}``
+     ``\sphinxstyleindexlettergroup``; ``{\Large\sffamily#1}\nopagebreak\vspace{1mm}``
+     ``\sphinxstyleindexlettergroupDefault``; check source, too long for here
+     ``\sphinxstyletopictitle``;       ``\textbf{#1}\par\medskip``
+     ``\sphinxstylesidebartitle``;     ``\textbf{#1}\par\medskip``
+     ``\sphinxstyleothertitle``;       ``\textbf{#1}``
+     ``\sphinxstylesidebarsubtitle``;  ``~\\\textbf{#1} \smallskip``
+     ``\sphinxstyletheadfamily``;      ``\sffamily`` (*this one has no argument*)
+     ``\sphinxstyleemphasis``;         ``\emph{#1}``
+     ``\sphinxstyleliteralemphasis``;  ``\emph{\sphinxcode{#1}}``
+     ``\sphinxstylestrong``;           ``\textbf{#1}``
+     ``\sphinxstyleliteralstrong``;    ``\sphinxbfcode{#1}``
+     ``\sphinxstyleabbreviation``;     ``\textsc{#1}``
+     ``\sphinxstyleliteralintitle``;   ``\sphinxcode{#1}``
+     ``\sphinxstylecodecontinued``;    ``{\footnotesize(#1)}}``
+     ``\sphinxstylecodecontinues``;    ``{\footnotesize(#1)}}``
+     ``\sphinxstylenotetitle``;        ``\sphinxstrong{#1}<space>``
+     ``\sphinxstylehinttitle``;        *idem*
+     ``\sphinxstyleimportanttitle``;   *idem*
+     ``\sphinxstyletiptitle``;         *idem*
+     ``\sphinxstylewarningtitle``;     *idem*
+     ``\sphinxstylecautiontitle``;     *idem*
+     ``\sphinxstyleattentiontitle``;   *idem*
+     ``\sphinxstyledangertitle``;      *idem*
+     ``\sphinxstyleerrortitle``;       *idem*
+     ``\sphinxstyleseealsotitle``;     ``\sphinxstrong{#1}\par\nopagebreak``
 
   .. versionadded:: 1.5
      These macros were formerly hard-coded as non customizable ``\texttt``,
@@ -1015,8 +1528,29 @@
   .. versionadded:: 1.6.3
      ``\sphinxstylecodecontinued`` and ``\sphinxstylecodecontinues``.
 
-  .. versionadded:: 3.0
-     ``\sphinxkeyboard``
+  .. versionadded:: 1.8
+     ``\sphinxstyleindexlettergroup``, ``\sphinxstyleindexlettergroupDefault``.
+
+  .. versionadded:: 6.2.0
+     ``\sphinxstylenotetitle`` et al.  The ``#1`` is the localized name of the
+     directive, with a final colon.  Wrap it as ``\sphinxremovefinalcolon{#1}``
+     if this final colon is to be removed.  Examples:
+
+     .. code-block:: latex
+
+        \renewcommand\sphinxstylewarningtitle1{%
+          \underline{\textbf{\sphinxremovefinalcolon{#1}}}\par
+        }
+        \renewcommand{\sphinxstylenotetitle}1{%
+          \textit{\textbf{\sphinxremovefinalcolon{#1}}}\par\nobreak
+          % LaTeX syntax is complex and we would be better off using \hrule.
+          {\parskip0pt\noindent}%
+          \raisebox{1ex}%
+           {\makebox\linewidth{\textcolor{sphinxnoteBorderColor}{\dotfill}}}
+          % It is complex to obtain nice vertical spacing for both a paragraph
+          % or a list following up; this set-up is better for a paragraph next.
+          \par\vskip-\parskip
+        }
 
 - ``\sphinxtableofcontents``: A wrapper (defined differently in
   :file:`sphinxhowto.cls` and in :file:`sphinxmanual.cls`) of standard
@@ -1032,6 +1566,12 @@
      ``\sphinxtableofcontentshook``.  This macro is also executed by the
      ``'howto'`` docclass, but defaults to empty with it.
 
+  .. hint::
+
+     If adding to preamble the loading of ``tocloft`` package, also add to
+     preamble ``\renewcommand\sphinxtableofcontentshook{}`` else it will reset
+     ``\l@section`` and ``\l@subsection`` cancelling ``tocloft`` customization.
+
 - ``\sphinxmaketitle``: Used as the default setting of the ``'maketitle'``
   :confval:`latex_elements` key.
   Defined in the class files :file:`sphinxmanual.cls` and
@@ -1051,6 +1591,99 @@
 
 - ``\sphinxcite``: A wrapper of standard ``\cite`` for citation references.
 
+
+.. _sphinxbox:
+
+The ``\sphinxbox`` command
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.2.0
+
+The ``\sphinxboxkey=value,...{inline text}`` command can be used to "box"
+inline text elements with all the customizability which has been described in
+:ref:`additionalcss`.  It is a LaTeX command with one optional argument, which
+is a comma-separated list of key=value pairs, as for :ref:`latexsphinxsetup`.
+Here is the complete list of keys.  They don't use any prefix.
+
+- ``border-width``,
+- ``border-top-width``, ``border-right-width``, ``border-bottom-width``,
+  ``border-left-width``,
+- ``padding``,
+- ``padding-top``, ``padding-right``, ``padding-bottom``, ``padding-left``,
+- ``border-radius``,
+- ``border-top-left-radius``, ``border-top-right-radius``,
+  ``border-bottom-right-radius``, ``border-bottom-left-radius``,
+- ``box-shadow``,
+- ``border-TeXcolor``, ``background-TeXcolor``, ``box-shadow-TeXcolor``,
+  ``TeXcolor``,
+- ``TeXextras``,
+- and ``addstrut`` which is a boolean key, i.e. to be used as ``addstrut=true``,
+  or ``addstrut`` alone where ``=true`` is omitted, or ``addstrut=false``.
+
+This last key is specific to ``\sphinxbox`` and it means to add a ``\strut``
+so that heights and depths are equalized across various instances on the same
+line with varying contents.  The default is ``addstrut=false``.
+
+.. important::
+
+   Perhaps the default will turn into ``addstrut=true`` at 7.0.0 depending on
+   feedback until then.
+
+The combination ``addstrut, padding-bottom=0pt, padding-top=1pt`` is often
+satisfactory.
+
+Refer to :ref:`additionalcss` for important syntax information regarding the
+other keys.  The default
+configuration uses no shadow, a border-width of ``\fboxrule``, a padding of
+``\fboxsep``, circular corners with radii ``\fboxsep`` and background and
+border colors as for the default rendering of code-blocks.
+
+When a ``\sphinxbox`` usage is nested within another one, it will ignore the
+options of the outer one: it first resets all options to their default state
+as they were prior to applying the outer box options, then it applies its own
+specific ones.
+
+One can modify these defaults via the command ``\sphinxboxsetup{key=value,...}``.
+The effect is cumulative, if one uses this command multiple times.  Here the
+options are a mandatory argument so are within curly braces, not square
+brackets.
+
+Here is some example of use:
+
+.. code-block:: latex
+
+   latex_elements = {
+       'preamble': r'''
+   % modify globally the defaults
+   \sphinxboxsetup{border-width=2pt,%
+                   border-radius=4pt,%
+                   background-TeXcolor=yellow!20}
+   % configure some styling element with some extra specific options:
+   \protected\def\sphinxkeyboard#1{\sphinxboxborder-TeXcolor=green{\sphinxcode{#1}}}
+   ''',
+   }
+
+A utility ``\newsphinxbox`` is provided to create a new boxing macro, say
+``\foo`` which will act exactly like ``\sphinxbox`` but with a given extra
+configuration:
+
+.. code-block:: latex
+
+   % the specific options to \foo are within brackets
+   \newsphinxboxborder-radius=0pt, box-shadow=2pt 2pt{\foo}
+   % then use this \foo, possibly with some extra options still:
+   \protected\def\sphinxguilabel#1{\foo{#1}}
+   \protected\def\sphinxmenuselection#1{\foobox-shadow-TeXcolor=gray{#1}}
+
+Boxes rendered with ``\foo`` obey as the ones using directly ``\sphinxbox``
+the current configuration as set possibly mid-way in document via
+``\sphinxboxsetup`` (from a :dudir:`raw` LaTeX mark-up), the only difference
+is that they have an initial additional set of default extras.
+
+In the above examples, you can probably use ``\renewcommand`` syntax if you
+prefer it to ``\protected\def`` (with ``1`` in place of ``#1`` then).
+
+
 Environments
 ~~~~~~~~~~~~
 
@@ -1079,7 +1712,7 @@
   of the notice, for example ``Warning:`` for :dudir:`warning` directive, if
   English is the document language). Their default definitions use either the
   *sphinxheavybox* (for the last 5 ones) or the *sphinxlightbox*
-  environments, configured to use the parameters (colours, border thickness)
+  environments, configured to use the parameters (colors, border thickness)
   specific to each type, which can be set via ``'sphinxsetup'`` string.
 
   .. versionchanged:: 1.5
@@ -1087,7 +1720,17 @@
      parameters, such as ``noteBorderColor``, ``noteborder``,
      ``warningBgColor``, ``warningBorderColor``, ``warningborder``, ...
 
-- The :dudir:`contents` directive (with ``:local:`` option) and the
+- Environment for the :rst:dir:`seealso` directive: ``sphinxseealso``.
+  It takes one argument which will be the localized string ``See also``
+  followed with a colon.
+
+  .. versionadded:: 6.1.0
+  .. versionchanged:: 6.2.0
+
+     Colon made part of the mark-up rather than being inserted by the
+     environment for coherence with how admonitions are handled generally.
+
+- The contents_ directive (with ``:local:`` option) and the
   :dudir:`topic` directive are implemented by environment ``sphinxShadowBox``.
 
   .. versionadded:: 1.4.2
@@ -1100,7 +1743,7 @@
   implemented using ``sphinxVerbatim`` environment which is a wrapper of
   ``Verbatim`` environment from package ``fancyvrb.sty``. It adds the handling
   of the top caption and the wrapping of long lines, and a frame which allows
-  pagebreaks. Inside tables the used
+  page breaks. Inside tables the used
   environment is ``sphinxVerbatimintable`` (it does not draw a frame, but
   allows a caption).
 
@@ -1151,6 +1794,8 @@
      Formerly, use of *fncychap* with other styles than ``Bjarne`` was
      dysfunctional.
 
+.. _latexcontainer:
+
 - Docutils :dudir:`container` directives are supported in LaTeX output: to
   let a container class with name ``foo`` influence the final PDF via LaTeX,
   it is only needed to define in the preamble an environment

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/man/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/man/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/man/sphinx-apidoc.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/man/sphinx-apidoc.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/man/sphinx-autogen.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/man/sphinx-autogen.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/man/sphinx-build.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/man/sphinx-build.rst Changed

@@ -138,7 +138,7 @@
    the build directory; with this option you can select a different cache
    directory (the doctrees can be shared between all builders).
 
-.. option:: -j N
+.. option:: -j N, --jobs N
 
    Distribute the build over *N* processes in parallel, to make building on
    multiprocessor machines more effective.  Note that not all parts and not all
@@ -151,6 +151,9 @@
    .. versionchanged:: 1.7
       Support ``auto`` argument.
 
+   .. versionchanged:: 6.2
+      Add ``--jobs`` long option.
+
 .. option:: -c path
 
    Don't look for the :file:`conf.py` in the source directory, but use the given
@@ -304,6 +307,22 @@
    Additional options for :program:`sphinx-build`. These options can
    also be set via the shortcut variable **O** (capital 'o').
 
+.. describe:: NO_COLOR
+
+   When set (regardless of value), :program:`sphinx-build`  will not use color
+   in terminal output. ``NO_COLOR`` takes precedence over ``FORCE_COLOR``. See
+   `no-color.org <https://no-color.org/>`__ for other libraries supporting this
+   community standard.
+
+   .. versionadded:: 4.5.0
+
+.. describe:: FORCE_COLOR
+
+   When set (regardless of value), :program:`sphinx-build` will use color in
+   terminal output. ``NO_COLOR`` takes precedence over ``FORCE_COLOR``.
+
+   .. versionadded:: 4.5.0
+
 .. _when-deprecation-warnings-are-displayed:
 
 Deprecation Warnings

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/man/sphinx-quickstart.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/man/sphinx-quickstart.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/doc/support.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/tutorial/automatic-doc-generation.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/tutorial/automatic-doc-generation.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/tutorial/deploying.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/tutorial/deploying.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/tutorial/describing-code.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/tutorial/describing-code.rst Changed

@@ -57,7 +57,7 @@
 - Sphinx parsed the argument of the ``.. py:function`` directive and
   highlighted the module, the function name, and the parameters appropriately.
 - The directive content includes a one-line description of the function,
-  as well as a :ref:`info field list <info-field-lists>` containing the function
+  as well as an :ref:`info field list <info-field-lists>` containing the function
   parameter, its expected type, the return value, and the return type.
 
 .. note::
@@ -85,10 +85,11 @@
    or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients`
    will raise an exception.
 
-When generating code documentation, Sphinx will generate a cross-reference automatically just
-by using the name of the object, without you having to explicitly use a role
-for that. For example, you can describe the custom exception raised by the
-function using the :rst:dir:`py:exception` directive:
+When generating code documentation, Sphinx will generate a
+cross-reference automatically just by using the name of the object,
+without you having to explicitly use a role for that. For example, you
+can describe the custom exception raised by the function using the
+:rst:dir:`py:exception` directive:
 
 .. code-block:: rst
    :caption: docs/source/usage.rst

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/tutorial/end.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/tutorial/end.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/tutorial/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/tutorial/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/advanced/intl.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/advanced/intl.rst Changed

@@ -68,6 +68,24 @@
 * Run your desired build.
 
 
+In order to protect against mistakes, a warning is emitted if
+cross-references in the translated paragraph do not match those from the
+original.  This can be turned off globally using the
+:confval:`suppress_warnings` configuration variable.  Alternatively, to
+turn it off for one message only, end the message with ``#noqa`` like
+this::
+
+   Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse
+   risus tortor, luctus id ultrices at. #noqa
+
+(Write ``\#noqa`` in case you want to have "#noqa" literally in the
+text.  This does not apply to code blocks, where ``#noqa`` is ignored
+because code blocks do not contain references anyway.)
+
+.. versionadded:: 4.5
+   The ``#noqa`` mechanism.
+
+
 Translating with sphinx-intl
 ----------------------------
 
@@ -150,7 +168,7 @@
    You need a :confval:`language` parameter in ``conf.py`` or you may also
    specify the parameter on the command line.
 
-   For for BSD/GNU make, run:
+   For BSD/GNU make, run:
 
    .. code-block:: console
 
@@ -216,9 +234,9 @@
 
    .. seealso:: `Transifex Client documentation`_
 
-#. Create your transifex_ account and create new project for your document.
+#. Create your Transifex_ account and create new project for your document.
 
-   Currently, transifex does not allow for a translation project to have more
+   Currently, Transifex does not allow for a translation project to have more
    than one version of the document, so you'd better include a version number in
    your project name.
 
@@ -243,7 +261,7 @@
       ...
       Done.
 
-#. Upload pot files to transifex service.
+#. Upload pot files to Transifex service.
 
    Register pot files to ``.tx/config`` file:
 
@@ -264,7 +282,7 @@
       ...
       Done.
 
-#. Forward the translation on transifex.
+#. Forward the translation on Transifex.
 
    .. TODO: write this section
 
@@ -294,12 +312,18 @@
 
    If you want to push all language's po files, you can be done by using
    :command:`tx push -t` command.  Watch out! This operation overwrites
-   translations in transifex.
+   translations in Transifex.
 
    In other words, if you have updated each in the service and local po files,
    it would take much time and effort to integrate them.
 
 
+Using Weblate service for team translation
+------------------------------------------
+
+Read more in `Weblate's documentation`_.
+
+
 Contributing to Sphinx reference translation
 --------------------------------------------
 
@@ -308,11 +332,11 @@
 
 There is a `sphinx translation page`_ for Sphinx (master) documentation.
 
-1. Login to transifex_ service.
+1. Login to Transifex_ service.
 2. Go to `sphinx translation page`_.
 3. Click ``Request language`` and fill form.
-4. Wait acceptance by transifex sphinx translation maintainers.
-5. (After acceptance) Translate on transifex.
+4. Wait acceptance by Transifex sphinx translation maintainers.
+5. (After acceptance) Translate on Transifex.
 
 Detail is here: https://docs.transifex.com/getting-started-1/translators
 
@@ -326,5 +350,6 @@
 .. _`transifex-client`: https://pypi.org/project/transifex-client/
 .. _`sphinx-intl`: https://pypi.org/project/sphinx-intl/
 .. _Transifex: https://www.transifex.com/
+.. _Weblate's documentation: https://docs.weblate.org/en/latest/devel/sphinx.html
 .. _`sphinx translation page`: https://www.transifex.com/sphinx-doc/sphinx-doc/
 .. _`Transifex Client documentation`: https://docs.transifex.com/client/introduction/

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/advanced/websupport/quickstart.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/advanced/websupport/quickstart.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/builders/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/builders/index.rst Changed

@@ -159,60 +159,56 @@
 
    .. versionchanged:: 1.5
 
-      Since Sphinx-1.5, the epub3 builder is used for the default builder of
-      epub.
+      Since Sphinx 1.5, the epub3 builder is used as the default epub builder.
 
 .. module:: sphinx.builders.latex
 .. class:: LaTeXBuilder
 
-   This builder produces a bunch of LaTeX files in the output directory.  You
-   have to specify which documents are to be included in which LaTeX files via
-   the :confval:`latex_documents` configuration value.  There are a few
-   configuration values that customize the output of this builder, see the
-   chapter :ref:`latex-options` for details.
+   This builder produces LaTeX source files in the output directory.  The
+   actual PDF builds happen inside this output directory and need to be
+   triggered in a second step.  This can be done via
+   :program:`make all-pdf` there.
+   To combine the two steps into only one, use :option:`sphinx-build -M`
+   (i.e. ``-M latexpdf`` not ``-b latexpdf``) or :program:`make latexpdf`
+   at the project root.
 
-   The produced LaTeX file uses several LaTeX packages that may not be present
-   in a "minimal" TeX distribution installation.
+   See :confval:`latex_documents` and the chapter :ref:`latex-options` for
+   available options.
 
-   On Ubuntu xenial, the following packages need to be installed for
-   successful PDF builds:
+   PDF builds need a sufficiently complete LaTeX installation.
+   The testing is currently (since 5.3.0) done on Ubuntu 22.04LTS,
+   whose LaTeX distribution matches upstream TeXLive 2021 as of 2022/02/04,
+   but PDF builds can be successfully done on much older LaTeX installations.
+
+   At any rate, on Ubuntu for example, following packages must all be present:
 
    * ``texlive-latex-recommended``
    * ``texlive-fonts-recommended``
-   * ``tex-gyre`` (if :confval:`latex_engine` is ``'pdflatex'``)
+   * ``tex-gyre`` (if :confval:`latex_engine` left to default)
    * ``texlive-latex-extra``
-   * ``latexmk`` (this is a Sphinx requirement on GNU/Linux and MacOS X
-     for functioning of ``make latexpdf``)
+   * ``latexmk``
+
+   .. versionchanged:: 4.0.0
+      TeX Gyre fonts now required for ``'pdflatex'`` engine (default).
 
-   Additional packages are needed in some circumstances (see the discussion of
-   the ``'fontpkg'`` key of :confval:`latex_elements` for more information):
+   Additional packages are needed in some circumstances:
 
-   * ``texlive-lang-cyrillic`` for Cyrillic (even individual letters), and,
-     ``cm-super`` or ``cm-super-minimal`` (if default fonts),
-   * ``texlive-lang-greek`` for Greek (even individual letters), and,
-     ``cm-super`` or ``cm-super-minimal`` (if default fonts),
+   * ``texlive-lang-cyrillic`` for Cyrillic (and also then
+     ``cm-super`` if using the default fonts),
+   * ``texlive-lang-greek`` for Greek (and also then
+     ``cm-super`` if using the default fonts),
    * ``texlive-xetex`` if :confval:`latex_engine` is ``'xelatex'``,
    * ``texlive-luatex`` if :confval:`latex_engine` is ``'lualatex'``,
-   * ``fonts-freefont-otf`` if :confval:`latex_engine` is ``'xelatex'``
-     or ``'lualatex'``.
-
-   The testing of Sphinx LaTeX is done on Ubuntu xenial whose TeX distribution
-   is based on a TeXLive 2015 snapshot dated March 2016.
-
-   .. versionchanged:: 1.6
-      Formerly, testing had been done on Ubuntu precise (TeXLive 2009).
-
-   .. versionchanged:: 2.0
-      Formerly, testing had been done on Ubuntu trusty (TeXLive 2013).
-
-   .. versionchanged:: 4.0.0
-      TeX Gyre fonts dependency for the default LaTeX font configuration.
+   * ``fonts-freefont-otf`` if :confval:`latex_engine` is either
+     ``'xelatex'`` or ``'lualatex'``.
 
    .. note::
 
-      Since 1.6, ``make latexpdf`` uses ``latexmk`` (not on Windows).  This
-      makes sure the needed number of runs is automatically executed to get
-      the cross-references, bookmarks, indices, and tables of contents right.
+      Since 1.6, ``make latexpdf`` uses on GNU/Linux and macOS
+      :program:`latexmk`, as it
+      makes sure the needed number of runs is automatically executed.
+      On Windows the PDF builds execute a fix number of LaTeX runs
+      (three, then ``makeindex``, then two more).
 
       One can pass to ``latexmk`` options via the ``LATEXMKOPTS``
       Makefile variable. For example:
@@ -244,7 +240,7 @@
 name is ``rinoh``. Refer to the `rinohtype manual`_ for details.
 
 .. _rinohtype: https://github.com/brechtm/rinohtype
-.. _rinohtype manual: https://www.mos6581.org/rinohtype/quickstart.html#sphinx-builder
+.. _rinohtype manual: https://www.mos6581.org/rinohtype/master/quickstart.html#sphinx-builder
 
 .. module:: sphinx.builders.text
 .. class:: TextBuilder
@@ -441,7 +437,7 @@
 
    .. versionchanged:: 1.5
 
-      Since Sphinx-1.5, the linkcheck builder comes to use requests module.
+      Since Sphinx 1.5, the linkcheck builder uses the requests module.
 
    .. versionchanged:: 3.4

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/configuration.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/configuration.rst Changed

@@ -14,12 +14,12 @@
 and contains (almost) all configuration needed to customize Sphinx input
 and output behavior.
 
-  An optional file `docutils.conf`_ can be added to the configuration
-  directory to adjust `Docutils`_ configuration if not otherwise overridden or
-  set by Sphinx.
+An optional file `docutils.conf`_ can be added to the configuration
+directory to adjust `Docutils`_ configuration if not otherwise overridden or
+set by Sphinx.
 
-  .. _`docutils`: https://docutils.sourceforge.io/
-  .. _`docutils.conf`: https://docutils.sourceforge.io/docs/user/config.html
+.. _`docutils`: https://docutils.sourceforge.io/
+.. _`docutils.conf`: https://docutils.sourceforge.io/docs/user/config.html
 
 The configuration file is executed as Python code at build time (using
 :func:`importlib.import_module`, and with the current directory set to its
@@ -200,15 +200,14 @@
 
 .. confval:: exclude_patterns
 
-   A list of glob-style patterns that should be excluded when looking for
-   source files. 1_ They are matched against the source file names relative
+   A list of glob-style patterns 1_ that should be excluded when looking for
+   source files. They are matched against the source file names relative
    to the source directory, using slashes as directory separators on all
    platforms.
 
    Example patterns:
 
-   - ``'library/xml.rst'`` -- ignores the ``library/xml.rst`` file (replaces
-     entry in :confval:`unused_docs`)
+   - ``'library/xml.rst'`` -- ignores the ``library/xml.rst`` file
    - ``'library/xml'`` -- ignores the ``library/xml`` directory
    - ``'library/xml*'`` -- ignores all files and directories starting with
      ``library/xml``
@@ -219,6 +218,23 @@
 
    .. versionadded:: 1.0
 
+.. confval:: include_patterns
+
+   A list of glob-style patterns 1_ that are used to find source files. They
+   are matched against the source file names relative to the source directory,
+   using slashes as directory separators on all platforms. The default is ``**``,
+   meaning that all files are recursively included from the source directory.
+
+   Example patterns:
+
+   - ``'**'`` -- all files in the source directory and subdirectories, recursively
+   - ``'library/xml'`` -- just the ``library/xml`` directory
+   - ``'library/xml*'`` -- all files and directories starting with ``library/xml``
+   - ``'**/doc'`` -- all ``doc`` directories (this might be useful if
+     documentation is co-located with source files)
+
+   .. versionadded:: 5.1
+
 .. confval:: templates_path
 
    A list of paths that contain extra templates (or templates that overwrite
@@ -291,7 +307,7 @@
    "filter".  The default is ``None``, which doesn't reassign the default role.
 
    The default role can always be set within individual documents using the
-   standard reST :rst:dir:`default-role` directive.
+   standard reST :dudir:`default-role` directive.
 
    .. versionadded:: 0.4
 
@@ -316,7 +332,11 @@
    * ``app.add_role``
    * ``app.add_generic_role``
    * ``app.add_source_parser``
+   * ``autosectionlabel.*``
    * ``download.not_readable``
+   * ``epub.unknown_project_files``
+   * ``epub.duplicated_toc_entry``
+   * ``i18n.inconsistent_references``
    * ``image.not_readable``
    * ``ref.term``
    * ``ref.ref``
@@ -332,11 +352,9 @@
    * ``toc.excluded``
    * ``toc.not_readable``
    * ``toc.secnum``
-   * ``epub.unknown_project_files``
-   * ``epub.duplicated_toc_entry``
-   * ``autosectionlabel.*``
 
-   You can choose from these types.
+   You can choose from these types.  You can also give only the first
+   component to exclude all warnings attached to it.
 
    Now, this option should be considered *experimental*.
 
@@ -366,6 +384,10 @@
 
       Added ``toc.excluded`` and ``toc.not_readable``
 
+   .. versionadded:: 4.5
+
+      Added ``i18n.inconsistent_references``
+
 .. confval:: needs_sphinx
 
    If set to a ``major.minor`` version string like ``'1.1'``, Sphinx will
@@ -392,14 +414,14 @@
 
 .. confval:: manpages_url
 
-   A URL to cross-reference :rst:role:`manpage` directives. If this is
+   A URL to cross-reference :rst:role:`manpage` roles. If this is
    defined to ``https://manpages.debian.org/{path}``, the
    :literal:`:manpage:`man(1)`` role will link to
    <https://manpages.debian.org/man(1)>. The patterns available are:
 
-     * ``page`` - the manual page (``man``)
-     * ``section`` - the manual section (``1``)
-     * ``path`` - the original manual page and section specified (``man(1)``)
+   * ``page`` - the manual page (``man``)
+   * ``section`` - the manual section (``1``)
+   * ``path`` - the original manual page and section specified (``man(1)``)
 
    This also supports manpages specified as ``man.1``.
 
@@ -418,12 +440,14 @@
 
 .. confval:: nitpick_ignore
 
-   A list of ``(type, target)`` tuples (by default empty) that should be
+   A set or list of ``(type, target)`` tuples (by default empty) that should be
    ignored when generating warnings in "nitpicky mode".  Note that ``type``
    should include the domain name if present.  Example entries would be
    ``('py:func', 'int')`` or ``('envvar', 'LD_LIBRARY_PATH')``.
 
    .. versionadded:: 1.1
+   .. versionchanged:: 6.2
+      Changed allowable container types to a set, list, or tuple
 
 .. confval:: nitpick_ignore_regex
 
@@ -438,6 +462,8 @@
    ``('py:class', 'food.bar.Barman')``.
 
    .. versionadded:: 4.1
+   .. versionchanged:: 6.2
+      Changed allowable container types to a set, list, or tuple
 
 .. confval:: numfig
 
@@ -546,7 +572,7 @@
          make latex O="-D smartquotes_action="
 
       This can follow some ``make html`` with no problem, in contrast to the
-      situation from the prior note.  It requires Docutils 0.14 or later.
+      situation from the prior note.
 
    .. versionadded:: 1.6.6
 
@@ -656,6 +682,29 @@
    :term:`object` names (for object types where a "module" of some kind is
    defined), e.g. for :rst:dir:`py:function` directives.  Default is ``True``.
 
+.. confval:: toc_object_entries
+
+  Create table of contents entries for domain objects (e.g. functions, classes,
+  attributes, etc.). Default is ``True``.
+
+.. confval:: toc_object_entries_show_parents
+
+   A string that determines how domain objects (e.g. functions, classes,
+   attributes, etc.) are displayed in their table of contents entry.
+
+   Use ``domain`` to allow the domain to determine the appropriate number of
+   parents to show. For example, the Python domain would show ``Class.method()``
+   and ``function()``, leaving out the ``module.`` level of parents.
+   This is the default setting.
+
+   Use ``hide`` to only show the name of the element without any parents
+   (i.e. ``method()``).
+
+   Use ``all`` to show the fully-qualified name for the object
+   (i.e. ``module.Class.method()``),  displaying all parents.
+
+   .. versionadded:: 5.2
+
 .. confval:: show_authors
 
    A boolean that decides whether :rst:dir:`codeauthor` and
@@ -698,8 +747,17 @@
    This was the behaviour before version 3.0, and setting this variable to
    ``True`` will reinstate that behaviour.
 
-    .. versionadded:: 3.0
+   .. versionadded:: 3.0
+
+.. confval:: option_emphasise_placeholders
 
+   Default is ``False``.
+   When enabled, emphasise placeholders in :rst:dir:`option` directives.
+   To display literal braces, escape with a backslash (``\{``). For example,
+   ``option_emphasise_placeholders=True`` and ``.. option:: -foption={TYPE}`` would
+   render with ``TYPE`` emphasised.
+
+   .. versionadded:: 5.1
 
 .. _intl-options:
 
@@ -719,7 +777,7 @@
    (e.g. the German version of ``myfigure.png`` will be ``myfigure.de.png``
    by default setting) and substitute them for original figures.  In the LaTeX
    builder, a suitable language will be selected as an option for the *Babel*
-   package.  Default is ``None``, which means that no translation will be done.
+   package.  Default is ``'en'``.
 
    .. versionadded:: 0.5
 
@@ -727,6 +785,8 @@
 
       Support figure substitution
 
+   .. versionchanged:: 5.0
+
    Currently supported languages by Sphinx are:
 
    * ``ar`` -- Arabic
@@ -739,7 +799,7 @@
    * ``da`` -- Danish
    * ``de`` -- German
    * ``el`` -- Greek
-   * ``en`` -- English
+   * ``en`` -- English (default)
    * ``eo`` -- Esperanto
    * ``es`` -- Spanish
    * ``et`` -- Estonian
@@ -1076,7 +1136,7 @@
 
    As a special attribute, *priority* can be set as an integer to load the CSS
    file earlier or lazier step.  For more information, refer
-   :meth:`Sphinx.add_css_files()`.
+   :meth:`.Sphinx.add_css_file()`.
 
    .. versionadded:: 1.8
    .. versionchanged:: 3.5
@@ -1099,7 +1159,7 @@
 
    As a special attribute, *priority* can be set as an integer to load the CSS
    file earlier or lazier step.  For more information, refer
-   :meth:`Sphinx.add_css_files()`.
+   :meth:`.Sphinx.add_css_file()`.
 
    .. versionadded:: 1.8
    .. versionchanged:: 3.5
@@ -1161,7 +1221,7 @@
 .. confval:: html_last_updated_fmt
 
    If this is not None, a 'Last updated on:' timestamp is inserted
-   at every page bottom, using the given :func:`strftime` format.
+   at every page bottom, using the given :func:`~time.strftime` format.
    The empty string is equivalent to ``'%b %d, %Y'`` (or a
    locale-dependent equivalent).
 
@@ -1173,24 +1233,6 @@
    .. deprecated:: 1.6
       To disable smart quotes, use rather :confval:`smartquotes`.
 
-.. confval:: html_add_permalinks
-
-   Sphinx will add "permalinks" for each heading and description environment as
-   paragraph signs that become visible when the mouse hovers over them.
-
-   This value determines the text for the permalink; it defaults to ``"¶"``.
-   Set it to ``None`` or the empty string to disable permalinks.
-
-   .. versionadded:: 0.6
-      Previously, this was always activated.
-
-   .. versionchanged:: 1.1
-      This can now be a string to select the actual text of the link.
-      Previously, only boolean values were accepted.
-
-   .. deprecated:: 3.5
-      This has been replaced by :confval:`html_permalinks`
-
 .. confval:: html_permalinks
 
    If true, Sphinx will add "permalinks" for each heading and description
@@ -1331,8 +1373,8 @@
 
 .. confval:: html_file_suffix
 
-   This is the file name suffix for generated HTML files.  The default is
-   ``".html"``.
+   This is the file name suffix for generated HTML files, if set to a :obj:`str`
+   value.  If left to the default ``None``, the suffix will be ``".html"``.
 
    .. versionadded:: 0.4
 
@@ -1351,6 +1393,13 @@
 
    .. versionadded:: 1.0
 
+.. confval:: html_show_search_summary
+
+   If true, the text around the keyword is shown as summary of each search result.
+   Default is ``True``.
+
+   .. versionadded:: 4.5
+
 .. confval:: html_show_sphinx
 
    If true, "Created using Sphinx" is shown in the HTML footer.  Default is
@@ -1435,8 +1484,8 @@
 
    :type:
       _`type` is dotted module path string to specify Splitter implementation
-      which should be derived from :class:`sphinx.search.ja.BaseSplitter`.  If
-      not specified or None is specified,
+      which should be derived from :class:`!sphinx.search.ja.BaseSplitter`.  If
+      not specified or ``None`` is specified,
       ``'sphinx.search.ja.DefaultSplitter'`` will be used.
 
       You can choose from these modules:
@@ -1505,12 +1554,12 @@
 
 .. confval:: html_scaled_image_link
 
-   If true, images itself links to the original image if it doesn't have
+   If true, image itself links to the original image if it doesn't have
    'target' option or scale related options: 'scale', 'width', 'height'.
    The default is ``True``.
 
-   Document authors can this feature manually with giving ``no-scaled-link``
-   class to the image:
+   Document authors can disable this feature manually with giving
+   ``no-scaled-link`` class to the image:
 
    .. code-block:: rst
 
@@ -1687,7 +1736,7 @@
    Italian    it
    =========  ====
 
-   Defaults to :confval:`language`, or if that is not set, to :confval:`en`.
+   Defaults to :confval:`language`, or if that is not set, to ``'en'``.
 
 .. confval:: applehelp_locale
 
@@ -1695,7 +1744,7 @@
    the name of the ``.lproj`` folder inside the Help Book’s ``Resources``, and
    is passed to the help indexer.
 
-   Defaults to :confval:`language`, or if that is not set, to :confval:`en`.
+   Defaults to :confval:`language`, or if that is not set, to ``'en'``.
 
 .. confval:: applehelp_title
 
@@ -1876,7 +1925,7 @@
    the types can be explicitly overwritten if the default entries are not
    appropriate. Example::
 
-      epub_guide = (('cover', 'cover.html', u'Cover Page'),)
+      epub_guide = (('cover', 'cover.html', 'Cover Page'),)
 
    The default value is ``()``.
 
@@ -2170,6 +2219,102 @@
 
    .. versionadded:: 1.6
 
+.. confval:: latex_table_style
+
+   A list of styling classes (strings).  Currently supported:
+
+   - ``'booktabs'``: no vertical lines, and only 2 or 3 horizontal lines (the
+     latter if there is a header), using the booktabs_ package.
+
+   - ``'borderless'``: no lines whatsoever.
+
+   - ``'colorrows'``: the table rows are rendered with alternating background
+     colours.  The interface to customize them is via :ref:`dedicated keys
+     <tablecolors>` of :ref:`latexsphinxsetup`.
+
+     .. important::
+
+        With the ``'colorrows'`` style, the ``\rowcolors`` LaTeX command
+        becomes a no-op (this command has limitations and has never correctly
+        supported all types of tables Sphinx produces in LaTeX).  Please
+        update your project to use instead
+        the :ref:`latex table color configuration <tablecolors>` keys.
+
+   Default: ``'booktabs', 'colorrows'``
+
+   .. versionadded:: 5.3.0
+
+   .. versionchanged:: 6.0.0
+
+      Modify default from ```` to ``'booktabs', 'colorrows'``.
+
+   Each table can override the global style via ``:class:`` option, or
+   ``.. rst-class::`` for no-directive tables (cf.  :ref:`table-directives`).
+   Currently recognized classes are ``booktabs``, ``borderless``,
+   ``standard``, ``colorrows``, ``nocolorrows``.  The latter two can be
+   combined with any of the first three.  The ``standard`` class produces
+   tables with both horizontal and vertical lines (as has been the default so
+   far with Sphinx).
+
+   A single-row multi-column merged cell will obey the row colour, if it is
+   set.  See also ``TableMergeColor{Header,Odd,Even}`` in the
+   :ref:`latexsphinxsetup` section.
+
+   .. note::
+
+      - It is hard-coded in LaTeX that a single cell will obey the row colour
+        even if there is a column colour set via ``\columncolor`` from a
+        column specification (see :rst:dir:`tabularcolumns`).  Sphinx provides
+        ``\sphinxnorowcolor`` which can be used like this:
+
+        .. code-block:: latex
+
+           >{\columncolor{blue}\sphinxnorowcolor}
+
+        in a table column specification.
+
+      - Sphinx also provides ``\sphinxcolorblend`` which however requires the
+        xcolor_ package.  Here is an example:
+
+        .. code-block:: latex
+
+           >{\sphinxcolorblend{!95!red}}
+
+        It means that in this column, the row colours will be slightly tinted
+        by red; refer to xcolor_ documentation for more on the syntax of its
+        ``\blendcolors`` command (a ``\blendcolors`` in place of
+        ``\sphinxcolorblend`` would modify colours of the cell *contents*, not
+        of the cell *background colour panel*...).  You can find an example of
+        usage in the :ref:`dev-deprecated-apis` section of this document in
+        PDF format.
+
+        .. hint::
+
+           If you want to use a special colour for the *contents* of the
+           cells of a given column use ``>{\noindent\color{<color>}}``,
+           possibly in addition to the above.
+
+      - Multi-row merged cells, whether single column or multi-column
+        currently ignore any set column, row, or cell colour.
+
+      - It is possible for a simple cell to set a custom colour via the
+        :dudir:`raw` directive and the ``\cellcolor`` LaTeX command used
+        anywhere in the cell contents.  This currently is without effect
+        in a merged cell, whatever its kind.
+
+   .. hint::
+
+      In a document not using ``'booktabs'`` globally, it is possible to style
+      an individual table via the ``booktabs`` class, but it will be necessary
+      to add ``r'\usepackage{booktabs}'`` to the LaTeX preamble.
+
+      On the other hand one can use ``colorrows`` class for individual tables
+      with no extra package (as Sphinx since 5.3.0 always loads colortbl_).
+
+   .. _booktabs: https://ctan.org/pkg/booktabs
+   .. _colortbl: https://ctan.org/pkg/colortbl
+   .. _xcolor: https://ctan.org/pkg/xcolor
+
 .. confval:: latex_use_xindy
 
    If ``True``, the PDF build from the LaTeX files created by Sphinx
@@ -2231,6 +2376,15 @@
    You have to make sure yourself that the filenames don't collide with those
    of any automatically copied files.
 
+   .. attention::
+
+      Filenames with extension ``.tex`` will automatically be handed over to
+      the PDF build process triggered by :option:`sphinx-build -M`
+      ``latexpdf`` or by :program:`make latexpdf`.  If the file was added only
+      to be ``\input{}`` from a modified preamble, you must add a further
+      suffix such as ``.txt`` to the filename and adjust accordingly the
+      ``\input{}`` command added to the LaTeX document preamble.
+
    .. versionadded:: 0.6
 
    .. versionchanged:: 1.2
@@ -2753,24 +2907,6 @@
 
   .. versionadded:: 4.0.3
 
-.. confval:: c_allow_pre_v3
-
-   A boolean (default ``False``) controlling whether to parse and try to
-   convert pre-v3 style type directives and type roles.
-
-   .. versionadded:: 3.2
-   .. deprecated:: 3.2
-      Use the directives and roles added in v3.
-
-.. confval:: c_warn_on_allowed_pre_v3
-
-   A boolean (default ``True``) controlling whether to warn when a pre-v3
-   style type directive/role is parsed and converted.
-
-   .. versionadded:: 3.2
-   .. deprecated:: 3.2
-      Use the directives and roles added in v3.
-
 .. _cpp-config:
 
 Options for the C++ domain
@@ -2804,6 +2940,36 @@
 Options for the Python domain
 -----------------------------
 
+.. confval:: python_display_short_literal_types
+
+   This value controls how :py:data:`~typing.Literal` types are displayed.
+   The setting is a boolean, default ``False``.
+
+   Examples
+   ~~~~~~~~
+
+   The examples below use the following :rst:dir:`py:function` directive:
+
+   .. code:: reStructuredText
+
+      .. py:function:: serve_food(item: Literal"egg", "spam", "lobster thermidor") -> None
+
+   When ``False``, :py:data:`~typing.Literal` types display as per standard
+   Python syntax, i.e.:
+
+      .. code:: python
+
+         serve_food(item: Literal"egg", "spam", "lobster thermidor") -> None
+
+   When ``True``, :py:data:`~typing.Literal` types display with a short,
+   :PEP:`604`-inspired syntax, i.e.:
+
+      .. code:: python
+
+         serve_food(item: "egg" | "spam" | "lobster thermidor") -> None
+
+   .. versionadded:: 6.2
+
 .. confval:: python_use_unqualified_type_names
 
    If true, suppress the module name of the python reference if it can be
@@ -2814,7 +2980,7 @@
    .. note:: This configuration is still in experimental
 
 Example of configuration file
-=============================
+-----------------------------
 
 .. literalinclude:: /_static/conf.py.txt
    :language: python

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/autodoc.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/autodoc.rst Changed

@@ -41,7 +41,7 @@
 docstrings to correct reStructuredText before :mod:`autodoc` processes them.
 
 .. _Google: https://github.com/google/styleguide/blob/gh-pages/pyguide.md#38-comments-and-docstrings
-.. _NumPy: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt
+.. _NumPy: https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard
 
 
 Directives
@@ -266,6 +266,10 @@
      ``__str__`` will be documented as in the past, but other special method
      that are not implemented in your class ``Foo``.
 
+     Since v5.0, it can take a comma separated list of ancestor classes.  It
+     allows to suppress inherited members of several classes on the module at
+     once by specifying the option to :rst:dir:`automodule` directive.
+
      Note: this will lead to markup errors if the inherited members come from a
      module whose docstrings are not reST formatted.
 
@@ -275,6 +279,10 @@
 
         It takes an ancestor class name as an argument.
 
+     .. versionchanged:: 5.0
+
+        It takes a comma separated list of ancestor class names.
+
    * It's possible to override the signature for explicitly documented callable
      objects (functions, methods, classes) with the regular syntax that will
      override the signature gained from introspection::
@@ -468,7 +476,7 @@
 
 .. confval:: autodoc_class_signature
 
-   This value selects how the signautre will be displayed for the class defined
+   This value selects how the signature will be displayed for the class defined
    by :rst:dir:`autoclass` directive.  The possible values are:
 
    ``"mixed"``
@@ -528,7 +536,8 @@
    The supported options are ``'members'``, ``'member-order'``,
    ``'undoc-members'``, ``'private-members'``, ``'special-members'``,
    ``'inherited-members'``, ``'show-inheritance'``, ``'ignore-module-all'``,
-   ``'imported-members'``, ``'exclude-members'`` and ``'class-doc-from'``.
+   ``'imported-members'``, ``'exclude-members'``, ``'class-doc-from'`` and
+   ``'no-value'``.
 
    .. versionadded:: 1.8
 
@@ -541,6 +550,9 @@
    .. versionchanged:: 4.1
       Added ``'class-doc-from'``.
 
+   .. versionchanged:: 4.5
+      Added ``'no-value'``.
+
 .. confval:: autodoc_docstring_signature
 
    Functions imported from C modules cannot be introspected, and therefore the
@@ -622,16 +634,24 @@
    When set to ``"documented"``, types will only be documented for a parameter
    or a return value that is already documented by the docstring.
 
+   With ``"documented_params"``, parameter types will only be annotated if the
+   parameter is documented in the docstring. The return type is always
+   annotated (except if it is ``None``).
+
    .. versionadded:: 4.0
 
+   .. versionadded:: 5.0
+
+      New option ``'documented_params'`` is added.
+
 .. confval:: autodoc_type_aliases
 
    A dictionary for users defined `type aliases`__ that maps a type name to the
    full-qualified object name.  It is used to keep type aliases not evaluated in
    the document.  Defaults to empty (``{}``).
 
-   The type aliases are only available if your program enables `Postponed
-   Evaluation of Annotations (PEP 563)`__ feature via ``from __future__ import
+   The type aliases are only available if your program enables :pep:`Postponed
+   Evaluation of Annotations (PEP 563) <563>` feature via ``from __future__ import
    annotations``.
 
    For example, there is code using a type alias::
@@ -658,7 +678,6 @@
 
         ...
 
-   .. __: https://www.python.org/dev/peps/pep-0563/
    .. __: https://mypy.readthedocs.io/en/latest/kinds_of_types.html#type-aliases
    .. versionadded:: 3.3
 
@@ -668,12 +687,15 @@
    following values:
 
    * ``'fully-qualified'`` -- Show the module name and its name of typehints
-     (default)
    * ``'short'`` -- Suppress the leading module names of the typehints
-     (ex. ``io.StringIO`` -> ``StringIO``)
+     (ex. ``io.StringIO`` -> ``StringIO``)  (default)
 
    .. versionadded:: 4.4
 
+   .. versionchanged:: 5.0
+
+      The default setting was changed to ``'short'``
+
 .. confval:: autodoc_preserve_defaults
 
    If True, the default argument values of functions will be not evaluated on

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/autosectionlabel.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/autosectionlabel.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/autosummary.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/autosummary.rst Changed

@@ -48,14 +48,14 @@
 
    produces a table like this:
 
-       .. currentmodule:: sphinx
+   .. currentmodule:: sphinx
 
-       .. autosummary::
+   .. autosummary::
 
-          environment.BuildEnvironment
-          util.relative_uri
+      environment.BuildEnvironment
+      util.relative_uri
 
-       .. currentmodule:: sphinx.ext.autosummary
+   .. currentmodule:: sphinx.ext.autosummary
 
    Autosummary preprocesses the docstrings and signatures with the same
    :event:`autodoc-process-docstring` and :event:`autodoc-process-signature`
@@ -255,7 +255,7 @@
 - :file:`autosummary/attribute.rst` -- template for class attributes
 - :file:`autosummary/method.rst` -- template for class methods
 
-The following variables available in the templates:
+The following variables are available in the templates:
 
 .. currentmodule:: None
 
@@ -271,6 +271,12 @@
 
    Full name of the documented object, including module and class parts.
 
+.. data:: objtype
+
+   Type of the documented object, one of ``"module"``, ``"function"``,
+   ``"class"``, ``"method"``, ``"attribute"``, ``"data"``, ``"object"``,
+   ``"exception"``, ``"newvarattribute"``, ``"newtypedata"``, ``"property"``.
+
 .. data:: module
 
    Name of the module the documented object belongs to.
@@ -300,7 +306,7 @@
 .. data:: functions
 
    List containing names of "public" functions in the module.  Here, "public"
-   here means that the name does not start with an underscore. Only available
+   means that the name does not start with an underscore. Only available
    for modules.
 
 .. data:: classes
@@ -323,9 +329,9 @@
    List containing names of "public" attributes in the class/module.  Only
    available for classes and modules.
 
-    .. versionchanged:: 3.1
+   .. versionchanged:: 3.1
 
-       Attributes of modules are supported.
+      Attributes of modules are supported.
 
 .. data:: modules

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/doctest.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/doctest.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/example_google.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/example_google.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/example_numpy.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/example_numpy.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/extlinks.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/extlinks.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/imgconverter.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/imgconverter.rst Changed

@@ -12,13 +12,14 @@
 builders.  For example, it allows you to use SVG images with LaTeX builder.
 As a result, you don't mind what image format the builder supports.
 
-Internally, this extension uses Imagemagick_ to convert images.
+By default the extension uses ImageMagick_ to perform conversions,
+and will not work if ImageMagick is not installed.
 
-.. _Imagemagick: https://www.imagemagick.org/script/index.php
+.. _ImageMagick: https://www.imagemagick.org
 
 .. note::
 
-   Imagemagick rasterizes a SVG image on conversion.  As a result, the image
+   ImageMagick rasterizes a SVG image on conversion.  As a result, the image
    becomes not scalable.  To avoid that, please use other image converters like
    `sphinxcontrib-svg2pdfconverter`__ (which uses Inkscape or
    ``rsvg-convert``).
@@ -31,10 +32,12 @@
 
 .. confval:: image_converter
 
-   A path to :command:`convert` command.  By default, the imgconverter uses
+   A path to a conversion command.  By default, the imgconverter finds
    the command from search paths.
 
-   On windows platform, :command:`magick` command is used by default.
+   On Unix platforms, the command :command:`convert` is used by default.
+
+   On Windows, the command :command:`magick` is used by default.
 
    .. versionchanged:: 3.1
 
@@ -45,8 +48,8 @@
    Additional command-line arguments to give to :command:`convert`, as a list.
    The default is an empty list ````.
 
-   On windows platform, it defaults to ``"convert"``.
+   On Windows, it defaults to ``"convert"``.
 
    .. versionchanged:: 3.1
 
-      Use ``"convert"`` by default on windows
+      Use ``"convert"`` by default on Windows

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/index.rst Changed

@@ -19,6 +19,7 @@
 :confval:`extensions` configuration value:
 
 .. toctree::
+   :maxdepth: 1
 
    autodoc
    autosectionlabel
@@ -49,14 +50,16 @@
 organization. If you wish to include your extension in this organization,
 simply follow the instructions provided in the `github-administration`__
 project. This is optional and there are several extensions hosted elsewhere.
-The `awesome-sphinxdoc`__ project contains a curated list of Sphinx packages,
-and many packages use the `Framework :: Sphinx :: Extension`__ and
+The `awesome-sphinxdoc`__ and `sphinx-extensions`__ projects are both curated
+lists of Sphinx packages, and many packages use the
+`Framework :: Sphinx :: Extension`__ and
 `Framework :: Sphinx :: Theme`__ trove classifiers for Sphinx extensions and
 themes, respectively.
 
 .. __: https://github.com/sphinx-contrib/
 .. __: https://github.com/sphinx-contrib/github-administration
 .. __: https://github.com/yoloseem/awesome-sphinxdoc
+.. __: https://sphinx-extensions.readthedocs.io/en/latest/
 .. __: https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Extension
 .. __: https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Theme

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/inheritance.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/inheritance.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/intersphinx.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/intersphinx.rst Changed

@@ -63,17 +63,7 @@
    When fetching remote inventory files, proxy settings will be read from
    the ``$HTTP_PROXY`` environment variable.
 
-   **Old format for this config value**
-
-   This is the format used before Sphinx 1.0.  It is still recognized.
-
-   A dictionary mapping URIs to either ``None`` or an URI.  The keys are the
-   base URI of the foreign Sphinx documentation sets and can be local paths or
-   HTTP URIs.  The values indicate where the inventory file can be found: they
-   can be ``None`` (at the same location as the base URI) or another local or
-   HTTP URI.
-
-   **New format for this config value**
+   **Format**
 
    .. versionadded:: 1.0
 
@@ -136,6 +126,28 @@
                   ('../../otherbook/build/html/objects.inv', None)),
       }
 
+   **Old format for this config value**
+
+   .. deprecated:: 6.2
+
+   .. RemovedInSphinx80Warning
+
+   .. caution:: This is the format used before Sphinx 1.0.
+                It is deprecated and will be removed in Sphinx 8.0.
+
+   A dictionary mapping URIs to either ``None`` or an URI.  The keys are the
+   base URI of the foreign Sphinx documentation sets and can be local paths or
+   HTTP URIs.  The values indicate where the inventory file can be found: they
+   can be ``None`` (at the same location as the base URI) or another local or
+   HTTP URI.
+
+   Example:
+
+   .. code:: python
+
+      intersphinx_mapping = {'https://docs.python.org/': None}
+
+
 .. confval:: intersphinx_cache_limit
 
    The maximum number of days to cache remote inventories.  The default is
@@ -157,6 +169,10 @@
 
    .. versionadded:: 4.3
 
+   .. versionchanged:: 5.0
+
+      Changed default value from an empty list to ``'std:doc'``.
+
    A list of strings being either:
 
    - the name of a specific reference type in a domain,
@@ -165,7 +181,7 @@
      ``std:*``, ``py:*``, or ``cpp:*``, or
    - simply a wildcard ``*``.
 
-   The default value is an empty list.
+   The default value is ``'std:doc'``.
 
    When a non-:rst:role:`external` cross-reference is being resolved by
    intersphinx, skip resolution if it matches one of the specifications in this
@@ -205,7 +221,7 @@
 
    If you would like to constrain the lookup to a specific external project,
    then the key of the project, as specified in :confval:`intersphinx_mapping`,
-   is added as well to get the two forms 
+   is added as well to get the two forms
 
    - ``:external+invname:domain:reftype:`target```,
      e.g., ``:external+python:py:class:`zipfile.ZipFile```, or

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/math.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/math.rst Changed

@@ -82,12 +82,37 @@
 
    .. hint::
 
+      To use `OpenType Math fonts`__ with ``unicode-math``, via a custom
+      :confval:`imgmath_latex_preamble`, you can set :confval:`imgmath_latex`
+      to ``'dvilualatex'``, but must then set :confval:`imgmath_image_format`
+      to ``'svg'``.  Note: this has only been tested with ``dvisvgm 3.0.3``.
+      It significantly increases image production duration compared to using
+      standard ``'latex'`` with traditional TeX math fonts.
+
+      __ https://tex.stackexchange.com/questions/425098/which-opentype-math-fonts-are-available
+
+
+   .. hint::
+
       Some fancy LaTeX mark-up (an example was reported which used TikZ to add
       various decorations to the equation) require multiple runs of the LaTeX
       executable.  To handle this, set this configuration setting to
       ``'latexmk'`` (or a full path to it) as this Perl script reliably
       chooses dynamically how many latex runs are needed.
 
+   .. versionchanged:: 6.2.0
+
+      Using ``'xelatex'`` (or a full path to it) is now supported.  But you
+      must then add ``'-no-pdf'`` to the :confval:`imgmath_latex_args` list of
+      the command options.  The ``'svg'`` :confval:`imgmath_image_format` is
+      required.  Also, you may need the ``dvisvgm`` binary to be relatively
+      recent (testing was done only with its ``3.0.3`` release).
+
+      .. note::
+
+         Regarding the previous note, it is currently not supported to use
+         ``latexmk`` with option ``-xelatex``.
+
 .. confval:: imgmath_latex_args
 
    Additional arguments to give to latex, as a list.  The default is an empty
@@ -133,6 +158,12 @@
    elements (cf the `dvisvgm FAQ`_). This option is used only when
    ``imgmath_image_format`` is ``'svg'``.
 
+.. confval:: imgmath_embed
+
+   Default: ``False``.  If true, encode LaTeX output images within HTML files
+   (base64 encoded) and do not save separate png/svg files to disk.
+
+   .. versionadded:: 5.2
 
 :mod:`sphinx.ext.mathjax` -- Render math via JavaScript
 -------------------------------------------------------

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/extensions/napoleon.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/extensions/napoleon.rst Changed

@@ -26,7 +26,7 @@
     :rtype: BufferedFileStorage
 
 `reStructuredText`_ is great, but it creates visually dense, hard to read
-`docstrings`_. Compare the jumble above to the same thing rewritten
+:pep:`docstrings <287>`. Compare the jumble above to the same thing rewritten
 according to the `Google Python Style Guide`_::
 
     Args:
@@ -50,11 +50,10 @@
 source code files.
 
 .. _ReStructuredText: https://docutils.sourceforge.io/rst.html
-.. _docstrings: https://www.python.org/dev/peps/pep-0287/
 .. _Google Python Style Guide:
    https://google.github.io/styleguide/pyguide.html
 .. _Google:
-   https://google.github.io/styleguide/pyguide.html#Comments
+   https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings
 .. _NumPy:
    https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard
 .. _Khan Academy:
@@ -95,38 +94,38 @@
 
 All of the following section headers are supported:
 
-    * ``Args`` *(alias of Parameters)*
-    * ``Arguments`` *(alias of Parameters)*
-    * ``Attention``
-    * ``Attributes``
-    * ``Caution``
-    * ``Danger``
-    * ``Error``
-    * ``Example``
-    * ``Examples``
-    * ``Hint``
-    * ``Important``
-    * ``Keyword Args`` *(alias of Keyword Arguments)*
-    * ``Keyword Arguments``
-    * ``Methods``
-    * ``Note``
-    * ``Notes``
-    * ``Other Parameters``
-    * ``Parameters``
-    * ``Return`` *(alias of Returns)*
-    * ``Returns``
-    * ``Raise`` *(alias of Raises)*
-    * ``Raises``
-    * ``References``
-    * ``See Also``
-    * ``Tip``
-    * ``Todo``
-    * ``Warning``
-    * ``Warnings`` *(alias of Warning)*
-    * ``Warn`` *(alias of Warns)*
-    * ``Warns``
-    * ``Yield`` *(alias of Yields)*
-    * ``Yields``
+* ``Args`` *(alias of Parameters)*
+* ``Arguments`` *(alias of Parameters)*
+* ``Attention``
+* ``Attributes``
+* ``Caution``
+* ``Danger``
+* ``Error``
+* ``Example``
+* ``Examples``
+* ``Hint``
+* ``Important``
+* ``Keyword Args`` *(alias of Keyword Arguments)*
+* ``Keyword Arguments``
+* ``Methods``
+* ``Note``
+* ``Notes``
+* ``Other Parameters``
+* ``Parameters``
+* ``Return`` *(alias of Returns)*
+* ``Returns``
+* ``Raise`` *(alias of Raises)*
+* ``Raises``
+* ``References``
+* ``See Also``
+* ``Tip``
+* ``Todo``
+* ``Warning``
+* ``Warnings`` *(alias of Warning)*
+* ``Warn`` *(alias of Warns)*
+* ``Warns``
+* ``Yield`` *(alias of Yields)*
+* ``Yields``
 
 Google vs NumPy
 ~~~~~~~~~~~~~~~
@@ -137,7 +136,7 @@
 
 Google style:
 
-.. code-block:: python3
+.. code-block:: python
 
     def func(arg1, arg2):
         """Summary line.
@@ -156,7 +155,7 @@
 
 NumPy style:
 
-.. code-block:: python3
+.. code-block:: python
 
     def func(arg1, arg2):
         """Summary line.
@@ -183,8 +182,6 @@
 read for short and simple docstrings, whereas NumPy style tends be easier
 to read for long and in-depth docstrings.
 
-The `Khan Academy`_ recommends using Google style.
-
 The choice between styles is largely aesthetic, but the two styles should
 not be mixed. Choose one style for your project and be consistent with it.
 
@@ -199,11 +196,11 @@
 Type Annotations
 ~~~~~~~~~~~~~~~~
 
-`PEP 484`_ introduced a standard way to express types in Python code.
+:pep:`484` introduced a standard way to express types in Python code.
 This is an alternative to expressing types directly in docstrings.
-One benefit of expressing types according to `PEP 484`_ is that
+One benefit of expressing types according to :pep:`484` is that
 type checkers and IDEs can take advantage of them for static code
-analysis. `PEP 484`_ was then extended by `PEP 526`_ which introduced
+analysis. :pep:`484` was then extended by :pep:`526` which introduced
 a similar way to annotate variables (and attributes).
 
 Google style with Python 3 type annotations::
@@ -222,7 +219,7 @@
 
         """
         return True
-    
+
     class Class:
         """Summary line.
 
@@ -252,7 +249,7 @@
 
         """
         return True
-    
+
     class Class:
         """Summary line.
 
@@ -267,9 +264,7 @@
    `Python 2/3 compatible annotations`_ aren't currently
    supported by Sphinx and won't show up in the docs.
 
-.. _PEP 484: https://www.python.org/dev/peps/pep-0484/
-.. _PEP 526: https://www.python.org/dev/peps/pep-0526/
-.. _Python 2/3 compatible annotations: https://www.python.org/dev/peps/pep-0484/#suggested-syntax-for-python-2-7-and-straddling-code
+.. _Python 2/3 compatible annotations: https://peps.python.org/pep-0484/#suggested-syntax-for-python-2-7-and-straddling-code
 
 
 Configuration
@@ -301,7 +296,7 @@
     napoleon_attr_annotations = True
 
 .. _Google style:
-   https://google.github.io/styleguide/pyguide.html
+   https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings
 .. _NumPy style:
    https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard
 
@@ -403,7 +398,7 @@
 
    .. seealso::
 
-      :attr:`napoleon_use_admonition_for_examples`
+      :confval:`napoleon_use_admonition_for_examples`
 
 .. confval:: napoleon_use_admonition_for_references
 
@@ -413,7 +408,7 @@
 
    .. seealso::
 
-      :attr:`napoleon_use_admonition_for_examples`
+      :confval:`napoleon_use_admonition_for_examples`
 
 .. confval:: napoleon_use_ivar
 
@@ -476,14 +471,14 @@
    keywords.
    *Defaults to True.*
 
-   This behaves similarly to  :attr:`napoleon_use_param`. Note unlike docutils,
+   This behaves similarly to :confval:`napoleon_use_param`. Note unlike docutils,
    ``:keyword:`` and ``:param:`` will not be treated the same way - there will
    be a separate "Keyword Arguments" section, rendered in the same fashion as
    "Parameters" section (type links created if possible)
 
    .. seealso::
 
-      :attr:`napoleon_use_param`
+      :confval:`napoleon_use_param`
 
 .. confval:: napoleon_use_rtype
 
@@ -548,7 +543,7 @@
 
 .. confval:: napoleon_attr_annotations
 
-   True to allow using `PEP 526`_ attributes annotations in classes.
+   True to allow using :pep:`526` attributes annotations in classes.
    If an attribute is documented in the docstring without a type and
    has an annotation in the class body, that type is used.

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/installation.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/installation.rst Changed

@@ -12,7 +12,7 @@
 Overview
 --------
 
-Sphinx is written in `Python`__ and supports Python 3.6+. It builds upon the
+Sphinx is written in `Python`__ and supports Python 3.8+. It builds upon the
 shoulders of many third-party libraries such as `Docutils`__ and `Jinja`__,
 which are installed when Sphinx is installed.
 
@@ -118,7 +118,7 @@
 ::
 
    $ choco install sphinx
-   
+
 You would need to `install Chocolatey
 <https://chocolatey.org/install>`_
 before running this.
@@ -208,9 +208,9 @@
    Note that in some Linux distributions, such as Debian and Ubuntu,
    this might require an extra installation step as follows.
 
-    .. code-block:: console
+   .. code-block:: console
 
-       $ apt-get install python3-venv
+      $ apt-get install python3-venv
 
 Docker
 ------
@@ -222,8 +222,8 @@
 - `sphinxdoc/sphinx-latexpdf`_
 
 .. _Docker Hub: https://hub.docker.com/
-.. _sphinxdoc/sphinx: https://hub.docker.com/repository/docker/sphinxdoc/sphinx
-.. _sphinxdoc/sphinx-latexpdf: https://hub.docker.com/repository/docker/sphinxdoc/sphinx-latexpdf
+.. _sphinxdoc/sphinx: https://hub.docker.com/r/sphinxdoc/sphinx
+.. _sphinxdoc/sphinx-latexpdf: https://hub.docker.com/r/sphinxdoc/sphinx-latexpdf
 
 Former one is used for standard usage of Sphinx, and latter one is mainly used for
 PDF builds using LaTeX.  Please choose one for your purpose.
@@ -243,7 +243,7 @@
 
       $ docker run -it --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart
 
-   And you can following command this to build HTML document:
+   And you can use the following command to build HTML document:
 
    .. code-block:: console
 
@@ -251,7 +251,7 @@
 
 For more details, please read `README file`__ of docker images.
 
-.. __: https://hub.docker.com/repository/docker/sphinxdoc/sphinx
+.. __: https://hub.docker.com/r/sphinxdoc/sphinx
 
 
 Installation from source

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/quickstart.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/quickstart.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/restructuredtext/basics.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/restructuredtext/basics.rst Changed

@@ -239,16 +239,16 @@
 
 Normally, there are no heading levels assigned to certain characters as the
 structure is determined from the succession of headings.  However, this
-convention is used in `Python's Style Guide for documenting
-<https://docs.python.org/devguide/documenting.html#style-guide>`_ which you may
+convention is used in `Python Developer's Guide for documenting
+<https://devguide.python.org/documentation/markup/#sections>`_ which you may
 follow:
 
 * ``#`` with overline, for parts
 * ``*`` with overline, for chapters
-* ``=``, for sections
-* ``-``, for subsections
-* ``^``, for subsubsections
-* ``"``, for paragraphs
+* ``=`` for sections
+* ``-`` for subsections
+* ``^`` for subsubsections
+* ``"`` for paragraphs
 
 Of course, you are free to use your own marker characters (see the reST
 documentation), and use a deeper nesting level, but keep in mind that most
@@ -370,7 +370,15 @@
   - :dudir:`include` (include reStructuredText from another file) -- in Sphinx,
     when given an absolute include file path, this directive takes it as
     relative to the source directory
-  - :dudir:`class` (assign a class attribute to the next element) 1_
+
+    .. _rstclass:
+
+  - :dudir:`class` (assign a class attribute to the next element)
+
+    .. note::
+
+       When the default domain contains a ``class`` directive, this directive
+       will be shadowed.  Therefore, Sphinx re-exports it as ``rst-class``.
 
 * HTML specifics:
 
@@ -536,7 +544,7 @@
 If you want to use some substitutions for all documents, put them into
 :confval:`rst_prolog` or :confval:`rst_epilog` or put them into a separate file
 and include it into all documents you want to use them in, using the
-:rst:dir:`include` directive.  (Be sure to give the include file a file name
+:dudir:`include` directive.  (Be sure to give the include file a file name
 extension differing from that of other source files, to avoid Sphinx finding it
 as a standalone document.)
 
@@ -566,7 +574,7 @@
 HTML Metadata
 -------------
 
-The :rst:dir:`meta` directive (:dudir:`ref <meta>`) allows specifying the HTML
+The :dudir:`meta` directive allows specifying the HTML
 `metadata element`_ of a Sphinx documentation page.  For example, the
 directive::
 
@@ -621,10 +629,3 @@
 
 * **No nested inline markup:** Something like ``*see :func:`foo`*`` is not
   possible.
-
-
-.. rubric:: Footnotes
-
-.. 1 When the default domain contains a :rst:dir:`class` directive, this
-       directive will be shadowed.  Therefore, Sphinx re-exports it as
-       :rst:dir:`rst-class`.

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/restructuredtext/directives.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/restructuredtext/directives.rst Changed

@@ -371,8 +371,9 @@
       .. centered:: LICENSE AGREEMENT
 
    .. deprecated:: 1.1
-      This presentation-only directive is a legacy from older versions.  Use a
-      :rst:dir:`rst-class` directive instead and add an appropriate style.
+      This presentation-only directive is a legacy from older versions.
+      Use a :ref:`rst-class <rstclass>` directive instead and add an
+      appropriate style.
 
 .. rst:directive:: hlist
 
@@ -489,6 +490,7 @@
       .. versionadded:: 2.1
 
 .. rst:directive:: .. code-block:: language
+                   .. sourcecode:: language
 
    Example::
 
@@ -499,8 +501,10 @@
    The directive's alias name :rst:dir:`sourcecode` works as well.  This
    directive takes a language name as an argument.  It can be `any lexer alias
    supported by Pygments <https://pygments.org/docs/lexers/>`_.  If it is not
-   given, the setting of :rst:dir:`highlight` directive will be used.
-   If not set, :confval:`highlight_language` will be used.
+   given, the setting of :rst:dir:`highlight` directive will be used.  If not
+   set, :confval:`highlight_language` will be used.  To display a code example
+   *inline* within other text, rather than as a separate block, you can use the
+   :rst:role:`code` role instead.
 
    .. versionchanged:: 2.0
       The ``language`` argument becomes optional.
@@ -590,6 +594,13 @@
 
       .. versionadded:: 1.3
 
+   .. rst:directive:option:: class: class names
+      :type: a list of class names separated by spaces
+
+      The class name of the graph.
+
+      .. versionadded:: 1.4
+
    .. rst:directive:option:: dedent: number
       :type: number or no value
 
@@ -756,6 +767,9 @@
       Added the ``diff``, ``lineno-match``, ``caption``, ``name``, and
       ``dedent`` options.
 
+   .. versionchanged:: 1.4
+      Added the ``class`` option.
+
    .. versionchanged:: 1.5
       Added the ``start-at``, and ``end-at`` options.
 
@@ -1033,114 +1047,78 @@
 The :dudir:`table` directive serves as optional wrapper of the *grid* and
 *simple* syntaxes.
 
-They work fine in HTML output, however there are some gotchas when using tables
-in LaTeX: the column width is hard to determine correctly automatically.  For
-this reason, the following directive exists:
+They work fine in HTML output, but rendering tables to LaTeX is complex.
+Check the :confval:`latex_table_style`.
 
-.. rst:directive:: .. tabularcolumns:: column spec
+.. versionchanged:: 1.6
+   Merged cells (multi-row, multi-column, both) from grid tables containing
+   complex contents such as multiple paragraphs, blockquotes, lists, literal
+   blocks, will render correctly to LaTeX output.
 
-   This directive gives a "column spec" for the next table occurring in the
-   source file.  The spec is the second argument to the LaTeX ``tabulary``
-   package's environment (which Sphinx uses to translate tables).  It can have
-   values like ::
-
-      |l|l|l|
-
-   which means three left-adjusted, nonbreaking columns.  For columns with
-   longer text that should automatically be broken, use either the standard
-   ``p{width}`` construct, or tabulary's automatic specifiers:
-
-   +-----+------------------------------------------+
-   |``L``| flush left column with automatic width   |
-   +-----+------------------------------------------+
-   |``R``| flush right column with automatic width  |
-   +-----+------------------------------------------+
-   |``C``| centered column with automatic width     |
-   +-----+------------------------------------------+
-   |``J``| justified column with automatic width    |
-   +-----+------------------------------------------+
+.. rst:directive:: .. tabularcolumns:: column spec
 
-   The automatic widths of the ``LRCJ`` columns are attributed by ``tabulary``
-   in proportion to the observed shares in a first pass where the table cells
-   are rendered at their natural "horizontal" widths.
+   This directive influences only the LaTeX output for the next table in
+   source.  The mandatory argument is a column specification (known as an
+   "alignment preamble" in LaTeX idiom).  Please refer to a LaTeX
+   documentation, such as the `wiki page`_, for basics of such a column
+   specification.
 
-   By default, Sphinx uses a table layout with ``J`` for every column.
+   .. _wiki page: https://en.wikibooks.org/wiki/LaTeX/Tables
 
    .. versionadded:: 0.3
 
-   .. versionchanged:: 1.6
-      Merged cells may now contain multiple paragraphs and are much better
-      handled, thanks to custom Sphinx LaTeX macros. This novel situation
-      motivated the switch to ``J`` specifier and not ``L`` by default.
-
-   .. hint::
+   .. note::
 
-      Sphinx actually uses ``T`` specifier having done ``\newcolumntype{T}{J}``.
-      To revert to previous default, insert ``\newcolumntype{T}{L}`` in the
-      LaTeX preamble (see :confval:`latex_elements`).
+      :rst:dir:`tabularcolumns` conflicts with ``:widths:`` option of table
+      directives.  If both are specified, ``:widths:`` option will be ignored.
 
-      A frequent issue with tabulary is that columns with little contents are
-      "squeezed". The minimal column width is a tabulary parameter called
-      ``\tymin``. You may set it globally in the LaTeX preamble via
-      ``\setlength{\tymin}{40pt}`` for example.
+   Sphinx will render tables with more than 30 rows with ``longtable``.
+   Besides the ``l``, ``r``, ``c`` and ``p{width}`` column specifiers, one can
+   also use ``\X{a}{b}`` (new in version 1.5) which configures the column
+   width to be a fraction ``a/b`` of the total line width and ``\Y{f}`` (new
+   in version 1.6) where ``f`` is a decimal: for example ``\Y{0.2}`` means that
+   the column will occupy ``0.2`` times the line width.
 
-      Else, use the :rst:dir:`tabularcolumns` directive with an explicit
-      ``p{40pt}`` (for example) for that column. You may use also ``l``
-      specifier but this makes the task of setting column widths more difficult
-      if some merged cell intersects that column.
+   When this directive is used for a table with at most 30 rows, Sphinx will
+   render it with ``tabulary``.  One can then use specific column types ``L``
+   (left), ``R`` (right), ``C`` (centered) and ``J`` (justified).  They have
+   the effect of a ``p{width}`` (i.e. each cell is a LaTeX ``\parbox``) with
+   the specified internal text alignment and an automatically computed
+   ``width``.
 
    .. warning::
 
-      Tables with more than 30 rows are rendered using ``longtable``, not
-      ``tabulary``, in order to allow pagebreaks. The ``L``, ``R``, ...
-      specifiers do not work for these tables.
-
-      Tables that contain list-like elements such as object descriptions,
-      blockquotes or any kind of lists cannot be set out of the box with
-      ``tabulary``. They are therefore set with the standard LaTeX ``tabular``
-      (or ``longtable``) environment if you don't give a ``tabularcolumns``
-      directive.  If you do, the table will be set with ``tabulary`` but you
-      must use the ``p{width}`` construct (or Sphinx's ``\X`` and ``\Y``
-      specifiers described below) for the columns containing these elements.
-
-      Literal blocks do not work with ``tabulary`` at all, so tables containing
-      a literal block are always set with ``tabular``. The verbatim environment
-      used for literal blocks only works in ``p{width}`` (and ``\X`` or ``\Y``)
-      columns, hence Sphinx generates such column specs for tables containing
-      literal blocks.
-
-   Since Sphinx 1.5, the ``\X{a}{b}`` specifier is used (there *is* a backslash
-   in the specifier letter). It is like ``p{width}`` with the width set to a
-   fraction ``a/b`` of the current line width. You can use it in the
-   :rst:dir:`tabularcolumns` (it is not a problem if some LaTeX macro is also
-   called ``\X``.)
-
-   It is *not* needed for ``b`` to be the total number of columns, nor for the
-   sum of the fractions of the ``\X`` specifiers to add  up to one. For example
-   ``|\X{2}{5}|\X{1}{5}|\X{1}{5}|`` is legitimate and the table will occupy
-   80% of the line width, the first of its three columns having the same width
-   as the sum  of the next two.
-
-   This is used by the ``:widths:`` option of the :dudir:`table` directive.
-
-   Since Sphinx 1.6, there is also the ``\Y{f}`` specifier which admits a
-   decimal argument, such has ``\Y{0.15}``: this would have the same effect as
-   ``\X{3}{20}``.
+      - Cells that contain list-like elements such as object descriptions,
+        blockquotes or any kind of lists are not compatible with the ``LRCJ``
+        column types.  The column type must then be some ``p{width}`` with an
+        explicit ``width`` (or ``\X{a}{b}`` or ``\Y{f}``).
 
-   .. versionchanged:: 1.6
+      - Literal blocks do not work with ``tabulary`` at all.  Sphinx will
+        fall back to ``tabular`` or ``longtable`` environments and generate a
+        suitable column specification.
 
-      Merged cells from complex grid tables (either multi-row, multi-column, or
-      both) now allow blockquotes, lists, literal blocks, ... as do regular
-      cells.
+In absence of the :rst:dir:`tabularcolumns` directive, and for a table with at
+most 30 rows and no problematic cells as described in the above warning,
+Sphinx uses ``tabulary`` and the ``J`` column-type for every column.
 
-      Sphinx's merged cells interact well with ``p{width}``, ``\X{a}{b}``,
-      ``\Y{f}`` and tabulary's columns.
+.. versionchanged:: 1.6
 
-   .. note::
+   Formerly, the ``L`` column-type was used (text is flushed-left).  To revert
+   to this, include ``\newcolumntype{T}{L}`` in the LaTeX preamble, as in fact
+   Sphinx uses ``T`` and sets it by default to be an alias of ``J``.
 
-      :rst:dir:`tabularcolumns` conflicts with ``:widths:`` option of table
-      directives.  If both are specified, ``:widths:`` option will be ignored.
+.. hint::
+
+   A frequent issue with ``tabulary`` is that columns with little contents
+   appear to be "squeezed".  One can add to the LaTeX preamble for example
+   ``\setlength{\tymin}{40pt}`` to ensure a minimal column width of ``40pt``,
+   the ``tabulary`` default of ``10pt`` being too small.
+
+.. hint::
 
+   To force usage of the LaTeX ``longtable`` environment pass ``longtable`` as
+   a ``:class:`` option to :dudir:`table`, :dudir:`csv-table`, or
+   :dudir:`list-table`.  Use :ref:`rst-class <rstclass>` for other tables.
 
 Math
 ----

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/restructuredtext/domains.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/restructuredtext/domains.rst Changed

@@ -42,11 +42,15 @@
 Most domains provide a number of :dfn:`object description directives`, used to
 describe specific objects provided by modules.  Each directive requires one or
 more signatures to provide basic information about what is being described, and
-the content should be the description.  A domain will typically keep an
-internal index of all entities to aid cross-referencing. Typically it will
-also add entries in the shown general index.
+the content should be the description.
+
+A domain will typically keep an internal index of all entities to aid
+cross-referencing.
+Typically it will also add entries in the shown general index.
 If you want to suppress the addition of an entry in the shown index, you can
 give the directive option flag ``:noindexentry:``.
+If you want to exclude the object description from the table of contents, you
+can give the directive option flag ``:nocontentsentry:``.
 If you want to typeset an object description, without even making it available
 for cross-referencing, you can give the directive option flag ``:noindex:``
 (which implies ``:noindexentry:``).
@@ -57,6 +61,10 @@
    The directive option ``noindexentry`` in the Python, C, C++, and Javascript
    domains.
 
+.. versionadded:: 5.2.3
+   The directive option ``:nocontentsentry:`` in the Python, C, C++, Javascript,
+   and reStructuredText domains.
+
 An example using a Python domain directive::
 
    .. py:function:: spam(eggs)
@@ -137,11 +145,15 @@
 
    This directive marks the beginning of the description of a module (or package
    submodule, in which case the name should be fully qualified, including the
-   package name).  It does not create content (like e.g. :rst:dir:`py:class`
-   does).
+   package name).  A description of the module such as the docstring can be
+   placed in the body of the directive.
 
    This directive will also cause an entry in the global module index.
 
+   .. versionchanged:: 5.2
+
+      Module directives support body content.
+
    .. rubric:: options
 
    .. rst:directive:option:: platform: platforms
@@ -165,6 +177,8 @@
       Mark a module as deprecated; it will be designated as such in various
       locations then.
 
+
+
 .. rst:directive:: .. py:currentmodule:: name
 
    This directive tells Sphinx that the classes, functions etc. documented from
@@ -211,6 +225,12 @@
 
       .. versionadded:: 4.0
 
+   .. rst::directive:option:: module
+      :type: text
+
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
+
 .. rst:directive:: .. py:data:: name
 
    Describes global data in a module, including both variables and values used
@@ -237,6 +257,12 @@
 
       .. versionadded:: 4.0
 
+   .. rst::directive:option:: module
+      :type: text
+
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
+
 .. rst:directive:: .. py:exception:: name
 
    Describes an exception class.  The signature can, but need not include
@@ -251,6 +277,12 @@
 
       .. versionadded:: 3.1
 
+   .. rst::directive:option:: module
+      :type: text
+
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
+
 .. rst:directive:: .. py:class:: name
                    .. py:class:: name(parameters)
 
@@ -291,6 +323,12 @@
 
       .. versionadded:: 3.1
 
+   .. rst::directive:option:: module
+      :type: text
+
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
+
 .. rst:directive:: .. py:attribute:: name
 
    Describes an object data attribute.  The description should include
@@ -317,6 +355,12 @@
 
       .. versionadded:: 4.0
 
+   .. rst::directive:option:: module
+      :type: text
+
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
+
 .. rst:directive:: .. py:property:: name
 
    Describes an object property.
@@ -340,6 +384,12 @@
    .. rst:directive:option:: type: type of the property
       :type: text
 
+   .. rst::directive:option:: module
+      :type: text
+
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
+
 .. rst:directive:: .. py:method:: name(parameters)
 
    Describes an object method.  The parameters should not include the ``self``
@@ -385,16 +435,11 @@
 
       .. versionadded:: 3.1
 
-   .. rst:directive:option:: property
-      :type: no value
-
-      Indicate the method is a property.
-
-      .. versionadded:: 2.1
-
-      .. deprecated:: 4.0
+   .. rst::directive:option:: module
+      :type: text
 
-         Use :rst:dir:`py:property` instead.
+      Describe the location where the object is defined.  The default value is
+      the module specified by :rst:dir:`py:currentmodule`.
 
    .. rst:directive:option:: staticmethod
       :type: no value
@@ -474,7 +519,8 @@
 (typically functions implemented in C extension modules without keyword
 argument support), you can use brackets to specify the optional parts:
 
-   .. py:function:: compile(source, filename, symbol)
+.. py:function:: compile(source, filename, symbol)
+   :noindex:
 
 It is customary to put the opening bracket before the comma.
 
@@ -530,20 +576,20 @@
 
 This will render like this:
 
-   .. py:function:: send_message(sender, recipient, message_body, priority=1)
-      :noindex:
+.. py:function:: send_message(sender, recipient, message_body, priority=1)
+   :noindex:
 
-      Send a message to a recipient
+   Send a message to a recipient
 
-      :param str sender: The person sending the message
-      :param str recipient: The recipient of the message
-      :param str message_body: The body of the message
-      :param priority: The priority of the message, can be a number 1-5
-      :type priority: integer or None
-      :return: the message id
-      :rtype: int
-      :raises ValueError: if the message_body exceeds 160 characters
-      :raises TypeError: if the message_body is not a basestring
+   :param str sender: The person sending the message
+   :param str recipient: The recipient of the message
+   :param str message_body: The body of the message
+   :param priority: The priority of the message, can be a number 1-5
+   :type priority: int or None
+   :return: the message id
+   :rtype: int
+   :raises ValueError: if the message_body exceeds 160 characters
+   :raises TypeError: if the message_body is not a basestring
 
 It is also possible to combine parameter type and description, if the type is a
 single word, like this::
@@ -813,12 +859,20 @@
 This will be rendered as:
 
 .. c:struct:: Data
+   :nocontentsentry:
+   :noindexentry:
 
    .. c:union:: @data
+      :nocontentsentry:
+      :noindexentry:
 
       .. c:var:: int a
+         :nocontentsentry:
+         :noindexentry:
 
       .. c:var:: double b
+         :nocontentsentry:
+         :noindexentry:
 
 Explicit ref: :c:var:`Data.@data.a`. Short-hand ref: :c:var:`Data.a`.
 
@@ -900,8 +954,12 @@
    will be rendered as follows:
 
    .. c:var:: int a = 42
+      :nocontentsentry:
+      :noindexentry:
 
    .. c:function:: int f(int i)
+      :nocontentsentry:
+      :noindexentry:
 
    An expression: :c:expr:`a * f(a)` (or as text: :c:texpr:`a * f(a)`).
 
@@ -1111,19 +1169,27 @@
    The example are rendered as follows.
 
    .. cpp:type:: std::vector<int> MyList
+      :nocontentsentry:
+      :noindexentry:
 
       A typedef-like declaration of a type.
 
    .. cpp:type:: MyContainer::const_iterator
+      :nocontentsentry:
+      :noindexentry:
 
       Declaration of a type alias with unspecified type.
 
    .. cpp:type:: MyType = std::unordered_map<int, std::string>
+      :nocontentsentry:
+      :noindexentry:
 
       Declaration of a type alias.
 
    .. cpp:type:: template<typename T> \
                  MyContainer = std::vector<T>
+      :nocontentsentry:
+      :noindexentry:
 
 .. rst:directive:: .. cpp:enum:: unscoped enum declaration
                    .. cpp:enum-struct:: scoped enum declaration
@@ -1218,7 +1284,7 @@
 
 Some directives support options:
 
-- ``:noindexentry:``, see :ref:`basic-domain-markup`.
+- ``:noindexentry:`` and ``:nocontentsentry:``, see :ref:`basic-domain-markup`.
 - ``:tparam-line-spec:``, for templated declarations.
   If specified, each template parameter will be rendered on a separate line.
 
@@ -1250,12 +1316,20 @@
 This will be rendered as:
 
 .. cpp:class:: Data
+   :nocontentsentry:
+   :noindexentry:
 
    .. cpp:union:: @data
+      :nocontentsentry:
+      :noindexentry:
 
       .. cpp:var:: int a
+         :nocontentsentry:
+         :noindexentry:
 
       .. cpp:var:: double b
+         :nocontentsentry:
+         :noindexentry:
 
 Explicit ref: :cpp:var:`Data::@data::a`. Short-hand ref: :cpp:var:`Data::a`.
 
@@ -1361,10 +1435,14 @@
 They are rendered as follows.
 
 .. cpp:function:: std::Iterator{It} void advance(It &it)
+   :nocontentsentry:
+   :noindexentry:
 
    A function template with a template parameter constrained to be an Iterator.
 
 .. cpp:class:: std::LessThanComparable{T} MySortedContainer
+   :nocontentsentry:
+   :noindexentry:
 
    A class template with a template parameter constrained to be
    LessThanComparable.
@@ -1394,8 +1472,12 @@
    will be rendered as follows:
 
    .. cpp:var:: int a = 42
+      :nocontentsentry:
+      :noindexentry:
 
    .. cpp:function:: int f(int i)
+      :nocontentsentry:
+      :noindexentry:
 
    An expression: :cpp:expr:`a * f(a)` (or as text: :cpp:texpr:`a * f(a)`).
 
@@ -1708,6 +1790,14 @@
    referenceable by :rst:role:`option` (in the example case, you'd use something
    like ``:option:`dest_dir```, ``:option:`-m```, or ``:option:`--module```).
 
+   .. versionchanged:: 5.3
+
+      One can cross-reference including an option value: ``:option:`--module=foobar```,
+      ,``:option:`--module=foobar``` or ``:option:`--module foobar```.
+
+   Use :confval:`option_emphasise_placeholders` for parsing of
+   "variable part" of a literal text (similarly to the :rst:role:`samp` role).
+
    ``cmdoption`` directive is a deprecated alias for the ``option`` directive.
 
 .. rst:directive:: .. envvar:: name
@@ -1781,6 +1871,9 @@
    current module name.
 
    .. versionadded:: 1.6
+   .. versionchanged:: 5.2
+
+      Module directives support body content.
 
 .. rst:directive:: .. js:function:: name(signature)
 
@@ -1804,15 +1897,16 @@
 
    This is rendered as:
 
-      .. js:function:: $.getJSON(href, callback, errback)
+   .. js:function:: $.getJSON(href, callback, errback)
+      :noindex:
 
-        :param string href: An URI to the location of the resource.
-        :param callback: Gets called with the object.
-        :param errback:
-            Gets called in case the request fails. And a lot of other
-            text so we need multiple lines.
-        :throws SomeError: For whatever reason in that case.
-        :returns: Something.
+      :param string href: An URI to the location of the resource.
+      :param callback: Gets called with the object.
+      :param errback:
+          Gets called in case the request fails. And a lot of other
+          text so we need multiple lines.
+      :throws SomeError: For whatever reason in that case.
+      :returns: Something.
 
 .. rst:directive:: .. js:method:: name(signature)
 
@@ -1833,10 +1927,11 @@
 
    This is rendered as:
 
-      .. js:class:: MyAnimal(name, age)
+   .. js:class:: MyAnimal(name, age)
+      :noindex:
 
-         :param string name: The name of the animal
-         :param number age: an optional age for the animal
+      :param string name: The name of the animal
+      :param number age: an optional age for the animal
 
 .. rst:directive:: .. js:data:: name
 
@@ -1879,13 +1974,15 @@
 
    will be rendered as:
 
-      .. rst:directive:: foo
+   .. rst:directive:: foo
+      :noindex:
 
-         Foo description.
+      Foo description.
 
-      .. rst:directive:: .. bar:: baz
+   .. rst:directive:: .. bar:: baz
+      :noindex:
 
-         Bar description.
+      Bar description.
 
 .. rst:directive:: .. rst:directive:option:: name
 
@@ -1901,12 +1998,14 @@
 
    will be rendered as:
 
-       .. rst:directive:: toctree
-          :noindex:
+   .. rst:directive:: toctree
+      :noindex:
 
-          .. rst:directive:option:: caption: caption of ToC
+      .. rst:directive:option:: caption: caption of ToC
+         :noindex:
 
-          .. rst:directive:option:: glob
+      .. rst:directive:option:: glob
+         :noindex:
 
    .. rubric:: options
 
@@ -1934,9 +2033,10 @@
 
    will be rendered as:
 
-      .. rst:role:: foo
+   .. rst:role:: foo
+      :noindex:
 
-         Foo description.
+      Foo description.
 
 .. _rst-roles:

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/restructuredtext/roles.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/restructuredtext/roles.rst Changed

@@ -74,7 +74,7 @@
 
    This role is a good candidate for setting :confval:`default_role`.  If you
    do, you can write cross-references without a lot of markup overhead.  For
-   example, in this Python function documentation ::
+   example, in this Python function documentation::
 
       .. function:: install()
 
@@ -276,6 +276,37 @@
    If you use a term that's not explained in a glossary, you'll get a warning
    during build.
 
+Inline code highlighting
+------------------------
+
+.. rst:role:: code
+
+   An *inline* code example.  When used directly, this role just displays the
+   text *without* syntax highlighting, as a literal.
+
+   .. code-block:: rst
+
+      By default, inline code such as :code:`1 + 2` just displays without
+      highlighting.
+
+   Displays: By default, inline code such as :code:`1 + 2` just displays without
+   highlighting.
+
+   Unlike the :rst:dir:`code-block` directive, this role does not respect the
+   default language set by the :rst:dir:`highlight` directive.
+
+   To enable syntax highlighting, you must first use the Docutils :dudir:`role`
+   directive to define a custom role associated with a specific language:
+
+   .. code-block:: rst
+
+      .. role:: python(code)
+         :language: python
+
+      In Python, :python:`1 + 2` is equal to :python:`3`.
+
+   To display a multi-line code example, use the :rst:dir:`code-block` directive
+   instead.
 
 Math
 ----
@@ -286,6 +317,8 @@
 
       Since Pythagoras, we know that :math:`a^2 + b^2 = c^2`.
 
+   Displays: Since Pythagoras, we know that :math:`a^2 + b^2 = c^2`.
+
 .. rst:role:: eq
 
    Same as :rst:role:`math:numref`.
@@ -303,7 +336,8 @@
    it will be treated specially: it will be shown in a tool-tip in HTML, and
    output only once in LaTeX.
 
-   Example: ``:abbr:`LIFO (last-in, first-out)```.
+   For example: ``:abbr:`LIFO (last-in, first-out)``` displays
+   :abbr:`LIFO (last-in, first-out)`.
 
    .. versionadded:: 0.6
 
@@ -311,17 +345,23 @@
 
    The name of an OS-level command, such as ``rm``.
 
+   For example: :command:`rm`
+
 .. rst:role:: dfn
 
    Mark the defining instance of a term in the text.  (No index entries are
    generated.)
 
+   For example: :dfn:`binary mode`
+
 .. rst:role:: file
 
    The name of a file or directory.  Within the contents, you can use curly
    braces to indicate a "variable" part, for example::
 
-      ... is installed in :file:`/usr/lib/python2.{x}/site-packages` ...
+      ... is installed in :file:`/usr/lib/python3.{x}/site-packages` ...
+
+   Displays: ... is installed in :file:`/usr/lib/python3.{x}/site-packages` ...
 
    In the built documentation, the ``x`` will be displayed differently to
    indicate that it is to be replaced by the Python minor version.
@@ -337,8 +377,9 @@
 
    .. versionchanged:: 1.0
       An accelerator key for the GUI label can be included using an ampersand;
-      this will be stripped and displayed underlined in the output (example:
-      ``:guilabel:`&Cancel```).  To include a literal ampersand, double it.
+      this will be stripped and displayed underlined in the output (for example:
+      ``:guilabel:`&Cancel``` displays :guilabel:`&Cancel`).  To include a literal
+      ampersand, double it.
 
 .. rst:role:: kbd
 
@@ -348,7 +389,8 @@
    improve accessibility for new users and non-native speakers.  For example,
    an *xemacs* key sequence may be marked like ``:kbd:`C-x C-f```, but without
    reference to a specific application or platform, the same sequence should be
-   marked as ``:kbd:`Control-x Control-f```.
+   marked as ``:kbd:`Control-x Control-f```, displaying :kbd:`C-x C-f` and
+   :kbd:`Control-x Control-f` respectively.
 
 .. rst:role:: mailheader
 
@@ -358,17 +400,19 @@
    the various MIME specifications.  The header name should be entered in the
    same way it would normally be found in practice, with the camel-casing
    conventions being preferred where there is more than one common usage. For
-   example: ``:mailheader:`Content-Type```.
+   example: ``:mailheader:`Content-Type``` displays :mailheader:`Content-Type`.
 
 .. rst:role:: makevar
 
    The name of a :command:`make` variable.
 
+   For example: :makevar:`help`
+
 .. rst:role:: manpage
 
    A reference to a Unix manual page including the section, e.g.
-   ``:manpage:`ls(1)```. Creates a hyperlink to an external site rendering the
-   manpage if :confval:`manpages_url` is defined.
+   ``:manpage:`ls(1)``` displays :manpage:`ls(1)`. Creates a hyperlink to an
+   external site rendering the manpage if :confval:`manpages_url` is defined.
 
 .. rst:role:: menuselection
 
@@ -382,6 +426,8 @@
 
       :menuselection:`Start --> Programs`
 
+   Displays: :menuselection:`Start --> Programs`
+
    When including a selection that includes some trailing indicator, such as
    the ellipsis some operating systems use to indicate that the command opens a
    dialog, the indicator should be omitted from the selection name.
@@ -394,10 +440,14 @@
    The name of a MIME type, or a component of a MIME type (the major or minor
    portion, taken alone).
 
+   For example: :mimetype:`text/plain`
+
 .. rst:role:: newsgroup
 
    The name of a Usenet newsgroup.
 
+   For example: :newsgroup:`comp.lang.python`
+
 .. todo:: Is this not part of the standard domain?
 
 .. rst:role:: program
@@ -406,19 +456,23 @@
    the executable for some platforms.  In particular, the ``.exe`` (or other)
    extension should be omitted for Windows programs.
 
+   For example: :program:`curl`
+
 .. rst:role:: regexp
 
    A regular expression. Quotes should not be included.
 
+   For example: :regexp:`(abc)+`
+
 .. rst:role:: samp
 
    A piece of literal text, such as code.  Within the contents, you can use
    curly braces to indicate a "variable" part, as in :rst:role:`file`.  For
    example, in ``:samp:`print 1+{variable}```, the part ``variable`` would be
-   emphasized.
+   emphasized: :samp:`print 1+{variable}`
 
    If you don't need the "variable part" indication, use the standard
-   ````code```` instead.
+   :rst:role:`code` role instead.
 
    .. versionchanged:: 1.8
       Allowed to escape curly braces with backslash
@@ -434,6 +488,8 @@
    this text is a hyperlink to an online copy of the specified PEP.  You can
    link to a specific section by saying ``:pep:`number#anchor```.
 
+   For example: :pep:`8`
+
 .. rst:role:: rfc
 
    A reference to an Internet Request for Comments.  This generates appropriate
@@ -441,6 +497,7 @@
    this text is a hyperlink to an online copy of the specified RFC.  You can
    link to a specific section by saying ``:rfc:`number#anchor```.
 
+   For example: :rfc:`2324`
 
 Note that there are no special roles for including hyperlinks as you can use
 the standard reST markup for that purpose.

_service:tar_scm:Sphinx-4.4.0.tar.gz/doc/usage/theming.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/doc/usage/theming.rst Changed

@@ -88,7 +88,7 @@
 Builtin themes
 ~~~~~~~~~~~~~~
 
-.. cssclass:: longtable
+.. cssclass:: longtable, standard
 
 +--------------------+--------------------+
 | **Theme overview** |                    |
@@ -158,9 +158,18 @@
     dimension string such as '70em' or '50%'. Use 'none' if you don't
     want a width limit. Defaults may depend on the theme (often 800px).
 
-  - **navigation_with_keys** (true or false): Allow navigating to the
-    previous/next page using the keyboard's left and right arrows.  Defaults to
-    ``False``.
+  - **navigation_with_keys** (true or false): Allow navigating
+    with the following keyboard shortcuts:
+
+    - :kbd:`Left arrow`: previous page
+    - :kbd:`Right arrow`: next page
+
+    Defaults to ``False``.
+
+  - **enable_search_shortcuts** (true or false): Allow jumping to the search box
+    with :kbd:`/` and allow removal of search highlighting with :kbd:`Esc`.
+
+    Defaults to ``True``.
 
   - **globaltoc_collapse** (true or false): Only expand subsections
     of the current document in ``globaltoc.html``
@@ -336,10 +345,12 @@
    available, however it will emit a notice that it is an alias for the new
    'alabaster' theme.
 
+.. _third-party-themes:
+
 Third Party Themes
 ~~~~~~~~~~~~~~~~~~
 
-There are many third-party themes available for Sphinx. Some of these are for
+There are many third-party themes created for Sphinx. Some of these are for
 general use, while others are specific to an individual project.
 
 sphinx-themes.org__ is a gallery that showcases various themes for Sphinx,

_service:tar_scm:Sphinx-7.0.1.tar.gz/pyproject.toml Added

@@ -0,0 +1,407 @@
+build-system
+requires = "flit_core>=3.7"
+build-backend = "flit_core.buildapi"
+
+# project metadata
+project
+name = "Sphinx"
+description = "Python documentation generator"
+readme = "README.rst"
+urls.Changelog = "https://www.sphinx-doc.org/en/master/changes.html"
+urls.Code = "https://github.com/sphinx-doc/sphinx"
+urls.Download = "https://pypi.org/project/Sphinx/"
+urls.Homepage = "https://www.sphinx-doc.org/"
+urls."Issue tracker" = "https://github.com/sphinx-doc/sphinx/issues"
+license.text = "BSD-2-Clause"
+requires-python = ">=3.8"
+
+# Classifiers list: https://pypi.org/classifiers/
+classifiers = 
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Framework :: Sphinx",
+    "Framework :: Sphinx :: Extension",
+    "Framework :: Sphinx :: Theme",
+    "Topic :: Documentation",
+    "Topic :: Documentation :: Sphinx",
+    "Topic :: Internet :: WWW/HTTP :: Site Management",
+    "Topic :: Printing",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Documentation",
+    "Topic :: Text Processing",
+    "Topic :: Text Processing :: General",
+    "Topic :: Text Processing :: Indexing",
+    "Topic :: Text Processing :: Markup",
+    "Topic :: Text Processing :: Markup :: HTML",
+    "Topic :: Text Processing :: Markup :: LaTeX",
+    "Topic :: Utilities",
+
+dependencies = 
+    "sphinxcontrib-applehelp",
+    "sphinxcontrib-devhelp",
+    "sphinxcontrib-jsmath",
+    "sphinxcontrib-htmlhelp>=2.0.0",
+    "sphinxcontrib-serializinghtml>=1.1.5",
+    "sphinxcontrib-qthelp",
+    "Jinja2>=3.0",
+    "Pygments>=2.13",
+    "docutils>=0.18.1,<0.21",
+    "snowballstemmer>=2.0",
+    "babel>=2.9",
+    "alabaster>=0.7,<0.8",
+    "imagesize>=1.3",
+    "requests>=2.25.0",
+    "packaging>=21.0",
+    "importlib-metadata>=4.8; python_version < '3.10'",
+    "colorama>=0.4.5; sys_platform == 'win32'",
+
+dynamic = "version"
+
+project.optional-dependencies
+docs = 
+    "sphinxcontrib-websupport",
+
+lint = 
+    "flake8>=3.5.0",
+    "flake8-simplify",
+    "isort",
+    "ruff",
+    "mypy>=0.990",
+    "sphinx-lint",
+    "docutils-stubs",
+    "types-requests",
+
+test = 
+    "pytest>=4.6",
+    "html5lib",
+    "cython",
+    "filelock"
+
+
+project.authors
+name = "Georg Brandl"
+email = "georg@python.org"
+
+project.scripts
+sphinx-build = "sphinx.cmd.build:main"
+sphinx-quickstart = "sphinx.cmd.quickstart:main"
+sphinx-apidoc = "sphinx.ext.apidoc:main"
+sphinx-autogen = "sphinx.ext.autosummary.generate:main"
+
+tool.flit.module
+name = "sphinx"
+
+tool.flit.sdist
+include = 
+    "LICENSE",
+    "AUTHORS",
+    "CHANGES",
+    # Documentation
+    "doc/",
+    "CODE_OF_CONDUCT",  # used as an include in the Documentation
+    "EXAMPLES",  # used as an include in the Documentation
+    # Tests
+    "tests/",
+    "tox.ini",
+    # Utilities
+    "utils/",
+    "babel.cfg",
+
+exclude = 
+    "doc/_build",
+
+
+tool.isort
+line_length = 95
+profile = "black"
+remove_redundant_aliases = true
+
+tool.ruff
+target-version = "py38"  # Pin Ruff to Python 3.8
+line-length = 95
+show-source = true
+exclude = 
+    ".git",
+    ".tox",
+    ".venv",
+    "tests/roots/*",
+    "build/*",
+    "doc/_build/*",
+    "sphinx/search/*",
+    "doc/usage/extensions/example*.py",
+
+ignore = 
+    # pycodestyle
+    "E741",
+    # flake8-builtins
+    "A001",  # variable is shadowing a python builtin
+    "A002",  # argument is shadowing a python builtin
+    "A003",  # class attribute is shadowing a python builtin
+    # flake8-annotations
+    "ANN",
+    # flake8-unused-arguments
+    "ARG001",  #  unused function argument
+    "ARG002",  #  unused method argument
+    "ARG003",  #  unused class method argument
+    "ARG005",  #  unused lambda argument
+    # flake8-bugbear
+    "B006",  # do not use mutable data structures for argument default
+    "B023",  # function definition does not bind loop variable
+    "B026",  # keyword argument ... must come after starred arguments
+    "B028",  # no explicit `stacklevel` keyword argument found
+    # flake8-bugbear opinionated (disabled by default in flake8)
+    "B904",  # within an except clause, raise exceptions with `raise ... from ...`
+    # flake8-blind-except
+    "BLE001",  # do not catch blind exception
+    # mccabe
+    "C901",  # ... is too complex
+    # flake8-commas
+    "COM819",  # trailing comma prohibited
+    # pydocstyle
+    "D",
+    # flake8-django
+    "DJ",  # Django is not used in Sphinx
+    # flake8-datetimez
+    "DTZ001",  # do not use `datetime.datetime()` without `tzinfo` argument
+    "DTZ004",  # do not use `datetime.datetime.utcfromtimestamp()`
+    "DTZ005",  # do not use `datetime.datetime.now()` without `tz` argument
+    "DTZ006",  # do not use `datetime.datetime.fromtimestamp()` without `tz` argument
+    # flake8-errmsg
+    "EM101",  # exception must not use a string literal, assign to variable first
+    "EM102",  # exception must not use an f-string literal, assign to variable first
+    # eradicate
+    "ERA001",  # found commented-out code
+    # flake8-executable
+    "EXE002",  # file executable but no shebang present
+    # flake8-boolean-trap
+    "FBT001",  # boolean positional arg in function definition
+    "FBT002",  # boolean default value in function definition
+    "FBT003",  # boolean positional value in function call
+    # flake8-logging-format
+    "G002",  # logging statement uses `%`
+    "G003",  # logging statement uses `+`
+    # flake8-implicit-str-concat
+    "ISC001",  # implicitly concatenated string literals on one line
+    "ISC002",  # implicitly concatenated string literals over multiple lines
+    "ISC003",  # explicitly concatenated string should be implicitly concatenated
+    # pep8-naming
+    "N",
+    # NumPy-specific rules
+    "NPY",  # numpy is not used in Sphinx
+    # pandas-vet
+    "PD",  # pandas is not used in Sphinx
+    # pygrep-hooks
+    "PGH003",
+    # flake8-pie
+    "PIE790",   # unnecessary 'pass' statement
+    # pylint
+    "PLC1901",  # simplify truthy/falsey string comparisons
+    "PLR2004",  # avoid magic values
+    "PLR0911",  # too many return statements
+    "PLR0912",  # too many branches
+    "PLR0913",  # too many arguments to function call
+    "PLR0915",  # too many statements
+    "PLR5501",  # consider using elif to remove an indentation level
+    "PLW0603",  # using the global statement to update variables is discouraged
+    "PLW2901",  # outer loop variable overwritten by inner assignment
+    # flake8-pytest-style
+    "PT003",  # `scope='function'` is implied in `@pytest.fixture()`
+    "PT006",  # wrong name type in `@pytest.mark.parametrize`,
+    "PT007",  # wrong values type in `@pytest.mark.parametrize`
+    "PT011",  # `pytest.raises(ValueError)` is too broad, set the `match` parameter
+    # flake8-use-pathlib
+    "PTH",
+    # flake8-quotes
+    "Q000",  # double quotes found but single quotes preferred
+    "Q001",  # single quote docstring found but double quotes preferred
+    # flake8-return
+    "RET504",  # unnecessary variable assignment before `return` statement
+    "RET505",  # unnecessary `else` after `return` statement
+    # flake8-raise
+    "RSE102",
+    # Ruff-specific rules
+    "RUF001",  # string contains ambiguous unicode character
+    "RUF003",  # comment contains ambiguous unicode character
+    "RUF005",  # consider unpacking instead of concatenation
+    # flake8-bandit
+    "S101",  # assert used
+    "S105",  # possible hardcoded password
+    "S110",  # try/except/pass detected
+    "S113",  # probable use of requests call without timeout
+    "S301",  # 'pickle' unsafe when loading untrusted data
+    "S324",  # probable use of insecure hash functions
+    "S701",  # use autoescape=True for Jinja
+    # flake8-simplify
+    "SIM102", # nested 'if' statements
+    "SIM103", # return condition directly
+    "SIM105", # use contextlib.suppress
+    "SIM108", # use ternary operator
+    "SIM115", # use context handler for opening files
+    "SIM117", # use single 'with' statement
+    # flake8-self
+    "SLF001",  # private member accessed
+    # flake8-print
+    "T201",  # print found
+    # flake8-type-checking
+    "TCH001", # move application import into a type-checking block
+    "TCH002", # move third-party import into a type-checking block
+    # tryceratops
+    "TRY",
+    # pyupgrade
+    "UP031", # replace with format specifiers
+
+external =   # Whitelist for RUF100 unknown code warnings
+    "E704",
+    "W291",
+    "W293",
+    "SIM110",
+    "SIM113",
+
+select = 
+    "ALL",  # every check supported by Ruff
+
+
+tool.ruff.per-file-ignores
+"doc/conf.py" = "INP001"
+"doc/development/tutorials/examples/*" = "INP001"
+
+"sphinx/environment/collectors/toctree.py" = "B026"
+"sphinx/environment/adapters/toctree.py" = "B026"
+
+"tests/*" = "E501"
+
+tool.ruff.flake8-quotes
+inline-quotes = "single"
+
+tool.mypy
+check_untyped_defs = true
+disallow_incomplete_defs = true
+follow_imports = "skip"
+ignore_missing_imports = true
+no_implicit_optional = true
+python_version = "3.8"
+show_column_numbers = true
+show_error_codes = true
+show_error_context = true
+strict_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+disallow_any_generics = true
+
+tool.mypy.overrides
+module = 
+    "sphinx.application",
+    "sphinx.builders",
+    "sphinx.builders.html",
+    "sphinx.builders.latex",
+    "sphinx.builders.linkcheck",
+    "sphinx.domains",
+    "sphinx.domains.c",
+    "sphinx.domains.cpp",
+    "sphinx.domains.javascript",
+    "sphinx.domains.python",
+    "sphinx.domains.std",
+    "sphinx.environment",
+    "sphinx.environment.adapters.toctree",
+    "sphinx.environment.adapters.indexentries",
+    "sphinx.ext.apidoc",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autodoc.mock",
+    "sphinx.ext.autodoc.importer",
+    "sphinx.ext.autodoc.preserve_defaults",
+    "sphinx.ext.autodoc.type_comment",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.autosummary.generate",
+    "sphinx.ext.doctest",
+    "sphinx.ext.duration",
+    "sphinx.ext.graphviz",
+    "sphinx.ext.inheritance_diagram",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.imgmath",
+    "sphinx.ext.linkcode",
+    "sphinx.ext.mathjax",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.napoleon.docstring",
+    "sphinx.pycode.parser",
+    "sphinx.registry",
+    "sphinx.testing.util",
+    "sphinx.transforms.i18n",
+    "sphinx.transforms.post_transforms.images",
+    "sphinx.util.cfamily",
+    "sphinx.util.docfields",
+    "sphinx.util.docutils",
+    "sphinx.util.typing",
+    "sphinx.writers.latex",
+    "sphinx.writers.text",
+    "sphinx.writers.xml",
+
+strict_optional = false
+
+tool.mypy.overrides
+module = 
+    "sphinx.application",
+    "sphinx.builders._epub_base",
+    "sphinx.builders.html",
+    "sphinx.builders.linkcheck",
+    "sphinx.cmd.quickstart",
+    "sphinx.config",
+    "sphinx.domains",
+    "sphinx.domains.c",
+    "sphinx.domains.cpp",
+    "sphinx.environment.*",
+    "sphinx.events",
+    "sphinx.ext.*",
+    "sphinx.highlighting",
+    "sphinx.jinja2glue",
+    "sphinx.registry",
+    "sphinx.roles",
+    "sphinx.search.*",
+    "sphinx.testing.*",
+    "sphinx.util.*",
+
+disallow_any_generics = false
+
+tool.pytest.ini_options
+filterwarnings = 
+    "all",
+    "ignore::DeprecationWarning:docutils.io",
+    "ignore::DeprecationWarning:pyximport.pyximport",
+    "ignore::ImportWarning:importlib._bootstrap",
+
+markers = 
+    "apidoc",
+
+testpaths = "tests"
+
+tool.coverage.run
+branch = true
+parallel = true
+source = 'sphinx'
+
+tool.coverage.report
+exclude_lines = 
+    # Have to re-enable the standard pragma
+    'pragma: no cover',
+    # Don't complain if tests don't hit defensive assertion code:
+    'raise NotImplementedError',
+    # Don't complain if non-runnable code isn't run:
+    'if __name__ == .__main__.:',
+
+ignore_errors = true

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/__init__.py Changed

@@ -1,21 +1,11 @@
-"""
-    Sphinx
-    ~~~~~~
-
-    The Sphinx documentation toolchain.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""The Sphinx documentation toolchain."""
 
 # Keep this file executable as-is in Python 3!
-# (Otherwise getting the version out of it from setup.py is impossible.)
+# (Otherwise getting the version out of it when packaging is impossible.)
 
 import os
-import subprocess
 import warnings
 from os import path
-from subprocess import PIPE
 
 from .deprecation import RemovedInNextVersionWarning
 
@@ -26,9 +16,11 @@
 # docutils.io using mode='rU' for open
 warnings.filterwarnings('ignore', "'U' mode is deprecated",
                         DeprecationWarning, module='docutils.io')
+warnings.filterwarnings('ignore', 'The frontend.Option class .*',
+                        DeprecationWarning, module='docutils.frontend')
 
-__version__ = '4.4.0'
-__released__ = '4.4.0'  # used when Sphinx builds its own docs
+__version__ = '7.0.1'
+__display_version__ = __version__  # used for command line version
 
 #: Version info for better programmatic use.
 #:
@@ -38,22 +30,25 @@
 #:
 #: .. versionadded:: 1.2
 #:    Before version 1.2, check the string ``sphinx.__version__``.
-version_info = (4, 4, 0, 'final', 0)
+version_info = (7, 0, 1, 'final', 0)
 
 package_dir = path.abspath(path.dirname(__file__))
 
-__display_version__ = __version__  # used for command line version
-if __version__.endswith('+'):
-    # try to find out the commit hash if checked out from git, and append
-    # it to __version__ (since we use this value from setup.py, it gets
-    # automatically propagated to an installed copy as well)
-    __display_version__ = __version__
-    __version__ = __version__:-1  # remove '+' for PEP-440 version spec.
+_in_development = False
+if _in_development:
+    # Only import subprocess if needed
+    import subprocess
+
     try:
-        ret = subprocess.run('git', 'show', '-s', '--pretty=format:%h',
-                             cwd=package_dir,
-                             stdout=PIPE, stderr=PIPE, encoding='ascii')
-        if ret.stdout:
-            __display_version__ += '/' + ret.stdout.strip()
-    except Exception:
-        pass
+        ret = subprocess.run(
+            'git', 'show', '-s', '--pretty=format:%h',
+            cwd=package_dir,
+            capture_output=True,
+            encoding='ascii',
+        ).stdout
+        if ret:
+            __display_version__ += '+/' + ret.strip()
+        del ret
+    finally:
+        del subprocess
+del _in_development

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/__main__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/__main__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/addnodes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/addnodes.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.addnodes
-    ~~~~~~~~~~~~~~~
+"""Document tree nodes that Sphinx defines on top of those in Docutils."""
 
-    Additional docutils nodes.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Dict, List, Sequence
+from typing import TYPE_CHECKING, Any, Sequence
 
 from docutils import nodes
 from docutils.nodes import Element
@@ -16,12 +10,22 @@
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
-try:
-    from docutils.nodes import meta as docutils_meta  # type: ignore
-except ImportError:
-    # docutils-0.17 or older
-    from docutils.parsers.rst.directives.html import MetaBody
-    docutils_meta = MetaBody.meta
+# deprecated name -> (object to return, canonical path or empty string)
+_DEPRECATED_OBJECTS = {
+    'meta': (nodes.meta, 'docutils.nodes.meta'),  # type: ignoreattr-defined
+    'docutils_meta': (nodes.meta, 'docutils.nodes.meta'),  # type: ignoreattr-defined
+}
+
+
+def __getattr__(name):
+    if name not in _DEPRECATED_OBJECTS:
+        raise AttributeError(f'module {__name__!r} has no attribute {name!r}')
+
+    from sphinx.deprecation import _deprecation_warning
+
+    deprecated_object, canonical_name = _DEPRECATED_OBJECTSname
+    _deprecation_warning(__name__, name, canonical_name, remove=(7, 0))
+    return deprecated_object
 
 
 class document(nodes.document):
@@ -34,21 +38,9 @@
                    in your extensions.  It will be removed without deprecation period.
     """
 
-    def set_id(self, node: Element, msgnode: Element = None,
+    def set_id(self, node: Element, msgnode: Element | None = None,
                suggested_prefix: str = '') -> str:
-        from sphinx.util import docutils
-        if docutils.__version_info__ >= (0, 16):
-            ret = super().set_id(node, msgnode, suggested_prefix)  # type: ignore
-        else:
-            ret = super().set_id(node, msgnode)
-
-        if docutils.__version_info__ < (0, 17):
-            # register other node IDs forcedly
-            for node_id in node'ids':
-                if node_id not in self.ids:
-                    self.idsnode_id = node
-
-        return ret
+        return super().set_id(node, msgnode, suggested_prefix)  # type: ignore
 
 
 class translatable(nodes.Node):
@@ -110,8 +102,8 @@
         if self.get('rawcaption') == original_message:
             self'caption' = translated_message
 
-    def extract_original_messages(self) -> Liststr:
-        messages: Liststr = 
+    def extract_original_messages(self) -> liststr:
+        messages: liststr = 
 
         # toctree entries
         messages.extend(self.get('rawentries', ))
@@ -127,12 +119,12 @@
 #############################################################
 
 class _desc_classes_injector(nodes.Element, not_smartquotable):
-    """Helper base class for injecting a fixes list of classes.
+    """Helper base class for injecting a fixed list of classes.
 
     Use as the first base class.
     """
 
-    classes: Liststr = 
+    classes: liststr = 
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
@@ -206,7 +198,7 @@
     classes = 'sig', 'sig-inline'
 
     def __init__(self, domain: str, *args: Any, **kwargs: Any) -> None:
-        super().__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs, domain=domain)
         self'classes'.append(domain)
 
 
@@ -258,7 +250,7 @@
     child_text_separator = ', '
 
     def astext(self):
-        return '({})'.format(super().astext())
+        return f'({super().astext()})'
 
 
 class desc_parameter(nodes.Part, nodes.Inline, nodes.FixedTextElement):
@@ -286,7 +278,7 @@
 
 class desc_sig_element(nodes.inline, _desc_classes_injector):
     """Common parent class of nodes for inline text of a signature."""
-    classes: Liststr = 
+    classes: liststr = 
 
     def __init__(self, rawsource: str = '', text: str = '',
                  *children: Element, **attributes: Any) -> None:
@@ -398,7 +390,7 @@
 
 
 class centered(nodes.Part, nodes.TextElement):
-    """Deprecated."""
+    """This node is deprecated."""
 
 
 class acks(nodes.Element):
@@ -443,13 +435,6 @@
     """Node for specifying tabular columns, used for LaTeX output."""
 
 
-class meta(nodes.Special, nodes.PreBibliographic, nodes.Element):
-    """Node for meta directive -- same as docutils' standard meta node,
-    but pickleable.
-    """
-    rawcontent = None
-
-
 # inline nodes
 
 class pending_xref(nodes.Inline, nodes.Element):
@@ -463,13 +448,18 @@
 
 
 class pending_xref_condition(nodes.Inline, nodes.TextElement):
-    """Node for cross-references that are used to choose appropriate
-    content of the reference by conditions on the resolving phase.
+    """Node representing a potential way to create a cross-reference and the
+    condition in which this way should be used.
+
+    This node is only allowed to be placed under a :py:class:`pending_xref`
+    node.  A **pending_xref** node must contain either no **pending_xref_condition**
+    nodes or it must only contains **pending_xref_condition** nodes.
 
-    When the :py:class:`pending_xref` node contains one or more
-    **pending_xref_condition** nodes, the cross-reference resolver
-    should choose the content of the reference using defined conditions
-    in ``condition`` attribute of each pending_xref_condition nodes::
+    The cross-reference resolver will replace a :py:class:`pending_xref` which
+    contains **pending_xref_condition** nodes by the content of exactly one of
+    those **pending_xref_condition** nodes' content. It uses the **condition**
+    attribute to decide which **pending_xref_condition** node's content to
+    use. For example, let us consider how the cross-reference resolver acts on::
 
         <pending_xref refdomain="py" reftarget="io.StringIO ...>
             <pending_xref_condition condition="resolved">
@@ -479,32 +469,26 @@
                 <literal>
                     io.StringIO
 
-    After the processing of cross-reference resolver, one of the content node
-    under pending_xref_condition node is chosen by its condition and to be
-    removed all of pending_xref_condition nodes::
+    If the cross-reference resolver successfully resolves the cross-reference,
+    then it rewrites the **pending_xref** as::
 
-        # When resolved the cross-reference successfully
         <reference>
             <literal>
                 StringIO
 
-        # When resolution is failed
+    Otherwise, if the cross-reference resolution failed, it rewrites the
+    **pending_xref** as::
+
         <reference>
             <literal>
                 io.StringIO
 
-    .. note:: This node is only allowed to be placed under pending_xref node.
-              It is not allows to place it under other nodes.  In addition,
-              pending_xref node must contain only pending_xref_condition
-              nodes if it contains one or more pending_xref_condition nodes.
-
-    The pending_xref_condition node should have **condition** attribute.
+    The **pending_xref_condition** node should have **condition** attribute.
     Domains can be store their individual conditions into the attribute to
     filter contents on resolving phase.  As a reserved condition name,
     ``condition="*"`` is used for the fallback of resolution failure.
     Additionally, as a recommended condition name, ``condition="resolved"``
-    is used for the representation of resolstion success in the intersphinx
-    module.
+    represents a resolution success in the intersphinx module.
 
     .. versionadded:: 4.0
     """
@@ -534,9 +518,7 @@
     """Node for references to manpages."""
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
-    from sphinx.util import docutils  # lazy import
-
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_node(toctree)
 
     app.add_node(desc)
@@ -579,9 +561,6 @@
     app.add_node(literal_strong)
     app.add_node(manpage)
 
-    if docutils.__version_info__ < (0, 18):
-        app.add_node(meta)
-
     return {
         'version': 'builtin',
         'parallel_read_safe': True,

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/application.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/application.py Changed

@@ -1,23 +1,17 @@
-"""
-    sphinx.application
-    ~~~~~~~~~~~~~~~~~~
-
-    Sphinx application class and extensibility interface.
+"""Sphinx application class and extensibility interface.
 
-    Gracefully adapted from the TextPress system by Armin.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Gracefully adapted from the TextPress system by Armin.
 """
 
+from __future__ import annotations
+
 import os
 import pickle
 import sys
-import warnings
 from collections import deque
 from io import StringIO
 from os import path
-from typing import IO, TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple, Type, Union
+from typing import IO, TYPE_CHECKING, Any, Callable
 
 from docutils import nodes
 from docutils.nodes import Element, TextElement
@@ -29,7 +23,6 @@
 import sphinx
 from sphinx import locale, package_dir
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.domains import Domain, Index
 from sphinx.environment import BuildEnvironment
 from sphinx.environment.collectors import EnvironmentCollector
@@ -42,9 +35,10 @@
 from sphinx.registry import SphinxComponentRegistry
 from sphinx.roles import XRefRole
 from sphinx.theming import Theme
-from sphinx.util import docutils, logging, progress_message
+from sphinx.util import docutils, logging
 from sphinx.util.build_phase import BuildPhase
 from sphinx.util.console import bold  # type: ignore
+from sphinx.util.display import progress_message
 from sphinx.util.i18n import CatalogRepository
 from sphinx.util.logging import prefixed_warnings
 from sphinx.util.osutil import abspath, ensuredir, relpath
@@ -52,12 +46,12 @@
 from sphinx.util.typing import RoleFunction, TitleGetter
 
 if TYPE_CHECKING:
-    from docutils.nodes import Node  # NOQA
+    from docutils.nodes import Node  # noqa: F401
 
     from sphinx.builders import Builder
 
 
-builtin_extensions = (
+builtin_extensions: tuplestr, ... = (
     'sphinx.addnodes',
     'sphinx.builders.changes',
     'sphinx.builders.epub3',
@@ -98,7 +92,6 @@
     'sphinx.transforms.post_transforms',
     'sphinx.transforms.post_transforms.code',
     'sphinx.transforms.post_transforms.images',
-    'sphinx.util.compat',
     'sphinx.versioning',
     # collectors should be loaded by specific order
     'sphinx.environment.collectors.dependencies',
@@ -106,16 +99,21 @@
     'sphinx.environment.collectors.metadata',
     'sphinx.environment.collectors.title',
     'sphinx.environment.collectors.toctree',
+)
+_first_party_extensions = (
     # 1st party extensions
     'sphinxcontrib.applehelp',
     'sphinxcontrib.devhelp',
     'sphinxcontrib.htmlhelp',
     'sphinxcontrib.serializinghtml',
     'sphinxcontrib.qthelp',
-    # Strictly, alabaster theme is not a builtin extension,
-    # but it is loaded automatically to use it as default theme.
+)
+_first_party_themes = (
+    # Alabaster is loaded automatically to be used as the default theme
     'alabaster',
 )
+builtin_extensions += _first_party_themes
+builtin_extensions += _first_party_extensions
 
 ENV_PICKLE_FILENAME = 'environment.pickle'
 
@@ -134,17 +132,16 @@
     warningiserror: bool
     _warncount: int
 
-    def __init__(self, srcdir: str, confdir: Optionalstr, outdir: str, doctreedir: str,
-                 buildername: str, confoverrides: Dict = None,
-                 status: IO = sys.stdout, warning: IO = sys.stderr,
-                 freshenv: bool = False, warningiserror: bool = False, tags: Liststr = None,
-                 verbosity: int = 0, parallel: int = 0, keep_going: bool = False) -> None:
+    def __init__(self, srcdir: str, confdir: str | None, outdir: str, doctreedir: str,
+                 buildername: str, confoverrides: dict | None = None,
+                 status: IO | None = sys.stdout, warning: IO | None = sys.stderr,
+                 freshenv: bool = False, warningiserror: bool = False,
+                 tags: liststr | None = None,
+                 verbosity: int = 0, parallel: int = 0, keep_going: bool = False,
+                 pdb: bool = False) -> None:
         self.phase = BuildPhase.INITIALIZATION
         self.verbosity = verbosity
-        self.extensions: Dictstr, Extension = {}
-        self.builder: OptionalBuilder = None
-        self.env: OptionalBuildEnvironment = None
-        self.project: OptionalProject = None
+        self.extensions: dictstr, Extension = {}
         self.registry = SphinxComponentRegistry()
 
         # validate provided directories
@@ -183,6 +180,7 @@
             self.warningiserror = False
         else:
             self.warningiserror = warningiserror
+        self.pdb = pdb
         logging.setup(self, self._status, self._warning)
 
         self.events = EventManager(self)
@@ -221,7 +219,8 @@
                 __('This project needs at least Sphinx v%s and therefore cannot '
                    'be built with this version.') % self.config.needs_sphinx)
 
-        # load all built-in extension modules
+        # load all built-in extension modules, first-party extension modules,
+        # and first-party themes
         for extension in builtin_extensions:
             self.setup_extension(extension)
 
@@ -246,7 +245,7 @@
                     raise ConfigError(
                         __("'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.")
+                           "This is needed for conf.py to behave as a Sphinx extension."),
                     )
 
         # now that we know all config values, collect them from conf.py
@@ -255,10 +254,16 @@
 
         # create the project
         self.project = Project(self.srcdir, self.config.source_suffix)
+
+        # set up the build environment
+        self.env = self._init_env(freshenv)
+
         # create the builder
         self.builder = self.create_builder(buildername)
-        # set up the build environment
-        self._init_env(freshenv)
+
+        # build environment post-initialisation, after creating the builder
+        self._post_init_env()
+
         # set up the builder
         self._init_builder()
 
@@ -266,8 +271,8 @@
         """Load translated strings from the configured localedirs if enabled in
         the configuration.
         """
-        if self.config.language is None:
-            self.translator, has_translation = locale.init(, None)
+        if self.config.language == 'en':
+            self.translator, _ = locale.init(, None)
         else:
             logger.info(bold(__('loading translations %s... ') % self.config.language),
                         nonl=True)
@@ -280,89 +285,72 @@
                     catalog.write_mo(self.config.language,
                                      self.config.gettext_allow_fuzzy_translations)
 
-            locale_dirs: ListOptionalstr = list(repo.locale_dirs)
+            locale_dirs: liststr | None = list(repo.locale_dirs)
             locale_dirs += None
             locale_dirs += path.join(package_dir, 'locale')
 
             self.translator, has_translation = locale.init(locale_dirs, self.config.language)
-            if has_translation or self.config.language == 'en':
-                # "en" never needs to be translated
+            if has_translation:
                 logger.info(__('done'))
             else:
                 logger.info(__('not available for built-in messages'))
 
-    def _init_env(self, freshenv: bool) -> None:
+    def _init_env(self, freshenv: bool) -> BuildEnvironment:
         filename = path.join(self.doctreedir, ENV_PICKLE_FILENAME)
         if freshenv or not os.path.exists(filename):
-            self.env = BuildEnvironment(self)
-            self.env.find_files(self.config, self.builder)
+            return self._create_fresh_env()
         else:
-            try:
-                with progress_message(__('loading pickled environment')):
-                    with open(filename, 'rb') as f:
-                        self.env = pickle.load(f)
-                        self.env.setup(self)
-            except Exception as err:
-                logger.info(__('failed: %s'), err)
-                self._init_env(freshenv=True)
+            return self._load_existing_env(filename)
+
+    def _create_fresh_env(self) -> BuildEnvironment:
+        env = BuildEnvironment(self)
+        self._fresh_env_used = True
+        return env
+
+    def _load_existing_env(self, filename: str) -> BuildEnvironment:
+        try:
+            with progress_message(__('loading pickled environment')):
+                with open(filename, 'rb') as f:
+                    env = pickle.load(f)
+                    env.setup(self)
+                    self._fresh_env_used = False
+        except Exception as err:
+            logger.info(__('failed: %s'), err)
+            env = self._create_fresh_env()
+        return env
+
+    def _post_init_env(self) -> None:
+        if self._fresh_env_used:
+            self.env.find_files(self.config, self.builder)
+        del self._fresh_env_used
 
     def preload_builder(self, name: str) -> None:
         self.registry.preload_builder(self, name)
 
-    def create_builder(self, name: str) -> "Builder":
+    def create_builder(self, name: str) -> Builder:
         if name is None:
             logger.info(__('No builder selected, using default: html'))
             name = 'html'
 
-        return self.registry.create_builder(self, name)
+        return self.registry.create_builder(self, name, self.env)
 
     def _init_builder(self) -> None:
-        self.builder.set_environment(self.env)
         self.builder.init()
         self.events.emit('builder-inited')
 
     # ---- main "build" method -------------------------------------------------
 
-    def build(self, force_all: bool = False, filenames: Liststr = None) -> None:
+    def build(self, force_all: bool = False, filenames: liststr | None = None) -> None:
         self.phase = BuildPhase.READING
         try:
             if force_all:
-                self.builder.compile_all_catalogs()
                 self.builder.build_all()
             elif filenames:
-                self.builder.compile_specific_catalogs(filenames)
                 self.builder.build_specific(filenames)
             else:
-                self.builder.compile_update_catalogs()
                 self.builder.build_update()
 
-            if self._warncount and self.keep_going:
-                self.statuscode = 1
-
-            status = (__('succeeded') if self.statuscode == 0
-                      else __('finished with problems'))
-            if self._warncount:
-                if self.warningiserror:
-                    if self._warncount == 1:
-                        msg = __('build %s, %s warning (with warnings treated as errors).')
-                    else:
-                        msg = __('build %s, %s warnings (with warnings treated as errors).')
-                else:
-                    if self._warncount == 1:
-                        msg = __('build %s, %s warning.')
-                    else:
-                        msg = __('build %s, %s warnings.')
-
-                logger.info(bold(msg % (status, self._warncount)))
-            else:
-                logger.info(bold(__('build %s.') % status))
-
-            if self.statuscode == 0 and self.builder.epilog:
-                logger.info('')
-                logger.info(self.builder.epilog % {
-                    'outdir': relpath(self.outdir),
-                    'project': self.config.project
-                })
+            self.events.emit('build-finished', None)
         except Exception as err:
             # delete the saved env to force a fresh build next time
             envfile = path.join(self.doctreedir, ENV_PICKLE_FILENAME)
@@ -370,8 +358,35 @@
                 os.unlink(envfile)
             self.events.emit('build-finished', err)
             raise
+
+        if self._warncount and self.keep_going:
+            self.statuscode = 1
+
+        status = (__('succeeded') if self.statuscode == 0
+                  else __('finished with problems'))
+        if self._warncount:
+            if self.warningiserror:
+                if self._warncount == 1:
+                    msg = __('build %s, %s warning (with warnings treated as errors).')
+                else:
+                    msg = __('build %s, %s warnings (with warnings treated as errors).')
+            else:
+                if self._warncount == 1:
+                    msg = __('build %s, %s warning.')
+                else:
+                    msg = __('build %s, %s warnings.')
+
+            logger.info(bold(msg % (status, self._warncount)))
         else:
-            self.events.emit('build-finished', None)
+            logger.info(bold(__('build %s.') % status))
+
+        if self.statuscode == 0 and self.builder.epilog:
+            logger.info('')
+            logger.info(self.builder.epilog % {
+                'outdir': relpath(self.outdir),
+                'project': self.config.project,
+            })
+
         self.builder.cleanup()
 
     # ---- general extensibility interface -------------------------------------
@@ -430,7 +445,7 @@
         self.events.disconnect(listener_id)
 
     def emit(self, event: str, *args: Any,
-             allowed_exceptions: TupleTypeException, ... = ()) -> List:
+             allowed_exceptions: tupletypeException, ... = ()) -> list:
         """Emit *event* and pass *arguments* to the callback functions.
 
         Return the return values of all callbacks as a list.  Do not emit core
@@ -447,7 +462,7 @@
         return self.events.emit(event, *args, allowed_exceptions=allowed_exceptions)
 
     def emit_firstresult(self, event: str, *args: Any,
-                         allowed_exceptions: TupleTypeException, ... = ()) -> Any:
+                         allowed_exceptions: tupletypeException, ... = ()) -> Any:
         """Emit *event* and pass *arguments* to the callback functions.
 
         Return the result of the first callback that doesn't return ``None``.
@@ -466,7 +481,7 @@
 
     # registering addon parts
 
-    def add_builder(self, builder: Type"Builder", override: bool = False) -> None:
+    def add_builder(self, builder: typeBuilder, override: bool = False) -> None:
         """Register a new builder.
 
         :param builder: A builder class
@@ -479,7 +494,7 @@
         self.registry.add_builder(builder, override=override)
 
     # TODO(stephenfin): Describe 'types' parameter
-    def add_config_value(self, name: str, default: Any, rebuild: Unionbool, str,
+    def add_config_value(self, name: str, default: Any, rebuild: bool | str,
                          types: Any = ()) -> None:
         """Register a configuration value.
 
@@ -528,7 +543,7 @@
         logger.debug('app adding event: %r', name)
         self.events.add(name)
 
-    def set_translator(self, name: str, translator_class: Typenodes.NodeVisitor,
+    def set_translator(self, name: str, translator_class: typenodes.NodeVisitor,
                        override: bool = False) -> None:
         """Register or override a Docutils translator class.
 
@@ -547,8 +562,8 @@
         """
         self.registry.add_translator(name, translator_class, override=override)
 
-    def add_node(self, node: TypeElement, override: bool = False,
-                 **kwargs: TupleCallable, OptionalCallable) -> None:
+    def add_node(self, node: typeElement, override: bool = False,
+                 **kwargs: tupleCallable, Callable | None) -> None:
         """Register a Docutils node class.
 
         This is necessary for Docutils internals.  It may also be used in the
@@ -591,9 +606,9 @@
         docutils.register_node(node)
         self.registry.add_translation_handlers(node, **kwargs)
 
-    def add_enumerable_node(self, node: TypeElement, figtype: str,
-                            title_getter: TitleGetter = None, override: bool = False,
-                            **kwargs: TupleCallable, Callable) -> None:
+    def add_enumerable_node(self, node: typeElement, figtype: str,
+                            title_getter: TitleGetter | None = None, override: bool = False,
+                            **kwargs: tupleCallable, Callable) -> None:
         """Register a Docutils node class as a numfig target.
 
         Sphinx numbers the node automatically. And then the users can refer it
@@ -620,13 +635,14 @@
         self.registry.add_enumerable_node(node, figtype, title_getter, override=override)
         self.add_node(node, override=override, **kwargs)
 
-    def add_directive(self, name: str, cls: TypeDirective, override: bool = False) -> None:
+    def add_directive(self, name: str, cls: typeDirective, override: bool = False) -> None:
         """Register a Docutils directive.
 
         :param name: The name of the directive
         :param cls: A directive class
-        :param override: If true, install the directive forcedly even if another directive
+        :param override: If false, do not install it if another directive
                          is already installed as the same name
+                         If true, unconditionally install the directive.
 
         For example, a custom directive named ``my-directive`` would be added
         like this:
@@ -673,8 +689,9 @@
 
         :param name: The name of role
         :param role: A role function
-        :param override: If true, install the role forcedly even if another role is already
-                         installed as the same name
+        :param override: If false, do not install it if another role
+                         is already installed as the same name
+                         If true, unconditionally install the role.
 
         For more details about role functions, see `the Docutils docs
         <https://docutils.sourceforge.io/docs/howto/rst-roles.html>`__ .
@@ -694,8 +711,9 @@
         Register a Docutils role that does nothing but wrap its contents in the
         node given by *nodeclass*.
 
-        If *override* is True, the given *nodeclass* is forcedly installed even if
-        a role named as *name* is already installed.
+        :param override: If false, do not install it if another role
+                         is already installed as the same name
+                         If true, unconditionally install the role.
 
         .. versionadded:: 0.6
         .. versionchanged:: 1.8
@@ -710,12 +728,13 @@
         role = roles.GenericRole(name, nodeclass)
         docutils.register_role(name, role)
 
-    def add_domain(self, domain: TypeDomain, override: bool = False) -> None:
+    def add_domain(self, domain: typeDomain, override: bool = False) -> None:
         """Register a domain.
 
         :param domain: A domain class
-        :param override: If true, install the domain forcedly even if another domain
+        :param override: If false, do not install it if another domain
                          is already installed as the same name
+                         If true, unconditionally install the domain.
 
         .. versionadded:: 1.0
         .. versionchanged:: 1.8
@@ -724,7 +743,7 @@
         self.registry.add_domain(domain, override=override)
 
     def add_directive_to_domain(self, domain: str, name: str,
-                                cls: TypeDirective, override: bool = False) -> None:
+                                cls: typeDirective, override: bool = False) -> None:
         """Register a Docutils directive in a domain.
 
         Like :meth:`add_directive`, but the directive is added to the domain
@@ -733,8 +752,9 @@
         :param domain: The name of target domain
         :param name: A name of directive
         :param cls: A directive class
-        :param override: If true, install the directive forcedly even if another directive
+        :param override: If false, do not install it if another directive
                          is already installed as the same name
+                         If true, unconditionally install the directive.
 
         .. versionadded:: 1.0
         .. versionchanged:: 1.8
@@ -742,7 +762,7 @@
         """
         self.registry.add_directive_to_domain(domain, name, cls, override=override)
 
-    def add_role_to_domain(self, domain: str, name: str, role: UnionRoleFunction, XRefRole,
+    def add_role_to_domain(self, domain: str, name: str, role: RoleFunction | XRefRole,
                            override: bool = False) -> None:
         """Register a Docutils role in a domain.
 
@@ -752,8 +772,9 @@
         :param domain: The name of the target domain
         :param name: The name of the role
         :param role: The role function
-        :param override: If true, install the role forcedly even if another role is already
-                         installed as the same name
+        :param override: If false, do not install it if another role
+                         is already installed as the same name
+                         If true, unconditionally install the role.
 
         .. versionadded:: 1.0
         .. versionchanged:: 1.8
@@ -761,7 +782,7 @@
         """
         self.registry.add_role_to_domain(domain, name, role, override=override)
 
-    def add_index_to_domain(self, domain: str, index: TypeIndex, override: bool = False
+    def add_index_to_domain(self, domain: str, index: typeIndex, override: bool = False,
                             ) -> None:
         """Register a custom index for a domain.
 
@@ -769,8 +790,9 @@
 
         :param domain: The name of the target domain
         :param index: The index class
-        :param override: If true, install the index forcedly even if another index is
-                         already installed as the same name
+        :param override: If false, do not install it if another index
+                         is already installed as the same name
+                         If true, unconditionally install the index.
 
         .. versionadded:: 1.0
         .. versionchanged:: 1.8
@@ -779,8 +801,9 @@
         self.registry.add_index_to_domain(domain, index)
 
     def add_object_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                        parse_node: Callable = None, ref_nodeclass: TypeTextElement = None,
-                        objname: str = '', doc_field_types: List = , override: bool = False
+                        parse_node: Callable | None = None,
+                        ref_nodeclass: typeTextElement | None = None,
+                        objname: str = '', doc_field_types: list = , override: bool = False,
                         ) -> None:
         """Register a new object type.
 
@@ -846,11 +869,11 @@
                                       override=override)
 
     def add_crossref_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                          ref_nodeclass: TypeTextElement = None, objname: str = '',
+                          ref_nodeclass: typeTextElement | None = None, objname: str = '',
                           override: bool = False) -> None:
         """Register a new crossref object type.
 
-        This method is very similar to :meth:`add_object_type` except that the
+        This method is very similar to :meth:`~Sphinx.add_object_type` except that the
         directive it generates must be empty, and will produce no output.
 
         That means that you can add semantic targets to your sources, and refer
@@ -874,8 +897,10 @@
         (Of course, the element following the ``topic`` directive needn't be a
         section.)
 
-        If *override* is True, the given crossref_type is forcedly installed even if
-        a crossref_type having the same name is already installed.
+
+        :param override: If false, do not install it if another cross-reference type
+                         is already installed as the same name
+                         If true, unconditionally install the cross-reference type.
 
         .. versionchanged:: 1.8
            Add *override* keyword.
@@ -884,12 +909,12 @@
                                         indextemplate, ref_nodeclass, objname,
                                         override=override)
 
-    def add_transform(self, transform: TypeTransform) -> None:
+    def add_transform(self, transform: typeTransform) -> None:
         """Register a Docutils transform to be applied after parsing.
 
-        Add the standard docutils :class:`Transform` subclass *transform* to
-        the list of transforms that are applied after Sphinx parses a reST
-        document.
+        Add the standard docutils :class:`~docutils.transforms.Transform`
+        subclass *transform* to the list of transforms that are applied after
+        Sphinx parses a reST document.
 
         :param transform: A transform class
 
@@ -916,38 +941,40 @@
         refs: `Transform Priority Range Categories`__
 
         __ https://docutils.sourceforge.io/docs/ref/transforms.html#transform-priority-range-categories
-        """  # NOQA
+        """  # NoQA: E501,RUF100  # Flake8 thinks the URL is too long, Ruff special cases URLs.
         self.registry.add_transform(transform)
 
-    def add_post_transform(self, transform: TypeTransform) -> None:
+    def add_post_transform(self, transform: typeTransform) -> None:
         """Register a Docutils transform to be applied before writing.
 
-        Add the standard docutils :class:`Transform` subclass *transform* to
-        the list of transforms that are applied before Sphinx writes a
-        document.
+        Add the standard docutils :class:`~docutils.transforms.Transform`
+        subclass *transform* to the list of transforms that are applied before
+        Sphinx writes a document.
 
         :param transform: A transform class
         """
         self.registry.add_post_transform(transform)
 
-    def add_js_file(self, filename: str, priority: int = 500,
-                    loading_method: Optionalstr = None, **kwargs: Any) -> None:
+    def add_js_file(self, filename: str | None, priority: int = 500,
+                    loading_method: str | None = None, **kwargs: Any) -> None:
         """Register a JavaScript file to include in the HTML output.
 
-        :param filename: The filename of the JavaScript file.  It must be relative to the HTML
-                         static path, a full URI with scheme, or ``None`` value.  The ``None``
-                         value is used to create inline ``<script>`` tag.  See the description
-                         of *kwargs* below.
-        :param priority: The priority to determine the order of ``<script>`` tag for
-                         JavaScript files.  See list of "prority range for JavaScript
-                         files" below.  If the priority of the JavaScript files it the same
-                         as others, the JavaScript files will be loaded in order of
-                         registration.
-        :param loading_method: The loading method of the JavaScript file.  ``'async'`` or
-                               ``'defer'`` is allowed.
-        :param kwargs: Extra keyword arguments are included as attributes of the ``<script>``
-                       tag.  A special keyword argument ``body`` is given, its value will be
-                       added between the ``<script>`` tag.
+        :param filename: The name of a JavaScript file that the default HTML
+                         template will include. It must be relative to the HTML
+                         static path, or a full URI with scheme, or ``None`` .
+                         The ``None`` value is used to create an inline
+                         ``<script>`` tag.  See the description of *kwargs*
+                         below.
+        :param priority: Files are included in ascending order of priority. If
+                         multiple JavaScript files have the same priority,
+                         those files will be included in order of registration.
+                         See list of "priority range for JavaScript files" below.
+        :param loading_method: The loading method for the JavaScript file.
+                               Either ``'async'`` or ``'defer'`` are allowed.
+        :param kwargs: Extra keyword arguments are included as attributes of the
+                       ``<script>`` tag.  If the special keyword argument
+                       ``body`` is given, its value will be added as the content
+                       of the  ``<script>`` tag.
 
         Example::
 
@@ -993,20 +1020,22 @@
             kwargs'defer' = 'defer'
 
         self.registry.add_js_file(filename, priority=priority, **kwargs)
-        if hasattr(self.builder, 'add_js_file'):
-            self.builder.add_js_file(filename, priority=priority, **kwargs)  # type: ignore
+        if hasattr(self, 'builder') and hasattr(self.builder, 'add_js_file'):
+            self.builder.add_js_file(filename,
+                                     priority=priority, **kwargs)
 
     def add_css_file(self, filename: str, priority: int = 500, **kwargs: Any) -> None:
         """Register a stylesheet to include in the HTML output.
 
-        :param filename: The filename of the CSS file.  It must be relative to the HTML
+        :param filename: The name of a CSS file that the default HTML
+                         template will include. It must be relative to the HTML
                          static path, or a full URI with scheme.
-        :param priority: The priority to determine the order of ``<link>`` tag for the
-                         CSS files.  See list of "prority range for CSS files" below.
-                         If the priority of the CSS files it the same as others, the
-                         CSS files will be loaded in order of registration.
-        :param kwargs: Extra keyword arguments are included as attributes of the ``<link>``
-                       tag.
+        :param priority: Files are included in ascending order of priority. If
+                         multiple CSS files have the same priority,
+                         those files will be included in order of registration.
+                         See list of "priority range for CSS files" below.
+        :param kwargs: Extra keyword arguments are included as attributes of the
+                       ``<link>`` tag.
 
         Example::
 
@@ -1054,30 +1083,11 @@
         """
         logger.debug('app adding stylesheet: %r', filename)
         self.registry.add_css_files(filename, priority=priority, **kwargs)
-        if hasattr(self.builder, 'add_css_file'):
-            self.builder.add_css_file(filename, priority=priority, **kwargs)  # type: ignore
-
-    def add_stylesheet(self, filename: str, alternate: bool = False, title: str = None
-                       ) -> None:
-        """An alias of :meth:`add_css_file`.
-
-        .. deprecated:: 1.8
-        """
-        logger.warning('The app.add_stylesheet() is deprecated. '
-                       'Please use app.add_css_file() instead.')
-
-        attributes = {}  # type: Dictstr, Any
-        if alternate:
-            attributes'rel' = 'alternate stylesheet'
-        else:
-            attributes'rel' = 'stylesheet'
+        if hasattr(self, 'builder') and hasattr(self.builder, 'add_css_file'):
+            self.builder.add_css_file(filename,
+                                      priority=priority, **kwargs)
 
-        if title:
-            attributes'title' = title
-
-        self.add_css_file(filename, **attributes)
-
-    def add_latex_package(self, packagename: str, options: str = None,
+    def add_latex_package(self, packagename: str, options: str | None = None,
                           after_hyperref: bool = False) -> None:
         r"""Register a package to include in the LaTeX source code.
 
@@ -1100,15 +1110,16 @@
         """
         self.registry.add_latex_package(packagename, options, after_hyperref)
 
-    def add_lexer(self, alias: str, lexer: TypeLexer) -> None:
+    def add_lexer(self, alias: str, lexer: typeLexer) -> None:
         """Register a new lexer for source code.
 
         Use *lexer* to highlight code blocks with the given language *alias*.
 
         .. versionadded:: 0.6
         .. versionchanged:: 2.1
-           Take a lexer class as an argument.  An instance of lexers are
-           still supported until Sphinx-3.x.
+           Take a lexer class as an argument.
+        .. versionchanged:: 4.0
+           Removed support for lexer instances as an argument.
         """
         logger.debug('app adding lexer: %r', (alias, lexer))
         lexer_classesalias = lexer
@@ -1120,7 +1131,7 @@
         extension.  It must be a subclass of
         :class:`sphinx.ext.autodoc.Documenter`.  This allows auto-documenting
         new types of objects.  See the source of the autodoc module for
-        examples on how to subclass :class:`Documenter`.
+        examples on how to subclass :class:`~sphinx.ext.autodoc.Documenter`.
 
         If *override* is True, the given *cls* is forcedly installed even if
         a documenter having the same name is already installed.
@@ -1136,7 +1147,7 @@
         self.registry.add_documenter(cls.objtype, cls)
         self.add_directive('auto' + cls.objtype, AutodocDirective, override=override)
 
-    def add_autodoc_attrgetter(self, typ: Type, getter: CallableAny, str, Any, Any
+    def add_autodoc_attrgetter(self, typ: type, getter: CallableAny, str, Any, Any,
                                ) -> None:
         """Register a new ``getattr``-like function for the autodoc extension.
 
@@ -1173,18 +1184,20 @@
         Same as :confval:`source_suffix`.  The users can override this
         using the config setting.
 
-        If *override* is True, the given *suffix* is forcedly installed even if
-        the same suffix is already installed.
+        :param override: If false, do not install it the same suffix
+                         is already installed.
+                         If true, unconditionally install the suffix.
 
         .. versionadded:: 1.8
         """
         self.registry.add_source_suffix(suffix, filetype, override=override)
 
-    def add_source_parser(self, parser: TypeParser, override: bool = False) -> None:
+    def add_source_parser(self, parser: typeParser, override: bool = False) -> None:
         """Register a parser class.
 
-        If *override* is True, the given *parser* is forcedly installed even if
-        a parser for the same suffix is already installed.
+        :param override: If false, do not install it if another parser
+                         is already installed for the same suffix.
+                         If true, unconditionally install the parser.
 
         .. versionadded:: 1.4
         .. versionchanged:: 1.8
@@ -1195,7 +1208,7 @@
         """
         self.registry.add_source_parser(parser, override=override)
 
-    def add_env_collector(self, collector: TypeEnvironmentCollector) -> None:
+    def add_env_collector(self, collector: typeEnvironmentCollector) -> None:
         """Register an environment collector class.
 
         Refer to :ref:`collector-api`.
@@ -1217,8 +1230,8 @@
         self.registry.add_html_theme(name, theme_path)
 
     def add_html_math_renderer(self, name: str,
-                               inline_renderers: TupleCallable, Callable = None,
-                               block_renderers: TupleCallable, Callable = None) -> None:
+                               inline_renderers: tupleCallable, Callable = None,
+                               block_renderers: tupleCallable, Callable = None) -> None:
         """Register a math renderer for HTML.
 
         The *name* is a name of math renderer.  Both *inline_renderers* and
@@ -1293,12 +1306,6 @@
             raise ValueError('policy %s is not supported' % policy)
         self.registry.html_assets_policy = policy
 
-    @property
-    def html_themes(self) -> Dictstr, str:
-        warnings.warn('app.html_themes is deprecated.',
-                      RemovedInSphinx60Warning)
-        return self.registry.html_themes
-
 
 class TemplateBridge:
     """
@@ -1306,7 +1313,12 @@
     that renders templates given a template name and a context.
     """
 
-    def init(self, builder: "Builder", theme: Theme = None, dirs: Liststr = None) -> None:
+    def init(
+        self,
+        builder: Builder,
+        theme: Theme | None = None,
+        dirs: liststr | None = None,
+    ) -> None:
         """Called by the builder to initialize the template system.
 
         *builder* is the builder object; you'll probably want to look at the
@@ -1324,13 +1336,13 @@
         """
         return 0
 
-    def render(self, template: str, context: Dict) -> None:
+    def render(self, template: str, context: dict) -> None:
         """Called by the builder to render a template given as a filename with
         a specified context (a Python dictionary).
         """
         raise NotImplementedError('must be implemented in subclasses')
 
-    def render_string(self, template: str, context: Dict) -> str:
+    def render_string(self, template: str, context: dict) -> str:
         """Called by the builder to render a template given as a string with a
         specified context (a Python dictionary).
         """

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/__init__.py Changed

@@ -1,41 +1,37 @@
-"""
-    sphinx.builders
-    ~~~~~~~~~~~~~~~
+"""Builder superclass for all builders."""
 
-    Builder superclass for all builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import codecs
 import pickle
 import time
 from os import path
-from typing import (TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Sequence, Set, Tuple,
-                    Type, Union)
+from typing import TYPE_CHECKING, Any, Iterable, Sequence
 
 from docutils import nodes
 from docutils.nodes import Node
+from docutils.utils import DependencyList
 
 from sphinx.config import Config
 from sphinx.environment import CONFIG_CHANGED_REASON, CONFIG_OK, BuildEnvironment
 from sphinx.environment.adapters.asset import ImageAdapter
 from sphinx.errors import SphinxError
 from sphinx.events import EventManager
-from sphinx.io import read_doc
 from sphinx.locale import __
-from sphinx.util import import_object, logging, progress_message, rst, status_iterator
+from sphinx.util import UnicodeDecodeErrorHandler, get_filetype, import_object, logging, rst
 from sphinx.util.build_phase import BuildPhase
 from sphinx.util.console import bold  # type: ignore
+from sphinx.util.display import progress_message, status_iterator
 from sphinx.util.docutils import sphinx_domains
 from sphinx.util.i18n import CatalogInfo, CatalogRepository, docname_to_domain
 from sphinx.util.osutil import SEP, ensuredir, relative_uri, relpath
 from sphinx.util.parallel import ParallelTasks, SerialTasks, make_chunks, parallel_available
 from sphinx.util.tags import Tags
+from sphinx.util.typing import NoneType
 
 # side effect: registers roles and directives
-from sphinx import directives  # NOQA isort:skip
-from sphinx import roles  # NOQA isort:skip
+from sphinx import directives  # noqa: F401  isort:skip
+from sphinx import roles  # noqa: F401  isort:skip
 try:
     import multiprocessing
 except ImportError:
@@ -63,8 +59,8 @@
     epilog = ''
 
     #: default translator class for the builder.  This can be overridden by
-    #: :py:meth:`app.set_translator()`.
-    default_translator_class: Typenodes.NodeVisitor = None
+    #: :py:meth:`~sphinx.application.Sphinx.set_translator`.
+    default_translator_class: typenodes.NodeVisitor = None
     # doctree versioning method
     versioning_method = 'none'
     versioning_compare = False
@@ -75,13 +71,13 @@
 
     #: The list of MIME types of image formats supported by the builder.
     #: Image files are searched in the order in which they appear here.
-    supported_image_types: Liststr = 
+    supported_image_types: liststr = 
     #: The builder supports remote images or not.
     supported_remote_images = False
     #: The builder supports data URIs or not.
     supported_data_uri_images = False
 
-    def __init__(self, app: "Sphinx") -> None:
+    def __init__(self, app: Sphinx, env: BuildEnvironment) -> None:
         self.srcdir = app.srcdir
         self.confdir = app.confdir
         self.outdir = app.outdir
@@ -89,7 +85,9 @@
         ensuredir(self.doctreedir)
 
         self.app: Sphinx = app
-        self.env: OptionalBuildEnvironment = None
+        self.env: BuildEnvironment = env
+        self.env.set_versioning_method(self.versioning_method,
+                                       self.versioning_compare)
         self.events: EventManager = app.events
         self.config: Config = app.config
         self.tags: Tags = app.tags
@@ -99,7 +97,7 @@
         self.tags.add("builder_%s" % self.name)
 
         # images that need to be copied over (source -> dest)
-        self.images: Dictstr, str = {}
+        self.images: dictstr, str = {}
         # basename of images directory
         self.imagedir = ""
         # relative path to image directory from current docname (used at writing docs)
@@ -109,13 +107,7 @@
         self.parallel_ok = False
         self.finish_tasks: Any = None
 
-    def set_environment(self, env: BuildEnvironment) -> None:
-        """Store BuildEnvironment object."""
-        self.env = env
-        self.env.set_versioning_method(self.versioning_method,
-                                       self.versioning_compare)
-
-    def get_translator_class(self, *args: Any) -> Typenodes.NodeVisitor:
+    def get_translator_class(self, *args: Any) -> typenodes.NodeVisitor:
         """Return a class of translator."""
         return self.app.registry.get_translator_class(self)
 
@@ -159,7 +151,7 @@
         return relative_uri(self.get_target_uri(from_),
                             self.get_target_uri(to, typ))
 
-    def get_outdated_docs(self) -> Unionstr, Iterablestr:
+    def get_outdated_docs(self) -> str | Iterablestr:
         """Return an iterable of output files that are outdated, or a string
         describing what an update build will build.
 
@@ -169,7 +161,7 @@
         """
         raise NotImplementedError
 
-    def get_asset_paths(self) -> Liststr:
+    def get_asset_paths(self) -> liststr:
         """Return list of paths for assets (ex. templates, CSS, etc.)."""
         return 
 
@@ -206,7 +198,7 @@
 
     # compile po methods
 
-    def compile_catalogs(self, catalogs: SetCatalogInfo, message: str) -> None:
+    def compile_catalogs(self, catalogs: setCatalogInfo, message: str) -> None:
         if not self.config.gettext_auto_build:
             return
 
@@ -226,8 +218,8 @@
         message = __('all of %d po files') % len(list(repo.catalogs))
         self.compile_catalogs(set(repo.catalogs), message)
 
-    def compile_specific_catalogs(self, specified_files: Liststr) -> None:
-        def to_domain(fpath: str) -> Optionalstr:
+    def compile_specific_catalogs(self, specified_files: liststr) -> None:
+        def to_domain(fpath: str) -> str | None:
             docname = self.env.path2doc(path.abspath(fpath))
             if docname:
                 return docname_to_domain(docname, self.config.gettext_compact)
@@ -244,6 +236,7 @@
         message = __('targets for %d po files that are specified') % len(catalogs)
         self.compile_catalogs(catalogs, message)
 
+    # TODO(stephenfin): This would make more sense as 'compile_outdated_catalogs'
     def compile_update_catalogs(self) -> None:
         repo = CatalogRepository(self.srcdir, self.config.locale_dirs,
                                  self.config.language, self.config.source_encoding)
@@ -255,37 +248,44 @@
 
     def build_all(self) -> None:
         """Build all source files."""
+        self.compile_all_catalogs()
+
         self.build(None, summary=__('all source files'), method='all')
 
-    def build_specific(self, filenames: Liststr) -> None:
+    def build_specific(self, filenames: liststr) -> None:
         """Only rebuild as much as needed for changes in the *filenames*."""
-        # bring the filenames to the canonical format, that is,
-        # relative to the source directory and without source_suffix.
-        dirlen = len(self.srcdir) + 1
-        to_write = 
-        suffixes: Tuplestr = tuple(self.config.source_suffix)  # type: ignore
+        docnames: liststr = 
+
         for filename in filenames:
             filename = path.normpath(path.abspath(filename))
+
+            if not path.isfile(filename):
+                logger.warning(__('file %r given on command line does not exist, '),
+                               filename)
+                continue
+
             if not filename.startswith(self.srcdir):
                 logger.warning(__('file %r given on command line is not under the '
                                   'source directory, ignoring'), filename)
                 continue
-            if not path.isfile(filename):
-                logger.warning(__('file %r given on command line does not exist, '
-                                  'ignoring'), filename)
+
+            docname = self.env.path2doc(filename)
+            if not docname:
+                logger.warning(__('file %r given on command line is not a valid '
+                                  'document, ignoring'), filename)
                 continue
-            filename = filenamedirlen:
-            for suffix in suffixes:
-                if filename.endswith(suffix):
-                    filename = filename:-len(suffix)
-                    break
-            filename = filename.replace(path.sep, SEP)
-            to_write.append(filename)
-        self.build(to_write, method='specific',
-                   summary=__('%d source files given on command line') % len(to_write))
+
+            docnames.append(docname)
+
+        self.compile_specific_catalogs(filenames)
+
+        self.build(docnames, method='specific',
+                   summary=__('%d source files given on command line') % len(docnames))
 
     def build_update(self) -> None:
         """Only rebuild what was changed or added since last build."""
+        self.compile_update_catalogs()
+
         to_build = self.get_outdated_docs()
         if isinstance(to_build, str):
             self.build('__all__', to_build)
@@ -295,10 +295,13 @@
                        summary=__('targets for %d source files that are out of date') %
                        len(to_build))
 
-    def build(self, docnames: Iterablestr, summary: str = None, method: str = 'update') -> None:  # NOQA
+    def build(
+        self, docnames: Iterablestr, summary: str | None = None, method: str = 'update',
+    ) -> None:
         """Main build method.
 
-        First updates the environment, and then calls :meth:`write`.
+        First updates the environment, and then calls
+        :meth:`!write`.
         """
         if summary:
             logger.info(bold(__('building %s: ') % self.name) + summary)
@@ -363,7 +366,7 @@
         # wait for all tasks
         self.finish_tasks.join()
 
-    def read(self) -> Liststr:
+    def read(self) -> liststr:
         """(Re-)read all files new or changed since last update.
 
         Store all environment docnames in the canonical format (ie using SEP as
@@ -427,7 +430,7 @@
 
         return sorted(docnames)
 
-    def _read_serial(self, docnames: Liststr) -> None:
+    def _read_serial(self, docnames: liststr) -> None:
         for docname in status_iterator(docnames, __('reading sources... '), "purple",
                                        len(docnames), self.app.verbosity):
             # remove all inventory entries for that file
@@ -435,35 +438,41 @@
             self.env.clear_doc(docname)
             self.read_doc(docname)
 
-    def _read_parallel(self, docnames: Liststr, nproc: int) -> None:
+    def _read_parallel(self, docnames: liststr, nproc: int) -> None:
+        chunks = make_chunks(docnames, nproc)
+
+        # create a status_iterator to step progressbar after reading a document
+        # (see: ``merge()`` function)
+        progress = status_iterator(chunks, __('reading sources... '), "purple",
+                                   len(chunks), self.app.verbosity)
+
         # clear all outdated docs at once
         for docname in docnames:
             self.events.emit('env-purge-doc', self.env, docname)
             self.env.clear_doc(docname)
 
-        def read_process(docs: Liststr) -> bytes:
+        def read_process(docs: liststr) -> bytes:
             self.env.app = self.app
             for docname in docs:
-                self.read_doc(docname)
+                self.read_doc(docname, _cache=False)
             # allow pickling self to send it back
             return pickle.dumps(self.env, pickle.HIGHEST_PROTOCOL)
 
-        def merge(docs: Liststr, otherenv: bytes) -> None:
+        def merge(docs: liststr, otherenv: bytes) -> None:
             env = pickle.loads(otherenv)
             self.env.merge_info_from(docs, env, self.app)
 
-        tasks = ParallelTasks(nproc)
-        chunks = make_chunks(docnames, nproc)
+            next(progress)
 
-        for chunk in status_iterator(chunks, __('reading sources... '), "purple",
-                                     len(chunks), self.app.verbosity):
+        tasks = ParallelTasks(nproc)
+        for chunk in chunks:
             tasks.add_task(read_process, chunk, merge)
 
         # make sure all threads have finished
-        logger.info(bold(__('waiting for workers...')))
         tasks.join()
+        logger.info('')
 
-    def read_doc(self, docname: str) -> None:
+    def read_doc(self, docname: str, *, _cache: bool = True) -> None:
         """Parse a file and add/update inventory entries for the doctree."""
         self.env.prepare_settings(docname)
 
@@ -472,8 +481,19 @@
         if path.isfile(docutilsconf):
             self.env.note_dependency(docutilsconf)
 
+        filename = self.env.doc2path(docname)
+        filetype = get_filetype(self.app.config.source_suffix, filename)
+        publisher = self.app.registry.get_publisher(self.app, filetype)
+        # record_dependencies is mutable even though it is in settings,
+        # explicitly re-initialise for each document
+        publisher.settings.record_dependencies = DependencyList()
         with sphinx_domains(self.env), rst.default_role(docname, self.config.default_role):
-            doctree = read_doc(self.app, self.env, self.env.doc2path(docname))
+            # set up error_handler for the target document
+            codecs.register_error('sphinx', UnicodeDecodeErrorHandler(docname))  # type: ignore
+
+            publisher.set_source(source_path=filename)
+            publisher.publish()
+            doctree = publisher.document
 
         # store time of reading, for outdated files detection
         # (Some filesystems have coarse timestamp resolution;
@@ -486,13 +506,19 @@
         self.env.temp_data.clear()
         self.env.ref_context.clear()
 
-        self.write_doctree(docname, doctree)
+        self.write_doctree(docname, doctree, _cache=_cache)
 
-    def write_doctree(self, docname: str, doctree: nodes.document) -> None:
+    def write_doctree(
+        self, docname: str, doctree: nodes.document, *, _cache: bool = True,
+    ) -> None:
         """Write the doctree to a file."""
         # make it picklable
         doctree.reporter = None
         doctree.transformer = None
+
+        # Create a copy of settings object before modification because it is
+        # shared with other documents.
+        doctree.settings = doctree.settings.copy()
         doctree.settings.warning_stream = None
         doctree.settings.env = None
         doctree.settings.record_dependencies = None
@@ -502,7 +528,18 @@
         with open(doctree_filename, 'wb') as f:
             pickle.dump(doctree, f, pickle.HIGHEST_PROTOCOL)
 
-    def write(self, build_docnames: Iterablestr, updated_docnames: Sequencestr, method: str = 'update') -> None:  # NOQA
+        # When Sphinx is running in parallel mode, ``write_doctree()`` is invoked
+        # in the context of a process worker, and thus it does not make sense to
+        # pickle the doctree and send it to the main process
+        if _cache:
+            self.env._write_doc_doctree_cachedocname = doctree
+
+    def write(
+        self,
+        build_docnames: Iterablestr,
+        updated_docnames: Sequencestr,
+        method: str = 'update',
+    ) -> None:
         if build_docnames is None or build_docnames == '__all__':
             # build_all
             build_docnames = self.env.found_docs
@@ -542,7 +579,7 @@
                 self.write_doc(docname, doctree)
 
     def _write_parallel(self, docnames: Sequencestr, nproc: int) -> None:
-        def write_process(docs: ListTuplestr, nodes.document) -> None:
+        def write_process(docs: listtuplestr, nodes.document) -> None:
             self.app.phase = BuildPhase.WRITING
             for docname, doctree in docs:
                 self.write_doc(docname, doctree)
@@ -558,21 +595,28 @@
         tasks = ParallelTasks(nproc)
         chunks = make_chunks(docnames, nproc)
 
+        # create a status_iterator to step progressbar after writing a document
+        # (see: ``on_chunk_done()`` function)
+        progress = status_iterator(chunks, __('writing output... '), "darkgreen",
+                                   len(chunks), self.app.verbosity)
+
+        def on_chunk_done(args: listtuplestr, NoneType, result: NoneType) -> None:
+            next(progress)
+
         self.app.phase = BuildPhase.RESOLVING
-        for chunk in status_iterator(chunks, __('writing output... '), "darkgreen",
-                                     len(chunks), self.app.verbosity):
+        for chunk in chunks:
             arg = 
             for docname in chunk:
                 doctree = self.env.get_and_resolve_doctree(docname, self)
                 self.write_doc_serialized(docname, doctree)
                 arg.append((docname, doctree))
-            tasks.add_task(write_process, arg)
+            tasks.add_task(write_process, arg, on_chunk_done)
 
         # make sure all threads have finished
-        logger.info(bold(__('waiting for workers...')))
         tasks.join()
+        logger.info('')
 
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         """A place where you can add logic before :meth:`write_doc` is run"""
         raise NotImplementedError
 
@@ -610,8 +654,8 @@
         # At the moment, only XXX_use_index is looked up this way.
         # Every new builder variant must be registered in Config.config_values.
         try:
-            optname = '%s_%s' % (self.name, option)
+            optname = f'{self.name}_{option}'
             return getattr(self.config, optname)
         except AttributeError:
-            optname = '%s_%s' % (default, option)
+            optname = f'{default}_{option}'
             return getattr(self.config, optname)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/_epub_base.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/_epub_base.py Changed

@@ -1,18 +1,13 @@
-"""
-    sphinx.builders._epub_base
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Base class of epub2/epub3 builders."""
 
-    Base class of epub2/epub3 builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import html
 import os
 import re
 from os import path
-from typing import Any, Dict, List, NamedTuple, Set, Tuple
+from typing import Any, NamedTuple
+from urllib.parse import quote
 from zipfile import ZIP_DEFLATED, ZIP_STORED, ZipFile
 
 from docutils import nodes
@@ -22,7 +17,8 @@
 from sphinx import addnodes
 from sphinx.builders.html import BuildInfo, StandaloneHTMLBuilder
 from sphinx.locale import __
-from sphinx.util import logging, status_iterator
+from sphinx.util import logging
+from sphinx.util.display import status_iterator
 from sphinx.util.fileutil import copy_asset_file
 from sphinx.util.i18n import format_date
 from sphinx.util.osutil import copyfile, ensuredir
@@ -57,13 +53,14 @@
 # XXX These strings should be localized according to epub_language
 GUIDE_TITLES = {
     'toc': 'Table of Contents',
-    'cover': 'Cover'
+    'cover': 'Cover',
 }
 
 MEDIA_TYPES = {
     '.xhtml': 'application/xhtml+xml',
     '.css': 'text/css',
     '.png': 'image/png',
+    '.webp': 'image/webp',
     '.gif': 'image/gif',
     '.svg': 'image/svg+xml',
     '.jpg': 'image/jpeg',
@@ -103,7 +100,7 @@
     playorder: int
     text: str
     refuri: str
-    children: ListAny     # mypy does not support recursive types
+    children: listAny     # mypy does not support recursive types
                             # https://github.com/python/mypy/issues/7069
 
 
@@ -165,14 +162,14 @@
         self.link_suffix = '.xhtml'
         self.playorder = 0
         self.tocid = 0
-        self.id_cache: Dictstr, str = {}
+        self.id_cache: dictstr, str = {}
         self.use_index = self.get_builder_config('use_index', 'epub')
-        self.refnodes: ListDictstr, Any = 
+        self.refnodes: listdictstr, Any = 
 
     def create_build_info(self) -> BuildInfo:
         return BuildInfo(self.config, self.tags, 'html', 'epub')
 
-    def get_theme_config(self) -> Tuplestr, Dict:
+    def get_theme_config(self) -> tuplestr, dict:
         return self.config.epub_theme, self.config.epub_theme_options
 
     # generic support functions
@@ -185,14 +182,15 @@
             self.id_cachename = id
         return id
 
-    def get_refnodes(self, doctree: Node, result: ListDictstr, Any) -> ListDictstr, Any:  # NOQA
+    def get_refnodes(
+        self, doctree: Node, result: listdictstr, Any,
+    ) -> listdictstr, Any:
         """Collect section titles, their depth in the toc and the refuri."""
         # XXX: is there a better way than checking the attribute
         # toctree-l1-8 on the parent node?
         if isinstance(doctree, nodes.reference) and doctree.get('refuri'):
             refuri = doctree'refuri'
-            if refuri.startswith('http://') or refuri.startswith('https://') \
-               or refuri.startswith('irc:') or refuri.startswith('mailto:'):
+            if refuri.startswith(('http://', 'https://', 'irc:', 'mailto:')):
                 return result
             classes = doctree.parent.attributes'classes'
             for level in range(8, 0, -1):  # or range(1, 8)?
@@ -200,7 +198,7 @@
                     result.append({
                         'level': level,
                         'refuri': html.escape(refuri),
-                        'text': ssp(html.escape(doctree.astext()))
+                        'text': ssp(html.escape(doctree.astext())),
                     })
                     break
         elif isinstance(doctree, nodes.Element):
@@ -208,8 +206,8 @@
                 result = self.get_refnodes(elem, result)
         return result
 
-    def check_refnodes(self, nodes: ListDictstr, Any) -> None:
-        appeared: Setstr = set()
+    def check_refnodes(self, nodes: listdictstr, Any) -> None:
+        appeared: setstr = set()
         for node in nodes:
             if node'refuri' in appeared:
                 logger.warning(
@@ -236,26 +234,26 @@
                 item'refuri' = master_dir + item'refuri'
         self.toc_add_files(self.refnodes)
 
-    def toc_add_files(self, refnodes: ListDictstr, Any) -> None:
+    def toc_add_files(self, refnodes: listdictstr, Any) -> None:
         """Add the root_doc, pre and post files to a list of refnodes.
         """
         refnodes.insert(0, {
             'level': 1,
             'refuri': html.escape(self.config.root_doc + self.out_suffix),
             'text': ssp(html.escape(
-                self.env.titlesself.config.root_doc.astext()))
+                self.env.titlesself.config.root_doc.astext())),
         })
         for file, text in reversed(self.config.epub_pre_files):
             refnodes.insert(0, {
                 'level': 1,
                 'refuri': html.escape(file),
-                'text': ssp(html.escape(text))
+                'text': ssp(html.escape(text)),
             })
         for file, text in self.config.epub_post_files:
             refnodes.append({
                 'level': 1,
                 'refuri': html.escape(file),
-                'text': ssp(html.escape(text))
+                'text': ssp(html.escape(text)),
             })
 
     def fix_fragment(self, prefix: str, fragment: str) -> str:
@@ -270,7 +268,7 @@
         """
         def update_node_id(node: Element) -> None:
             """Update IDs of given *node*."""
-            new_ids: Liststr = 
+            new_ids: liststr = 
             for node_id in node'ids':
                 new_id = self.fix_fragment('', node_id)
                 if new_id not in new_ids:
@@ -315,7 +313,7 @@
             doc.note_autofootnote(footnote)
             return footnote
 
-        def footnote_spot(tree: nodes.document) -> TupleElement, int:
+        def footnote_spot(tree: nodes.document) -> tupleElement, int:
             """Find or create a spot to place footnotes.
 
             The function returns the tuple (parent, index)."""
@@ -344,8 +342,7 @@
             nr = 1
         for node in list(tree.findall(nodes.reference)):
             uri = node.get('refuri', '')
-            if (uri.startswith('http:') or uri.startswith('https:') or
-                    uri.startswith('ftp:')) and uri not in node.astext():
+            if uri.startswith(('http:', 'https:', 'ftp:')) and uri not in node.astext():
                 idx = node.parent.index(node) + 1
                 if show_urls == 'inline':
                     uri = self.link_target_template % {'uri': uri}
@@ -373,7 +370,7 @@
         self.add_visible_links(doctree, self.config.epub_show_urls)
         super().write_doc(docname, doctree)
 
-    def fix_genindex(self, tree: ListTuplestr, ListTuplestr, Any) -> None:
+    def fix_genindex(self, tree: listtuplestr, listtuplestr, Any) -> None:
         """Fix href attributes for genindex pages."""
         # XXX: modifies tree inline
         # Logic modeled from themes/basic/genindex.html
@@ -427,7 +424,7 @@
                 (width, height) = img.size
                 nw = self.config.epub_max_image_width
                 if width > nw:
-                    nh = (height * nw) / width
+                    nh = round((height * nw) / width)
                     img = img.resize((nw, nh), Image.BICUBIC)
             try:
                 img.save(path.join(self.outdir, self.imagedir, dest))
@@ -452,8 +449,8 @@
     def copy_download_files(self) -> None:
         pass
 
-    def handle_page(self, pagename: str, addctx: Dict, templatename: str = 'page.html',
-                    outfilename: str = None, event_arg: Any = None) -> None:
+    def handle_page(self, pagename: str, addctx: dict, templatename: str = 'page.html',
+                    outfilename: str | None = None, event_arg: Any = None) -> None:
         """Create a rendered page.
 
         This method is overwritten for genindex pages in order to fix href link
@@ -471,18 +468,18 @@
         logger.info(__('writing mimetype file...'))
         copy_asset_file(path.join(self.template_dir, 'mimetype'), self.outdir)
 
-    def build_container(self, outname: str = 'META-INF/container.xml') -> None:  # NOQA
+    def build_container(self, outname: str = 'META-INF/container.xml') -> None:
         """Write the metainfo file META-INF/container.xml."""
         logger.info(__('writing META-INF/container.xml file...'))
         outdir = path.join(self.outdir, 'META-INF')
         ensuredir(outdir)
         copy_asset_file(path.join(self.template_dir, 'container.xml'), outdir)
 
-    def content_metadata(self) -> Dictstr, Any:
+    def content_metadata(self) -> dictstr, Any:
         """Create a dictionary with all metadata for the content.opf
         file properly escaped.
         """
-        metadata: Dictstr, Any = {}
+        metadata: dictstr, Any = {}
         metadata'title' = html.escape(self.config.epub_title)
         metadata'author' = html.escape(self.config.epub_author)
         metadata'uid' = html.escape(self.config.epub_uid)
@@ -491,7 +488,7 @@
         metadata'copyright' = html.escape(self.config.epub_copyright)
         metadata'scheme' = html.escape(self.config.epub_scheme)
         metadata'id' = html.escape(self.config.epub_identifier)
-        metadata'date' = html.escape(format_date("%Y-%m-%d"))
+        metadata'date' = html.escape(format_date("%Y-%m-%d", language='en'))
         metadata'manifest_items' = 
         metadata'spines' = 
         metadata'guides' = 
@@ -508,7 +505,7 @@
         if not self.outdir.endswith(os.sep):
             self.outdir += os.sep
         olen = len(self.outdir)
-        self.files: Liststr = 
+        self.files: liststr = 
         self.ignored_files = '.buildinfo', 'mimetype', 'content.opf',
                               'toc.ncx', 'META-INF/container.xml',
                               'Thumbs.db', 'ehthumbs.db', '.DS_Store',
@@ -531,7 +528,7 @@
                                        type='epub', subtype='unknown_project_files')
                     continue
                 filename = filename.replace(os.sep, '/')
-                item = ManifestItem(html.escape(filename),
+                item = ManifestItem(html.escape(quote(filename)),
                                     html.escape(self.make_id(filename)),
                                     html.escape(self.media_typesext))
                 metadata'manifest_items'.append(item)
@@ -608,7 +605,7 @@
         # write the project file
         copy_asset_file(path.join(self.template_dir, 'content.opf_t'), self.outdir, metadata)
 
-    def new_navpoint(self, node: Dictstr, Any, level: int, incr: bool = True) -> NavPoint:
+    def new_navpoint(self, node: dictstr, Any, level: int, incr: bool = True) -> NavPoint:
         """Create a new entry in the toc from the node at given level."""
         # XXX Modifies the node
         if incr:
@@ -617,13 +614,13 @@
         return NavPoint('navPoint%d' % self.tocid, self.playorder,
                         node'text', node'refuri', )
 
-    def build_navpoints(self, nodes: ListDictstr, Any) -> ListNavPoint:
+    def build_navpoints(self, nodes: listdictstr, Any) -> listNavPoint:
         """Create the toc navigation structure.
 
         Subelements of a node are nested inside the navpoint.  For nested nodes
         the parent node is reinserted in the subnav.
         """
-        navstack: ListNavPoint = 
+        navstack: listNavPoint = 
         navstack.append(NavPoint('dummy', 0, '', '', ))
         level = 0
         lastnode = None
@@ -661,11 +658,11 @@
 
         return navstack0.children
 
-    def toc_metadata(self, level: int, navpoints: ListNavPoint) -> Dictstr, Any:
+    def toc_metadata(self, level: int, navpoints: listNavPoint) -> dictstr, Any:
         """Create a dictionary with all metadata for the toc.ncx file
         properly escaped.
         """
-        metadata: Dictstr, Any = {}
+        metadata: dictstr, Any = {}
         metadata'uid' = self.config.epub_uid
         metadata'title' = html.escape(self.config.epub_title)
         metadata'level' = level

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/changes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/changes.py Changed

@@ -1,16 +1,10 @@
-"""
-    sphinx.builders.changes
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""Changelog builder."""
 
-    Changelog builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import html
 from os import path
-from typing import Any, Dict, List, Tuple, cast
+from typing import Any, cast
 
 from sphinx import package_dir
 from sphinx.application import Sphinx
@@ -51,9 +45,9 @@
     def write(self, *ignored: Any) -> None:
         version = self.config.version
         domain = cast(ChangeSetDomain, self.env.get_domain('changeset'))
-        libchanges: Dictstr, ListTuplestr, str, int = {}
-        apichanges: ListTuplestr, str, int = 
-        otherchanges: DictTuplestr, str, ListTuplestr, str, int = {}
+        libchanges: dictstr, listtuplestr, str, int = {}
+        apichanges: listtuplestr, str, int = 
+        otherchanges: dicttuplestr, str, listtuplestr, str, int = {}
 
         changesets = domain.get_changesets_for(version)
         if not changesets:
@@ -69,26 +63,24 @@
             context = changeset.content.replace('\n', ' ')
             if descname and changeset.docname.startswith('c-api'):
                 if context:
-                    entry = '<b>%s</b>: <i>%s:</i> %s' % (descname, ttext,
-                                                          context)
+                    entry = f'<b>{descname}</b>: <i>{ttext}:</i> {context}'
                 else:
-                    entry = '<b>%s</b>: <i>%s</i>.' % (descname, ttext)
+                    entry = f'<b>{descname}</b>: <i>{ttext}</i>.'
                 apichanges.append((entry, changeset.docname, changeset.lineno))
             elif descname or changeset.module:
                 module = changeset.module or _('Builtins')
                 if not descname:
                     descname = _('Module level')
                 if context:
-                    entry = '<b>%s</b>: <i>%s:</i> %s' % (descname, ttext,
-                                                          context)
+                    entry = f'<b>{descname}</b>: <i>{ttext}:</i> {context}'
                 else:
-                    entry = '<b>%s</b>: <i>%s</i>.' % (descname, ttext)
+                    entry = f'<b>{descname}</b>: <i>{ttext}</i>.'
                 libchanges.setdefault(module, ).append((entry, changeset.docname,
                                                           changeset.lineno))
             else:
                 if not context:
                     continue
-                entry = '<i>%s:</i> %s' % (ttext.capitalize(), context)
+                entry = f'<i>{ttext.capitalize()}:</i> {context}'
                 title = self.env.titleschangeset.docname.astext()
                 otherchanges.setdefault((changeset.docname, title), ).append(
                     (entry, changeset.docname, changeset.lineno))
@@ -135,8 +127,8 @@
             with open(targetfn, 'w', encoding='utf-8') as f:
                 text = ''.join(hl(i + 1, line) for (i, line) in enumerate(lines))
                 ctx = {
-                    'filename': self.env.doc2path(docname, None),
-                    'text': text
+                    'filename': self.env.doc2path(docname, False),
+                    'text': text,
                 }
                 f.write(self.templates.render('changes/rstsource.html', ctx))
         themectx = {'theme_' + key: val for (key, val) in
@@ -149,15 +141,15 @@
     def hl(self, text: str, version: str) -> str:
         text = html.escape(text)
         for directive in ('versionchanged', 'versionadded', 'deprecated'):
-            text = text.replace('.. %s:: %s' % (directive, version),
-                                '<b>.. %s:: %s</b>' % (directive, version))
+            text = text.replace(f'.. {directive}:: {version}',
+                                f'<b>.. {directive}:: {version}</b>')
         return text
 
     def finish(self) -> None:
         pass
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(ChangesBuilder)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/dirhtml.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/dirhtml.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/dummy.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/dummy.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.builders.dummy
-    ~~~~~~~~~~~~~~~~~~~~~
+"""Do syntax checks, but no writing."""
 
-    Do syntax checks, but no writing.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, Set
+from typing import Any
 
 from docutils.nodes import Node
 
@@ -26,13 +20,13 @@
     def init(self) -> None:
         pass
 
-    def get_outdated_docs(self) -> Setstr:
+    def get_outdated_docs(self) -> setstr:
         return self.env.found_docs
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         return ''
 
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         pass
 
     def write_doc(self, docname: str, doctree: Node) -> None:
@@ -42,7 +36,7 @@
         pass
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(DummyBuilder)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/epub3.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/epub3.py Changed

@@ -1,24 +1,21 @@
-"""
-    sphinx.builders.epub3
-    ~~~~~~~~~~~~~~~~~~~~~
-
-    Build epub3 files.
-    Originally derived from epub.py.
+"""Build epub3 files.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Originally derived from epub.py.
 """
 
+from __future__ import annotations
+
 import html
+import re
 from os import path
-from typing import Any, Dict, List, NamedTuple, Set, Tuple
+from typing import Any, NamedTuple
 
 from sphinx import package_dir
 from sphinx.application import Sphinx
 from sphinx.builders import _epub_base
 from sphinx.config import ENUM, Config
 from sphinx.locale import __
-from sphinx.util import logging, xmlname_checker
+from sphinx.util import logging
 from sphinx.util.fileutil import copy_asset_file
 from sphinx.util.i18n import format_date
 from sphinx.util.osutil import make_filename
@@ -29,7 +26,7 @@
 class NavPoint(NamedTuple):
     text: str
     refuri: str
-    children: ListAny     # mypy does not support recursive types
+    children: listAny     # mypy does not support recursive types
                             # https://github.com/python/mypy/issues/7069
 
 
@@ -54,6 +51,19 @@
     'xmlns:epub="http://www.idpf.org/2007/ops">'
 )
 
+# https://www.w3.org/TR/REC-xml/#NT-Name
+_xml_name_start_char = (
+    ':|A-Z|_|a-z|\u00C0-\u00D6'
+    '|\u00D8-\u00F6|\u00F8-\u02FF|\u0370-\u037D'
+    '|\u037F-\u1FFF|\u200C-\u200D|\u2070-\u218F'
+    '|\u2C00-\u2FEF|\u3001-\uD7FF|\uF900-\uFDCF'
+    '|\uFDF0-\uFFFD|\U00010000-\U000EFFFF'
+)
+_xml_name_char = (
+    _xml_name_start_char + r'\-|\.' '|0-9|\u00B7|\u0300-\u036F|\u203F-\u2040'
+)
+_XML_NAME_PATTERN = re.compile(f'({_xml_name_start_char})({_xml_name_char})*')
+
 
 class Epub3Builder(_epub_base.EpubBuilder):
     """
@@ -83,7 +93,7 @@
         self.build_toc()
         self.build_epub()
 
-    def content_metadata(self) -> Dict:
+    def content_metadata(self) -> dictstr, Any:
         """Create a dictionary with all metadata for the content.opf
         file properly escaped.
         """
@@ -94,12 +104,12 @@
         metadata'contributor' = html.escape(self.config.epub_contributor)
         metadata'page_progression_direction' = PAGE_PROGRESSION_DIRECTIONS.get(writing_mode)
         metadata'ibook_scroll_axis' = IBOOK_SCROLL_AXIS.get(writing_mode)
-        metadata'date' = html.escape(format_date("%Y-%m-%dT%H:%M:%SZ"))
+        metadata'date' = html.escape(format_date("%Y-%m-%dT%H:%M:%SZ", language='en'))
         metadata'version' = html.escape(self.config.version)
         metadata'epub_version' = self.config.epub_version
         return metadata
 
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         super().prepare_writing(docnames)
 
         writing_mode = self.config.epub_writing_mode
@@ -108,7 +118,7 @@
         self.globalcontext'use_meta_charset' = self.use_meta_charset
         self.globalcontext'skip_ua_compatible' = True
 
-    def build_navlist(self, navnodes: ListDictstr, Any) -> ListNavPoint:
+    def build_navlist(self, navnodes: listdictstr, Any) -> listNavPoint:
         """Create the toc navigation structure.
 
         This method is almost same as build_navpoints method in epub.py.
@@ -118,7 +128,7 @@
         The difference from build_navpoints method is templates which are used
         when generating navigation documents.
         """
-        navstack: ListNavPoint = 
+        navstack: listNavPoint = 
         navstack.append(NavPoint('', '', ))
         level = 0
         for node in navnodes:
@@ -150,15 +160,15 @@
 
         return navstack0.children
 
-    def navigation_doc_metadata(self, navlist: ListNavPoint) -> Dict:
+    def navigation_doc_metadata(self, navlist: listNavPoint) -> dictstr, Any:
         """Create a dictionary with all metadata for the nav.xhtml file
         properly escaped.
         """
-        metadata: Dict = {}
-        metadata'lang' = html.escape(self.config.epub_language)
-        metadata'toc_locale' = html.escape(self.guide_titles'toc')
-        metadata'navlist' = navlist
-        return metadata
+        return {
+            'lang': html.escape(self.config.epub_language),
+            'toc_locale': html.escape(self.guide_titles'toc'),
+            'navlist': navlist,
+        }
 
     def build_navigation_doc(self) -> None:
         """Write the metainfo file nav.xhtml."""
@@ -191,7 +201,7 @@
         logger.warning(__('conf value "epub_language" (or "language") '
                           'should not be empty for EPUB3'))
     # <package> unique-identifier attribute
-    if not xmlname_checker().match(app.config.epub_uid):
+    if not _XML_NAME_PATTERN.match(app.config.epub_uid):
         logger.warning(__('conf value "epub_uid" should be XML NAME for EPUB3'))
     # dc:title
     if not app.config.epub_title:
@@ -223,7 +233,7 @@
 
 def convert_epub_css_files(app: Sphinx, config: Config) -> None:
     """This converts string styled epub_css_files to tuple styled one."""
-    epub_css_files: ListTuplestr, Dict = 
+    epub_css_files: listtuplestr, dictstr, Any = 
     for entry in config.epub_css_files:
         if isinstance(entry, str):
             epub_css_files.append((entry, {}))
@@ -238,11 +248,11 @@
     config.epub_css_files = epub_css_files  # type: ignore
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(Epub3Builder)
 
     # config values
-    app.add_config_value('epub_basename', lambda self: make_filename(self.project), None)
+    app.add_config_value('epub_basename', lambda self: make_filename(self.project), False)
     app.add_config_value('epub_version', 3.0, 'epub')  # experimental
     app.add_config_value('epub_theme', 'epub', 'epub')
     app.add_config_value('epub_theme_options', {}, 'epub')

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/gettext.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/gettext.py Changed

@@ -1,19 +1,13 @@
-"""
-    sphinx.builders.gettext
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""The MessageCatalogBuilder class."""
 
-    The MessageCatalogBuilder class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from codecs import open
-from collections import OrderedDict, defaultdict
+from collections import defaultdict
 from datetime import datetime, timedelta, tzinfo
 from os import getenv, path, walk
 from time import time
-from typing import Any, DefaultDict, Dict, Generator, Iterable, List, Set, Tuple, Union
+from typing import Any, Generator, Iterable
 from uuid import uuid4
 
 from docutils import nodes
@@ -25,8 +19,9 @@
 from sphinx.domains.python import pairindextypes
 from sphinx.errors import ThemeError
 from sphinx.locale import __
-from sphinx.util import logging, split_index_msg, status_iterator
+from sphinx.util import logging, split_index_msg
 from sphinx.util.console import bold  # type: ignore
+from sphinx.util.display import status_iterator
 from sphinx.util.i18n import CatalogInfo, docname_to_domain
 from sphinx.util.nodes import extract_messages, traverse_translatable_index
 from sphinx.util.osutil import canon_path, ensuredir, relpath
@@ -38,7 +33,7 @@
 
 class Message:
     """An entry of translatable message."""
-    def __init__(self, text: str, locations: ListTuplestr, int, uuids: Liststr):
+    def __init__(self, text: str, locations: listtuplestr, int, uuids: liststr):
         self.text = text
         self.locations = locations
         self.uuids = uuids
@@ -48,12 +43,12 @@
     """Catalog of translatable messages."""
 
     def __init__(self) -> None:
-        self.messages: Liststr =   # retain insertion order, a la OrderedDict
+        self.messages: liststr =   # retain insertion order
 
         # msgid -> file, line, uid
-        self.metadata: Dictstr, ListTuplestr, int, str = OrderedDict()
+        self.metadata: dictstr, listtuplestr, int, str = {}
 
-    def add(self, msg: str, origin: UnionElement, "MsgOrigin") -> None:
+    def add(self, msg: str, origin: Element | MsgOrigin) -> None:
         if not hasattr(origin, 'uid'):
             # Nodes that are replicated like todo don't have a uid,
             # however i18n is also unnecessary.
@@ -61,11 +56,15 @@
         if msg not in self.metadata:  # faster lookup in hash
             self.messages.append(msg)
             self.metadatamsg = 
-        self.metadatamsg.append((origin.source, origin.line, origin.uid))  # type: ignore
+        line = origin.line
+        if line is None:
+            line = -1
+        self.metadatamsg.append((origin.source, line, origin.uid))
 
     def __iter__(self) -> GeneratorMessage, None, None:
         for message in self.messages:
-            positions = (source, line) for source, line, uuid in self.metadatamessage
+            positions = sorted({(source, line) for source, line, uuid
+                               in self.metadatamessage})
             uuids = uuid for source, line, uuid in self.metadatamessage
             yield Message(message, positions, uuids)
 
@@ -82,7 +81,9 @@
 
 
 class GettextRenderer(SphinxRenderer):
-    def __init__(self, template_path: str = None, outdir: str = None) -> None:
+    def __init__(
+        self, template_path: str | None = None, outdir: str | None = None,
+    ) -> None:
         self.outdir = outdir
         if template_path is None:
             template_path = path.join(package_dir, 'templates', 'gettext')
@@ -97,7 +98,7 @@
         self.env.filters'e' = escape
         self.env.filters'escape' = escape
 
-    def render(self, filename: str, context: Dict) -> str:
+    def render(self, filename: str, context: dictstr, Any) -> str:
         def _relpath(s: str) -> str:
             return canon_path(relpath(s, self.outdir))
 
@@ -121,7 +122,6 @@
     """
     name = 'i18n'
     versioning_method = 'text'
-    versioning_compare: bool = None  # be set by `gettext_uuid`
     use_message_catalog = False
 
     def init(self) -> None:
@@ -129,18 +129,18 @@
         self.env.set_versioning_method(self.versioning_method,
                                        self.env.config.gettext_uuid)
         self.tags = I18nTags()
-        self.catalogs: DefaultDictstr, Catalog = defaultdict(Catalog)
+        self.catalogs: defaultdictstr, Catalog = defaultdict(Catalog)
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         return ''
 
-    def get_outdated_docs(self) -> Setstr:
+    def get_outdated_docs(self) -> setstr:
         return self.env.found_docs
 
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         return
 
-    def compile_catalogs(self, catalogs: SetCatalogInfo, message: str) -> None:
+    def compile_catalogs(self, catalogs: setCatalogInfo, message: str) -> None:
         return
 
     def write_doc(self, docname: str, doctree: nodes.document) -> None:
@@ -183,10 +183,13 @@
         super().__init__(*args, **kwargs)
         self.tzdelta = tzdelta
 
-    def utcoffset(self, dt: datetime) -> timedelta:
+    def tzname(self, dt: datetime | None) -> str:  # purely to satisfy mypy
+        return "local"
+
+    def utcoffset(self, dt: datetime | None) -> timedelta:
         return self.tzdelta
 
-    def dst(self, dt: datetime) -> timedelta:
+    def dst(self, dt: datetime | None) -> timedelta:
         return timedelta(0)
 
 
@@ -223,7 +226,7 @@
         self.create_template_bridge()
         self.templates.init(self)
 
-    def _collect_templates(self) -> Setstr:
+    def _collect_templates(self) -> setstr:
         template_files = set()
         for template_path in self.config.templates_path:
             tmpl_abs_path = path.join(self.app.srcdir, template_path)
@@ -251,9 +254,11 @@
                     origin = MsgOrigin(template, line)
                     self.catalogs'sphinx'.add(msg, origin)
             except Exception as exc:
-                raise ThemeError('%s: %r' % (template, exc)) from exc
+                raise ThemeError(f'{template}: {exc!r}') from exc
 
-    def build(self, docnames: Iterablestr, summary: str = None, method: str = 'update') -> None:  # NOQA
+    def build(
+        self, docnames: Iterablestr, summary: str | None = None, method: str = 'update',
+    ) -> None:
         self._extract_from_template()
         super().build(docnames, summary, method)
 
@@ -286,7 +291,7 @@
                     pofile.write(content)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(MessageCatalogBuilder)
 
     app.add_config_value('gettext_compact', True, 'gettext', {bool, str})

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/html/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/html/__init__.py Changed

@@ -1,25 +1,21 @@
-"""
-    sphinx.builders.html
-    ~~~~~~~~~~~~~~~~~~~~
+"""Several HTML builders."""
 
-    Several HTML builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import html
 import os
 import posixpath
 import re
 import sys
+import warnings
 from datetime import datetime
 from os import path
-from typing import IO, Any, Dict, Iterable, Iterator, List, Set, Tuple, Type
+from typing import IO, Any, Iterable, Iterator, List, Tuple, Type
 from urllib.parse import quote
 
+import docutils.readers.doctree
 from docutils import nodes
-from docutils.core import publish_parts
+from docutils.core import Publisher
 from docutils.frontend import OptionParser
 from docutils.io import DocTreeInput, StringOutput
 from docutils.nodes import Node
@@ -31,6 +27,7 @@
 from sphinx.builders import Builder
 from sphinx.config import ENUM, Config
 from sphinx.domains import Domain, Index, IndexEntry
+from sphinx.environment import BuildEnvironment
 from sphinx.environment.adapters.asset import ImageAdapter
 from sphinx.environment.adapters.indexentries import IndexEntries
 from sphinx.environment.adapters.toctree import TocTree
@@ -39,22 +36,17 @@
 from sphinx.locale import _, __
 from sphinx.search import js_index
 from sphinx.theming import HTMLThemeFactory
-from sphinx.util import isurl, logging, md5, progress_message, status_iterator
-from sphinx.util.docutils import is_html5_writer_available, new_document
+from sphinx.util import isurl, logging, md5
+from sphinx.util.display import progress_message, status_iterator
+from sphinx.util.docutils import new_document
 from sphinx.util.fileutil import copy_asset
 from sphinx.util.i18n import format_date
 from sphinx.util.inventory import InventoryFile
 from sphinx.util.matching import DOTFILES, Matcher, patmatch
 from sphinx.util.osutil import copyfile, ensuredir, os_path, relative_uri
 from sphinx.util.tags import Tags
-from sphinx.writers.html import HTMLTranslator, HTMLWriter
-
-# HTML5 Writer is available or not
-if is_html5_writer_available():
-    from sphinx.writers.html5 import HTML5Translator
-    html5_ready = True
-else:
-    html5_ready = False
+from sphinx.writers.html import HTMLWriter
+from sphinx.writers.html5 import HTML5Translator
 
 #: the filename for the inventory of objects
 INVENTORY_FILENAME = 'objects.inv'
@@ -62,6 +54,17 @@
 logger = logging.getLogger(__name__)
 return_codes_re = re.compile('\r\n+')
 
+DOMAIN_INDEX_TYPE = Tuple
+    # Index name (e.g. py-modindex)
+    str,
+    # Index class
+    TypeIndex,
+    # list of (heading string, list of index entries) pairs.
+    ListTuplestr, ListIndexEntry,
+    # whether sub-entries should start collapsed
+    bool,
+
+
 
 def get_stable_hash(obj: Any) -> str:
     """
@@ -76,6 +79,17 @@
     return md5(str(obj).encode()).hexdigest()
 
 
+def convert_locale_to_language_tag(locale: str | None) -> str | None:
+    """Convert a locale string to a language tag (ex. en_US -> en-US).
+
+    refs: BCP 47 (:rfc:`5646`)
+    """
+    if locale:
+        return locale.replace('_', '-')
+    else:
+        return None
+
+
 class Stylesheet(str):
     """A metadata of stylesheet.
 
@@ -83,12 +97,12 @@
     its filename (str).
     """
 
-    attributes: Dictstr, str = None
+    attributes: dictstr, str = None
     filename: str = None
     priority: int = None
 
-    def __new__(cls, filename: str, *args: str, priority: int = 500, **attributes: Any
-                ) -> "Stylesheet":
+    def __new__(cls, filename: str, *args: str, priority: int = 500, **attributes: Any,
+                ) -> Stylesheet:
         self = str.__new__(cls, filename)
         self.filename = filename
         self.priority = priority
@@ -109,11 +123,11 @@
     its filename (str).
     """
 
-    attributes: Dictstr, str = None
+    attributes: dictstr, str = None
     filename: str = None
     priority: int = None
 
-    def __new__(cls, filename: str, priority: int = 500, **attributes: str) -> "JavaScript":
+    def __new__(cls, filename: str, priority: int = 500, **attributes: str) -> JavaScript:
         self = str.__new__(cls, filename)
         self.filename = filename
         self.priority = priority
@@ -130,7 +144,7 @@
     """
 
     @classmethod
-    def load(cls, f: IO) -> "BuildInfo":
+    def load(cls, f: IO) -> BuildInfo:
         try:
             lines = f.readlines()
             assert lines0.rstrip() == '# Sphinx build info version 1'
@@ -144,7 +158,9 @@
         except Exception as exc:
             raise ValueError(__('build info file is broken: %r') % exc) from exc
 
-    def __init__(self, config: Config = None, tags: Tags = None, config_categories: Liststr = ) -> None:  # NOQA
+    def __init__(
+        self, config: Config = None, tags: Tags = None, config_categories: liststr = ,
+    ) -> None:
         self.config_hash = ''
         self.tags_hash = ''
 
@@ -155,7 +171,7 @@
         if tags:
             self.tags_hash = get_stable_hash(sorted(tags))
 
-    def __eq__(self, other: "BuildInfo") -> bool:  # type: ignore
+    def __eq__(self, other: BuildInfo) -> bool:  # type: ignore
         return (self.config_hash == other.config_hash and
                 self.tags_hash == other.tags_hash)
 
@@ -197,23 +213,39 @@
     download_support = True  # enable download role
 
     imgpath: str = None
-    domain_indices: ListTuplestr, TypeIndex, ListTuplestr, ListIndexEntry, bool =   # NOQA
+    domain_indices: listDOMAIN_INDEX_TYPE = 
 
-    def __init__(self, app: Sphinx) -> None:
-        super().__init__(app)
+    def __init__(self, app: Sphinx, env: BuildEnvironment = None) -> None:
+        super().__init__(app, env)
 
         # CSS files
-        self.css_files: ListStylesheet = 
+        self.css_files: listStylesheet = 
 
         # JS files
-        self.script_files: ListJavaScript = 
+        self.script_files: listJavaScript = 
+
+        # Cached Publisher for writing doctrees to HTML
+        reader = docutils.readers.doctree.Reader(parser_name='restructuredtext')
+        pub = Publisher(
+            reader=reader,
+            parser=reader.parser,
+            writer=HTMLWriter(self),
+            source_class=DocTreeInput,
+            destination=StringOutput(encoding='unicode'),
+        )
+        if docutils.__version_info__:2 >= (0, 19):
+            pub.get_settings(output_encoding='unicode', traceback=True)
+        else:
+            op = pub.setup_option_parser(output_encoding='unicode', traceback=True)
+            pub.settings = op.get_default_values()
+        self._publisher = pub
 
     def init(self) -> None:
         self.build_info = self.create_build_info()
         # basename of images directory
         self.imagedir = '_images'
         # section numbers for headings in the currently visited document
-        self.secnumbers: Dictstr, Tupleint, ... = {}
+        self.secnumbers: dictstr, tupleint, ... = {}
         # currently written docname
         self.current_docname: str = None
 
@@ -251,15 +283,18 @@
                 return jsfile
         return None
 
-    def _get_style_filename(self) -> str:
-        if self.config.html_style is not None:
-            return self.config.html_style
+    def _get_style_filenames(self) -> Iteratorstr:
+        if isinstance(self.config.html_style, str):
+            yield self.config.html_style
+        elif self.config.html_style is not None:
+            yield from self.config.html_style
         elif self.theme:
-            return self.theme.get_config('theme', 'stylesheet')
+            stylesheet = self.theme.get_config('theme', 'stylesheet')
+            yield from map(str.strip, stylesheet.split(','))
         else:
-            return 'default.css'
+            yield 'default.css'
 
-    def get_theme_config(self) -> Tuplestr, Dict:
+    def get_theme_config(self) -> tuplestr, dict:
         return self.config.html_theme, self.config.html_theme_options
 
     def init_templates(self) -> None:
@@ -296,7 +331,9 @@
     def init_css_files(self) -> None:
         self.css_files = 
         self.add_css_file('pygments.css', priority=200)
-        self.add_css_file(self._get_style_filename(), priority=200)
+
+        for filename in self._get_style_filenames():
+            self.add_css_file(filename, priority=200)
 
         for filename, attrs in self.app.registry.css_files:
             self.add_css_file(filename, **attrs)
@@ -315,9 +352,8 @@
         self.script_files = 
         self.add_js_file('documentation_options.js', id="documentation_options",
                          data_url_root='', priority=200)
-        self.add_js_file('jquery.js', priority=200)
-        self.add_js_file('underscore.js', priority=200)
         self.add_js_file('doctools.js', priority=200)
+        self.add_js_file('sphinx_highlight.js', priority=200)
 
         for filename, attrs in self.app.registry.js_files:
             self.add_js_file(filename, **attrs)
@@ -326,7 +362,7 @@
             attrs.setdefault('priority', 800)  # User's JSs are loaded after extensions'
             self.add_js_file(filename, **attrs)
 
-        if self.config.language and self._get_translations_js():
+        if self._get_translations_js():
             self.add_js_file('translations.js')
 
     def add_js_file(self, filename: str, **kwargs: Any) -> None:
@@ -336,11 +372,8 @@
         self.script_files.append(JavaScript(filename, **kwargs))
 
     @property
-    def default_translator_class(self) -> Typenodes.NodeVisitor:  # type: ignore
-        if not html5_ready or self.config.html4_writer:
-            return HTMLTranslator
-        else:
-            return HTML5Translator
+    def default_translator_class(self) -> typenodes.NodeVisitor:  # type: ignore
+        return HTML5Translator
 
     @property
     def math_renderer_name(self) -> str:
@@ -364,7 +397,7 @@
 
     def get_outdated_docs(self) -> Iteratorstr:
         try:
-            with open(path.join(self.outdir, '.buildinfo')) as fp:
+            with open(path.join(self.outdir, '.buildinfo'), encoding="utf-8") as fp:
                 buildinfo = BuildInfo.load(fp)
 
             if self.build_info != buildinfo:
@@ -408,41 +441,40 @@
                 # source doesn't exist anymore
                 pass
 
-    def get_asset_paths(self) -> Liststr:
+    def get_asset_paths(self) -> liststr:
         return self.config.html_extra_path + self.config.html_static_path
 
-    def render_partial(self, node: Node) -> Dictstr, str:
+    def render_partial(self, node: Node | None) -> dictstr, str:
         """Utility: Render a lone doctree node."""
         if node is None:
             return {'fragment': ''}
+
         doc = new_document('<partial node>')
         doc.append(node)
+        self._publisher.set_source(doc)
+        self._publisher.publish()
+        return self._publisher.writer.parts
 
-        writer = HTMLWriter(self)
-        return publish_parts(reader_name='doctree',
-                             writer=writer,
-                             source_class=DocTreeInput,
-                             settings_overrides={'output_encoding': 'unicode'},
-                             source=doc)
-
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         # create the search indexer
         self.indexer = None
         if self.search:
             from sphinx.search import IndexBuilder
             lang = self.config.html_search_language or self.config.language
-            if not lang:
-                lang = 'en'
             self.indexer = IndexBuilder(self.env, lang,
                                         self.config.html_search_options,
                                         self.config.html_search_scorer)
             self.load_indexer(docnames)
 
         self.docwriter = HTMLWriter(self)
-        self.docsettings: Any = OptionParser(
-            defaults=self.env.settings,
-            components=(self.docwriter,),
-            read_config_files=True).get_default_values()
+        with warnings.catch_warnings():
+            warnings.filterwarnings('ignore', category=DeprecationWarning)
+            # DeprecationWarning: The frontend.OptionParser class will be replaced
+            # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+            self.docsettings: Any = OptionParser(
+                defaults=self.env.settings,
+                components=(self.docwriter,),
+                read_config_files=True).get_default_values()
         self.docsettings.compact_lists = bool(self.config.html_compact_lists)
 
         # determine the additional indices to include
@@ -453,7 +485,7 @@
             for domain_name in sorted(self.env.domains):
                 domain: Domain = self.env.domainsdomain_name
                 for indexcls in domain.indices:
-                    indexname = '%s-%s' % (domain.name, indexcls.name)
+                    indexname = f'{domain.name}-{indexcls.name}'
                     if isinstance(indices_config, list):
                         if indexname not in indices_config:
                             continue
@@ -483,7 +515,7 @@
 
         self.relations = self.env.collect_relations()
 
-        rellinks: ListTuplestr, str, str, str = 
+        rellinks: listtuplestr, str, str, str = 
         if self.use_index:
             rellinks.append(('genindex', _('General Index'), 'I', _('index')))
         for indexname, indexcls, _content, _collapse in self.domain_indices:
@@ -495,6 +527,7 @@
         # back up script_files and css_files to allow adding JS/CSS files to a specific page.
         self._script_files = list(self.script_files)
         self._css_files = list(self.css_files)
+        styles = list(self._get_style_filenames())
 
         self.globalcontext = {
             'embedded': self.embedded,
@@ -509,6 +542,7 @@
             'docstitle': self.config.html_title,
             'shorttitle': self.config.html_short_title,
             'show_copyright': self.config.html_show_copyright,
+            'show_search_summary': self.config.html_show_search_summary,
             'show_sphinx': self.config.html_show_sphinx,
             'has_source': self.config.html_copy_source,
             'show_source': self.config.html_show_sourcelink,
@@ -516,17 +550,18 @@
             'file_suffix': self.out_suffix,
             'link_suffix': self.link_suffix,
             'script_files': self.script_files,
-            'language': self.config.language,
+            'language': convert_locale_to_language_tag(self.config.language),
             'css_files': self.css_files,
             'sphinx_version': __display_version__,
             'sphinx_version_tuple': sphinx_version,
-            'style': self._get_style_filename(),
+            'docutils_version_info': docutils.__version_info__:5,
+            'styles': styles,
             'rellinks': rellinks,
             'builder': self.name,
             'parents': ,
-            'logo': logo,
-            'favicon': favicon,
-            'html5_doctype': html5_ready and not self.config.html4_writer,
+            'logo_url': logo,
+            'favicon_url': favicon,
+            'html5_doctype': True,
         }
         if self.theme:
             self.globalcontext.update(
@@ -534,7 +569,7 @@
                 self.theme.get_options(self.theme_options).items())
         self.globalcontext.update(self.config.html_context)
 
-    def get_doc_context(self, docname: str, body: str, metatags: str) -> Dictstr, Any:
+    def get_doc_context(self, docname: str, body: str, metatags: str) -> dictstr, Any:
         """Collect items for the template context of a page."""
         # find out relations
         prev = next = None
@@ -546,7 +581,7 @@
             try:
                 next = {
                     'link': self.get_relative_uri(docname, related2),
-                    'title': self.render_partial(titlesrelated2)'title'
+                    'title': self.render_partial(titlesrelated2)'title',
                 }
                 rellinks.append((related2, next'title', 'N', _('next')))
             except KeyError:
@@ -555,7 +590,7 @@
             try:
                 prev = {
                     'link': self.get_relative_uri(docname, related1),
-                    'title': self.render_partial(titlesrelated1)'title'
+                    'title': self.render_partial(titlesrelated1)'title',
                 }
                 rellinks.append((related1, prev'title', 'P', _('previous')))
             except KeyError:
@@ -758,19 +793,20 @@
 
     def create_pygments_style_file(self) -> None:
         """create a style file for pygments."""
-        with open(path.join(self.outdir, '_static', 'pygments.css'), 'w') as f:
+        with open(path.join(self.outdir, '_static', 'pygments.css'), 'w',
+                  encoding="utf-8") as f:
             f.write(self.highlighter.get_stylesheet())
 
         if self.dark_highlighter:
-            with open(path.join(self.outdir, '_static', 'pygments_dark.css'), 'w') as f:
+            with open(path.join(self.outdir, '_static', 'pygments_dark.css'), 'w',
+                      encoding="utf-8") as f:
                 f.write(self.dark_highlighter.get_stylesheet())
 
     def copy_translation_js(self) -> None:
         """Copy a JavaScript file for translations."""
-        if self.config.language is not None:
-            jsfile = self._get_translations_js()
-            if jsfile:
-                copyfile(jsfile, path.join(self.outdir, '_static', 'translations.js'))
+        jsfile = self._get_translations_js()
+        if jsfile:
+            copyfile(jsfile, path.join(self.outdir, '_static', 'translations.js'))
 
     def copy_stemmer_js(self) -> None:
         """Copy a JavaScript file for stemmer."""
@@ -783,7 +819,7 @@
                 if jsfile:
                     copyfile(jsfile, path.join(self.outdir, '_static', '_stemmer.js'))
 
-    def copy_theme_static_files(self, context: Dict) -> None:
+    def copy_theme_static_files(self, context: dictstr, Any) -> None:
         def onerror(filename: str, error: Exception) -> None:
             logger.warning(__('Failed to copy a file in html_static_file: %s: %r'),
                            filename, error)
@@ -795,7 +831,7 @@
                            excluded=DOTFILES, context=context,
                            renderer=self.templates, onerror=onerror)
 
-    def copy_html_static_files(self, context: Dict) -> None:
+    def copy_html_static_files(self, context: dict) -> None:
         def onerror(filename: str, error: Exception) -> None:
             logger.warning(__('Failed to copy a file in html_static_file: %s: %r'),
                            filename, error)
@@ -849,7 +885,7 @@
 
     def write_buildinfo(self) -> None:
         try:
-            with open(path.join(self.outdir, '.buildinfo'), 'w') as fp:
+            with open(path.join(self.outdir, '.buildinfo'), 'w', encoding="utf-8") as fp:
                 self.build_info.dump(fp)
         except OSError as exc:
             logger.warning(__('Failed to write build info file: %r'), exc)
@@ -863,7 +899,7 @@
         """Pick the best candidate for an image and link down-scaled images to
         their high res version.
         """
-        Builder.post_process_images(self, doctree)
+        super().post_process_images(doctree)
 
         if self.config.html_scaled_image_link and self.html_scaled_image_link:
             for node in doctree.findall(nodes.image):
@@ -871,10 +907,10 @@
                     # resizing options are not given. scaled image link is available
                     # only for resized images.
                     continue
-                elif isinstance(node.parent, nodes.reference):
+                if isinstance(node.parent, nodes.reference):
                     # A image having hyperlink target
                     continue
-                elif 'no-scaled-link' in node'classes':
+                if 'no-scaled-link' in node'classes':
                     # scaled image link is disabled for this node
                     continue
 
@@ -900,7 +936,7 @@
                     self.indexer.load(fb, self.indexer_format)
         except (OSError, ValueError):
             if keep:
-                logger.warning(__('search index couldn\'t be loaded, but not all '
+                logger.warning(__("search index couldn't be loaded, but not all "
                                   'documents will be built: the index will be '
                                   'incomplete.'))
         # delete all entries for files that will be rebuilt
@@ -927,7 +963,7 @@
     def get_outfilename(self, pagename: str) -> str:
         return path.join(self.outdir, os_path(pagename) + self.out_suffix)
 
-    def add_sidebars(self, pagename: str, ctx: Dict) -> None:
+    def add_sidebars(self, pagename: str, ctx: dict) -> None:
         def has_wildcard(pattern: str) -> bool:
             return any(char in pattern for char in '*?')
 
@@ -982,8 +1018,8 @@
     def get_target_uri(self, docname: str, typ: str = None) -> str:
         return quote(docname) + self.link_suffix
 
-    def handle_page(self, pagename: str, addctx: Dict, templatename: str = 'page.html',
-                    outfilename: str = None, event_arg: Any = None) -> None:
+    def handle_page(self, pagename: str, addctx: dict, templatename: str = 'page.html',
+                    outfilename: str | None = None, event_arg: Any = None) -> None:
         ctx = self.globalcontext.copy()
         # current_page_name is backwards compatibility
         ctx'pagename' = ctx'current_page_name' = pagename
@@ -999,7 +1035,9 @@
         else:
             ctx'pageurl' = None
 
-        def pathto(otheruri: str, resource: bool = False, baseuri: str = default_baseuri) -> str:  # NOQA
+        def pathto(
+            otheruri: str, resource: bool = False, baseuri: str = default_baseuri,
+        ) -> str:
             if resource and '://' in otheruri:
                 # allow non-local resources given by scheme
                 return otheruri
@@ -1014,9 +1052,9 @@
         def hasdoc(name: str) -> bool:
             if name in self.env.all_docs:
                 return True
-            elif name == 'search' and self.search:
+            if name == 'search' and self.search:
                 return True
-            elif name == 'genindex' and self.get_builder_config('use_index', 'html'):
+            if name == 'genindex' and self.get_builder_config('use_index', 'html'):
                 return True
             return False
         ctx'hasdoc' = hasdoc
@@ -1038,7 +1076,7 @@
         # sort JS/CSS before rendering HTML
         try:
             # Convert script_files to list to support non-list script_files (refs: #8889)
-            ctx'script_files' = sorted(list(ctx'script_files'), key=lambda js: js.priority)
+            ctx'script_files' = sorted(ctx'script_files', key=lambda js: js.priority)
         except AttributeError:
             # Skip sorting if users modifies script_files directly (maybe via `html_context`).
             # refs: #8885
@@ -1047,7 +1085,7 @@
             pass
 
         try:
-            ctx'css_files' = sorted(list(ctx'css_files'), key=lambda css: css.priority)
+            ctx'css_files' = sorted(ctx'css_files', key=lambda css: css.priority)
         except AttributeError:
             pass
 
@@ -1080,7 +1118,7 @@
             copyfile(self.env.doc2path(pagename), source_name)
 
     def update_page_context(self, pagename: str, templatename: str,
-                            ctx: Dict, event_arg: Any) -> None:
+                            ctx: dict, event_arg: Any) -> None:
         pass
 
     def handle_finish(self) -> None:
@@ -1109,7 +1147,7 @@
 
 def convert_html_css_files(app: Sphinx, config: Config) -> None:
     """This converts string styled html_css_files to tuple styled one."""
-    html_css_files: ListTuplestr, Dict = 
+    html_css_files: listtuplestr, dict = 
     for entry in config.html_css_files:
         if isinstance(entry, str):
             html_css_files.append((entry, {}))
@@ -1126,7 +1164,7 @@
 
 def convert_html_js_files(app: Sphinx, config: Config) -> None:
     """This converts string styled html_js_files to tuple styled one."""
-    html_js_files: ListTuplestr, Dict = 
+    html_js_files: listtuplestr, dict = 
     for entry in config.html_js_files:
         if isinstance(entry, str):
             html_js_files.append((entry, {}))
@@ -1142,7 +1180,7 @@
 
 
 def setup_css_tag_helper(app: Sphinx, pagename: str, templatename: str,
-                         context: Dict, doctree: Node) -> None:
+                         context: dict, doctree: Node) -> None:
     """Set up css_tag() template helper.
 
     .. note:: This set up function is added to keep compatibility with webhelper.
@@ -1154,7 +1192,7 @@
         for key in sorted(css.attributes):
             value = css.attributeskey
             if value is not None:
-                attrs.append('%s="%s"' % (key, html.escape(value, True)))
+                attrs.append(f'{key}="{html.escape(value, True)}"')
         attrs.append('href="%s"' % pathto(css.filename, resource=True))
         return '<link %s />' % ' '.join(attrs)
 
@@ -1162,7 +1200,7 @@
 
 
 def setup_js_tag_helper(app: Sphinx, pagename: str, templatename: str,
-                        context: Dict, doctree: Node) -> None:
+                        context: dict, doctree: Node) -> None:
     """Set up js_tag() template helper.
 
     .. note:: This set up function is added to keep compatibility with webhelper.
@@ -1181,7 +1219,7 @@
                     elif key == 'data_url_root':
                         attrs.append('data-url_root="%s"' % pathto('', resource=True))
                     else:
-                        attrs.append('%s="%s"' % (key, html.escape(value, True)))
+                        attrs.append(f'{key}="{html.escape(value, True)}"')
             if js.filename:
                 attrs.append('src="%s"' % pathto(js.filename, resource=True))
         else:
@@ -1189,31 +1227,27 @@
             attrs.append('src="%s"' % pathto(js, resource=True))
 
         if attrs:
-            return '<script %s>%s</script>' % (' '.join(attrs), body)
+            return f'<script {" ".join(attrs)}>{body}</script>'
         else:
-            return '<script>%s</script>' % body
+            return f'<script>{body}</script>'
 
     context'js_tag' = js_tag
 
 
 def setup_resource_paths(app: Sphinx, pagename: str, templatename: str,
-                         context: Dict, doctree: Node) -> None:
+                         context: dict, doctree: Node) -> None:
     """Set up relative resource paths."""
     pathto = context.get('pathto')
 
     # favicon_url
-    favicon = context.get('favicon')
-    if favicon and not isurl(favicon):
-        context'favicon_url' = pathto('_static/' + favicon, resource=True)
-    else:
-        context'favicon_url' = favicon
+    favicon_url = context.get('favicon_url')
+    if favicon_url and not isurl(favicon_url):
+        context'favicon_url' = pathto('_static/' + favicon_url, resource=True)
 
     # logo_url
-    logo = context.get('logo')
-    if logo and not isurl(logo):
-        context'logo_url' = pathto('_static/' + logo, resource=True)
-    else:
-        context'logo_url' = logo
+    logo_url = context.get('logo_url')
+    if logo_url and not isurl(logo_url):
+        context'logo_url' = pathto('_static/' + logo_url, resource=True)
 
 
 def validate_math_renderer(app: Sphinx) -> None:
@@ -1224,7 +1258,7 @@
     if name is None:
         raise ConfigError(__('Many math_renderers are registered. '
                              'But no math_renderer is selected.'))
-    elif name not in app.registry.html_inline_math_renderers:
+    if name not in app.registry.html_inline_math_renderers:
         raise ConfigError(__('Unknown math_renderer %r is given.') % name)
 
 
@@ -1272,40 +1306,16 @@
         config.html_favicon = None  # type: ignore
 
 
-class _stable_repr_object():
-
-    def __repr__(self):
-        return '<object>'
-
-
-UNSET = _stable_repr_object()
-
-
-def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None:
-    """Migrate html_add_permalinks to html_permalinks*."""
-    html_add_permalinks = config.html_add_permalinks
-    if html_add_permalinks is UNSET:
-        return
-
-    # RemovedInSphinx60Warning
-    logger.warning(__('html_add_permalinks has been deprecated since v3.5.0. '
-                      'Please use html_permalinks and html_permalinks_icon instead.'))
-    if not html_add_permalinks:
-        config.html_permalinks = False  # type: ignoreattr-defined
-        return
-
-    config.html_permalinks_icon = html.escape(  # type: ignoreattr-defined
-        html_add_permalinks
-    )
-
-# for compatibility
-import sphinxcontrib.serializinghtml  # NOQA
-
-import sphinx.builders.dirhtml  # NOQA
-import sphinx.builders.singlehtml  # NOQA
+def error_on_html_4(_app: Sphinx, config: Config) -> None:
+    """Error on HTML 4."""
+    if config.html4_writer:
+        raise ConfigError(_(
+            'HTML 4 is no longer supported by Sphinx. '
+            '("html4_writer=True" detected in configuration options)',
+        ))
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     # builders
     app.add_builder(StandaloneHTMLBuilder)
 
@@ -1317,7 +1327,7 @@
                          lambda self: _('%s %s documentation') % (self.project, self.release),
                          'html', str)
     app.add_config_value('html_short_title', lambda self: self.html_title, 'html')
-    app.add_config_value('html_style', None, 'html', str)
+    app.add_config_value('html_style', None, 'html', list, str)
     app.add_config_value('html_logo', None, 'html', str)
     app.add_config_value('html_favicon', None, 'html', str)
     app.add_config_value('html_css_files', , 'html')
@@ -1328,7 +1338,6 @@
     app.add_config_value('html_sidebars', {}, 'html')
     app.add_config_value('html_additional_pages', {}, 'html')
     app.add_config_value('html_domain_indices', True, 'html', list)
-    app.add_config_value('html_add_permalinks', UNSET, 'html')
     app.add_config_value('html_permalinks', True, 'html')
     app.add_config_value('html_permalinks_icon', '¶', 'html')
     app.add_config_value('html_use_index', True, 'html')
@@ -1340,6 +1349,7 @@
     app.add_config_value('html_file_suffix', None, 'html', str)
     app.add_config_value('html_link_suffix', None, 'html', str)
     app.add_config_value('html_show_copyright', True, 'html')
+    app.add_config_value('html_show_search_summary', True, 'html')
     app.add_config_value('html_show_sphinx', True, 'html')
     app.add_config_value('html_context', {}, 'html')
     app.add_config_value('html_output_encoding', 'utf-8', 'html')
@@ -1350,7 +1360,7 @@
     app.add_config_value('html_search_scorer', '', None)
     app.add_config_value('html_scaled_image_link', True, 'html')
     app.add_config_value('html_baseurl', '', 'html')
-    app.add_config_value('html_codeblock_linenos_style', 'inline', 'html',  # RemovedInSphinx60Warning  # NOQA
+    app.add_config_value('html_codeblock_linenos_style', 'inline', 'html',  # RemovedInSphinx70Warning  # noqa: E501
                          ENUM('table', 'inline'))
     app.add_config_value('html_math_renderer', None, 'env')
     app.add_config_value('html4_writer', False, 'html')
@@ -1362,11 +1372,11 @@
     # event handlers
     app.connect('config-inited', convert_html_css_files, priority=800)
     app.connect('config-inited', convert_html_js_files, priority=800)
-    app.connect('config-inited', migrate_html_add_permalinks, priority=800)
     app.connect('config-inited', validate_html_extra_path, priority=800)
     app.connect('config-inited', validate_html_static_path, priority=800)
     app.connect('config-inited', validate_html_logo, priority=800)
     app.connect('config-inited', validate_html_favicon, priority=800)
+    app.connect('config-inited', error_on_html_4, priority=800)
     app.connect('builder-inited', validate_math_renderer)
     app.connect('html-page-context', setup_css_tag_helper)
     app.connect('html-page-context', setup_js_tag_helper)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/html/transforms.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/html/transforms.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.builders.html.transforms
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Transforms for HTML builder."""
 
-    Transforms for HTML builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import Any, Dict, List
+from typing import Any
 
 from docutils import nodes
 
@@ -39,16 +33,18 @@
     formats = ('html',)
     pattern = re.compile(r'(?<=.)(-|\+|\^|\s+)(?=.)')
     multiwords_keys = (('caps', 'lock'),
-                       ('page' 'down'),
+                       ('page', 'down'),
                        ('page', 'up'),
-                       ('scroll' 'lock'),
+                       ('scroll', 'lock'),
                        ('num', 'lock'),
-                       ('sys' 'rq'),
-                       ('back' 'space'))
+                       ('sys', 'rq'),
+                       ('back', 'space'))
 
     def run(self, **kwargs: Any) -> None:
         matcher = NodeMatcher(nodes.literal, classes="kbd")
-        for node in self.document.findall(matcher):  # type: nodes.literal
+        # this list must be pre-created as during iteration new nodes
+        # are added which match the condition in the NodeMatcher.
+        for node in list(self.document.findall(matcher)):  # type: nodes.literal
             parts = self.pattern.split(node-1.astext())
             if len(parts) == 1 or self.is_multiwords_key(parts):
                 continue
@@ -70,18 +66,15 @@
                 except IndexError:
                     pass
 
-    def is_multiwords_key(self, parts: Liststr) -> bool:
+    def is_multiwords_key(self, parts: liststr) -> bool:
         if len(parts) >= 3 and parts1.strip() == '':
             name = parts0.lower(), parts2.lower()
-            if name in self.multiwords_keys:
-                return True
-            else:
-                return False
+            return name in self.multiwords_keys
         else:
             return False
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_post_transform(KeyboardTransform)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/latex/__init__.py Changed

@@ -1,22 +1,16 @@
-"""
-    sphinx.builders.latex
-    ~~~~~~~~~~~~~~~~~~~~~
+"""LaTeX builder."""
 
-    LaTeX builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import warnings
 from os import path
-from typing import Any, Dict, Iterable, List, Tuple, Union
+from typing import Any, Iterable
 
 from docutils.frontend import OptionParser
 from docutils.nodes import Node
 
-import sphinx.builders.latex.nodes  # NOQA  # Workaround: import this before writer to avoid ImportError
+import sphinx.builders.latex.nodes  # noqa: F401,E501  # Workaround: import this before writer to avoid ImportError
 from sphinx import addnodes, highlighting, package_dir
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
@@ -24,12 +18,12 @@
 from sphinx.builders.latex.theming import Theme, ThemeFactory
 from sphinx.builders.latex.util import ExtBabel
 from sphinx.config import ENUM, Config
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.environment.adapters.asset import ImageAdapter
 from sphinx.errors import NoUri, SphinxError
 from sphinx.locale import _, __
-from sphinx.util import logging, progress_message, status_iterator, texescape
+from sphinx.util import logging, texescape
 from sphinx.util.console import bold, darkgreen  # type: ignore
+from sphinx.util.display import progress_message, status_iterator
 from sphinx.util.docutils import SphinxFileOutput, new_document
 from sphinx.util.fileutil import copy_asset_file
 from sphinx.util.i18n import format_date
@@ -123,9 +117,9 @@
 
     def init(self) -> None:
         self.babel: ExtBabel = None
-        self.context: Dictstr, Any = {}
+        self.context: dictstr, Any = {}
         self.docnames: Iterablestr = {}
-        self.document_data: ListTuplestr, str, str, str, str, bool = 
+        self.document_data: listtuplestr, str, str, str, str, bool = 
         self.themes = ThemeFactory(self.app)
         texescape.init()
 
@@ -133,16 +127,15 @@
         self.init_babel()
         self.init_multilingual()
 
-    def get_outdated_docs(self) -> Unionstr, Liststr:
+    def get_outdated_docs(self) -> str | liststr:
         return 'all documents'  # for now
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         if docname not in self.docnames:
             raise NoUri(docname, typ)
-        else:
-            return '%' + docname
+        return '%' + docname
 
-    def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str:
+    def get_relative_uri(self, from_: str, to: str, typ: str | None = None) -> str:
         # ignore source path
         return self.get_target_uri(to, typ)
 
@@ -153,7 +146,7 @@
                               'will be written'))
             return
         # assign subdirs to titles
-        self.titles: ListTuplestr, str = 
+        self.titles: listtuplestr, str = 
         for entry in preliminary_document_data:
             docname = entry0
             if docname not in self.env.all_docs:
@@ -172,14 +165,16 @@
         self.context.update(ADDITIONAL_SETTINGS.get(self.config.latex_engine, {}))
 
         # Add special settings for (latex_engine, language_code)
-        if self.config.language:
-            key = (self.config.latex_engine, self.config.language:2)
-            self.context.update(ADDITIONAL_SETTINGS.get(key, {}))
+        key = (self.config.latex_engine, self.config.language:2)
+        self.context.update(ADDITIONAL_SETTINGS.get(key, {}))
 
         # Apply user settings to context
         self.context.update(self.config.latex_elements)
         self.context'release' = self.config.release
         self.context'use_xindy' = self.config.latex_use_xindy
+        self.context'booktabs' = 'booktabs' in self.config.latex_table_style
+        self.context'borderless' = 'borderless' in self.config.latex_table_style
+        self.context'colorrows' = 'colorrows' in self.config.latex_table_style
 
         if self.config.today:
             self.context'date' = self.config.today
@@ -205,7 +200,7 @@
 
     def init_babel(self) -> None:
         self.babel = ExtBabel(self.config.language, not self.context'babel')
-        if self.config.language and not self.babel.is_supported_language():
+        if not self.babel.is_supported_language():
             # emit warning if specified language is invalid
             # (only emitting, nothing changed to processing)
             logger.warning(__('no Babel option known for language %r'),
@@ -234,38 +229,41 @@
             self.context'classoptions' += ',' + self.babel.get_language()
             # this branch is not taken for xelatex/lualatex if default settings
             self.context'multilingual' = self.context'babel'
-            if self.config.language:
-                self.context'shorthandoff' = SHORTHANDOFF
+            self.context'shorthandoff' = SHORTHANDOFF
 
-                # Times fonts don't work with Cyrillic languages
-                if self.babel.uses_cyrillic() and 'fontpkg' not in self.config.latex_elements:
-                    self.context'fontpkg' = ''
+            # Times fonts don't work with Cyrillic languages
+            if self.babel.uses_cyrillic() and 'fontpkg' not in self.config.latex_elements:
+                self.context'fontpkg' = ''
         elif self.context'polyglossia':
             self.context'classoptions' += ',' + self.babel.get_language()
             options = self.babel.get_mainlanguage_options()
             if options:
-                language = r'\setmainlanguage%s{%s}' % (options, self.babel.get_language())
+                language = fr'\setmainlanguage{options}{{{self.babel.get_language()}}}'
             else:
                 language = r'\setmainlanguage{%s}' % self.babel.get_language()
 
-            self.context'multilingual' = '%s\n%s' % (self.context'polyglossia', language)
+            self.context'multilingual' = f'{self.context"polyglossia"}\n{language}'
 
     def write_stylesheet(self) -> None:
         highlighter = highlighting.PygmentsBridge('latex', self.config.pygments_style)
         stylesheet = path.join(self.outdir, 'sphinxhighlight.sty')
-        with open(stylesheet, 'w') as f:
+        with open(stylesheet, 'w', encoding="utf-8") as f:
             f.write('\\NeedsTeXFormat{LaTeX2e}1995/12/01\n')
             f.write('\\ProvidesPackage{sphinxhighlight}'
-                    '2016/05/29 stylesheet for highlighting with pygments\n')
+                    '2022/06/30 stylesheet for highlighting with pygments\n')
             f.write('% Its contents depend on pygments_style configuration variable.\n\n')
             f.write(highlighter.get_stylesheet())
 
     def write(self, *ignored: Any) -> None:
         docwriter = LaTeXWriter(self)
-        docsettings: Any = OptionParser(
-            defaults=self.env.settings,
-            components=(docwriter,),
-            read_config_files=True).get_default_values()
+        with warnings.catch_warnings():
+            warnings.filterwarnings('ignore', category=DeprecationWarning)
+            # DeprecationWarning: The frontend.OptionParser class will be replaced
+            # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+            docsettings: Any = OptionParser(
+                defaults=self.env.settings,
+                components=(docwriter,),
+                read_config_files=True).get_default_values()
 
         self.init_document_data()
         self.write_stylesheet()
@@ -325,7 +323,9 @@
         self.context'pointsize' = theme.pointsize
         self.context'wrapperclass' = theme.wrapperclass
 
-    def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: Liststr) -> nodes.document:  # NOQA
+    def assemble_doctree(
+        self, indexfile: str, toctree_only: bool, appendices: liststr,
+    ) -> nodes.document:
         self.docnames = set(indexfile + appendices)
         logger.info(darkgreen(indexfile) + " ", nonl=True)
         tree = self.env.get_doctree(indexfile)
@@ -356,12 +356,12 @@
         for pendingnode in largetree.findall(addnodes.pending_xref):
             docname = pendingnode'refdocname'
             sectname = pendingnode'refsectname'
-            newnodes: ListNode = nodes.emphasis(sectname, sectname)
+            newnodes: listNode = nodes.emphasis(sectname, sectname)
             for subdir, title in self.titles:
                 if docname.startswith(subdir):
-                    newnodes.append(nodes.Text(_(' (in '), _(' (in ')))
+                    newnodes.append(nodes.Text(_(' (in ')))
                     newnodes.append(nodes.emphasis(title, title))
-                    newnodes.append(nodes.Text(')', ')'))
+                    newnodes.append(nodes.Text(')'))
                     break
             else:
                 pass
@@ -382,14 +382,10 @@
         # configure usage of xindy (impacts Makefile and latexmkrc)
         # FIXME: convert this rather to a confval with suitable default
         #        according to language ? but would require extra documentation
-        if self.config.language:
-            xindy_lang_option = \
-                XINDY_LANG_OPTIONS.get(self.config.language:2,
-                                       '-L general -C utf8 ')
-            xindy_cyrillic = self.config.language:2 in XINDY_CYRILLIC_SCRIPTS
-        else:
-            xindy_lang_option = '-L english -C utf8 '
-            xindy_cyrillic = False
+        xindy_lang_option = XINDY_LANG_OPTIONS.get(self.config.language:2,
+                                                   '-L general -C utf8 ')
+        xindy_cyrillic = self.config.language:2 in XINDY_CYRILLIC_SCRIPTS
+
         context = {
             'latex_engine':      self.config.latex_engine,
             'xindy_use':         self.config.latex_use_xindy,
@@ -431,8 +427,7 @@
         if self.config.latex_logo:
             if not path.isfile(path.join(self.confdir, self.config.latex_logo)):
                 raise SphinxError(__('logo file %r does not exist') % self.config.latex_logo)
-            else:
-                copy_asset_file(path.join(self.confdir, self.config.latex_logo), self.outdir)
+            copy_asset_file(path.join(self.confdir, self.config.latex_logo), self.outdir)
 
     def write_message_catalog(self) -> None:
         formats = self.config.numfig_format
@@ -440,7 +435,7 @@
             'addtocaptions': r'\@iden',
             'figurename': formats.get('figure', '').split('%s', 1),
             'tablename': formats.get('table', '').split('%s', 1),
-            'literalblockname': formats.get('code-block', '').split('%s', 1)
+            'literalblockname': formats.get('code-block', '').split('%s', 1),
         }
 
         if self.context'babel' or self.context'polyglossia':
@@ -449,18 +444,6 @@
         filename = path.join(package_dir, 'templates', 'latex', 'sphinxmessages.sty_t')
         copy_asset_file(filename, self.outdir, context=context, renderer=LaTeXRenderer())
 
-    @property
-    def usepackages(self) -> ListTuplestr, str:
-        warnings.warn('LaTeXBuilder.usepackages is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self.app.registry.latex_packages
-
-    @property
-    def usepackages_after_hyperref(self) -> ListTuplestr, str:
-        warnings.warn('LaTeXBuilder.usepackages_after_hyperref is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self.app.registry.latex_packages_after_hyperref
-
 
 def validate_config_values(app: Sphinx, config: Config) -> None:
     for key in list(config.latex_elements):
@@ -488,15 +471,14 @@
     """ Better default latex_engine settings for specific languages. """
     if config.language == 'ja':
         return 'uplatex'
-    elif (config.language or '').startswith('zh'):
+    if config.language.startswith('zh'):
         return 'xelatex'
-    elif config.language == 'el':
+    if config.language == 'el':
         return 'xelatex'
-    else:
-        return 'pdflatex'
+    return 'pdflatex'
 
 
-def default_latex_docclass(config: Config) -> Dictstr, str:
+def default_latex_docclass(config: Config) -> dictstr, str:
     """ Better default latex_docclass settings for specific languages. """
     if config.language == 'ja':
         if config.latex_engine == 'uplatex':
@@ -514,7 +496,7 @@
     return config.latex_engine in {'xelatex', 'lualatex'}
 
 
-def default_latex_documents(config: Config) -> ListTuplestr, str, str, str, str:
+def default_latex_documents(config: Config) -> listtuplestr, str, str, str, str:
     """ Better default latex_documents settings. """
     project = texescape.escape(config.project, config.latex_engine)
     author = texescape.escape(config.author, config.latex_engine)
@@ -525,7 +507,7 @@
              config.latex_theme)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.setup_extension('sphinx.builders.latex.transforms')
 
     app.add_builder(LaTeXBuilder)
@@ -533,25 +515,26 @@
     app.connect('config-inited', validate_latex_theme_options, priority=800)
     app.connect('builder-inited', install_packages_for_ja)
 
-    app.add_config_value('latex_engine', default_latex_engine, None,
+    app.add_config_value('latex_engine', default_latex_engine, False,
                          ENUM('pdflatex', 'xelatex', 'lualatex', 'platex', 'uplatex'))
-    app.add_config_value('latex_documents', default_latex_documents, None)
-    app.add_config_value('latex_logo', None, None, str)
-    app.add_config_value('latex_appendices', , None)
-    app.add_config_value('latex_use_latex_multicolumn', False, None)
-    app.add_config_value('latex_use_xindy', default_latex_use_xindy, None, bool)
-    app.add_config_value('latex_toplevel_sectioning', None, None,
+    app.add_config_value('latex_documents', default_latex_documents, False)
+    app.add_config_value('latex_logo', None, False, str)
+    app.add_config_value('latex_appendices', , False)
+    app.add_config_value('latex_use_latex_multicolumn', False, False)
+    app.add_config_value('latex_use_xindy', default_latex_use_xindy, False, bool)
+    app.add_config_value('latex_toplevel_sectioning', None, False,
                          ENUM(None, 'part', 'chapter', 'section'))
-    app.add_config_value('latex_domain_indices', True, None, list)
-    app.add_config_value('latex_show_urls', 'no', None)
-    app.add_config_value('latex_show_pagerefs', False, None)
-    app.add_config_value('latex_elements', {}, None)
-    app.add_config_value('latex_additional_files', , None)
-    app.add_config_value('latex_theme', 'manual', None, str)
-    app.add_config_value('latex_theme_options', {}, None)
-    app.add_config_value('latex_theme_path', , None, list)
-
-    app.add_config_value('latex_docclass', default_latex_docclass, None)
+    app.add_config_value('latex_domain_indices', True, False, list)
+    app.add_config_value('latex_show_urls', 'no', False)
+    app.add_config_value('latex_show_pagerefs', False, False)
+    app.add_config_value('latex_elements', {}, False)
+    app.add_config_value('latex_additional_files', , False)
+    app.add_config_value('latex_table_style', 'booktabs', 'colorrows', False, list)
+    app.add_config_value('latex_theme', 'manual', False, str)
+    app.add_config_value('latex_theme_options', {}, False)
+    app.add_config_value('latex_theme_path', , False, list)
+
+    app.add_config_value('latex_docclass', default_latex_docclass, False)
 
     return {
         'version': 'builtin',

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex/constants.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/latex/constants.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex/nodes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/latex/nodes.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex/theming.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/latex/theming.py Changed

@@ -1,16 +1,9 @@
-"""
-    sphinx.builders.latex.theming
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Theming support for LaTeX builder."""
 
-    Theming support for LaTeX builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import configparser
 from os import path
-from typing import Dict
 
 from sphinx.application import Sphinx
 from sphinx.config import Config
@@ -81,7 +74,7 @@
     def __init__(self, name: str, filename: str) -> None:
         super().__init__(name)
         self.config = configparser.RawConfigParser()
-        self.config.read(path.join(filename))
+        self.config.read(path.join(filename), encoding='utf-8')
 
         for key in self.REQUIRED_CONFIG_KEYS:
             try:
@@ -106,7 +99,7 @@
     """A factory class for LaTeX Themes."""
 
     def __init__(self, app: Sphinx) -> None:
-        self.themes: Dictstr, Theme = {}
+        self.themes: dictstr, Theme = {}
         self.theme_paths = path.join(app.srcdir, p) for p in app.config.latex_theme_path
         self.config = app.config
         self.load_builtin_themes(app.config)
@@ -121,14 +114,12 @@
         if name in self.themes:
             theme = self.themesname
         else:
-            theme = self.find_user_theme(name)
-            if not theme:
-                theme = Theme(name)
+            theme = self.find_user_theme(name) or Theme(name)
 
         theme.update(self.config)
         return theme
 
-    def find_user_theme(self, name: str) -> Theme:
+    def find_user_theme(self, name: str) -> Theme | None:
         """Find a theme named as *name* from latex_theme_path."""
         for theme_path in self.theme_paths:
             config_path = path.join(theme_path, name, 'theme.conf')

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex/transforms.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/latex/transforms.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.builders.latex.transforms
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Transforms for LaTeX builder."""
 
-    Transforms for LaTeX builder.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, List, Set, Tuple, cast
+from typing import Any, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -16,9 +10,15 @@
 
 from sphinx import addnodes
 from sphinx.application import Sphinx
-from sphinx.builders.latex.nodes import (captioned_literal_block, footnotemark, footnotetext,
-                                         math_reference, thebibliography)
+from sphinx.builders.latex.nodes import (
+    captioned_literal_block,
+    footnotemark,
+    footnotetext,
+    math_reference,
+    thebibliography,
+)
 from sphinx.domains.citation import CitationDomain
+from sphinx.locale import __
 from sphinx.transforms import SphinxTransform
 from sphinx.transforms.post_transforms import SphinxPostTransform
 from sphinx.util.nodes import NodeMatcher
@@ -38,7 +38,7 @@
 
 
 class SubstitutionDefinitionsRemover(SphinxPostTransform):
-    """Remove ``substitution_definition node from doctrees."""
+    """Remove ``substitution_definition`` nodes from doctrees."""
 
     # should be invoked after Substitutions process
     default_priority = Substitutions.default_priority + 1
@@ -102,15 +102,22 @@
     def get_docname_for_node(self, node: Node) -> str:
         while node:
             if isinstance(node, nodes.document):
-                return self.env.path2doc(node'source')
+                return self.env.path2doc(node'source') or ''
             elif isinstance(node, addnodes.start_of_file):
                 return node'docname'
             else:
                 node = node.parent
 
-        return None  # never reached here. only for type hinting
-
-    def create_footnote(self, uri: str, docname: str) -> Tuplenodes.footnote, nodes.footnote_reference:  # NOQA
+        try:
+            source = node'source'  # type: ignoreindex
+        except TypeError:
+            raise ValueError(__('Failed to get a docname!')) from None
+        raise ValueError(__('Failed to get a docname '
+                            'for source {source!r}!').format(source=source))
+
+    def create_footnote(
+        self, uri: str, docname: str,
+    ) -> tuplenodes.footnote, nodes.footnote_reference:
         reference = nodes.reference('', nodes.Text(uri), refuri=uri, nolinkurl=True)
         footnote = nodes.footnote(uri, auto=1, docname=docname)
         footnote'names'.append('#')
@@ -157,9 +164,9 @@
     """Collect footnotes and footnote references on the document"""
 
     def __init__(self, document: nodes.document) -> None:
-        self.auto_footnotes: Listnodes.footnote = 
-        self.used_footnote_numbers: Setstr = set()
-        self.footnote_refs: Listnodes.footnote_reference = 
+        self.auto_footnotes: listnodes.footnote = 
+        self.used_footnote_numbers: setstr = set()
+        self.footnote_refs: listnodes.footnote_reference = 
         super().__init__(document)
 
     def unknown_visit(self, node: Node) -> None:
@@ -237,7 +244,8 @@
           blah blah blah ...
 
     * Replace second and subsequent footnote references which refers same footnote definition
-      by footnotemark node.
+      by footnotemark node.  Additionally, the footnote definition node is marked as
+      "referred".
 
       Before::
 
@@ -258,7 +266,7 @@
       After::
 
           blah blah blah
-          <footnote ids="id1">
+          <footnote ids="id1" referred=True>
               <label>
                   1
               <paragraph>
@@ -357,12 +365,12 @@
 
 
 class LaTeXFootnoteVisitor(nodes.NodeVisitor):
-    def __init__(self, document: nodes.document, footnotes: Listnodes.footnote) -> None:
-        self.appeared: SetTuplestr, str = set()
-        self.footnotes: Listnodes.footnote = footnotes
-        self.pendings: Listnodes.footnote = 
-        self.table_footnotes: Listnodes.footnote = 
-        self.restricted: Element = None
+    def __init__(self, document: nodes.document, footnotes: listnodes.footnote) -> None:
+        self.appeared: dicttuplestr, str, nodes.footnote = {}
+        self.footnotes: listnodes.footnote = footnotes
+        self.pendings: listnodes.footnote = 
+        self.table_footnotes: listnodes.footnote = 
+        self.restricted: Element | None = None
         super().__init__(document)
 
     def unknown_visit(self, node: Node) -> None:
@@ -439,22 +447,24 @@
     def visit_footnote_reference(self, node: nodes.footnote_reference) -> None:
         number = node.astext().strip()
         docname = node'docname'
-        if self.restricted:
-            mark = footnotemark('', number, refid=node'refid')
-            node.replace_self(mark)
-            if (docname, number) not in self.appeared:
-                footnote = self.get_footnote_by_reference(node)
-                self.pendings.append(footnote)
-        elif (docname, number) in self.appeared:
+        if (docname, number) in self.appeared:
+            footnote = self.appeared(docname, number)
+            footnote"referred" = True
+
             mark = footnotemark('', number, refid=node'refid')
             node.replace_self(mark)
         else:
             footnote = self.get_footnote_by_reference(node)
-            self.footnotes.remove(footnote)
-            node.replace_self(footnote)
-            footnote.walkabout(self)
+            if self.restricted:
+                mark = footnotemark('', number, refid=node'refid')
+                node.replace_self(mark)
+                self.pendings.append(footnote)
+            else:
+                self.footnotes.remove(footnote)
+                node.replace_self(footnote)
+                footnote.walkabout(self)
 
-        self.appeared.add((docname, number))
+            self.appeared(docname, number) = footnote
         raise nodes.SkipNode
 
     def get_footnote_by_reference(self, node: nodes.footnote_reference) -> nodes.footnote:
@@ -463,7 +473,7 @@
             if docname == footnote'docname' and footnote'ids'0 == node'refid':
                 return footnote
 
-        return None
+        raise ValueError(__('No footnote was found for given reference node %r') % node)
 
 
 class BibliographyTransform(SphinxPostTransform):
@@ -610,7 +620,7 @@
                     node.parent.insert(i + 1, index)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_transform(FootnoteDocnameUpdater)
     app.add_post_transform(SubstitutionDefinitionsRemover)
     app.add_post_transform(BibliographyTransform)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/latex/util.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/latex/util.py Changed

@@ -1,14 +1,6 @@
-"""
-    sphinx.builders.latex.util
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Utilities for LaTeX builder."""
 
-    Utilities for LaTeX builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Optional
+from __future__ import annotations
 
 from docutils.writers.latex2e import Babel
 
@@ -20,7 +12,7 @@
         self.language_code = language_code
         self.use_polyglossia = use_polyglossia
         self.supported = True
-        super().__init__(language_code or '')
+        super().__init__(language_code)
 
     def uses_cyrillic(self) -> bool:
         return self.language in self.cyrillic_languages
@@ -42,7 +34,7 @@
             self.supported = False
             return 'english'  # fallback to english
 
-    def get_mainlanguage_options(self) -> Optionalstr:
+    def get_mainlanguage_options(self) -> str | None:
         """Return options for polyglossia's ``\\setmainlanguage``."""
         if self.use_polyglossia is False:
             return None

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/linkcheck.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/linkcheck.py Changed

@@ -1,37 +1,28 @@
-"""
-    sphinx.builders.linkcheck
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The CheckExternalLinksBuilder class."""
 
-    The CheckExternalLinksBuilder class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import json
 import re
 import socket
 import time
-import warnings
+from copy import deepcopy
 from datetime import datetime, timezone
 from email.utils import parsedate_to_datetime
 from html.parser import HTMLParser
 from os import path
 from queue import PriorityQueue, Queue
 from threading import Thread
-from typing import (Any, Dict, Generator, List, NamedTuple, Optional, Pattern, Set, Tuple,
-                    Union, cast)
+from typing import Any, Generator, NamedTuple, Tuple, Union, cast
 from urllib.parse import unquote, urlparse, urlunparse
 
 from docutils import nodes
-from docutils.nodes import Element
 from requests import Response
 from requests.exceptions import ConnectionError, HTTPError, TooManyRedirects
 
 from sphinx.application import Sphinx
 from sphinx.builders.dummy import DummyBuilder
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.locale import __
 from sphinx.transforms.post_transforms import SphinxPostTransform
@@ -47,12 +38,12 @@
 class Hyperlink(NamedTuple):
     uri: str
     docname: str
-    lineno: Optionalint
+    lineno: int | None
 
 
 class CheckRequest(NamedTuple):
     next_check: float
-    hyperlink: OptionalHyperlink
+    hyperlink: Hyperlink | None
 
 
 class CheckResult(NamedTuple):
@@ -80,16 +71,6 @@
 DEFAULT_DELAY = 60.0
 
 
-def node_line_or_0(node: Element) -> int:
-    """
-    PriorityQueue items must be comparable. The line number is part of the
-    tuple used by the PriorityQueue, keep an homogeneous type for comparison.
-    """
-    warnings.warn('node_line_or_0() is deprecated.',
-                  RemovedInSphinx50Warning, stacklevel=2)
-    return get_node_line(node) or 0
-
-
 class AnchorCheckParser(HTMLParser):
     """Specialized HTML parser that looks for a specific anchor."""
 
@@ -133,120 +114,17 @@
                 '%(outdir)s/output.txt')
 
     def init(self) -> None:
-        self.hyperlinks: Dictstr, Hyperlink = {}
-        self._good: Setstr = set()
-        self._broken: Dictstr, str = {}
-        self._redirected: Dictstr, Tuplestr, int = {}
+        self.broken_hyperlinks = 0
+        self.hyperlinks: dictstr, Hyperlink = {}
         # set a timeout for non-responding servers
         socket.setdefaulttimeout(5.0)
 
-        # create queues and worker threads
-        self._wqueue: PriorityQueueCheckRequestType = PriorityQueue()
-        self._rqueue: QueueCheckResult = Queue()
-
-    @property
-    def anchors_ignore(self) -> ListPattern:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "anchors_ignore"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return re.compile(x) for x in self.config.linkcheck_anchors_ignore
-
-    @property
-    def auth(self) -> ListTuplePattern, Any:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "auth"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return (re.compile(pattern), auth_info) for pattern, auth_info
-                in self.config.linkcheck_auth
-
-    @property
-    def to_ignore(self) -> ListPattern:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "to_ignore"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return re.compile(x) for x in self.config.linkcheck_ignore
-
-    @property
-    def good(self) -> Setstr:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "good"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return self._good
-
-    @property
-    def broken(self) -> Dictstr, str:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "broken"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return self._broken
-
-    @property
-    def redirected(self) -> Dictstr, Tuplestr, int:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "redirected"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return self._redirected
-
-    def check_thread(self) -> None:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "check_thread"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        # do nothing.
-
-    def limit_rate(self, response: Response) -> Optionalfloat:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "limit_rate"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        worker = HyperlinkAvailabilityCheckWorker(self.env, self.config,
-                                                  None, None, {})
-        return worker.limit_rate(response)
-
-    def rqueue(self, response: Response) -> Queue:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "rqueue"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return self._rqueue
-
-    def workers(self, response: Response) -> ListThread:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "workers"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return 
-
-    def wqueue(self, response: Response) -> Queue:
-        warnings.warn(
-            "%s.%s is deprecated." % (self.__class__.__name__, "wqueue"),
-            RemovedInSphinx50Warning,
-            stacklevel=2,
-        )
-        return self._wqueue
-
     def process_result(self, result: CheckResult) -> None:
-        filename = self.env.doc2path(result.docname, None)
+        filename = self.env.doc2path(result.docname, False)
 
-        linkstat = dict(filename=filename, lineno=result.lineno,
-                        status=result.status, code=result.code, uri=result.uri,
-                        info=result.message)
+        linkstat = {"filename": filename, "lineno": result.lineno,
+                    "status": result.status, "code": result.code, "uri": result.uri,
+                    "info": result.message}
         self.write_linkstat(linkstat)
 
         if result.status == 'unchecked':
@@ -273,6 +151,7 @@
                 logger.info(red('broken    ') + result.uri + red(' - ' + result.message))
             self.write_entry('broken', result.docname, filename, result.lineno,
                              result.uri + ': ' + result.message)
+            self.broken_hyperlinks += 1
         elif result.status == 'redirected':
             try:
                 text, color = {
@@ -298,51 +177,43 @@
 
     def write_entry(self, what: str, docname: str, filename: str, line: int,
                     uri: str) -> None:
-        self.txt_outfile.write("%s:%s: %s %s\n" % (filename, line, what, uri))
+        self.txt_outfile.write(f"{filename}:{line}: {what} {uri}\n")
 
     def write_linkstat(self, data: dict) -> None:
         self.json_outfile.write(json.dumps(data))
         self.json_outfile.write('\n')
 
     def finish(self) -> None:
-        checker = HyperlinkAvailabilityChecker(self.env, self.config, self)
+        checker = HyperlinkAvailabilityChecker(self.env, self.config)
         logger.info('')
 
-        with open(path.join(self.outdir, 'output.txt'), 'w') as self.txt_outfile,\
-             open(path.join(self.outdir, 'output.json'), 'w') as self.json_outfile:
+        output_text = path.join(self.outdir, 'output.txt')
+        output_json = path.join(self.outdir, 'output.json')
+        with open(output_text, 'w', encoding="utf-8") as self.txt_outfile,\
+             open(output_json, 'w', encoding="utf-8") as self.json_outfile:
             for result in checker.check(self.hyperlinks):
                 self.process_result(result)
 
-        if self._broken:
+        if self.broken_hyperlinks:
             self.app.statuscode = 1
 
 
 class HyperlinkAvailabilityChecker:
-    def __init__(self, env: BuildEnvironment, config: Config,
-                 builder: CheckExternalLinksBuilder = None) -> None:
-        # Warning: builder argument will be removed in the sphinx-5.0.
-        # Don't use it from extensions.
-        # tag: RemovedInSphinx50Warning
-        self.builder = builder
+    def __init__(self, env: BuildEnvironment, config: Config) -> None:
         self.config = config
         self.env = env
-        self.rate_limits: Dictstr, RateLimit = {}
-        self.workers: ListThread = 
+        self.rate_limits: dictstr, RateLimit = {}
+        self.rqueue: QueueCheckResult = Queue()
+        self.workers: listThread = 
+        self.wqueue: PriorityQueueCheckRequest = PriorityQueue()
 
         self.to_ignore = re.compile(x) for x in self.config.linkcheck_ignore
 
-        if builder:
-            self.rqueue = builder._rqueue
-            self.wqueue = builder._wqueue
-        else:
-            self.rqueue = Queue()
-            self.wqueue = PriorityQueue()
-
     def invoke_threads(self) -> None:
         for _i in range(self.config.linkcheck_workers):
             thread = HyperlinkAvailabilityCheckWorker(self.env, self.config,
                                                       self.rqueue, self.wqueue,
-                                                      self.rate_limits, self.builder)
+                                                      self.rate_limits)
             thread.start()
             self.workers.append(thread)
 
@@ -351,7 +222,7 @@
         for _worker in self.workers:
             self.wqueue.put(CheckRequest(CHECK_IMMEDIATELY, None), False)
 
-    def check(self, hyperlinks: Dictstr, Hyperlink) -> GeneratorCheckResult, None, None:
+    def check(self, hyperlinks: dictstr, Hyperlink) -> GeneratorCheckResult, None, None:
         self.invoke_threads()
 
         total_links = 0
@@ -377,12 +248,8 @@
 class HyperlinkAvailabilityCheckWorker(Thread):
     """A worker class for checking the availability of hyperlinks."""
 
-    def __init__(self, env: BuildEnvironment, config: Config, rqueue: Queue,
-                 wqueue: Queue, rate_limits: Dictstr, RateLimit,
-                 builder: CheckExternalLinksBuilder = None) -> None:
-        # Warning: builder argument will be removed in the sphinx-5.0.
-        # Don't use it from extensions.
-        # tag: RemovedInSphinx50Warning
+    def __init__(self, env: BuildEnvironment, config: Config, rqueue: QueueCheckResult,
+                 wqueue: QueueCheckRequest, rate_limits: dictstr, RateLimit) -> None:
         self.config = config
         self.env = env
         self.rate_limits = rate_limits
@@ -396,17 +263,6 @@
         self.auth = (re.compile(pattern), auth_info) for pattern, auth_info
                      in self.config.linkcheck_auth
 
-        if builder:
-            # if given, fill the result of checks as cache
-            self._good = builder._good
-            self._broken = builder._broken
-            self._redirected = builder._redirected
-        else:
-            # only for compatibility. Will be removed in Sphinx-5.0
-            self._good = set()
-            self._broken = {}
-            self._redirected = {}
-
         super().__init__(daemon=True)
 
     def run(self) -> None:
@@ -414,22 +270,22 @@
         if self.config.linkcheck_timeout:
             kwargs'timeout' = self.config.linkcheck_timeout
 
-        def get_request_headers() -> Dict:
+        def get_request_headers() -> dictstr, str:
             url = urlparse(uri)
-            candidates = "%s://%s" % (url.scheme, url.netloc),
-                          "%s://%s/" % (url.scheme, url.netloc),
+            candidates = f"{url.scheme}://{url.netloc}",
+                          f"{url.scheme}://{url.netloc}/",
                           uri,
                           "*"
 
             for u in candidates:
                 if u in self.config.linkcheck_request_headers:
-                    headers = dict(DEFAULT_REQUEST_HEADERS)
+                    headers = deepcopy(DEFAULT_REQUEST_HEADERS)
                     headers.update(self.config.linkcheck_request_headersu)
                     return headers
 
             return {}
 
-        def check_uri() -> Tuplestr, str, int:
+        def check_uri() -> tuplestr, str, int:
             # split off anchor
             if '#' in uri:
                 req_url, anchor = uri.split('#', 1)
@@ -448,7 +304,7 @@
                 req_url = encode_uri(req_url)
 
             # Get auth info, if any
-            for pattern, auth_info in self.auth:
+            for pattern, auth_info in self.auth:  # noqa: B007 (false positive)
                 if pattern.match(uri):
                     break
             else:
@@ -460,10 +316,10 @@
             try:
                 if anchor and self.config.linkcheck_anchors:
                     # Read the whole document and see if #anchor exists
-                    response = requests.get(req_url, stream=True, config=self.config,
-                                            auth=auth_info, **kwargs)
-                    response.raise_for_status()
-                    found = check_anchor(response, unquote(anchor))
+                    with requests.get(req_url, stream=True, config=self.config, auth=auth_info,
+                                      **kwargs) as response:
+                        response.raise_for_status()
+                        found = check_anchor(response, unquote(anchor))
 
                     if not found:
                         raise Exception(__("Anchor '%s' not found") % anchor)
@@ -471,10 +327,9 @@
                     try:
                         # try a HEAD request first, which should be easier on
                         # the server and the network
-                        response = requests.head(req_url, allow_redirects=True,
-                                                 config=self.config, auth=auth_info,
-                                                 **kwargs)
-                        response.raise_for_status()
+                        with requests.head(req_url, allow_redirects=True, config=self.config,
+                                           auth=auth_info, **kwargs) as response:
+                            response.raise_for_status()
                     # Servers drop the connection on HEAD requests, causing
                     # ConnectionError.
                     except (ConnectionError, HTTPError, TooManyRedirects) as err:
@@ -482,10 +337,9 @@
                             raise
                         # retry with GET request if that fails, some servers
                         # don't like HEAD requests.
-                        response = requests.get(req_url, stream=True,
-                                                config=self.config,
-                                                auth=auth_info, **kwargs)
-                        response.raise_for_status()
+                        with requests.get(req_url, stream=True, config=self.config,
+                                          auth=auth_info, **kwargs) as response:
+                            response.raise_for_status()
             except HTTPError as err:
                 if err.response.status_code == 401:
                     # We'll take "Unauthorized" as working.
@@ -526,13 +380,13 @@
                     return 'redirected', new_url, 0
 
         def allowed_redirect(url: str, new_url: str) -> bool:
-            for from_url, to_url in self.config.linkcheck_allowed_redirects.items():
-                if from_url.match(url) and to_url.match(new_url):
-                    return True
+            return any(
+                from_url.match(url) and to_url.match(new_url)
+                for from_url, to_url
+                in self.config.linkcheck_allowed_redirects.items()
+            )
 
-            return False
-
-        def check(docname: str) -> Tuplestr, str, int:
+        def check(docname: str) -> tuplestr, str, int:
             # check for various conditions without bothering the network
 
             for doc_matcher in self.documents_exclude:
@@ -554,14 +408,7 @@
                     if path.exists(path.join(srcdir, uri)):
                         return 'working', '', 0
                     else:
-                        self._brokenuri = ''
                         return 'broken', '', 0
-            elif uri in self._good:
-                return 'working', 'old', 0
-            elif uri in self._broken:
-                return 'broken', self._brokenuri, 0
-            elif uri in self._redirected:
-                return 'redirected', self._redirecteduri0, self._redirecteduri1
 
             # need to actually check the URI
             for _ in range(self.config.linkcheck_retries):
@@ -569,26 +416,15 @@
                 if status != "broken":
                     break
 
-            if status == "working":
-                self._good.add(uri)
-            elif status == "broken":
-                self._brokenuri = info
-            elif status == "redirected":
-                self._redirecteduri = (info, code)
-
             return (status, info, code)
 
         while True:
             check_request = self.wqueue.get()
-            try:
-                next_check, hyperlink = check_request
-                if hyperlink is None:
-                    break
+            next_check, hyperlink = check_request
+            if hyperlink is None:
+                break
 
-                uri, docname, lineno = hyperlink
-            except ValueError:
-                # old styled check_request (will be deprecated in Sphinx-5.0)
-                next_check, uri, docname, lineno = check_request
+            uri, docname, lineno = hyperlink
 
             if uri is None:
                 break
@@ -615,7 +451,7 @@
                 self.rqueue.put(CheckResult(uri, docname, lineno, status, info, code))
             self.wqueue.task_done()
 
-    def limit_rate(self, response: Response) -> Optionalfloat:
+    def limit_rate(self, response: Response) -> float | None:
         next_check = None
         retry_after = response.headers.get("Retry-After")
         if retry_after:
@@ -662,35 +498,40 @@
         builder = cast(CheckExternalLinksBuilder, self.app.builder)
         hyperlinks = builder.hyperlinks
 
-        # reference nodes
-        for refnode in self.document.findall(nodes.reference):
-            if 'refuri' not in refnode:
-                continue
-            uri = refnode'refuri'
+        def add_uri(uri: str, node: nodes.Element) -> None:
             newuri = self.app.emit_firstresult('linkcheck-process-uri', uri)
             if newuri:
                 uri = newuri
 
-            lineno = get_node_line(refnode)
+            try:
+                lineno = get_node_line(node)
+            except ValueError:
+                lineno = None
             uri_info = Hyperlink(uri, self.env.docname, lineno)
             if uri not in hyperlinks:
                 hyperlinksuri = uri_info
 
+        # reference nodes
+        for refnode in self.document.findall(nodes.reference):
+            if 'refuri' not in refnode:
+                continue
+            uri = refnode'refuri'
+            add_uri(uri, refnode)
+
         # image nodes
         for imgnode in self.document.findall(nodes.image):
             uri = imgnode'candidates'.get('?')
             if uri and '://' in uri:
-                newuri = self.app.emit_firstresult('linkcheck-process-uri', uri)
-                if newuri:
-                    uri = newuri
+                add_uri(uri, imgnode)
 
-                lineno = get_node_line(imgnode)
-                uri_info = Hyperlink(uri, self.env.docname, lineno)
-                if uri not in hyperlinks:
-                    hyperlinksuri = uri_info
+        # raw nodes
+        for rawnode in self.document.findall(nodes.raw):
+            uri = rawnode.get('source')
+            if uri and '://' in uri:
+                add_uri(uri, rawnode)
 
 
-def rewrite_github_anchor(app: Sphinx, uri: str) -> Optionalstr:
+def rewrite_github_anchor(app: Sphinx, uri: str) -> str | None:
     """Rewrite anchor name of the hyperlink to github.com
 
     The hyperlink anchors in github.com are dynamically generated.  This rewrites
@@ -718,23 +559,23 @@
             app.config.linkcheck_allowed_redirects.pop(url)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(CheckExternalLinksBuilder)
     app.add_post_transform(HyperlinkCollector)
 
-    app.add_config_value('linkcheck_ignore', , None)
-    app.add_config_value('linkcheck_exclude_documents', , None)
-    app.add_config_value('linkcheck_allowed_redirects', {}, None)
-    app.add_config_value('linkcheck_auth', , None)
-    app.add_config_value('linkcheck_request_headers', {}, None)
-    app.add_config_value('linkcheck_retries', 1, None)
-    app.add_config_value('linkcheck_timeout', None, None, int)
-    app.add_config_value('linkcheck_workers', 5, None)
-    app.add_config_value('linkcheck_anchors', True, None)
+    app.add_config_value('linkcheck_ignore', , False)
+    app.add_config_value('linkcheck_exclude_documents', , False)
+    app.add_config_value('linkcheck_allowed_redirects', {}, False)
+    app.add_config_value('linkcheck_auth', , False)
+    app.add_config_value('linkcheck_request_headers', {}, False)
+    app.add_config_value('linkcheck_retries', 1, False)
+    app.add_config_value('linkcheck_timeout', None, False, int, float)
+    app.add_config_value('linkcheck_workers', 5, False)
+    app.add_config_value('linkcheck_anchors', True, False)
     # Anchors starting with ! are ignored since they are
     # commonly used for dynamic pages
-    app.add_config_value('linkcheck_anchors_ignore', "^!", None)
-    app.add_config_value('linkcheck_rate_limit_timeout', 300.0, None)
+    app.add_config_value('linkcheck_anchors_ignore', "^!", False)
+    app.add_config_value('linkcheck_rate_limit_timeout', 300.0, False)
 
     app.add_event('linkcheck-process-uri')

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/manpage.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/manpage.py Changed

@@ -1,15 +1,10 @@
-"""
-    sphinx.builders.manpage
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""Manual pages builder."""
 
-    Manual pages builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import warnings
 from os import path
-from typing import Any, Dict, List, Set, Tuple, Union
+from typing import Any
 
 from docutils.frontend import OptionParser
 from docutils.io import FileOutput
@@ -18,10 +13,10 @@
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.config import Config
-from sphinx.errors import NoUri
 from sphinx.locale import __
-from sphinx.util import logging, progress_message
+from sphinx.util import logging
 from sphinx.util.console import darkgreen  # type: ignore
+from sphinx.util.display import progress_message
 from sphinx.util.nodes import inline_all_toctrees
 from sphinx.util.osutil import ensuredir, make_filename_from_project
 from sphinx.writers.manpage import ManualPageTranslator, ManualPageWriter
@@ -38,28 +33,30 @@
     epilog = __('The manual pages are in %(outdir)s.')
 
     default_translator_class = ManualPageTranslator
-    supported_image_types: Liststr = 
+    supported_image_types: liststr = 
 
     def init(self) -> None:
         if not self.config.man_pages:
             logger.warning(__('no "man_pages" config value found; no manual pages '
                               'will be written'))
 
-    def get_outdated_docs(self) -> Unionstr, Liststr:
+    def get_outdated_docs(self) -> str | liststr:
         return 'all manpages'  # for now
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
-        if typ == 'token':
-            return ''
-        raise NoUri(docname, typ)
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
+        return ''
 
     @progress_message(__('writing'))
     def write(self, *ignored: Any) -> None:
         docwriter = ManualPageWriter(self)
-        docsettings: Any = OptionParser(
-            defaults=self.env.settings,
-            components=(docwriter,),
-            read_config_files=True).get_default_values()
+        with warnings.catch_warnings():
+            warnings.filterwarnings('ignore', category=DeprecationWarning)
+            # DeprecationWarning: The frontend.OptionParser class will be replaced
+            # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+            docsettings: Any = OptionParser(
+                defaults=self.env.settings,
+                components=(docwriter,),
+                read_config_files=True).get_default_values()
 
         for info in self.config.man_pages:
             docname, name, description, authors, section = info
@@ -81,9 +78,9 @@
             if self.config.man_make_section_directory:
                 dirname = 'man%s' % section
                 ensuredir(path.join(self.outdir, dirname))
-                targetname = '%s/%s.%s' % (dirname, name, section)
+                targetname = f'{dirname}/{name}.{section}'
             else:
-                targetname = '%s.%s' % (name, section)
+                targetname = f'{name}.{section}'
 
             logger.info(darkgreen(targetname) + ' { ', nonl=True)
             destination = FileOutput(
@@ -91,7 +88,7 @@
                 encoding='utf-8')
 
             tree = self.env.get_doctree(docname)
-            docnames: Setstr = set()
+            docnames: setstr = set()
             largetree = inline_all_toctrees(self, docnames, docname, tree,
                                             darkgreen, docname)
             largetree.settings = docsettings
@@ -107,19 +104,19 @@
         pass
 
 
-def default_man_pages(config: Config) -> ListTuplestr, str, str, Liststr, int:
+def default_man_pages(config: Config) -> listtuplestr, str, str, liststr, int:
     """ Better default man_pages settings. """
     filename = make_filename_from_project(config.project)
-    return (config.root_doc, filename, '%s %s' % (config.project, config.release),
+    return (config.root_doc, filename, f'{config.project} {config.release}',
              config.author, 1)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(ManualPageBuilder)
 
-    app.add_config_value('man_pages', default_man_pages, None)
-    app.add_config_value('man_show_urls', False, None)
-    app.add_config_value('man_make_section_directory', False, None)
+    app.add_config_value('man_pages', default_man_pages, False)
+    app.add_config_value('man_show_urls', False, False)
+    app.add_config_value('man_make_section_directory', False, False)
 
     return {
         'version': 'builtin',

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/singlehtml.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/singlehtml.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.builders.singlehtml
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Single HTML builders."""
 
-    Single HTML builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from os import path
-from typing import Any, Dict, List, Tuple, Union
+from typing import Any
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -18,8 +12,9 @@
 from sphinx.builders.html import StandaloneHTMLBuilder
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.locale import __
-from sphinx.util import logging, progress_message
+from sphinx.util import logging
 from sphinx.util.console import darkgreen  # type: ignore
+from sphinx.util.display import progress_message
 from sphinx.util.nodes import inline_all_toctrees
 
 logger = logging.getLogger(__name__)
@@ -35,10 +30,10 @@
 
     copysource = False
 
-    def get_outdated_docs(self) -> Unionstr, Liststr:  # type: ignore
+    def get_outdated_docs(self) -> str | liststr:  # type: ignoreoverride
         return 'all documents'
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         if docname in self.env.all_docs:
             # all references are on the same page...
             return self.config.root_doc + self.out_suffix + \
@@ -47,7 +42,7 @@
             # chances are this is a html_additional_page
             return docname + self.out_suffix
 
-    def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str:
+    def get_relative_uri(self, from_: str, to: str, typ: str | None = None) -> str:
         # ignore source
         return self.get_target_uri(to, typ)
 
@@ -82,7 +77,7 @@
         self.fix_refuris(tree)
         return tree
 
-    def assemble_toc_secnumbers(self) -> Dictstr, Dictstr, Tupleint, ...:
+    def assemble_toc_secnumbers(self) -> dictstr, dictstr, tupleint, ...:
         # Assemble toc_secnumbers to resolve section numbers on SingleHTML.
         # Merge all secnumbers to single secnumber.
         #
@@ -92,15 +87,15 @@
         #
         #       There are related codes in inline_all_toctres() and
         #       HTMLTranslter#add_secnumber().
-        new_secnumbers: Dictstr, Tupleint, ... = {}
+        new_secnumbers: dictstr, tupleint, ... = {}
         for docname, secnums in self.env.toc_secnumbers.items():
             for id, secnum in secnums.items():
-                alias = "%s/%s" % (docname, id)
+                alias = f"{docname}/{id}"
                 new_secnumbersalias = secnum
 
         return {self.config.root_doc: new_secnumbers}
 
-    def assemble_toc_fignumbers(self) -> Dictstr, Dictstr, Dictstr, Tupleint, ...:
+    def assemble_toc_fignumbers(self) -> dictstr, dictstr, dictstr, tupleint, ...:
         # Assemble toc_fignumbers to resolve figure numbers on SingleHTML.
         # Merge all fignumbers to single fignumber.
         #
@@ -110,18 +105,18 @@
         #
         #       There are related codes in inline_all_toctres() and
         #       HTMLTranslter#add_fignumber().
-        new_fignumbers: Dictstr, Dictstr, Tupleint, ... = {}
+        new_fignumbers: dictstr, dictstr, tupleint, ... = {}
         # {'foo': {'figure': {'id2': (2,), 'id1': (1,)}}, 'bar': {'figure': {'id1': (3,)}}}
         for docname, fignumlist in self.env.toc_fignumbers.items():
             for figtype, fignums in fignumlist.items():
-                alias = "%s/%s" % (docname, figtype)
+                alias = f"{docname}/{figtype}"
                 new_fignumbers.setdefault(alias, {})
                 for id, fignum in fignums.items():
                     new_fignumbersaliasid = fignum
 
         return {self.config.root_doc: new_fignumbers}
 
-    def get_doc_context(self, docname: str, body: str, metatags: str) -> Dict:
+    def get_doc_context(self, docname: str, body: str, metatags: str) -> dictstr, Any:
         # no relation links...
         toctree = TocTree(self.env).get_toctree_for(self.config.root_doc, self, False)
         # if there is no toctree, toc is None
@@ -186,7 +181,7 @@
             self.handle_page('opensearch', {}, 'opensearch.xml', outfilename=fn)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.setup_extension('sphinx.builders.html')
 
     app.add_builder(SingleFileHTMLBuilder)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/texinfo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/texinfo.py Changed

@@ -1,16 +1,11 @@
-"""
-    sphinx.builders.texinfo
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""Texinfo builder."""
 
-    Texinfo builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
+import warnings
 from os import path
-from typing import Any, Dict, Iterable, List, Tuple, Union
+from typing import Any, Iterable
 
 from docutils import nodes
 from docutils.frontend import OptionParser
@@ -24,8 +19,9 @@
 from sphinx.environment.adapters.asset import ImageAdapter
 from sphinx.errors import NoUri
 from sphinx.locale import _, __
-from sphinx.util import logging, progress_message, status_iterator
+from sphinx.util import logging
 from sphinx.util.console import darkgreen  # type: ignore
+from sphinx.util.display import progress_message, status_iterator
 from sphinx.util.docutils import new_document
 from sphinx.util.fileutil import copy_asset_file
 from sphinx.util.nodes import inline_all_toctrees
@@ -54,18 +50,17 @@
 
     def init(self) -> None:
         self.docnames: Iterablestr = 
-        self.document_data: ListTuplestr, str, str, str, str, str, str, bool = 
+        self.document_data: listtuplestr, str, str, str, str, str, str, bool = 
 
-    def get_outdated_docs(self) -> Unionstr, Liststr:
+    def get_outdated_docs(self) -> str | liststr:
         return 'all documents'  # for now
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         if docname not in self.docnames:
             raise NoUri(docname, typ)
-        else:
-            return '%' + docname
+        return '%' + docname
 
-    def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str:
+    def get_relative_uri(self, from_: str, to: str, typ: str | None = None) -> str:
         # ignore source path
         return self.get_target_uri(to, typ)
 
@@ -76,7 +71,7 @@
                               'will be written'))
             return
         # assign subdirs to titles
-        self.titles: ListTuplestr, str = 
+        self.titles: listtuplestr, str = 
         for entry in preliminary_document_data:
             docname = entry0
             if docname not in self.env.all_docs:
@@ -109,10 +104,14 @@
             with progress_message(__("writing")):
                 self.post_process_images(doctree)
                 docwriter = TexinfoWriter(self)
-                settings: Any = OptionParser(
-                    defaults=self.env.settings,
-                    components=(docwriter,),
-                    read_config_files=True).get_default_values()
+                with warnings.catch_warnings():
+                    warnings.filterwarnings('ignore', category=DeprecationWarning)
+                    # DeprecationWarning: The frontend.OptionParser class will be replaced
+                    # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+                    settings: Any = OptionParser(
+                        defaults=self.env.settings,
+                        components=(docwriter,),
+                        read_config_files=True).get_default_values()
                 settings.author = author
                 settings.title = title
                 settings.texinfo_filename = targetname:-5 + '.info'
@@ -125,7 +124,9 @@
                 docwriter.write(doctree, destination)
                 self.copy_image_files(targetname:-5)
 
-    def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: Liststr) -> nodes.document:  # NOQA
+    def assemble_doctree(
+        self, indexfile: str, toctree_only: bool, appendices: liststr,
+    ) -> nodes.document:
         self.docnames = set(indexfile + appendices)
         logger.info(darkgreen(indexfile) + " ", nonl=True)
         tree = self.env.get_doctree(indexfile)
@@ -155,12 +156,12 @@
         for pendingnode in largetree.findall(addnodes.pending_xref):
             docname = pendingnode'refdocname'
             sectname = pendingnode'refsectname'
-            newnodes: ListNode = nodes.emphasis(sectname, sectname)
+            newnodes: listNode = nodes.emphasis(sectname, sectname)
             for subdir, title in self.titles:
                 if docname.startswith(subdir):
-                    newnodes.append(nodes.Text(_(' (in '), _(' (in ')))
+                    newnodes.append(nodes.Text(_(' (in ')))
                     newnodes.append(nodes.emphasis(title, title))
-                    newnodes.append(nodes.Text(')', ')'))
+                    newnodes.append(nodes.Text(')'))
                     break
             else:
                 pass
@@ -195,23 +196,25 @@
             logger.warning(__("error writing file Makefile: %s"), err)
 
 
-def default_texinfo_documents(config: Config) -> ListTuplestr, str, str, str, str, str, str:  # NOQA
+def default_texinfo_documents(
+    config: Config,
+) -> listtuplestr, str, str, str, str, str, str:
     """ Better default texinfo_documents settings. """
     filename = make_filename_from_project(config.project)
     return (config.root_doc, filename, config.project, config.author, filename,
              'One line description of project', 'Miscellaneous')
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(TexinfoBuilder)
 
-    app.add_config_value('texinfo_documents', default_texinfo_documents, None)
-    app.add_config_value('texinfo_appendices', , None)
-    app.add_config_value('texinfo_elements', {}, None)
-    app.add_config_value('texinfo_domain_indices', True, None, list)
-    app.add_config_value('texinfo_show_urls', 'footnote', None)
-    app.add_config_value('texinfo_no_detailmenu', False, None)
-    app.add_config_value('texinfo_cross_references', True, None)
+    app.add_config_value('texinfo_documents', default_texinfo_documents, False)
+    app.add_config_value('texinfo_appendices', , False)
+    app.add_config_value('texinfo_elements', {}, False)
+    app.add_config_value('texinfo_domain_indices', True, False, list)
+    app.add_config_value('texinfo_show_urls', 'footnote', False)
+    app.add_config_value('texinfo_no_detailmenu', False, False)
+    app.add_config_value('texinfo_cross_references', True, False)
 
     return {
         'version': 'builtin',

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/text.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/text.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.builders.text
-    ~~~~~~~~~~~~~~~~~~~~
+"""Plain-text Sphinx builder."""
 
-    Plain-text Sphinx builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from os import path
-from typing import Any, Dict, Iterator, Set, Tuple
+from typing import Any, Iterator
 
 from docutils.io import StringOutput
 from docutils.nodes import Node
@@ -33,11 +27,11 @@
     allow_parallel = True
     default_translator_class = TextTranslator
 
-    current_docname: str = None
+    current_docname: str | None = None
 
     def init(self) -> None:
         # section numbers for headings in the currently visited document
-        self.secnumbers: Dictstr, Tupleint, ... = {}
+        self.secnumbers: dictstr, tupleint, ... = {}
 
     def get_outdated_docs(self) -> Iteratorstr:
         for docname in self.env.found_docs:
@@ -57,10 +51,10 @@
                 # source doesn't exist anymore
                 pass
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         return ''
 
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         self.writer = TextWriter(self)
 
     def write_doc(self, docname: str, doctree: Node) -> None:
@@ -80,7 +74,7 @@
         pass
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(TextBuilder)
 
     app.add_config_value('text_sectionchars', '*=-~"+`', 'env')

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/builders/xml.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/builders/xml.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.builders.xml
-    ~~~~~~~~~~~~~~~~~~~
+"""Docutils-native XML and pseudo-XML builders."""
 
-    Docutils-native XML and pseudo-XML builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from os import path
-from typing import Any, Dict, Iterator, Set, Type, Union
+from typing import Any, Iterator
 
 from docutils import nodes
 from docutils.io import StringOutput
@@ -37,7 +31,7 @@
     out_suffix = '.xml'
     allow_parallel = True
 
-    _writer_class: UnionTypeXMLWriter, TypePseudoXMLWriter = XMLWriter
+    _writer_class: typeXMLWriter | typePseudoXMLWriter = XMLWriter
     default_translator_class = XMLTranslator
 
     def init(self) -> None:
@@ -61,10 +55,10 @@
                 # source doesn't exist anymore
                 pass
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         return docname
 
-    def prepare_writing(self, docnames: Setstr) -> None:
+    def prepare_writing(self, docnames: setstr) -> None:
         self.writer = self._writer_class(self)
 
     def write_doc(self, docname: str, doctree: Node) -> None:
@@ -110,7 +104,7 @@
     _writer_class = PseudoXMLWriter
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(XMLBuilder)
     app.add_builder(PseudoXMLBuilder)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/cmd/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/cmd/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/cmd/build.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/cmd/build.py Changed

@@ -1,38 +1,35 @@
-"""
-    sphinx.cmd.build
-    ~~~~~~~~~~~~~~~~
+"""Build documentation from a provided source."""
 
-    Build documentation from a provided source.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import argparse
 import bdb
 import locale
 import multiprocessing
 import os
-import pdb
+import pdb  # NoQA: T100
 import sys
 import traceback
 from os import path
-from typing import IO, Any, List
+from typing import Any, TextIO
 
 from docutils.utils import SystemMessage
 
 import sphinx.locale
-from sphinx import __display_version__, package_dir
+from sphinx import __display_version__
 from sphinx.application import Sphinx
 from sphinx.errors import SphinxError
 from sphinx.locale import __
-from sphinx.util import Tee, format_exception_cut_frames, save_traceback
+from sphinx.util import Tee
 from sphinx.util.console import color_terminal, nocolor, red, terminal_safe  # type: ignore
 from sphinx.util.docutils import docutils_namespace, patch_docutils
+from sphinx.util.exceptions import format_exception_cut_frames, save_traceback
 from sphinx.util.osutil import abspath, ensuredir
 
 
-def handle_exception(app: Sphinx, args: Any, exception: BaseException, stderr: IO = sys.stderr) -> None:  # NOQA
+def handle_exception(
+    app: Sphinx | None, args: Any, exception: BaseException, stderr: TextIO = sys.stderr,
+) -> None:
     if isinstance(exception, bdb.BdbQuit):
         return
 
@@ -57,7 +54,7 @@
         elif isinstance(exception, UnicodeError):
             print(red(__('Encoding error:')), file=stderr)
             print(terminal_safe(str(exception)), file=stderr)
-            tbpath = save_traceback(app)
+            tbpath = save_traceback(app, exception)
             print(red(__('The full traceback has been saved in %s, if you want '
                          'to report the issue to the developers.') % tbpath),
                   file=stderr)
@@ -72,7 +69,7 @@
         else:
             print(red(__('Exception occurred:')), file=stderr)
             print(format_exception_cut_frames().rstrip(), file=stderr)
-            tbpath = save_traceback(app)
+            tbpath = save_traceback(app, exception)
             print(red(__('The full traceback has been saved in %s, if you '
                          'want to report the issue to the developers.') % tbpath),
                   file=stderr)
@@ -140,12 +137,13 @@
                        help=__('write all files (default: only write new and '
                                'changed files)'))
     group.add_argument('-E', action='store_true', dest='freshenv',
-                       help=__('don\'t use a saved environment, always read '
+                       help=__("don't use a saved environment, always read "
                                'all files'))
     group.add_argument('-d', metavar='PATH', dest='doctreedir',
                        help=__('path for the cached environment and doctree '
                                'files (default: OUTPUTDIR/.doctrees)'))
-    group.add_argument('-j', metavar='N', default=1, type=jobs_argument, dest='jobs',
+    group.add_argument('-j', '--jobs', metavar='N', default=1, type=jobs_argument,
+                       dest='jobs',
                        help=__('build in parallel with N processes where '
                                'possible (special value "auto" will set N to cpu-count)'))
     group = parser.add_argument_group('build configuration options')
@@ -195,15 +193,13 @@
     return parser
 
 
-def make_main(argv: Liststr = sys.argv1:) -> int:
+def make_main(argv: liststr = sys.argv1:) -> int:
     """Sphinx build "make mode" entry."""
     from sphinx.cmd import make_mode
     return make_mode.run_make_mode(argv1:)
 
 
-def build_main(argv: Liststr = sys.argv1:) -> int:
-    """Sphinx build "main" command-line entry."""
-
+def _parse_arguments(argv: liststr = sys.argv1:) -> argparse.Namespace:
     parser = get_parser()
     args = parser.parse_args(argv)
 
@@ -215,23 +211,14 @@
     if not args.doctreedir:
         args.doctreedir = os.path.join(args.outputdir, '.doctrees')
 
-    # handle remaining filename arguments
-    filenames = args.filenames
-    missing_files = 
-    for filename in filenames:
-        if not os.path.isfile(filename):
-            missing_files.append(filename)
-    if missing_files:
-        parser.error(__('cannot find files %r') % missing_files)
-
-    if args.force_all and filenames:
+    if args.force_all and args.filenames:
         parser.error(__('cannot combine -a option and filenames'))
 
     if args.color == 'no' or (args.color == 'auto' and not color_terminal()):
         nocolor()
 
-    status = sys.stdout
-    warning = sys.stderr
+    status: TextIO | None = sys.stdout
+    warning: TextIO | None = sys.stderr
     error = sys.stderr
 
     if args.quiet:
@@ -244,13 +231,17 @@
         try:
             warnfile = abspath(args.warnfile)
             ensuredir(path.dirname(warnfile))
-            warnfp = open(args.warnfile, 'w')
+            warnfp = open(args.warnfile, 'w', encoding="utf-8")
         except Exception as exc:
             parser.error(__('cannot open warning file %r: %s') % (
                 args.warnfile, exc))
         warning = Tee(warning, warnfp)  # type: ignore
         error = warning
 
+    args.status = status
+    args.warning = warning
+    args.error = error
+
     confoverrides = {}
     for val in args.define:
         try:
@@ -273,25 +264,57 @@
     if args.nitpicky:
         confoverrides'nitpicky' = True
 
+    args.confoverrides = confoverrides
+
+    return args
+
+
+def build_main(argv: liststr = sys.argv1:) -> int:
+    """Sphinx build "main" command-line entry."""
+    args = _parse_arguments(argv)
+
     app = None
     try:
         confdir = args.confdir or args.sourcedir
         with patch_docutils(confdir), docutils_namespace():
             app = Sphinx(args.sourcedir, args.confdir, args.outputdir,
-                         args.doctreedir, args.builder, confoverrides, status,
-                         warning, args.freshenv, args.warningiserror,
-                         args.tags, args.verbosity, args.jobs, args.keep_going)
-            app.build(args.force_all, filenames)
+                         args.doctreedir, args.builder, args.confoverrides, args.status,
+                         args.warning, args.freshenv, args.warningiserror,
+                         args.tags, args.verbosity, args.jobs, args.keep_going,
+                         args.pdb)
+            app.build(args.force_all, args.filenames)
             return app.statuscode
     except (Exception, KeyboardInterrupt) as exc:
-        handle_exception(app, args, exc, error)
+        handle_exception(app, args, exc, args.error)
         return 2
 
 
-def main(argv: Liststr = sys.argv1:) -> int:
-    sphinx.locale.setlocale(locale.LC_ALL, '')
-    sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx')
+def _bug_report_info() -> int:
+    from platform import platform, python_implementation
+
+    import docutils
+    import jinja2
+    import pygments
+
+    print('Please paste all output below into the bug report template\n\n')
+    print('```text')
+    print(f'Platform:              {sys.platform}; ({platform()})')
+    print(f'Python version:        {sys.version})')
+    print(f'Python implementation: {python_implementation()}')
+    print(f'Sphinx version:        {sphinx.__display_version__}')
+    print(f'Docutils version:      {docutils.__version__}')
+    print(f'Jinja2 version:        {jinja2.__version__}')
+    print(f'Pygments version:      {pygments.__version__}')
+    print('```')
+    return 0
+
+
+def main(argv: liststr = sys.argv1:) -> int:
+    locale.setlocale(locale.LC_ALL, '')
+    sphinx.locale.init_console()
 
+    if argv:1 == '--bug-report':
+        return _bug_report_info()
     if argv:1 == '-M':
         return make_main(argv)
     else:
@@ -299,4 +322,4 @@
 
 
 if __name__ == '__main__':
-    sys.exit(main(sys.argv1:))
+    raise SystemExit(main())

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/cmd/make_mode.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/cmd/make_mode.py Changed

@@ -1,29 +1,28 @@
-"""
-    sphinx.cmd.make_mode
-    ~~~~~~~~~~~~~~~~~~~~
-
-    sphinx-build -M command-line handling.
-
-    This replaces the old, platform-dependent and once-generated content
-    of Makefile / make.bat.
+"""sphinx-build -M command-line handling.
 
-    This is in its own module so that importing it is fast.  It should not
-    import the main Sphinx modules (like sphinx.applications, sphinx.builders).
+This replaces the old, platform-dependent and once-generated content
+of Makefile / make.bat.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This is in its own module so that importing it is fast.  It should not
+import the main Sphinx modules (like sphinx.applications, sphinx.builders).
 """
 
+from __future__ import annotations
+
 import os
 import subprocess
 import sys
 from os import path
-from typing import List
 
 import sphinx
 from sphinx.cmd.build import build_main
 from sphinx.util.console import blue, bold, color_terminal, nocolor  # type: ignore
-from sphinx.util.osutil import cd, rmtree
+from sphinx.util.osutil import rmtree
+
+try:
+    from contextlib import chdir  # type: ignoreattr-defined
+except ImportError:
+    from sphinx.util.osutil import _chdir as chdir
 
 BUILDERS = 
     ("",      "html",        "to make standalone HTML files"),
@@ -55,7 +54,7 @@
 
 
 class Make:
-    def __init__(self, srcdir: str, builddir: str, opts: Liststr) -> None:
+    def __init__(self, srcdir: str, builddir: str, opts: liststr) -> None:
         self.srcdir = srcdir
         self.builddir = builddir
         self.opts = opts
@@ -91,7 +90,7 @@
         print("Please use `make %s' where %s is one of" % ((blue('target'),) * 2))
         for osname, bname, description in BUILDERS:
             if not osname or os.name == osname:
-                print('  %s  %s' % (blue(bname.ljust(10)), description))
+                print(f'  {blue(bname.ljust(10))}  {description}')
 
     def build_latexpdf(self) -> int:
         if self.run_generic_build('latex') > 0:
@@ -102,7 +101,7 @@
         else:
             makecmd = self.makecmd
         try:
-            with cd(self.builddir_join('latex')):
+            with chdir(self.builddir_join('latex')):
                 return subprocess.call(makecmd, 'all-pdf')
         except OSError:
             print('Error: Failed to run: %s' % makecmd)
@@ -117,7 +116,7 @@
         else:
             makecmd = self.makecmd
         try:
-            with cd(self.builddir_join('latex')):
+            with chdir(self.builddir_join('latex')):
                 return subprocess.call(makecmd, 'all-pdf')
         except OSError:
             print('Error: Failed to run: %s' % makecmd)
@@ -127,7 +126,7 @@
         if self.run_generic_build('texinfo') > 0:
             return 1
         try:
-            with cd(self.builddir_join('texinfo')):
+            with chdir(self.builddir_join('texinfo')):
                 return subprocess.call(self.makecmd, 'info')
         except OSError:
             print('Error: Failed to run: %s' % self.makecmd)
@@ -139,7 +138,7 @@
             return 1
         return 0
 
-    def run_generic_build(self, builder: str, doctreedir: str = None) -> int:
+    def run_generic_build(self, builder: str, doctreedir: str | None = None) -> int:
         # compatibility with old Makefile
         papersize = os.getenv('PAPER', '')
         opts = self.opts
@@ -155,7 +154,7 @@
         return build_main(args + opts)
 
 
-def run_make_mode(args: Liststr) -> int:
+def run_make_mode(args: liststr) -> int:
     if len(args) < 3:
         print('Error: at least 3 arguments (builder, source '
               'dir, build dir) are required.', file=sys.stderr)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/cmd/quickstart.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/cmd/quickstart.py Changed

@@ -1,25 +1,21 @@
-"""
-    sphinx.cmd.quickstart
-    ~~~~~~~~~~~~~~~~~~~~~
+"""Quickly setup documentation source to work with Sphinx."""
 
-    Quickly setup documentation source to work with Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import argparse
 import locale
 import os
 import sys
 import time
-from collections import OrderedDict
 from os import path
-from typing import Any, Callable, Dict, List, Union
+from typing import TYPE_CHECKING, Any, Callable
 
 # try to import readline, unix specific enhancement
 try:
     import readline
+    if TYPE_CHECKING and sys.platform == "win32":  # always false, for type checking
+        raise ImportError
+    READLINE_AVAILABLE = True
     if readline.__doc__ and 'libedit' in readline.__doc__:
         readline.parse_and_bind("bind ^I rl_complete")
         USE_LIBEDIT = True
@@ -27,7 +23,7 @@
         readline.parse_and_bind("tab: complete")
         USE_LIBEDIT = False
 except ImportError:
-    readline = None
+    READLINE_AVAILABLE = False
     USE_LIBEDIT = False
 
 from docutils.utils import column_width
@@ -39,18 +35,18 @@
 from sphinx.util.osutil import ensuredir
 from sphinx.util.template import SphinxRenderer
 
-EXTENSIONS = OrderedDict(
-    ('autodoc', __('automatically insert docstrings from modules')),
-    ('doctest', __('automatically test code snippets in doctest blocks')),
-    ('intersphinx', __('link between Sphinx documentation of different projects')),
-    ('todo', __('write "todo" entries that can be shown or hidden on build')),
-    ('coverage', __('checks for documentation coverage')),
-    ('imgmath', __('include math, rendered as PNG or SVG images')),
-    ('mathjax', __('include math, rendered in the browser by MathJax')),
-    ('ifconfig', __('conditional inclusion of content based on config values')),
-    ('viewcode', __('include links to the source code of documented Python objects')),
-    ('githubpages', __('create .nojekyll file to publish the document on GitHub pages')),
-)
+EXTENSIONS = {
+    'autodoc': __('automatically insert docstrings from modules'),
+    'doctest': __('automatically test code snippets in doctest blocks'),
+    'intersphinx': __('link between Sphinx documentation of different projects'),
+    'todo': __('write "todo" entries that can be shown or hidden on build'),
+    'coverage': __('checks for documentation coverage'),
+    'imgmath': __('include math, rendered as PNG or SVG images'),
+    'mathjax': __('include math, rendered in the browser by MathJax'),
+    'ifconfig': __('conditional inclusion of content based on config values'),
+    'viewcode': __('include links to the source code of documented Python objects'),
+    'githubpages': __('create .nojekyll file to publish the document on GitHub pages'),
+}
 
 DEFAULTS = {
     'path': '.',
@@ -135,10 +131,12 @@
     return x
 
 
-def do_prompt(text: str, default: str = None, validator: Callablestr, Any = nonempty) -> Unionstr, bool:  # NOQA
+def do_prompt(
+    text: str, default: str | None = None, validator: Callablestr, Any = nonempty,
+) -> str | bool:
     while True:
         if default is not None:
-            prompt = PROMPT_PREFIX + '%s %s: ' % (text, default)
+            prompt = PROMPT_PREFIX + f'{text} {default}: '
         else:
             prompt = PROMPT_PREFIX + text + ': '
         if USE_LIBEDIT:
@@ -146,7 +144,7 @@
             # sequence (see #5335).  To avoid the problem, all prompts are not colored
             # on libedit.
             pass
-        elif readline:
+        elif READLINE_AVAILABLE:
             # pass input_mode=True if readline available
             prompt = colorize(COLOR_QUESTION, prompt, input_mode=True)
         else:
@@ -164,8 +162,8 @@
 
 
 class QuickstartRenderer(SphinxRenderer):
-    def __init__(self, templatedir: str) -> None:
-        self.templatedir = templatedir or ''
+    def __init__(self, templatedir: str = '') -> None:
+        self.templatedir = templatedir
         super().__init__()
 
     def _has_custom_template(self, template_name: str) -> bool:
@@ -175,12 +173,9 @@
               It will be removed in the future without deprecation period.
         """
         template = path.join(self.templatedir, path.basename(template_name))
-        if self.templatedir and path.exists(template):
-            return True
-        else:
-            return False
+        return bool(self.templatedir) and path.exists(template)
 
-    def render(self, template_name: str, context: Dict) -> str:
+    def render(self, template_name: str, context: dictstr, Any) -> str:
         if self._has_custom_template(template_name):
             custom_template = path.join(self.templatedir, path.basename(template_name))
             return self.render_from_file(custom_template, context)
@@ -188,7 +183,7 @@
             return super().render(template_name, context)
 
 
-def ask_user(d: Dict) -> None:
+def ask_user(d: dictstr, Any) -> None:
     """Ask the user for quickstart values missing from *d*.
 
     Values are:
@@ -231,7 +226,7 @@
         d'path' = do_prompt(__('Please enter a new root path (or just Enter to exit)'),
                               '', is_path_or_empty)
         if not d'path':
-            sys.exit(1)
+            raise SystemExit(1)
 
     if 'sep' not in d:
         print()
@@ -242,9 +237,9 @@
 
     if 'dot' not in d:
         print()
-        print(__('Inside the root directory, two more directories will be created; "_templates"\n'      # NOQA
-                 'for custom HTML templates and "_static" for custom stylesheets and other static\n'    # NOQA
-                 'files. You can enter another prefix (such as ".") to replace the underscore.'))       # NOQA
+        print(__('Inside the root directory, two more directories will be created; "_templates"\n'      # noqa: E501
+                 'for custom HTML templates and "_static" for custom stylesheets and other static\n'    # noqa: E501
+                 'files. You can enter another prefix (such as ".") to replace the underscore.'))       # noqa: E501
         d'dot' = do_prompt(__('Name prefix for templates and static dir'), '_', ok)
 
     if 'project' not in d:
@@ -259,7 +254,7 @@
         print(__('Sphinx has the notion of a "version" and a "release" for the\n'
                  'software. Each version can have multiple releases. For example, for\n'
                  'Python the version is something like 2.5 or 3.0, while the release is\n'
-                 'something like 2.5.1 or 3.0a1. If you don\'t need this dual structure,\n'
+                 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
                  'just set both to the same value.'))
         d'version' = do_prompt(__('Project version'), '', allow_empty)
     if 'release' not in d:
@@ -267,12 +262,14 @@
 
     if 'language' not in d:
         print()
-        print(__('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'
-                 'translate text that it generates into that language.\n'
-                 '\n'
-                 'For a list of supported codes, see\n'
-                 'https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.'))  # NOQA
+        print(__(
+            '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'
+            'translate text that it generates into that language.\n'
+            '\n'
+            'For a list of supported codes, see\n'
+            'https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.',
+        ))
         d'language' = do_prompt(__('Project language'), 'en')
         if d'language' == 'en':
             d'language' = None
@@ -305,7 +302,7 @@
         print(__('Indicate which of the following Sphinx extensions should be enabled:'))
         d'extensions' = 
         for name, description in EXTENSIONS.items():
-            if do_prompt('%s: %s (y/n)' % (name, description), 'n', boolean):
+            if do_prompt(f'{name}: {description} (y/n)', 'n', boolean):
                 d'extensions'.append('sphinx.ext.%s' % name)
 
         # Handle conflicting options
@@ -317,7 +314,7 @@
     if 'makefile' not in d:
         print()
         print(__('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'
+                 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
                  'directly.'))
         d'makefile' = do_prompt(__('Create Makefile? (y/n)'), 'y', boolean)
 
@@ -326,10 +323,11 @@
     print()
 
 
-def generate(d: Dict, overwrite: bool = True, silent: bool = False, templatedir: str = None
-             ) -> None:
+def generate(
+    d: dict, overwrite: bool = True, silent: bool = False, templatedir: str | None = None,
+) -> None:
     """Generate project based on values in *d*."""
-    template = QuickstartRenderer(templatedir=templatedir)
+    template = QuickstartRenderer(templatedir or '')
 
     if 'mastertoctree' not in d:
         d'mastertoctree' = ''
@@ -362,11 +360,11 @@
     ensuredir(path.join(srcdir, d'dot' + 'templates'))
     ensuredir(path.join(srcdir, d'dot' + 'static'))
 
-    def write_file(fpath: str, content: str, newline: str = None) -> None:
+    def write_file(fpath: str, content: str, newline: str | None = None) -> None:
         if overwrite or not path.isfile(fpath):
             if 'quiet' not in d:
                 print(__('Creating file %s.') % fpath)
-            with open(fpath, 'wt', encoding='utf-8', newline=newline) as f:
+            with open(fpath, 'w', encoding='utf-8', newline=newline) as f:
                 f.write(content)
         else:
             if 'quiet' not in d:
@@ -375,7 +373,7 @@
     conf_path = os.path.join(templatedir, 'conf.py_t') if templatedir else None
     if not conf_path or not path.isfile(conf_path):
         conf_path = os.path.join(package_dir, 'templates', 'quickstart', 'conf.py_t')
-    with open(conf_path) as f:
+    with open(conf_path, encoding="utf-8") as f:
         conf_text = f.read()
 
     write_file(path.join(srcdir, 'conf.py'), template.render_string(conf_text, d))
@@ -384,7 +382,7 @@
     if template._has_custom_template('quickstart/master_doc.rst_t'):
         msg = ('A custom template `master_doc.rst_t` found. It has been renamed to '
                '`root_doc.rst_t`.  Please rename it on your project too.')
-        print(colorize('red', msg))  # RemovedInSphinx60Warning
+        print(colorize('red', msg))
         write_file(masterfile, template.render('quickstart/master_doc.rst_t', d))
     else:
         write_file(masterfile, template.render('quickstart/root_doc.rst_t', d))
@@ -427,7 +425,7 @@
     print()
 
 
-def valid_dir(d: Dict) -> bool:
+def valid_dir(d: dict) -> bool:
     dir = d'path'
     if not path.exists(dir):
         return True
@@ -463,7 +461,7 @@
         "\n"
         "sphinx-quickstart is an interactive tool that asks some questions about your\n"
         "project and then generates a complete documentation directory and sample\n"
-        "Makefile to be used with sphinx-build.\n"
+        "Makefile to be used with sphinx-build.\n",
     )
     parser = argparse.ArgumentParser(
         usage='%(prog)s OPTIONS <PROJECT_DIR>',
@@ -541,9 +539,9 @@
     return parser
 
 
-def main(argv: Liststr = sys.argv1:) -> int:
-    sphinx.locale.setlocale(locale.LC_ALL, '')
-    sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx')
+def main(argv: liststr = sys.argv1:) -> int:
+    locale.setlocale(locale.LC_ALL, '')
+    sphinx.locale.init_console()
 
     if not color_terminal():
         nocolor()
@@ -553,7 +551,7 @@
     try:
         args = parser.parse_args(argv)
     except SystemExit as err:
-        return err.code
+        return err.code  # type: ignorereturn-value
 
     d = vars(args)
     # delete None or False value
@@ -607,4 +605,4 @@
 
 
 if __name__ == '__main__':
-    sys.exit(main(sys.argv1:))
+    raise SystemExit(main())

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/config.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/config.py Changed

@@ -1,29 +1,26 @@
-"""
-    sphinx.config
-    ~~~~~~~~~~~~~
+"""Build configuration file handling."""
 
-    Build configuration file handling.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 import traceback
 import types
-from collections import OrderedDict
 from os import getenv, path
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Generator, Iterator, List, NamedTuple,
-                    Optional, Set, Tuple, Union)
+from typing import TYPE_CHECKING, Any, Callable, Generator, Iterator, NamedTuple
 
 from sphinx.errors import ConfigError, ExtensionError
 from sphinx.locale import _, __
 from sphinx.util import logging
 from sphinx.util.i18n import format_date
-from sphinx.util.osutil import cd, fs_encoding
+from sphinx.util.osutil import fs_encoding
 from sphinx.util.tags import Tags
 from sphinx.util.typing import NoneType
 
+try:
+    from contextlib import chdir  # type: ignoreattr-defined
+except ImportError:
+    from sphinx.util.osutil import _chdir as chdir
+
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.environment import BuildEnvironment
@@ -38,7 +35,7 @@
 class ConfigValue(NamedTuple):
     name: str
     value: Any
-    rebuild: Unionbool, str
+    rebuild: bool | str
 
 
 def is_serializable(obj: Any) -> bool:
@@ -64,7 +61,7 @@
     def __init__(self, *candidates: str) -> None:
         self.candidates = candidates
 
-    def match(self, value: Unionstr, List, Tuple) -> bool:
+    def match(self, value: str | list | tuple) -> bool:
         if isinstance(value, (list, tuple)):
             return all(item in self.candidates for item in value)
         else:
@@ -72,15 +69,15 @@
 
 
 class Config:
-    """Configuration file abstraction.
+    r"""Configuration file abstraction.
 
     The config object makes the values of all config values available as
     attributes.
 
-    It is exposed via the :py:attr:`sphinx.application.Application.config` and
-    :py:attr:`sphinx.environment.Environment.config` attributes. For example,
-    to get the value of :confval:`language`, use either ``app.config.language``
-    or ``env.config.language``.
+    It is exposed via the :py:class:`~sphinx.application.Sphinx`\ ``.config``
+    and :py:class:`sphinx.environment.BuildEnvironment`\ ``.config`` attributes.
+    For example, to get the value of :confval:`language`, use either
+    ``app.config.language`` or ``env.config.language``.
     """
 
     # the values are: (default, what needs to be rebuilt if changed)
@@ -88,7 +85,7 @@
     # If you add a value here, don't forget to include it in the
     # quickstart.py file template as well as in the docs!
 
-    config_values: Dictstr, Tuple = {
+    config_values: dictstr, tuple = {
         # general options
         'project': ('Python', 'env', ),
         'author': ('unknown', 'env', ),
@@ -100,7 +97,7 @@
         # the real default is locale-dependent
         'today_fmt': (None, 'env', str),
 
-        'language': (None, 'env', str),
+        'language': ('en', 'env', str),
         'locale_dirs': ('locales', 'env', ),
         'figure_language_filename': ('{root}.{language}{ext}', 'env', str),
         'gettext_allow_fuzzy_translations': (False, 'gettext', ),
@@ -109,10 +106,14 @@
         'root_doc': (lambda config: config.master_doc, 'env', ),
         'source_suffix': ({'.rst': 'restructuredtext'}, 'env', Any),
         'source_encoding': ('utf-8-sig', 'env', ),
-        'exclude_patterns': (, 'env', ),
+        'exclude_patterns': (, 'env', str),
+        'include_patterns': ("**", 'env', str),
         'default_role': (None, 'env', str),
         'add_function_parentheses': (True, 'env', ),
         'add_module_names': (True, 'env', ),
+        'toc_object_entries': (True, 'env', bool),
+        'toc_object_entries_show_parents': ('domain', 'env',
+                                            ENUM('domain', 'all', 'hide')),
         'trim_footnote_reference_space': (False, 'env', ),
         'show_authors': (False, 'env', ),
         'pygments_style': (None, 'html', str),
@@ -131,8 +132,8 @@
         'needs_extensions': ({}, None, ),
         'manpages_url': (None, 'env', ),
         'nitpicky': (False, None, ),
-        'nitpick_ignore': (, None, ),
-        'nitpick_ignore_regex': (, None, ),
+        'nitpick_ignore': (, None, set, list, tuple),
+        'nitpick_ignore_regex': (, None, set, list, tuple),
         'numfig': (False, 'env', ),
         'numfig_secnum_depth': (1, 'env', ),
         'numfig_format': ({}, 'env', ),  # will be initialized in init_numfig_format()
@@ -148,29 +149,43 @@
         'smartquotes_excludes': ({'languages': 'ja',
                                   'builders': 'man', 'text'},
                                  'env', ),
+        'option_emphasise_placeholders': (False, 'env', ),
     }
 
-    def __init__(self, config: Dictstr, Any = {}, overrides: Dictstr, Any = {}) -> None:
+    def __init__(self, config: dictstr, Any = {}, overrides: dictstr, Any = {}) -> None:
         self.overrides = dict(overrides)
         self.values = Config.config_values.copy()
         self._raw_config = config
-        self.setup: OptionalCallable = config.get('setup', None)
+        self.setup: Callable | None = config.get('setup', None)
 
         if 'extensions' in self.overrides:
             if isinstance(self.overrides'extensions', str):
                 config'extensions' = self.overrides.pop('extensions').split(',')
             else:
                 config'extensions' = self.overrides.pop('extensions')
-        self.extensions: Liststr = config.get('extensions', )
+        self.extensions: liststr = config.get('extensions', )
 
     @classmethod
-    def read(cls, confdir: str, overrides: Dict = None, tags: Tags = None) -> "Config":
+    def read(
+        cls, confdir: str, overrides: dict | None = None, tags: Tags | None = None,
+    ) -> Config:
         """Create a Config object from configuration file."""
         filename = path.join(confdir, CONFIG_FILENAME)
         if not path.isfile(filename):
             raise ConfigError(__("config directory doesn't contain a conf.py file (%s)") %
                               confdir)
         namespace = eval_config_file(filename, tags)
+
+        # Note: Old sphinx projects have been configured as "language = None" because
+        #       sphinx-quickstart previously generated this by default.
+        #       To keep compatibility, they should be fallback to 'en' for a while
+        #       (This conversion should not be removed before 2025-01-01).
+        if namespace.get("language", ...) is None:
+            logger.warning(__("Invalid configuration value found: 'language = None'. "
+                              "Update your configuration to a valid language code. "
+                              "Falling back to 'en' (English)."))
+            namespace"language" = "en"
+
         return cls(namespace, overrides or {})
 
     def convert_overrides(self, name: str, value: Any) -> Any:
@@ -237,7 +252,7 @@
                     realvalname, key = valname.split('.', 1)
                     config.setdefault(realvalname, {})key = value
                     continue
-                elif valname not in self.values:
+                if valname not in self.values:
                     logger.warning(__('unknown config value %r in override, ignoring'),
                                    valname)
                     continue
@@ -288,18 +303,17 @@
         for name, value in self.values.items():
             yield ConfigValue(name, getattr(self, name), value1)
 
-    def add(self, name: str, default: Any, rebuild: Unionbool, str, types: Any) -> None:
+    def add(self, name: str, default: Any, rebuild: bool | str, types: Any) -> None:
         if name in self.values:
             raise ExtensionError(__('Config value %r already present') % name)
-        else:
-            self.valuesname = (default, rebuild, types)
+        self.valuesname = (default, rebuild, types)
 
-    def filter(self, rebuild: Unionstr, Liststr) -> IteratorConfigValue:
+    def filter(self, rebuild: str | liststr) -> IteratorConfigValue:
         if isinstance(rebuild, str):
             rebuild = rebuild
         return (value for value in self if value.rebuild in rebuild)
 
-    def __getstate__(self) -> Dict:
+    def __getstate__(self) -> dict:
         """Obtains serializable data for pickling."""
         # remove potentially pickling-problematic values from config
         __dict__ = {}
@@ -322,22 +336,22 @@
 
         return __dict__
 
-    def __setstate__(self, state: Dict) -> None:
+    def __setstate__(self, state: dict) -> None:
         self.__dict__.update(state)
 
 
-def eval_config_file(filename: str, tags: OptionalTags) -> Dictstr, Any:
+def eval_config_file(filename: str, tags: Tags | None) -> dictstr, Any:
     """Evaluate a config file."""
-    namespace: Dictstr, Any = {}
+    namespace: dictstr, Any = {}
     namespace'__file__' = filename
     namespace'tags' = tags
 
-    with cd(path.dirname(filename)):
+    with chdir(path.dirname(filename)):
         # during executing config file, current dir is changed to ``confdir``.
         try:
             with open(filename, 'rb') as f:
                 code = compile(f.read(), filename.encode(fs_encoding), 'exec')
-                exec(code, namespace)
+                exec(code, namespace)  # NoQA: S102
         except SyntaxError as err:
             msg = __("There is a syntax error in your configuration file: %s\n")
             raise ConfigError(msg % err) from err
@@ -355,7 +369,7 @@
     return namespace
 
 
-def convert_source_suffix(app: "Sphinx", config: Config) -> None:
+def convert_source_suffix(app: Sphinx, config: Config) -> None:
     """Convert old styled source_suffix to new styled one.
 
     * old style: str or list
@@ -367,20 +381,17 @@
         #
         # The default filetype is determined on later step.
         # By default, it is considered as restructuredtext.
-        config.source_suffix = OrderedDict({source_suffix: None})  # type: ignore
+        config.source_suffix = {source_suffix: None}  # type: ignoreattr-defined
     elif isinstance(source_suffix, (list, tuple)):
         # if list, considers as all of them are default filetype
-        config.source_suffix = OrderedDict((s, None) for s in source_suffix)  # type: ignore  # NOQA
-    elif isinstance(source_suffix, dict):
-        # if dict, convert it to OrderedDict
-        config.source_suffix = OrderedDict(config.source_suffix)  # type: ignore
-    else:
+        config.source_suffix = {s: None for s in source_suffix}  # type: ignoreattr-defined
+    elif not isinstance(source_suffix, dict):
         logger.warning(__("The config value `source_suffix' expects "
                           "a string, list of strings, or dictionary. "
                           "But `%r' is given." % source_suffix))
 
 
-def convert_highlight_options(app: "Sphinx", config: Config) -> None:
+def convert_highlight_options(app: Sphinx, config: Config) -> None:
     """Convert old styled highlight_options to new styled one.
 
     * old style: options
@@ -392,7 +403,7 @@
         config.highlight_options = {config.highlight_language: options}  # type: ignore
 
 
-def init_numfig_format(app: "Sphinx", config: Config) -> None:
+def init_numfig_format(app: Sphinx, config: Config) -> None:
     """Initialize :confval:`numfig_format`."""
     numfig_format = {'section': _('Section %s'),
                      'figure': _('Fig. %s'),
@@ -404,7 +415,7 @@
     config.numfig_format = numfig_format  # type: ignore
 
 
-def correct_copyright_year(app: "Sphinx", config: Config) -> None:
+def correct_copyright_year(app: Sphinx, config: Config) -> None:
     """Correct values of copyright year that are not coherent with
     the SOURCE_DATE_EPOCH environment variable (if set)
 
@@ -413,11 +424,11 @@
     if getenv('SOURCE_DATE_EPOCH') is not None:
         for k in ('copyright', 'epub_copyright'):
             if k in config:
-                replace = r'\g<1>%s' % format_date('%Y')
+                replace = r'\g<1>%s' % format_date('%Y', language='en')
                 configk = copyright_year_re.sub(replace, configk)
 
 
-def check_confval_types(app: "Sphinx", config: Config) -> None:
+def check_confval_types(app: Sphinx | None, config: Config) -> None:
     """Check all values for deviation from the default value's type, since
     that can result in TypeErrors all over the place NB.
     """
@@ -454,11 +465,10 @@
             if annotations:
                 msg = __("The config value `{name}' has type `{current.__name__}'; "
                          "expected {permitted}.")
-                wrapped_annotations = "`{}'".format(c.__name__) for c in annotations
+                wrapped_annotations = f"`{c.__name__}'" for c in annotations
                 if len(wrapped_annotations) > 2:
-                    permitted = "{}, or {}".format(
-                        ", ".join(wrapped_annotations:-1),
-                        wrapped_annotations-1)
+                    permitted = (", ".join(wrapped_annotations:-1)
+                                 + f", or {wrapped_annotations-1}")
                 else:
                     permitted = " or ".join(wrapped_annotations)
                 logger.warning(msg.format(name=confval.name,
@@ -472,15 +482,15 @@
                                           default=type(default)), once=True)
 
 
-def check_primary_domain(app: "Sphinx", config: Config) -> None:
+def check_primary_domain(app: Sphinx, config: Config) -> None:
     primary_domain = config.primary_domain
     if primary_domain and not app.registry.has_domain(primary_domain):
         logger.warning(__('primary_domain %r not found, ignored.'), primary_domain)
         config.primary_domain = None  # type: ignore
 
 
-def check_root_doc(app: "Sphinx", env: "BuildEnvironment", added: Setstr,
-                   changed: Setstr, removed: Setstr) -> Setstr:
+def check_root_doc(app: Sphinx, env: BuildEnvironment, added: setstr,
+                   changed: setstr, removed: setstr) -> setstr:
     """Adjust root_doc to 'contents' to support an old project which does not have
     any root_doc setting.
     """
@@ -494,7 +504,7 @@
     return changed
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('config-inited', convert_source_suffix, priority=800)
     app.connect('config-inited', convert_highlight_options, priority=800)
     app.connect('config-inited', init_numfig_format, priority=800)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/deprecation.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/deprecation.py Changed

@@ -1,89 +1,64 @@
-"""
-    sphinx.deprecation
-    ~~~~~~~~~~~~~~~~~~
+"""Sphinx deprecation classes and utilities."""
 
-    Sphinx deprecation classes and utilities.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import sys
 import warnings
-from importlib import import_module
-from typing import Any, Dict, Type
 
 
-class RemovedInSphinx50Warning(DeprecationWarning):
+class RemovedInSphinx80Warning(DeprecationWarning):
     pass
 
 
-class RemovedInSphinx60Warning(PendingDeprecationWarning):
+class RemovedInSphinx90Warning(PendingDeprecationWarning):
     pass
 
 
-RemovedInNextVersionWarning = RemovedInSphinx50Warning
-
-
-def deprecated_alias(modname: str, objects: Dictstr, object,
-                     warning: TypeWarning, names: Dictstr, str = {}) -> None:
-    module = import_module(modname)
-    sys.modulesmodname = _ModuleWrapper(  # type: ignore
-        module, modname, objects, warning, names)
+RemovedInNextVersionWarning = RemovedInSphinx80Warning
 
 
-class _ModuleWrapper:
-    def __init__(self, module: Any, modname: str,
-                 objects: Dictstr, object,
-                 warning: TypeWarning,
-                 names: Dictstr, str) -> None:
-        self._module = module
-        self._modname = modname
-        self._objects = objects
-        self._warning = warning
-        self._names = names
+def _deprecation_warning(
+    module: str,
+    attribute: str,
+    canonical_name: str,
+    *,
+    remove: tupleint, int,
+) -> None:
+    """Helper function for module-level deprecations using __getattr__
 
-    def __getattr__(self, name: str) -> Any:
-        if name not in self._objects:
-            return getattr(self._module, name)
+    Exemplar usage:
 
-        canonical_name = self._names.get(name, None)
-        if canonical_name is not None:
-            warnings.warn(
-                "The alias '{}.{}' is deprecated, use '{}' instead. Check CHANGES for "
-                "Sphinx API modifications.".format(self._modname, name, canonical_name),
-                self._warning, stacklevel=3)
-        else:
-            warnings.warn("{}.{} is deprecated. Check CHANGES for Sphinx "
-                          "API modifications.".format(self._modname, name),
-                          self._warning, stacklevel=3)
-        return self._objectsname
+    .. code:: python
 
+       # deprecated name -> (object to return, canonical path or empty string)
+       _DEPRECATED_OBJECTS = {
+           'deprecated_name': (object_to_return, 'fully_qualified_replacement_name', (8, 0)),
+       }
 
-class DeprecatedDict(dict):
-    """A deprecated dict which warns on each access."""
 
-    def __init__(self, data: Dict, message: str, warning: TypeWarning) -> None:
-        self.message = message
-        self.warning = warning
-        super().__init__(data)
+       def __getattr__(name):
+           if name not in _DEPRECATED_OBJECTS:
+               raise AttributeError(f'module {__name__!r} has no attribute {name!r}')
 
-    def __setitem__(self, key: str, value: Any) -> None:
-        warnings.warn(self.message, self.warning, stacklevel=2)
-        super().__setitem__(key, value)
+           from sphinx.deprecation import _deprecation_warning
 
-    def setdefault(self, key: str, default: Any = None) -> Any:
-        warnings.warn(self.message, self.warning, stacklevel=2)
-        return super().setdefault(key, default)
+           deprecated_object, canonical_name, remove = _DEPRECATED_OBJECTSname
+           _deprecation_warning(__name__, name, canonical_name, remove=remove)
+           return deprecated_object
+    """
 
-    def __getitem__(self, key: str) -> None:
-        warnings.warn(self.message, self.warning, stacklevel=2)
-        return super().__getitem__(key)
+    if remove == (8, 0):
+        warning_class: typeWarning = RemovedInSphinx80Warning
+    elif remove == (9, 0):
+        warning_class = RemovedInSphinx90Warning
+    else:
+        raise RuntimeError(f'removal version {remove!r} is invalid!')
 
-    def get(self, key: str, default: Any = None) -> Any:
-        warnings.warn(self.message, self.warning, stacklevel=2)
-        return super().get(key, default)
+    qualified_name = f'{module}.{attribute}'
+    if canonical_name:
+        message = (f'The alias {qualified_name!r} is deprecated, '
+                   f'use {canonical_name!r} instead.')
+    else:
+        message = f'{qualified_name!r} is deprecated.'
 
-    def update(self, other: Dict) -> None:  # type: ignore
-        warnings.warn(self.message, self.warning, stacklevel=2)
-        super().update(other)
+    warnings.warn(message + " Check CHANGES for Sphinx API modifications.",
+                  warning_class, stacklevel=3)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/directives/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/directives/__init__.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.directives
-    ~~~~~~~~~~~~~~~~~
+"""Handlers for additional ReST directives."""
 
-    Handlers for additional ReST directives.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import TYPE_CHECKING, Any, Dict, Generic, List, Tuple, TypeVar, cast
+from typing import TYPE_CHECKING, Any, Generic, List, TypeVar, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -17,10 +11,10 @@
 
 from sphinx import addnodes
 from sphinx.addnodes import desc_signature
-from sphinx.deprecation import RemovedInSphinx50Warning, deprecated_alias
 from sphinx.util import docutils
 from sphinx.util.docfields import DocFieldTransformer, Field, TypedField
 from sphinx.util.docutils import SphinxDirective
+from sphinx.util.nodes import nested_parse_with_titles
 from sphinx.util.typing import OptionSpec
 
 if TYPE_CHECKING:
@@ -31,10 +25,8 @@
 nl_escape_re = re.compile(r'\\\n')
 strip_backslash_re = re.compile(r'\\(.)')
 
-T = TypeVar('T')
-
 
-def optional_int(argument: str) -> int:
+def optional_int(argument: str) -> int | None:
     """
     Check for an integer argument or None value; raise ``ValueError`` if not.
     """
@@ -47,7 +39,10 @@
         return value
 
 
-class ObjectDescription(SphinxDirective, GenericT):
+ObjDescT = TypeVar('ObjDescT')
+
+
+class ObjectDescription(SphinxDirective, GenericObjDescT):
     """
     Directive to describe a class, function or similar object.  Not used
     directly, but subclassed (in domain-specific directives) to add custom
@@ -60,18 +55,20 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {
         'noindex': directives.flag,
+        'noindexentry': directives.flag,
+        'nocontentsentry': directives.flag,
     }
 
     # types of doc fields that this directive handles, see sphinx.util.docfields
-    doc_field_types: ListField = 
-    domain: str = None
-    objtype: str = None
-    indexnode: addnodes.index = None
+    doc_field_types: listField = 
+    domain: str | None = None
+    objtype: str  # set when `run` method is called
+    indexnode: addnodes.index
 
     # Warning: this might be removed in future version. Don't touch this from extensions.
-    _doc_field_type_map: Dictstr, TupleField, bool = {}
+    _doc_field_type_map: dictstr, tupleField, bool = {}
 
-    def get_field_type_map(self) -> Dictstr, TupleField, bool:
+    def get_field_type_map(self) -> dictstr, tupleField, bool:
         if self._doc_field_type_map == {}:
             self._doc_field_type_map = {}
             for field in self.doc_field_types:
@@ -85,7 +82,7 @@
 
         return self._doc_field_type_map
 
-    def get_signatures(self) -> Liststr:
+    def get_signatures(self) -> liststr:
         """
         Retrieve the signatures to document from the directive arguments.  By
         default, signatures are given as arguments, one per line.
@@ -97,7 +94,7 @@
         else:
             return line.strip() for line in lines
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> T:
+    def handle_signature(self, sig: str, signode: desc_signature) -> ObjDescT:
         """
         Parse the signature *sig* into individual nodes and append them to
         *signode*. If ValueError is raised, parsing is aborted and the whole
@@ -109,7 +106,7 @@
         """
         raise ValueError
 
-    def add_target_and_index(self, name: T, sig: str, signode: desc_signature) -> None:
+    def add_target_and_index(self, name: ObjDescT, sig: str, signode: desc_signature) -> None:
         """
         Add cross-reference IDs and entries to self.indexnode, if applicable.
 
@@ -140,7 +137,45 @@
         """
         pass
 
-    def run(self) -> ListNode:
+    def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuplestr, ...:
+        """
+        Returns a tuple of strings, one entry for each part of the object's
+        hierarchy (e.g. ``('module', 'submodule', 'Class', 'method')``). The
+        returned tuple is used to properly nest children within parents in the
+        table of contents, and can also be used within the
+        :py:meth:`_toc_entry_name` method.
+
+        This method must not be used outwith table of contents generation.
+        """
+        return ()
+
+    def _toc_entry_name(self, sig_node: desc_signature) -> str:
+        """
+        Returns the text of the table of contents entry for the object.
+
+        This function is called once, in :py:meth:`run`, to set the name for the
+        table of contents entry (a special attribute ``_toc_name`` is set on the
+        object node, later used in
+        ``environment.collectors.toctree.TocTreeCollector.process_doc().build_toc()``
+        when the table of contents entries are collected).
+
+        To support table of contents entries for their objects, domains must
+        override this method, also respecting the configuration setting
+        ``toc_object_entries_show_parents``. Domains must also override
+        :py:meth:`_object_hierarchy_parts`, with one (string) entry for each part of the
+        object's hierarchy. The result of this method is set on the signature
+        node, and can be accessed as ``sig_node'_toc_parts'`` for use within
+        this method. The resulting tuple is also used to properly nest children
+        within parents in the table of contents.
+
+        An example implementations of this method is within the python domain
+        (:meth:`!PyObject._toc_entry_name`). The python domain sets the
+        ``_toc_parts`` attribute within the :py:meth:`handle_signature()`
+        method.
+        """
+        return ''
+
+    def run(self) -> listNode:
         """
         Main directive entry function, called by docutils upon encountering the
         directive.
@@ -166,15 +201,28 @@
 
         node = addnodes.desc()
         node.document = self.state.document
+        source, line = self.get_source_info()
+        # If any options were specified to the directive,
+        # self.state.document.current_line will at this point be set to
+        # None.  To ensure nodes created as part of the signature have a line
+        # number set, set the document's line number correctly.
+        #
+        # Note that we need to subtract one from the line number since
+        # note_source uses 0-based line numbers.
+        if line is not None:
+            line -= 1
+        self.state.document.note_source(source, line)
         node'domain' = self.domain
         # 'desctype' is a backwards compatible attribute
         node'objtype' = node'desctype' = self.objtype
         node'noindex' = noindex = ('noindex' in self.options)
+        node'noindexentry' = ('noindexentry' in self.options)
+        node'nocontentsentry' = ('nocontentsentry' in self.options)
         if self.domain:
             node'classes'.append(self.domain)
         node'classes'.append(node'objtype')
 
-        self.names: ListT = 
+        self.names: listObjDescT = 
         signatures = self.get_signatures()
         for sig in signatures:
             # add a signature node for each signature in the current unit
@@ -192,6 +240,15 @@
                 signode.clear()
                 signode += addnodes.desc_name(sig, sig)
                 continue  # we don't want an index entry here
+            finally:
+                # Private attributes for ToC generation. Will be modified or removed
+                # without notice.
+                if self.env.app.config.toc_object_entries:
+                    signode'_toc_parts' = self._object_hierarchy_parts(signode)
+                    signode'_toc_name' = self._toc_entry_name(signode)
+                else:
+                    signode'_toc_parts' = ()
+                    signode'_toc_name' = ''
             if name not in self.names:
                 self.names.append(name)
                 if not noindex:
@@ -201,11 +258,12 @@
 
         contentnode = addnodes.desc_content()
         node.append(contentnode)
+
         if self.names:
             # needed for association of version{added,changed} directives
             self.env.temp_data'object' = self.names0
         self.before_content()
-        self.state.nested_parse(self.content, self.content_offset, contentnode)
+        nested_parse_with_titles(self.state, self.content, contentnode, self.content_offset)
         self.transform_content(contentnode)
         self.env.app.emit('object-description-transform',
                           self.domain, self.objtype, contentnode)
@@ -223,14 +281,14 @@
     optional_arguments = 1
     final_argument_whitespace = False
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if not self.arguments:
             docutils.unregister_role('')
             return 
         role_name = self.arguments0
         role, messages = roles.role(role_name, self.state_machine.language,
                                     self.lineno, self.state.reporter)
-        if role:
+        if role:  # type: ignoretruthy-function
             docutils.register_role('', role)
             self.env.temp_data'default_role' = role_name
         else:
@@ -254,7 +312,7 @@
     final_argument_whitespace = False
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         domain_name = self.arguments0.lower()
         # if domain_name not in env.domains:
         #     # try searching by label
@@ -266,17 +324,7 @@
         return 
 
 
-deprecated_alias('sphinx.directives',
-                 {
-                     'DescDirective': ObjectDescription,
-                 },
-                 RemovedInSphinx50Warning,
-                 {
-                     'DescDirective': 'sphinx.directives.ObjectDescription',
-                 })
-
-
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_config_value("strip_signature_backslash", False, 'env')
     directives.register_directive('default-role', DefaultRole)
     directives.register_directive('default-domain', DefaultDomain)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/directives/code.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/directives/code.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.directives.code
-    ~~~~~~~~~~~~~~~~~~~~~~
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import sys
 import textwrap
 from difflib import unified_diff
-from typing import TYPE_CHECKING, Any, Dict, List, Tuple
+from typing import TYPE_CHECKING, Any
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -45,7 +39,7 @@
         'linenothreshold': directives.positive_int,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         language = self.arguments0.strip()
         linenothreshold = self.options.get('linenothreshold', sys.maxsize)
         force = 'force' in self.options
@@ -56,7 +50,9 @@
                                        linenothreshold=linenothreshold)
 
 
-def dedent_lines(lines: Liststr, dedent: int, location: Tuplestr, int = None) -> Liststr:
+def dedent_lines(
+    lines: liststr, dedent: int | None, location: tuplestr, int | None = None,
+) -> liststr:
     if dedent is None:
         return textwrap.dedent(''.join(lines)).splitlines(True)
 
@@ -73,7 +69,9 @@
     return new_lines
 
 
-def container_wrapper(directive: SphinxDirective, literal_node: Node, caption: str) -> nodes.container:  # NOQA
+def container_wrapper(
+    directive: SphinxDirective, literal_node: Node, caption: str,
+) -> nodes.container:
     container_node = nodes.container('', literal_block=True,
                                      classes='literal-block-wrapper')
     parsed = nodes.Element()
@@ -82,7 +80,7 @@
     if isinstance(parsed0, nodes.system_message):
         msg = __('Invalid caption: %s' % parsed0.astext())
         raise ValueError(msg)
-    elif isinstance(parsed0, nodes.Element):
+    if isinstance(parsed0, nodes.Element):
         caption_node = nodes.caption(parsed0.rawsource, '',
                                      *parsed0.children)
         caption_node.source = literal_node.source
@@ -90,8 +88,7 @@
         container_node += caption_node
         container_node += literal_node
         return container_node
-    else:
-        raise RuntimeError  # never reached
+    raise RuntimeError  # never reached
 
 
 class CodeBlock(SphinxDirective):
@@ -115,7 +112,7 @@
         'name': directives.unchanged,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         document = self.state.document
         code = '\n'.join(self.content)
         location = self.state_machine.get_source_and_line(self.lineno)
@@ -194,7 +191,7 @@
         ('diff', 'end-at'),
     
 
-    def __init__(self, filename: str, options: Dict, config: Config) -> None:
+    def __init__(self, filename: str, options: dictstr, Any, config: Config) -> None:
         self.filename = filename
         self.options = options
         self.encoding = options.get('encoding', config.source_encoding)
@@ -208,7 +205,9 @@
                 raise ValueError(__('Cannot use both "%s" and "%s" options') %
                                  (option1, option2))
 
-    def read_file(self, filename: str, location: Tuplestr, int = None) -> Liststr:
+    def read_file(
+        self, filename: str, location: tuplestr, int | None = None,
+    ) -> liststr:
         try:
             with open(filename, encoding=self.encoding, errors='strict') as f:
                 text = f.read()
@@ -224,7 +223,7 @@
                                   'be wrong, try giving an :encoding: option') %
                                (self.encoding, filename)) from exc
 
-    def read(self, location: Tuplestr, int = None) -> Tuplestr, int:
+    def read(self, location: tuplestr, int | None = None) -> tuplestr, int:
         if 'diff' in self.options:
             lines = self.show_diff()
         else:
@@ -232,23 +231,25 @@
                        self.start_filter,
                        self.end_filter,
                        self.lines_filter,
+                       self.dedent_filter,
                        self.prepend_filter,
-                       self.append_filter,
-                       self.dedent_filter
+                       self.append_filter
             lines = self.read_file(self.filename, location=location)
             for func in filters:
                 lines = func(lines, location=location)
 
         return ''.join(lines), len(lines)
 
-    def show_diff(self, location: Tuplestr, int = None) -> Liststr:
+    def show_diff(self, location: tuplestr, int | None = None) -> liststr:
         new_lines = self.read_file(self.filename)
-        old_filename = self.options.get('diff')
+        old_filename = self.options'diff'
         old_lines = self.read_file(old_filename)
         diff = unified_diff(old_lines, new_lines, old_filename, self.filename)
         return list(diff)
 
-    def pyobject_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def pyobject_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         pyobject = self.options.get('pyobject')
         if pyobject:
             from sphinx.pycode import ModuleAnalyzer
@@ -257,16 +258,17 @@
             if pyobject not in tags:
                 raise ValueError(__('Object named %r not found in include file %r') %
                                  (pyobject, self.filename))
-            else:
-                start = tagspyobject1
-                end = tagspyobject2
-                lines = linesstart - 1:end
-                if 'lineno-match' in self.options:
-                    self.lineno_start = start
+            start = tagspyobject1
+            end = tagspyobject2
+            lines = linesstart - 1:end
+            if 'lineno-match' in self.options:
+                self.lineno_start = start
 
         return lines
 
-    def lines_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def lines_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         linespec = self.options.get('lines')
         if linespec:
             linelist = parselinenos(linespec, len(lines))
@@ -290,7 +292,9 @@
 
         return lines
 
-    def start_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def start_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         if 'start-at' in self.options:
             start = self.options.get('start-at')
             inclusive = False
@@ -321,7 +325,9 @@
 
         return lines
 
-    def end_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def end_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         if 'end-at' in self.options:
             end = self.options.get('end-at')
             inclusive = True
@@ -348,21 +354,27 @@
 
         return lines
 
-    def prepend_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def prepend_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         prepend = self.options.get('prepend')
         if prepend:
             lines.insert(0, prepend + '\n')
 
         return lines
 
-    def append_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def append_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         append = self.options.get('append')
         if append:
             lines.append(append + '\n')
 
         return lines
 
-    def dedent_filter(self, lines: Liststr, location: Tuplestr, int = None) -> Liststr:
+    def dedent_filter(
+        self, lines: liststr, location: tuplestr, int | None = None,
+    ) -> liststr:
         if 'dedent' in self.options:
             return dedent_lines(lines, self.options.get('dedent'), location=location)
         else:
@@ -404,7 +416,7 @@
         'diff': directives.unchanged_required,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         document = self.state.document
         if not document.settings.file_insertion_enabled:
             return document.reporter.warning('File insertion disabled',
@@ -456,7 +468,7 @@
             return document.reporter.warning(exc, line=self.lineno)
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     directives.register_directive('highlight', Highlight)
     directives.register_directive('code-block', CodeBlock)
     directives.register_directive('sourcecode', CodeBlock)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/directives/other.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/directives/other.py Changed

@@ -1,13 +1,7 @@
-"""
-    sphinx.directives.other
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import TYPE_CHECKING, Any, Dict, List, cast
+from typing import TYPE_CHECKING, Any, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -17,7 +11,7 @@
 from docutils.parsers.rst.directives.misc import Include as BaseInclude
 
 from sphinx import addnodes
-from sphinx.domains.changeset import VersionChange  # NOQA  # for compatibility
+from sphinx.domains.changeset import VersionChange  # noqa: F401  # for compatibility
 from sphinx.locale import _, __
 from sphinx.util import docname_join, logging, url_re
 from sphinx.util.docutils import SphinxDirective
@@ -60,7 +54,7 @@
         'reversed': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         subnode = addnodes.toctree()
         subnode'parent' = self.env.docname
 
@@ -84,14 +78,15 @@
         ret.append(wrappernode)
         return ret
 
-    def parse_content(self, toctree: addnodes.toctree) -> ListNode:
+    def parse_content(self, toctree: addnodes.toctree) -> listNode:
+        generated_docnames = frozenset(self.env.domains'std'._virtual_doc_names)
         suffixes = self.config.source_suffix
 
         # glob target documents
-        all_docnames = self.env.found_docs.copy()
+        all_docnames = self.env.found_docs.copy() | generated_docnames
         all_docnames.remove(self.env.docname)  # remove current document
 
-        ret: ListNode = 
+        ret: listNode = 
         excluded = Matcher(self.config.exclude_patterns)
         for entry in self.content:
             if not entry:
@@ -103,11 +98,14 @@
                 patname = docname_join(self.env.docname, entry)
                 docnames = sorted(patfilter(all_docnames, patname))
                 for docname in docnames:
+                    if docname in generated_docnames:
+                        # don't include generated documents in globs
+                        continue
                     all_docnames.remove(docname)  # don't include it again
                     toctree'entries'.append((None, docname))
                     toctree'includefiles'.append(docname)
                 if not docnames:
-                    logger.warning(__('toctree glob pattern %r didn\'t match any documents'),
+                    logger.warning(__("toctree glob pattern %r didn't match any documents"),
                                    entry, location=toctree)
             else:
                 if explicit:
@@ -126,8 +124,8 @@
                 docname = docname_join(self.env.docname, docname)
                 if url_re.match(ref) or ref == 'self':
                     toctree'entries'.append((title, ref))
-                elif docname not in self.env.found_docs:
-                    if excluded(self.env.doc2path(docname, None)):
+                elif docname not in self.env.found_docs | generated_docnames:
+                    if excluded(self.env.doc2path(docname, False)):
                         message = __('toctree contains reference to excluded document %r')
                         subtype = 'excluded'
                     else:
@@ -166,7 +164,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if not self.config.show_authors:
             return 
         para: Element = nodes.paragraph(translatable=False)
@@ -180,11 +178,11 @@
             text = _('Code author: ')
         else:
             text = _('Author: ')
-        emph += nodes.Text(text, text)
+        emph += nodes.Text(text)
         inodes, messages = self.state.inline_text(self.arguments0, self.lineno)
         emph.extend(inodes)
 
-        ret: ListNode = para
+        ret: listNode = para
         ret += messages
         return ret
 
@@ -206,7 +204,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = addnodes.tabular_col_spec()
         node'spec' = self.arguments0
         self.set_source_info(node)
@@ -223,14 +221,14 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if not self.arguments:
             return 
         subnode: Element = addnodes.centered()
         inodes, messages = self.state.inline_text(self.arguments0, self.lineno)
         subnode.extend(inodes)
 
-        ret: ListNode = subnode
+        ret: listNode = subnode
         ret += messages
         return ret
 
@@ -245,7 +243,7 @@
     final_argument_whitespace = False
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = addnodes.acks()
         node.document = self.state.document
         self.state.nested_parse(self.content, self.content_offset, node)
@@ -269,7 +267,7 @@
         'columns': int,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         ncolumns = self.options.get('columns', 2)
         node = nodes.paragraph()
         node.document = self.state.document
@@ -304,7 +302,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = addnodes.only()
         node.document = self.state.document
         self.set_source_info(node)
@@ -358,7 +356,7 @@
     "correctly", i.e. relative to source directory.
     """
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if self.arguments0.startswith('<') and \
            self.arguments0.endswith('>'):
             # docutils "standard" includes, do not do path processing
@@ -369,7 +367,7 @@
         return super().run()
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     directives.register_directive('toctree', TocTree)
     directives.register_directive('sectionauthor', Author)
     directives.register_directive('moduleauthor', Author)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/directives/patches.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/directives/patches.py Changed

@@ -1,24 +1,16 @@
-"""
-    sphinx.directives.patches
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
-import warnings
 from os import path
-from typing import TYPE_CHECKING, Any, Dict, List, Sequence, Tuple, cast
+from typing import TYPE_CHECKING, Any, cast
 
 from docutils import nodes
-from docutils.nodes import Node, make_id, system_message
+from docutils.nodes import Node, make_id
 from docutils.parsers.rst import directives
 from docutils.parsers.rst.directives import images, tables
+from docutils.parsers.rst.directives.misc import Meta  # type: ignoreattr-defined
 from docutils.parsers.rst.roles import set_classes
 
-from sphinx import addnodes
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.directives import optional_int
 from sphinx.domains.math import MathDomain
 from sphinx.locale import __
@@ -28,12 +20,6 @@
 from sphinx.util.osutil import SEP, os_path, relpath
 from sphinx.util.typing import OptionSpec
 
-try:
-    from docutils.parsers.rst.directives.misc import Meta as MetaBase  # type: ignore
-except ImportError:
-    # docutils-0.17 or older
-    from docutils.parsers.rst.directives.html import Meta as MetaBase
-
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
 
@@ -46,7 +32,7 @@
     instead of the image node.
     """
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         name = self.options.pop('name', None)
         result = super().run()
         if len(result) == 2 or isinstance(result0, nodes.system_message):
@@ -67,49 +53,12 @@
         return figure_node
 
 
-class Meta(MetaBase, SphinxDirective):
-    def run(self) -> SequenceNode:
-        result = super().run()
-        for node in result:
-            # for docutils-0.17 or older.  Since docutils-0.18, patching is no longer needed
-            # because it uses picklable node; ``docutils.nodes.meta``.
-            if (isinstance(node, nodes.pending) and
-               isinstance(node.details'nodes'0, addnodes.docutils_meta)):
-                meta = node.details'nodes'0
-                meta.source = self.env.doc2path(self.env.docname)
-                meta.line = self.lineno
-                meta.rawcontent = meta'content'
-
-                # docutils' meta nodes aren't picklable because the class is nested
-                meta.__class__ = addnodes.meta
-
-        return result
-
-
-class RSTTable(tables.RSTTable):
-    """The table directive which sets source and line information to its caption.
-
-    Only for docutils-0.13 or older version."""
-
-    def run(self) -> ListNode:
-        warnings.warn('RSTTable is deprecated.',
-                      RemovedInSphinx60Warning)
-        return super().run()
-
-    def make_title(self) -> Tuplenodes.title, Listsystem_message:
-        title, message = super().make_title()
-        if title:
-            set_source_info(self, title)
-
-        return title, message
-
-
 class CSVTable(tables.CSVTable):
     """The csv-table directive which searches a CSV file from Sphinx project's source
     directory when an absolute path is given via :file: option.
     """
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if 'file' in self.options and self.options'file'.startswith((SEP, os.sep)):
             env = self.state.document.settings.env
             filename = self.options'file'
@@ -126,24 +75,6 @@
         return super().run()
 
 
-class ListTable(tables.ListTable):
-    """The list-table directive which sets source and line information to its caption.
-
-    Only for docutils-0.13 or older version."""
-
-    def run(self) -> ListNode:
-        warnings.warn('ListTable is deprecated.',
-                      RemovedInSphinx60Warning)
-        return super().run()
-
-    def make_title(self) -> Tuplenodes.title, Listsystem_message:
-        title, message = super().make_title()
-        if title:
-            set_source_info(self, title)
-
-        return title, message
-
-
 class Code(SphinxDirective):
     """Parse and mark up content of a code block.
 
@@ -158,7 +89,7 @@
     }
     has_content = True
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         self.assert_has_content()
 
         set_classes(self.options)
@@ -202,7 +133,7 @@
         'nowrap': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         latex = '\n'.join(self.content)
         if self.arguments and self.arguments0:
             latex = self.arguments0 + '\n\n' + latex
@@ -216,11 +147,11 @@
         self.add_name(node)
         self.set_source_info(node)
 
-        ret: ListNode = node
+        ret: listNode = node
         self.add_target(ret)
         return ret
 
-    def add_target(self, ret: ListNode) -> None:
+    def add_target(self, ret: listNode) -> None:
         node = cast(nodes.math_block, ret0)
 
         # assign label automatically if math_number_all enabled
@@ -244,7 +175,7 @@
         ret.insert(0, target)
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     directives.register_directive('figure', Figure)
     directives.register_directive('meta', Meta)
     directives.register_directive('csv-table', CSVTable)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/__init__.py Changed

@@ -1,18 +1,14 @@
-"""
-    sphinx.domains
-    ~~~~~~~~~~~~~~
-
-    Support for domains, which are groupings of description directives
-    and roles describing e.g. constructs of one programming language.
+"""Support for domains.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Domains are groupings of description directives
+and roles describing e.g. constructs of one programming language.
 """
 
+from __future__ import annotations
+
 import copy
 from abc import ABC, abstractmethod
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, List, NamedTuple, Optional,
-                    Tuple, Type, Union, cast)
+from typing import TYPE_CHECKING, Any, Callable, Iterable, NamedTuple, Optional, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
@@ -25,6 +21,8 @@
 from sphinx.util.typing import RoleFunction
 
 if TYPE_CHECKING:
+    from docutils.parsers.rst import Directive
+
     from sphinx.builders import Builder
     from sphinx.environment import BuildEnvironment
 
@@ -50,8 +48,8 @@
 
     def __init__(self, lname: str, *roles: Any, **attrs: Any) -> None:
         self.lname = lname
-        self.roles: Tuple = roles
-        self.attrs: Dict = self.known_attrs.copy()
+        self.roles: tuple = roles
+        self.attrs: dict = self.known_attrs.copy()
         self.attrs.update(attrs)
 
 
@@ -88,19 +86,19 @@
        :rst:role:`ref` role.
     """
 
-    name: str = None
-    localname: str = None
-    shortname: str = None
+    name: str
+    localname: str
+    shortname: str | None = None
 
-    def __init__(self, domain: "Domain") -> None:
+    def __init__(self, domain: Domain) -> None:
         if self.name is None or self.localname is None:
             raise SphinxError('Index subclass %s has no valid name or localname'
                               % self.__class__.__name__)
         self.domain = domain
 
     @abstractmethod
-    def generate(self, docnames: Iterablestr = None
-                 ) -> TupleListTuplestr, ListIndexEntry, bool:
+    def generate(self, docnames: Iterablestr | None = None,
+                 ) -> tuplelisttuplestr, listIndexEntry, bool:
         """Get entries for the index.
 
         If ``docnames`` is given, restrict to entries referring to these
@@ -153,6 +151,9 @@
         raise NotImplementedError
 
 
+TitleGetter = CallableNode, Optionalstr
+
+
 class Domain:
     """
     A Domain is meant to be a group of "object" description directives for
@@ -181,31 +182,30 @@
     #: domain label: longer, more descriptive (used in messages)
     label = ''
     #: type (usually directive) name -> ObjType instance
-    object_types: Dictstr, ObjType = {}
+    object_types: dictstr, ObjType = {}
     #: directive name -> directive class
-    directives: Dictstr, Any = {}
+    directives: dictstr, typeDirective = {}
     #: role name -> role callable
-    roles: Dictstr, UnionRoleFunction, XRefRole = {}
+    roles: dictstr, RoleFunction | XRefRole = {}
     #: a list of Index subclasses
-    indices: ListTypeIndex = 
+    indices: listtypeIndex = 
     #: role name -> a warning message if reference is missing
-    dangling_warnings: Dictstr, str = {}
+    dangling_warnings: dictstr, str = {}
     #: node_class -> (enum_node_type, title_getter)
-    enumerable_nodes: DictTypeNode, Tuplestr, Callable = {}
-
+    enumerable_nodes: dicttypeNode, tuplestr, TitleGetter | None = {}
     #: data value for a fresh environment
-    initial_data: Dict = {}
+    initial_data: dict = {}
     #: data value
-    data: Dict
+    data: dict
     #: data version, bump this when the format of `self.data` changes
     data_version = 0
 
-    def __init__(self, env: "BuildEnvironment") -> None:
+    def __init__(self, env: BuildEnvironment) -> None:
         self.env: BuildEnvironment = env
-        self._role_cache: Dictstr, Callable = {}
-        self._directive_cache: Dictstr, Callable = {}
-        self._role2type: Dictstr, Liststr = {}
-        self._type2role: Dictstr, str = {}
+        self._role_cache: dictstr, Callable = {}
+        self._directive_cache: dictstr, Callable = {}
+        self._role2type: dictstr, liststr = {}
+        self._type2role: dictstr, str = {}
 
         # convert class variables to instance one (to enhance through API)
         self.object_types = dict(self.object_types)
@@ -226,7 +226,7 @@
             for rolename in obj.roles:
                 self._role2type.setdefault(rolename, ).append(name)
             self._type2rolename = obj.roles0 if obj.roles else ''
-        self.objtypes_for_role: Callablestr, Liststr = self._role2type.get
+        self.objtypes_for_role: Callablestr, liststr = self._role2type.get
         self.role_for_objtype: Callablestr, str = self._type2role.get
 
     def setup(self) -> None:
@@ -237,7 +237,7 @@
         std = cast(StandardDomain, self.env.get_domain('std'))
         for index in self.indices:
             if index.name and index.localname:
-                docname = "%s-%s" % (self.name, index.name)
+                docname = f"{self.name}-{index.name}"
                 std.note_hyperlink_target(docname, docname, '', index.localname)
 
     def add_object_type(self, name: str, objtype: ObjType) -> None:
@@ -251,7 +251,7 @@
         for role in objtype.roles:
             self._role2type.setdefault(role, ).append(name)
 
-    def role(self, name: str) -> OptionalRoleFunction:
+    def role(self, name: str) -> RoleFunction | None:
         """Return a role adapter function that always gives the registered
         role its full name ('domain:name') as the first argument.
         """
@@ -259,17 +259,17 @@
             return self._role_cachename
         if name not in self.roles:
             return None
-        fullname = '%s:%s' % (self.name, name)
+        fullname = f'{self.name}:{name}'
 
         def role_adapter(typ: str, rawtext: str, text: str, lineno: int,
-                         inliner: Inliner, options: Dict = {}, content: Liststr = 
-                         ) -> TupleListNode, Listsystem_message:
+                         inliner: Inliner, options: dict = {}, content: liststr = ,
+                         ) -> tuplelistNode, listsystem_message:
             return self.rolesname(fullname, rawtext, text, lineno,
                                     inliner, options, content)
         self._role_cachename = role_adapter
         return role_adapter
 
-    def directive(self, name: str) -> OptionalCallable:
+    def directive(self, name: str) -> Callable | None:
         """Return a directive adapter class that always gives the registered
         directive its full name ('domain:name') as ``self.name``.
         """
@@ -277,11 +277,11 @@
             return self._directive_cachename
         if name not in self.directives:
             return None
-        fullname = '%s:%s' % (self.name, name)
+        fullname = f'{self.name}:{name}'
         BaseDirective = self.directivesname
 
-        class DirectiveAdapter(BaseDirective):  # type: ignore
-            def run(self) -> ListNode:
+        class DirectiveAdapter(BaseDirective):  # type: ignorevalid-type,misc
+            def run(self) -> listNode:
                 self.name = fullname
                 return super().run()
         self._directive_cachename = DirectiveAdapter
@@ -293,7 +293,7 @@
         """Remove traces of a document in the domain-specific inventories."""
         pass
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dict) -> None:
         """Merge in data regarding *docnames* from a different domaindata
         inventory (coming from a subprocess in parallel builds).
         """
@@ -301,7 +301,7 @@
                                   'to be able to do parallel builds!' %
                                   self.__class__)
 
-    def process_doc(self, env: "BuildEnvironment", docname: str,
+    def process_doc(self, env: BuildEnvironment, docname: str,
                     document: nodes.document) -> None:
         """Process a document after it is read by the environment."""
         pass
@@ -316,9 +316,9 @@
         """
         pass
 
-    def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder",
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+    def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         """Resolve the pending_xref *node* with the given *typ* and *target*.
 
         This method should return a new node, to replace the xref node,
@@ -334,9 +334,9 @@
         """
         pass
 
-    def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder",
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+    def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         """Resolve the pending_xref *node* with the given *target*.
 
         The reference comes from an "any" or similar role, which means that we
@@ -352,7 +352,7 @@
         """
         raise NotImplementedError
 
-    def get_objects(self) -> IterableTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iterabletuplestr, str, str, str, str, int:
         """Return an iterable of "object descriptions".
 
         Object descriptions are tuples with six items:
@@ -393,11 +393,11 @@
             return type.lname
         return _('%s %s') % (self.label, type.lname)
 
-    def get_enumerable_node_type(self, node: Node) -> Optionalstr:
+    def get_enumerable_node_type(self, node: Node) -> str | None:
         """Get type of enumerable nodes (experimental)."""
         enum_node_type, _ = self.enumerable_nodes.get(node.__class__, (None, None))
         return enum_node_type
 
-    def get_full_qualified_name(self, node: Element) -> Optionalstr:
+    def get_full_qualified_name(self, node: Element) -> str | None:
         """Return full qualified name for given node."""
-        return None
+        pass

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/c.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/c.py Changed

@@ -1,16 +1,9 @@
-"""
-    sphinx.domains.c
-    ~~~~~~~~~~~~~~~~
-
-    The C language domain.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""The C language domain."""
+
+from __future__ import annotations
 
 import re
-from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple, TypeVar,
-                    Union, cast)
+from typing import Any, Callable, Generator, Iterator, TypeVar, Union, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement, system_message
@@ -20,7 +13,6 @@
 from sphinx.addnodes import pending_xref
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.directives import ObjectDescription
 from sphinx.domains import Domain, ObjType
 from sphinx.environment import BuildEnvironment
@@ -29,13 +21,27 @@
 from sphinx.transforms import SphinxTransform
 from sphinx.transforms.post_transforms import ReferencesResolver
 from sphinx.util import logging
-from sphinx.util.cfamily import (ASTAttribute, ASTBaseBase, ASTBaseParenExprList, BaseParser,
-                                 DefinitionError, NoOldIdError, StringifyTransform,
-                                 UnsupportedMultiCharacterCharLiteral, anon_identifier_re,
-                                 binary_literal_re, char_literal_re, float_literal_re,
-                                 float_literal_suffix_re, hex_literal_re, identifier_re,
-                                 integer_literal_re, integers_literal_suffix_re,
-                                 octal_literal_re, verify_description_mode)
+from sphinx.util.cfamily import (
+    ASTAttributeList,
+    ASTBaseBase,
+    ASTBaseParenExprList,
+    BaseParser,
+    DefinitionError,
+    NoOldIdError,
+    StringifyTransform,
+    UnsupportedMultiCharacterCharLiteral,
+    anon_identifier_re,
+    binary_literal_re,
+    char_literal_re,
+    float_literal_re,
+    float_literal_suffix_re,
+    hex_literal_re,
+    identifier_re,
+    integer_literal_re,
+    integers_literal_suffix_re,
+    octal_literal_re,
+    verify_description_mode,
+)
 from sphinx.util.docfields import Field, GroupedField, TypedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import make_refnode
@@ -78,7 +84,7 @@
     '<<', '>>',
     '+', '-',
     '*', '/', '%',
-    '.*', '->*'
+    '.*', '->*',
 
 _expression_unary_ops = "++", "--", "*", "&", "+", "-", "!", "not", "~", "compl"
 _expression_assignment_ops = "=", "*=", "/=", "%=", "+=", "-=",
@@ -92,8 +98,8 @@
 _string_re = re.compile(r"LuU8?('(^'\\*(?:\\.^'\\*)*)'"
                         r'|"(^"\\*(?:\\.^"\\*)*)")', re.S)
 
-# bool, complex, and imaginary are macro "keywords", so they are handled seperately
-_simple_type_specifiers_re = re.compile(r"""(?x)
+# bool, complex, and imaginary are macro "keywords", so they are handled separately
+_simple_type_specifiers_re = re.compile(r"""
     \b(
     void|_Bool
     |signed|unsigned
@@ -109,11 +115,11 @@
     |__fp16  # extension
     |_Sat|_Fract|fract|_Accum|accum  # extension
     )\b
-""")
+""", re.VERBOSE)
 
 
 class _DuplicateSymbolError(Exception):
-    def __init__(self, symbol: "Symbol", declaration: "ASTDeclaration") -> None:
+    def __init__(self, symbol: Symbol, declaration: ASTDeclaration) -> None:
         assert symbol
         assert declaration
         self.symbol = symbol
@@ -125,7 +131,7 @@
 
 class ASTBase(ASTBaseBase):
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         raise NotImplementedError(repr(self))
 
 
@@ -152,8 +158,8 @@
     def get_display_string(self) -> str:
         return "anonymous" if self.is_anon() else self.identifier
 
-    def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment",
-                           prefix: str, symbol: "Symbol") -> None:
+    def describe_signature(self, signode: TextElement, mode: str, env: BuildEnvironment,
+                           prefix: str, symbol: Symbol) -> None:
         # note: slightly different signature of describe_signature due to the prefix
         verify_description_mode(mode)
         if self.is_anon():
@@ -180,13 +186,13 @@
 
 
 class ASTNestedName(ASTBase):
-    def __init__(self, names: ListASTIdentifier, rooted: bool) -> None:
+    def __init__(self, names: listASTIdentifier, rooted: bool) -> None:
         assert len(names) > 0
         self.names = names
         self.rooted = rooted
 
     @property
-    def name(self) -> "ASTNestedName":
+    def name(self) -> ASTNestedName:
         return self
 
     def get_id(self, version: int) -> str:
@@ -200,16 +206,16 @@
             return res
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         # just print the name part, with template args, not template params
         if mode == 'noneIsName':
             if self.rooted:
-                assert False, "Can this happen?"  # TODO
+                raise AssertionError("Can this happen?")  # TODO
                 signode += nodes.Text('.')
             for i in range(len(self.names)):
                 if i != 0:
-                    assert False, "Can this happen?"  # TODO
+                    raise AssertionError("Can this happen?")  # TODO
                     signode += nodes.Text('.')
                 n = self.namesi
                 n.describe_signature(signode, mode, env, '', symbol)
@@ -282,7 +288,7 @@
             return 'false'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         txt = str(self)
         signode += addnodes.desc_sig_keyword(txt, txt)
 
@@ -295,7 +301,7 @@
         return self.data
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         txt = str(self)
         signode += addnodes.desc_sig_literal_number(txt, txt)
 
@@ -317,7 +323,7 @@
             return self.prefix + "'" + self.data + "'"
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         txt = str(self)
         signode += addnodes.desc_sig_literal_char(txt, txt)
 
@@ -330,7 +336,7 @@
         return self.data
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         txt = str(self)
         signode += addnodes.desc_sig_literal_string(txt, txt)
 
@@ -347,7 +353,7 @@
         return self.name.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.name.describe_signature(signode, mode, env, symbol)
 
 
@@ -362,7 +368,7 @@
         return self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation(')', ')')
@@ -376,14 +382,14 @@
 
 
 class ASTPostfixCallExpr(ASTPostfixOp):
-    def __init__(self, lst: Union"ASTParenExprList", "ASTBracedInitList") -> None:
+    def __init__(self, lst: ASTParenExprList | ASTBracedInitList) -> None:
         self.lst = lst
 
     def _stringify(self, transform: StringifyTransform) -> str:
         return transform(self.lst)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.lst.describe_signature(signode, mode, env, symbol)
 
 
@@ -395,7 +401,7 @@
         return '' + transform(self.expr) + ''
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('', '')
         self.expr.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation('', '')
@@ -406,7 +412,7 @@
         return '++'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_operator('++', '++')
 
 
@@ -415,7 +421,7 @@
         return '--'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_operator('--', '--')
 
 
@@ -427,13 +433,13 @@
         return '->' + transform(self.name)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_operator('->', '->')
         self.name.describe_signature(signode, 'noneIsName', env, symbol)
 
 
 class ASTPostfixExpr(ASTExpression):
-    def __init__(self, prefix: ASTExpression, postFixes: ListASTPostfixOp):
+    def __init__(self, prefix: ASTExpression, postFixes: listASTPostfixOp):
         self.prefix = prefix
         self.postFixes = postFixes
 
@@ -444,7 +450,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.prefix.describe_signature(signode, mode, env, symbol)
         for p in self.postFixes:
             p.describe_signature(signode, mode, env, symbol)
@@ -465,7 +471,7 @@
             return self.op + transform(self.expr)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.op0 in 'cn':
             signode += addnodes.desc_sig_keyword(self.op, self.op)
             signode += addnodes.desc_sig_space()
@@ -482,7 +488,7 @@
         return "sizeof(" + transform(self.typ) + ")"
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
@@ -497,21 +503,21 @@
         return "sizeof " + transform(self.expr)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
         signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTAlignofExpr(ASTExpression):
-    def __init__(self, typ: "ASTType"):
+    def __init__(self, typ: ASTType):
         self.typ = typ
 
     def _stringify(self, transform: StringifyTransform) -> str:
         return "alignof(" + transform(self.typ) + ")"
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('alignof', 'alignof')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
@@ -522,7 +528,7 @@
 ################################################################################
 
 class ASTCastExpr(ASTExpression):
-    def __init__(self, typ: "ASTType", expr: ASTExpression):
+    def __init__(self, typ: ASTType, expr: ASTExpression):
         self.typ = typ
         self.expr = expr
 
@@ -534,7 +540,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation(')', ')')
@@ -542,7 +548,7 @@
 
 
 class ASTBinOpExpr(ASTBase):
-    def __init__(self, exprs: ListASTExpression, ops: Liststr):
+    def __init__(self, exprs: listASTExpression, ops: liststr):
         assert len(exprs) > 0
         assert len(exprs) == len(ops) + 1
         self.exprs = exprs
@@ -559,7 +565,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.exprs0.describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
             signode += addnodes.desc_sig_space()
@@ -573,7 +579,7 @@
 
 
 class ASTAssignmentExpr(ASTExpression):
-    def __init__(self, exprs: ListASTExpression, ops: Liststr):
+    def __init__(self, exprs: listASTExpression, ops: liststr):
         assert len(exprs) > 0
         assert len(exprs) == len(ops) + 1
         self.exprs = exprs
@@ -590,7 +596,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.exprs0.describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
             signode += addnodes.desc_sig_space()
@@ -614,7 +620,7 @@
         return str(self.expr)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += nodes.literal(self.expr, self.expr)
 
 
@@ -627,7 +633,7 @@
 
 
 class ASTTrailingTypeSpecFundamental(ASTTrailingTypeSpec):
-    def __init__(self, names: Liststr) -> None:
+    def __init__(self, names: liststr) -> None:
         assert len(names) != 0
         self.names = names
 
@@ -635,7 +641,7 @@
         return ' '.join(self.names)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         first = True
         for n in self.names:
             if not first:
@@ -663,7 +669,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.prefix:
             signode += addnodes.desc_sig_keyword(self.prefix, self.prefix)
             signode += addnodes.desc_sig_space()
@@ -671,11 +677,11 @@
 
 
 class ASTFunctionParameter(ASTBase):
-    def __init__(self, arg: "ASTTypeWithInit", ellipsis: bool = False) -> None:
+    def __init__(self, arg: ASTTypeWithInit | None, ellipsis: bool = False) -> None:
         self.arg = arg
         self.ellipsis = ellipsis
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         # the anchor will be our parent
         return symbol.parent.declaration.get_id(version, prefixed=False)
 
@@ -686,7 +692,7 @@
             return transform(self.arg)
 
     def describe_signature(self, signode: Any, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.ellipsis:
             signode += addnodes.desc_sig_punctuation('...', '...')
@@ -695,12 +701,12 @@
 
 
 class ASTParameters(ASTBase):
-    def __init__(self, args: ListASTFunctionParameter, attrs: ListASTAttribute) -> None:
+    def __init__(self, args: listASTFunctionParameter, attrs: ASTAttributeList) -> None:
         self.args = args
         self.attrs = attrs
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.args
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -713,13 +719,13 @@
             first = False
             res.append(str(a))
         res.append(')')
-        for attr in self.attrs:
+        if len(self.attrs) != 0:
             res.append(' ')
-            res.append(transform(attr))
+            res.append(transform(self.attrs))
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         # only use the desc_parameterlist for the outer list, not for inner lists
         if mode == 'lastIsName':
@@ -740,14 +746,14 @@
                 arg.describe_signature(signode, 'markType', env, symbol=symbol)
             signode += addnodes.desc_sig_punctuation(')', ')')
 
-        for attr in self.attrs:
+        if len(self.attrs) != 0:
             signode += addnodes.desc_sig_space()
-            attr.describe_signature(signode)
+            self.attrs.describe_signature(signode)
 
 
 class ASTDeclSpecsSimple(ASTBaseBase):
     def __init__(self, storage: str, threadLocal: str, inline: bool,
-                 restrict: bool, volatile: bool, const: bool, attrs: ListAny) -> None:
+                 restrict: bool, volatile: bool, const: bool, attrs: ASTAttributeList) -> None:
         self.storage = storage
         self.threadLocal = threadLocal
         self.inline = inline
@@ -756,7 +762,7 @@
         self.const = const
         self.attrs = attrs
 
-    def mergeWith(self, other: "ASTDeclSpecsSimple") -> "ASTDeclSpecsSimple":
+    def mergeWith(self, other: ASTDeclSpecsSimple) -> ASTDeclSpecsSimple:
         if not other:
             return self
         return ASTDeclSpecsSimple(self.storage or other.storage,
@@ -768,8 +774,9 @@
                                   self.attrs + other.attrs)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res: Liststr = 
-        res.extend(transform(attr) for attr in self.attrs)
+        res: liststr = 
+        if len(self.attrs) != 0:
+            res.append(transform(self.attrs))
         if self.storage:
             res.append(self.storage)
         if self.threadLocal:
@@ -784,16 +791,17 @@
             res.append('const')
         return ' '.join(res)
 
-    def describe_signature(self, modifiers: ListNode) -> None:
-        def _add(modifiers: ListNode, text: str) -> None:
-            if len(modifiers) > 0:
+    def describe_signature(self, modifiers: listNode) -> None:
+        def _add(modifiers: listNode, text: str) -> None:
+            if len(modifiers) != 0:
                 modifiers.append(addnodes.desc_sig_space())
             modifiers.append(addnodes.desc_sig_keyword(text, text))
 
-        for attr in self.attrs:
-            if len(modifiers) > 0:
-                modifiers.append(addnodes.desc_sig_space())
-            modifiers.append(attr.describe_signature(modifiers))
+        if len(modifiers) != 0 and len(self.attrs) != 0:
+            modifiers.append(addnodes.desc_sig_space())
+        tempNode = nodes.TextElement()
+        self.attrs.describe_signature(tempNode)
+        modifiers.extend(tempNode.children)
         if self.storage:
             _add(modifiers, self.storage)
         if self.threadLocal:
@@ -822,7 +830,7 @@
         self.trailingTypeSpec = trailing
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res: Liststr = 
+        res: liststr = 
         l = transform(self.leftSpecs)
         if len(l) > 0:
             res.append(l)
@@ -838,9 +846,9 @@
         return "".join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
-        modifiers: ListNode = 
+        modifiers: listNode = 
 
         self.leftSpecs.describe_signature(modifiers)
 
@@ -893,7 +901,7 @@
         return '' + ' '.join(el) + ''
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('', '')
         addSpace = False
@@ -927,7 +935,7 @@
         raise NotImplementedError(repr(self))
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         raise NotImplementedError(repr(self))
 
     def require_space_after_declSpecs(self) -> bool:
@@ -936,7 +944,7 @@
 
 class ASTDeclaratorNameParam(ASTDeclarator):
     def __init__(self, declId: ASTNestedName,
-                 arrayOps: ListASTArray, param: ASTParameters) -> None:
+                 arrayOps: listASTArray, param: ASTParameters) -> None:
         self.declId = declId
         self.arrayOps = arrayOps
         self.param = param
@@ -946,7 +954,7 @@
         return self.declId
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.param.function_params
 
     # ------------------------------------------------------------------------
@@ -965,7 +973,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.declId:
             self.declId.describe_signature(signode, mode, env, symbol)
@@ -998,7 +1006,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.declId:
             self.declId.describe_signature(signode, mode, env, symbol)
@@ -1010,7 +1018,7 @@
 
 class ASTDeclaratorPtr(ASTDeclarator):
     def __init__(self, next: ASTDeclarator, restrict: bool, volatile: bool, const: bool,
-                 attrs: Any) -> None:
+                 attrs: ASTAttributeList) -> None:
         assert next
         self.next = next
         self.restrict = restrict
@@ -1023,7 +1031,7 @@
         return self.next.name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.next.function_params
 
     def require_space_after_declSpecs(self) -> bool:
@@ -1033,9 +1041,8 @@
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = '*'
-        for a in self.attrs:
-            res.append(transform(a))
-        if len(self.attrs) > 0 and (self.restrict or self.volatile or self.const):
+        res.append(transform(self.attrs))
+        if len(self.attrs) != 0 and (self.restrict or self.volatile or self.const):
             res.append(' ')
         if self.restrict:
             res.append('restrict')
@@ -1054,12 +1061,11 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('*', '*')
-        for a in self.attrs:
-            a.describe_signature(signode)
-        if len(self.attrs) > 0 and (self.restrict or self.volatile or self.const):
+        self.attrs.describe_signature(signode)
+        if len(self.attrs) != 0 and (self.restrict or self.volatile or self.const):
             signode += addnodes.desc_sig_space()
 
         def _add_anno(signode: TextElement, text: str) -> None:
@@ -1094,7 +1100,7 @@
         return self.inner.name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.inner.function_params
 
     def require_space_after_declSpecs(self) -> bool:
@@ -1108,7 +1114,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.inner.describe_signature(signode, mode, env, symbol)
@@ -1120,7 +1126,7 @@
 ################################################################################
 
 class ASTParenExprList(ASTBaseParenExprList):
-    def __init__(self, exprs: ListASTExpression) -> None:
+    def __init__(self, exprs: listASTExpression) -> None:
         self.exprs = exprs
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1128,7 +1134,7 @@
         return '(%s)' % ', '.join(exprs)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('(', '(')
         first = True
@@ -1143,17 +1149,17 @@
 
 
 class ASTBracedInitList(ASTBase):
-    def __init__(self, exprs: ListASTExpression, trailingComma: bool) -> None:
+    def __init__(self, exprs: listASTExpression, trailingComma: bool) -> None:
         self.exprs = exprs
         self.trailingComma = trailingComma
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        exprs = transform(e) for e in self.exprs
+        exprs = ', '.join(transform(e) for e in self.exprs)
         trailingComma = ',' if self.trailingComma else ''
-        return '{%s%s}' % (', '.join(exprs), trailingComma)
+        return f'{{{exprs}{trailingComma}}}'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('{', '{')
         first = True
@@ -1170,7 +1176,7 @@
 
 
 class ASTInitializer(ASTBase):
-    def __init__(self, value: UnionASTBracedInitList, ASTExpression,
+    def __init__(self, value: ASTBracedInitList | ASTExpression,
                  hasAssign: bool = True) -> None:
         self.value = value
         self.hasAssign = hasAssign
@@ -1183,7 +1189,7 @@
             return val
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.hasAssign:
             signode += addnodes.desc_sig_space()
@@ -1203,11 +1209,11 @@
     def name(self) -> ASTNestedName:
         return self.decl.name
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.decl.function_params
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1226,7 +1232,7 @@
             return 'type'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.declSpecs.describe_signature(signode, 'markType', env, symbol)
         if (self.decl.require_space_after_declSpecs() and
@@ -1248,7 +1254,7 @@
     def name(self) -> ASTNestedName:
         return self.type.name
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return self.type.get_id(version, objectType, symbol)
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1259,7 +1265,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.type.describe_signature(signode, mode, env, symbol)
         if self.init:
@@ -1267,7 +1273,7 @@
 
 
 class ASTMacroParameter(ASTBase):
-    def __init__(self, arg: ASTNestedName, ellipsis: bool = False,
+    def __init__(self, arg: ASTNestedName | None, ellipsis: bool = False,
                  variadic: bool = False) -> None:
         self.arg = arg
         self.ellipsis = ellipsis
@@ -1282,7 +1288,7 @@
             return transform(self.arg)
 
     def describe_signature(self, signode: Any, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.ellipsis:
             signode += addnodes.desc_sig_punctuation('...', '...')
@@ -1294,7 +1300,7 @@
 
 
 class ASTMacro(ASTBase):
-    def __init__(self, ident: ASTNestedName, args: ListASTMacroParameter) -> None:
+    def __init__(self, ident: ASTNestedName, args: listASTMacroParameter | None) -> None:
         self.ident = ident
         self.args = args
 
@@ -1302,7 +1308,7 @@
     def name(self) -> ASTNestedName:
         return self.ident
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1320,7 +1326,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.ident.describe_signature(signode, mode, env, symbol)
         if self.args is None:
@@ -1337,14 +1343,14 @@
     def __init__(self, name: ASTNestedName) -> None:
         self.name = name
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
         return transform(self.name)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol=symbol)
 
@@ -1353,14 +1359,14 @@
     def __init__(self, name: ASTNestedName) -> None:
         self.name = name
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
         return transform(self.name)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol=symbol)
 
@@ -1369,44 +1375,52 @@
     def __init__(self, name: ASTNestedName) -> None:
         self.name = name
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
         return transform(self.name)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol=symbol)
 
 
 class ASTEnumerator(ASTBase):
-    def __init__(self, name: ASTNestedName, init: ASTInitializer) -> None:
+    def __init__(self, name: ASTNestedName, init: ASTInitializer | None,
+                 attrs: ASTAttributeList) -> None:
         self.name = name
         self.init = init
+        self.attrs = attrs
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = 
         res.append(transform(self.name))
+        if len(self.attrs) != 0:
+            res.append(' ')
+            res.append(transform(self.attrs))
         if self.init:
             res.append(transform(self.init))
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol)
+        if len(self.attrs) != 0:
+            signode += addnodes.desc_sig_space()
+            self.attrs.describe_signature(signode)
         if self.init:
             self.init.describe_signature(signode, 'markType', env, symbol)
 
 
 class ASTDeclaration(ASTBaseBase):
-    def __init__(self, objectType: str, directiveType: str,
-                 declaration: UnionDeclarationType, ASTFunctionParameter,
+    def __init__(self, objectType: str, directiveType: str | None,
+                 declaration: DeclarationType | ASTFunctionParameter,
                  semicolon: bool = False) -> None:
         self.objectType = objectType
         self.directiveType = directiveType
@@ -1417,7 +1431,7 @@
         # set by CObject._add_enumerator_to_parent
         self.enumeratorScopedSymbol: Symbol = None
 
-    def clone(self) -> "ASTDeclaration":
+    def clone(self) -> ASTDeclaration:
         return ASTDeclaration(self.objectType, self.directiveType,
                               self.declaration.clone(), self.semicolon)
 
@@ -1427,7 +1441,7 @@
         return decl.name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter | None:
         if self.objectType != 'function':
             return None
         decl = cast(ASTType, self.declaration)
@@ -1452,7 +1466,7 @@
         return res
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", options: Dict) -> None:
+                           env: BuildEnvironment, options: dict) -> None:
         verify_description_mode(mode)
         assert self.symbol
         # The caller of the domain added a desc_signature node.
@@ -1464,11 +1478,7 @@
         mainDeclNode'add_permalink' = not self.symbol.isRedeclaration
         signode += mainDeclNode
 
-        if self.objectType == 'member':
-            pass
-        elif self.objectType == 'function':
-            pass
-        elif self.objectType == 'macro':
+        if self.objectType in {'member', 'function', 'macro'}:
             pass
         elif self.objectType == 'struct':
             mainDeclNode += addnodes.desc_sig_keyword('struct', 'struct')
@@ -1488,14 +1498,14 @@
             mainDeclNode += addnodes.desc_sig_keyword(prefix, prefix)
             mainDeclNode += addnodes.desc_sig_space()
         else:
-            assert False
+            raise AssertionError()
         self.declaration.describe_signature(mainDeclNode, mode, env, self.symbol)
         if self.semicolon:
             mainDeclNode += addnodes.desc_sig_punctuation(';', ';')
 
 
 class SymbolLookupResult:
-    def __init__(self, symbols: Iterator"Symbol", parentSymbol: "Symbol",
+    def __init__(self, symbols: IteratorSymbol, parentSymbol: Symbol,
                  ident: ASTIdentifier) -> None:
         self.symbols = symbols
         self.parentSymbol = parentSymbol
@@ -1503,12 +1513,12 @@
 
 
 class LookupKey:
-    def __init__(self, data: ListTupleASTIdentifier, str) -> None:
+    def __init__(self, data: listtupleASTIdentifier, str) -> None:
         self.data = data
 
     def __str__(self) -> str:
-        return '{}'.format(', '.join("({}, {})".format(
-            ident, id_) for ident, id_ in self.data))
+        inner = ', '.join(f"({ident}, {id_})" for ident, id_ in self.data)
+        return f'{inner}'
 
 
 class Symbol:
@@ -1518,14 +1528,13 @@
     debug_show_tree = False
 
     def __copy__(self):
-        assert False  # shouldn't happen
+        raise AssertionError()  # shouldn't happen
 
     def __deepcopy__(self, memo):
         if self.parent:
-            assert False  # shouldn't happen
-        else:
-            # the domain base class makes a copy of the initial data, which is fine
-            return Symbol(None, None, None, None, None)
+            raise AssertionError()  # shouldn't happen
+        # the domain base class makes a copy of the initial data, which is fine
+        return Symbol(None, None, None, None, None)
 
     @staticmethod
     def debug_print(*args: Any) -> None:
@@ -1543,12 +1552,17 @@
 
     def __setattr__(self, key: str, value: Any) -> None:
         if key == "children":
-            assert False
-        else:
-            return super().__setattr__(key, value)
+            raise AssertionError()
+        return super().__setattr__(key, value)
 
-    def __init__(self, parent: "Symbol", ident: ASTIdentifier,
-                 declaration: ASTDeclaration, docname: str, line: int) -> None:
+    def __init__(
+        self,
+        parent: Symbol,
+        ident: ASTIdentifier,
+        declaration: ASTDeclaration | None,
+        docname: str | None,
+        line: int | None,
+    ) -> None:
         self.parent = parent
         # declarations in a single directive are linked together
         self.siblingAbove: Symbol = None
@@ -1561,8 +1575,8 @@
         self._assert_invariants()
 
         # Remember to modify Symbol.remove if modifications to the parent change.
-        self._children: ListSymbol = 
-        self._anonChildren: ListSymbol = 
+        self._children: listSymbol = 
+        self._anonChildren: listSymbol = 
         # note: _children includes _anonChildren
         if self.parent:
             self.parent._children.append(self)
@@ -1632,24 +1646,24 @@
                 sChild.siblingAbove = None
                 sChild.siblingBelow = None
 
-    def get_all_symbols(self) -> Iterator"Symbol":
+    def get_all_symbols(self) -> IteratorSymbol:
         yield self
         for sChild in self._children:
             yield from sChild.get_all_symbols()
 
     @property
-    def children(self) -> Iterator"Symbol":
+    def children(self) -> IteratorSymbol:
         yield from self._children
 
     @property
-    def children_recurse_anon(self) -> Iterator"Symbol":
+    def children_recurse_anon(self) -> IteratorSymbol:
         for c in self._children:
             yield c
             if not c.ident.is_anon():
                 continue
             yield from c.children_recurse_anon
 
-    def get_lookup_key(self) -> "LookupKey":
+    def get_lookup_key(self) -> LookupKey:
         # The pickle files for the environment and for each document are distinct.
         # The environment has all the symbols, but the documents has xrefs that
         # must know their scope. A lookup key is essentially a specification of
@@ -1682,7 +1696,7 @@
         return ASTNestedName(names, rooted=False)
 
     def _find_first_named_symbol(self, ident: ASTIdentifier,
-                                 matchSelf: bool, recurseInAnon: bool) -> "Symbol":
+                                 matchSelf: bool, recurseInAnon: bool) -> Symbol | None:
         # TODO: further simplification from C++ to C
         if Symbol.debug_lookup:
             Symbol.debug_print("_find_first_named_symbol ->")
@@ -1695,7 +1709,7 @@
 
     def _find_named_symbols(self, ident: ASTIdentifier,
                             matchSelf: bool, recurseInAnon: bool,
-                            searchInSiblings: bool) -> Iterator"Symbol":
+                            searchInSiblings: bool) -> IteratorSymbol:
         # TODO: further simplification from C++ to C
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
@@ -1708,7 +1722,7 @@
             Symbol.debug_print("recurseInAnon:    ", recurseInAnon)
             Symbol.debug_print("searchInSiblings: ", searchInSiblings)
 
-        def candidates() -> Generator"Symbol", None, None:
+        def candidates() -> GeneratorSymbol, None, None:
             s = self
             if Symbol.debug_lookup:
                 Symbol.debug_print("searching in self:")
@@ -1743,10 +1757,15 @@
         if Symbol.debug_lookup:
             Symbol.debug_indent -= 2
 
-    def _symbol_lookup(self, nestedName: ASTNestedName,
-                       onMissingQualifiedSymbol: Callable"Symbol", ASTIdentifier, "Symbol",  # NOQA
-                       ancestorLookupType: str, matchSelf: bool,
-                       recurseInAnon: bool, searchInSiblings: bool) -> SymbolLookupResult:
+    def _symbol_lookup(
+        self,
+        nestedName: ASTNestedName,
+        onMissingQualifiedSymbol: CallableSymbol, ASTIdentifier, Symbol | None,
+        ancestorLookupType: str | None,
+        matchSelf: bool,
+        recurseInAnon: bool,
+        searchInSiblings: bool,
+    ) -> SymbolLookupResult | None:
         # TODO: further simplification from C++ to C
         # ancestorLookupType: if not None, specifies the target type of the lookup
         if Symbol.debug_lookup:
@@ -1815,8 +1834,13 @@
             Symbol.debug_indent -= 2
         return SymbolLookupResult(symbols, parentSymbol, ident)
 
-    def _add_symbols(self, nestedName: ASTNestedName,
-                     declaration: ASTDeclaration, docname: str, line: int) -> "Symbol":
+    def _add_symbols(
+        self,
+        nestedName: ASTNestedName,
+        declaration: ASTDeclaration | None,
+        docname: str | None,
+        line: int | None,
+    ) -> Symbol:
         # TODO: further simplification from C++ to C
         # Used for adding a whole path of symbols, where the last may or may not
         # be an actual declaration.
@@ -1827,9 +1851,9 @@
             Symbol.debug_indent += 1
             Symbol.debug_print("nn:       ", nestedName)
             Symbol.debug_print("decl:     ", declaration)
-            Symbol.debug_print("location: {}:{}".format(docname, line))
+            Symbol.debug_print(f"location: {docname}:{line}")
 
-        def onMissingQualifiedSymbol(parentSymbol: "Symbol", ident: ASTIdentifier) -> "Symbol":
+        def onMissingQualifiedSymbol(parentSymbol: Symbol, ident: ASTIdentifier) -> Symbol:
             if Symbol.debug_lookup:
                 Symbol.debug_indent += 1
                 Symbol.debug_print("_add_symbols, onMissingQualifiedSymbol:")
@@ -1853,7 +1877,7 @@
                 Symbol.debug_indent += 1
                 Symbol.debug_print("ident:       ", lookupResult.ident)
                 Symbol.debug_print("declaration: ", declaration)
-                Symbol.debug_print("location:    {}:{}".format(docname, line))
+                Symbol.debug_print(f"location:    {docname}:{line}")
                 Symbol.debug_indent -= 1
             symbol = Symbol(parent=lookupResult.parentSymbol,
                             ident=lookupResult.ident,
@@ -1900,7 +1924,7 @@
         # First check if one of those with a declaration matches.
         # If it's a function, we need to compare IDs,
         # otherwise there should be only one symbol with a declaration.
-        def makeCandSymbol() -> "Symbol":
+        def makeCandSymbol() -> Symbol:
             if Symbol.debug_lookup:
                 Symbol.debug_print("begin: creating candidate symbol")
             symbol = Symbol(parent=lookupResult.parentSymbol,
@@ -1916,7 +1940,7 @@
         else:
             candSymbol = makeCandSymbol()
 
-            def handleDuplicateDeclaration(symbol: "Symbol", candSymbol: "Symbol") -> None:
+            def handleDuplicateDeclaration(symbol: Symbol, candSymbol: Symbol) -> None:
                 if Symbol.debug_lookup:
                     Symbol.debug_indent += 1
                     Symbol.debug_print("redeclaration")
@@ -1949,7 +1973,9 @@
         # if there is an empty symbol, fill that one
         if len(noDecl) == 0:
             if Symbol.debug_lookup:
-                Symbol.debug_print("no match, no empty, candSybmol is not None?:", candSymbol is not None)  # NOQA
+                Symbol.debug_print(
+                    "no match, no empty, candSybmol is not None?:", candSymbol is not None,
+                )
                 Symbol.debug_indent -= 2
             if candSymbol is not None:
                 return candSymbol
@@ -1959,7 +1985,7 @@
             if Symbol.debug_lookup:
                 Symbol.debug_print(
                     "no match, but fill an empty declaration, candSybmol is not None?:",
-                    candSymbol is not None)  # NOQA
+                    candSymbol is not None)
                 Symbol.debug_indent -= 2
             if candSymbol is not None:
                 candSymbol.remove()
@@ -1975,8 +2001,8 @@
             symbol._fill_empty(declaration, docname, line)
             return symbol
 
-    def merge_with(self, other: "Symbol", docnames: Liststr,
-                   env: "BuildEnvironment") -> None:
+    def merge_with(self, other: Symbol, docnames: liststr,
+                   env: BuildEnvironment) -> None:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("merge_with:")
@@ -2011,7 +2037,7 @@
         if Symbol.debug_lookup:
             Symbol.debug_indent -= 1
 
-    def add_name(self, nestedName: ASTNestedName) -> "Symbol":
+    def add_name(self, nestedName: ASTNestedName) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("add_name:")
@@ -2021,7 +2047,7 @@
         return res
 
     def add_declaration(self, declaration: ASTDeclaration,
-                        docname: str, line: int) -> "Symbol":
+                        docname: str, line: int) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("add_declaration:")
@@ -2035,8 +2061,8 @@
         return res
 
     def find_identifier(self, ident: ASTIdentifier,
-                        matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool
-                        ) -> "Symbol":
+                        matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool,
+                        ) -> Symbol | None:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("find_identifier:")
@@ -2065,7 +2091,7 @@
             current = current.siblingAbove
         return None
 
-    def direct_lookup(self, key: "LookupKey") -> "Symbol":
+    def direct_lookup(self, key: LookupKey) -> Symbol | None:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("direct_lookup:")
@@ -2094,14 +2120,16 @@
         return s
 
     def find_declaration(self, nestedName: ASTNestedName, typ: str,
-                         matchSelf: bool, recurseInAnon: bool) -> "Symbol":
+                         matchSelf: bool, recurseInAnon: bool) -> Symbol | None:
         # templateShorthand: missing template parameter lists for templates is ok
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("find_declaration:")
 
-        def onMissingQualifiedSymbol(parentSymbol: "Symbol",
-                                     ident: ASTIdentifier) -> "Symbol":
+        def onMissingQualifiedSymbol(
+            parentSymbol: Symbol,
+            ident: ASTIdentifier,
+        ) -> Symbol | None:
             return None
 
         lookupResult = self._symbol_lookup(nestedName,
@@ -2161,7 +2189,7 @@
     def paren_attributes(self):
         return self.config.c_paren_attributes
 
-    def _parse_string(self) -> str:
+    def _parse_string(self) -> str | None:
         if self.current_char != '"':
             return None
         startPos = self.pos
@@ -2180,7 +2208,7 @@
             self.pos += 1
         return self.definitionstartPos:self.pos
 
-    def _parse_literal(self) -> ASTLiteral:
+    def _parse_literal(self) -> ASTLiteral | None:
         # -> integer-literal
         #  | character-literal
         #  | floating-literal
@@ -2218,7 +2246,7 @@
                           " resulting in multiple decoded characters.")
         return None
 
-    def _parse_paren_expression(self) -> ASTExpression:
+    def _parse_paren_expression(self) -> ASTExpression | None:
         # "(" expression ")"
         if self.current_char != '(':
             return None
@@ -2229,12 +2257,12 @@
             self.fail("Expected ')' in end of parenthesized expression.")
         return ASTParenExpr(res)
 
-    def _parse_primary_expression(self) -> ASTExpression:
+    def _parse_primary_expression(self) -> ASTExpression | None:
         # literal
         # "(" expression ")"
         # id-expression -> we parse this with _parse_nested_name
         self.skip_ws()
-        res: ASTExpression = self._parse_literal()
+        res: ASTExpression | None = self._parse_literal()
         if res is not None:
             return res
         res = self._parse_paren_expression()
@@ -2245,8 +2273,8 @@
             return ASTIdExpression(nn)
         return None
 
-    def _parse_initializer_list(self, name: str, open: str, close: str
-                                ) -> TupleListASTExpression, bool:
+    def _parse_initializer_list(self, name: str, open: str, close: str,
+                                ) -> tuplelistASTExpression, bool:
         # Parse open and close with the actual initializer-list in between
         # -> initializer-clause '...'opt
         #  | initializer-list ',' initializer-clause '...'opt
@@ -2268,14 +2296,14 @@
             if self.skip_string(close):
                 break
             if not self.skip_string_and_ws(','):
-                self.fail("Error in %s, expected ',' or '%s'." % (name, close))
+                self.fail(f"Error in {name}, expected ',' or '{close}'.")
             if self.current_char == close and close == '}':
                 self.pos += 1
                 trailingComma = True
                 break
         return exprs, trailingComma
 
-    def _parse_paren_expression_list(self) -> ASTParenExprList:
+    def _parse_paren_expression_list(self) -> ASTParenExprList | None:
         # -> '(' expression-list ')'
         # though, we relax it to also allow empty parens
         # as it's needed in some cases
@@ -2288,7 +2316,7 @@
             return None
         return ASTParenExprList(exprs)
 
-    def _parse_braced_init_list(self) -> ASTBracedInitList:
+    def _parse_braced_init_list(self) -> ASTBracedInitList | None:
         # -> '{' initializer-list ','opt '}'
         #  | '{' '}'
         exprs, trailingComma = self._parse_initializer_list("braced-init-list", '{', '}')
@@ -2309,7 +2337,7 @@
         prefix = self._parse_primary_expression()
 
         # and now parse postfixes
-        postFixes: ListASTPostfixOp = 
+        postFixes: listASTPostfixOp = 
         while True:
             self.skip_ws()
             if self.skip_string_and_ws(''):
@@ -2453,7 +2481,7 @@
             return ASTBinOpExpr(exprs, ops)
         return _parse_bin_op_expr(self, 0)
 
-    def _parse_conditional_expression_tail(self, orExprHead: Any) -> ASTExpression:
+    def _parse_conditional_expression_tail(self, orExprHead: Any) -> ASTExpression | None:
         # -> "?" expression ":" assignment-expression
         return None
 
@@ -2500,7 +2528,7 @@
         return self._parse_assignment_expression()
 
     def _parse_expression_fallback(
-            self, end: Liststr,
+            self, end: liststr,
             parser: Callable, ASTExpression,
             allow: bool = True) -> ASTExpression:
         # Stupidly "parse" an expression.
@@ -2527,11 +2555,11 @@
         else:
             # TODO: add handling of more bracket-like things, and quote handling
             brackets = {'(': ')', '{': '}', '': ''}
-            symbols: Liststr = 
+            symbols: liststr = 
             while not self.eof:
                 if (len(symbols) == 0 and self.current_char in end):
                     break
-                if self.current_char in brackets.keys():
+                if self.current_char in brackets:
                     symbols.append(bracketsself.current_char)
                 elif len(symbols) > 0 and self.current_char == symbols-1:
                     symbols.pop()
@@ -2543,7 +2571,7 @@
         return ASTFallbackExpr(value.strip())
 
     def _parse_nested_name(self) -> ASTNestedName:
-        names: ListAny = 
+        names: listAny = 
 
         self.skip_ws()
         rooted = False
@@ -2572,7 +2600,7 @@
                 break
         return ASTNestedName(names, rooted)
 
-    def _parse_simple_type_specifier(self) -> Optionalstr:
+    def _parse_simple_type_specifier(self) -> str | None:
         if self.match(_simple_type_specifiers_re):
             return self.matched_text
         for t in ('bool', 'complex', 'imaginary'):
@@ -2581,8 +2609,8 @@
                     return t
         return None
 
-    def _parse_simple_type_specifiers(self) -> ASTTrailingTypeSpecFundamental:
-        names: Liststr = 
+    def _parse_simple_type_specifiers(self) -> ASTTrailingTypeSpecFundamental | None:
+        names: liststr = 
 
         self.skip_ws()
         while True:
@@ -2614,7 +2642,7 @@
         nestedName = self._parse_nested_name()
         return ASTTrailingTypeSpecName(prefix, nestedName)
 
-    def _parse_parameters(self, paramMode: str) -> ASTParameters:
+    def _parse_parameters(self, paramMode: str) -> ASTParameters | None:
         self.skip_ws()
         if not self.skip_string('('):
             if paramMode == 'function':
@@ -2642,23 +2670,16 @@
                 self.skip_ws()
                 if self.skip_string(','):
                     continue
-                elif self.skip_string(')'):
+                if self.skip_string(')'):
                     break
-                else:
-                    self.fail(
-                        'Expecting "," or ")" in parameters, '
-                        'got "%s".' % self.current_char)
-
-        attrs = 
-        while True:
-            attr = self._parse_attribute()
-            if attr is None:
-                break
-            attrs.append(attr)
+                self.fail(f'Expecting "," or ")" in parameters, got "{self.current_char}".')
 
+        attrs = self._parse_attribute_list()
         return ASTParameters(args, attrs)
 
-    def _parse_decl_specs_simple(self, outer: str, typed: bool) -> ASTDeclSpecsSimple:
+    def _parse_decl_specs_simple(
+        self, outer: str | None, typed: bool,
+    ) -> ASTDeclSpecsSimple:
         """Just parse the simple ones."""
         storage = None
         threadLocal = None
@@ -2714,9 +2735,9 @@
                 continue
             break
         return ASTDeclSpecsSimple(storage, threadLocal, inline,
-                                  restrict, volatile, const, attrs)
+                                  restrict, volatile, const, ASTAttributeList(attrs))
 
-    def _parse_decl_specs(self, outer: str, typed: bool = True) -> ASTDeclSpecs:
+    def _parse_decl_specs(self, outer: str | None, typed: bool = True) -> ASTDeclSpecs:
         if outer:
             if outer not in ('type', 'member', 'function'):
                 raise Exception('Internal error, unknown outer "%s".' % outer)
@@ -2731,7 +2752,7 @@
         return ASTDeclSpecs(outer, leftSpecs, rightSpecs, trailing)
 
     def _parse_declarator_name_suffix(
-            self, named: Unionbool, str, paramMode: str, typed: bool
+            self, named: bool | str, paramMode: str, typed: bool,
     ) -> ASTDeclarator:
         assert named in (True, False, 'single')
         # now we should parse the name, and then suffixes
@@ -2811,7 +2832,7 @@
         return ASTDeclaratorNameParam(declId=declId, arrayOps=arrayOps,
                                       param=param)
 
-    def _parse_declarator(self, named: Unionbool, str, paramMode: str,
+    def _parse_declarator(self, named: bool | str, paramMode: str,
                           typed: bool = True) -> ASTDeclarator:
         # 'typed' here means 'parse return type stuff'
         if paramMode not in ('type', 'function'):
@@ -2846,7 +2867,7 @@
             next = self._parse_declarator(named, paramMode, typed)
             return ASTDeclaratorPtr(next=next,
                                     restrict=restrict, volatile=volatile, const=const,
-                                    attrs=attrs)
+                                    attrs=ASTAttributeList(attrs))
         if typed and self.current_char == '(':  # note: peeking, not skipping
             # maybe this is the beginning of params, try that first,
             # otherwise assume it's noptr->declarator > ( ptr-declarator )
@@ -2892,10 +2913,10 @@
             header = "Error in declarator or parameters"
             raise self._make_multi_error(prevErrors, header) from e
 
-    def _parse_initializer(self, outer: str = None, allowFallback: bool = True
-                           ) -> ASTInitializer:
+    def _parse_initializer(self, outer: str | None = None, allowFallback: bool = True,
+                           ) -> ASTInitializer | None:
         self.skip_ws()
-        if outer == 'member' and False:  # TODO
+        if outer == 'member' and False:  # NoQA: SIM223  # TODO
             bracedInit = self._parse_braced_init_list()
             if bracedInit is not None:
                 return ASTInitializer(bracedInit, hasAssign=False)
@@ -2908,7 +2929,7 @@
             return ASTInitializer(bracedInit)
 
         if outer == 'member':
-            fallbackEnd: Liststr = 
+            fallbackEnd: liststr = 
         elif outer is None:  # function parameter
             fallbackEnd = ',', ')'
         else:
@@ -2921,7 +2942,7 @@
         value = self._parse_expression_fallback(fallbackEnd, parser, allow=allowFallback)
         return ASTInitializer(value)
 
-    def _parse_type(self, named: Unionbool, str, outer: str = None) -> ASTType:
+    def _parse_type(self, named: bool | str, outer: str | None = None) -> ASTType:
         """
         named=False|'single'|True: 'single' is e.g., for function objects which
         doesn't need to name the arguments, but otherwise is a single name
@@ -2959,7 +2980,7 @@
                         header = "Type must be either just a name or a "
                         header += "typedef-like declaration."
                         raise self._make_multi_error(prevErrors, header) from exTyped
-                    else:
+                    else:  # NoQA: RET506
                         # For testing purposes.
                         # do it again to get the proper traceback (how do you
                         # reliably save a traceback when an exception is
@@ -2980,7 +3001,7 @@
             decl = self._parse_declarator(named=named, paramMode=paramMode)
         return ASTType(declSpecs, decl)
 
-    def _parse_type_with_init(self, named: Unionbool, str, outer: str) -> ASTTypeWithInit:
+    def _parse_type_with_init(self, named: bool | str, outer: str | None) -> ASTTypeWithInit:
         if outer:
             assert outer in ('type', 'member', 'function')
         type = self._parse_type(outer=outer, named=named)
@@ -3021,10 +3042,9 @@
             args.append(ASTMacroParameter(nn))
             if self.skip_string_and_ws(','):
                 continue
-            elif self.skip_string_and_ws(')'):
+            if self.skip_string_and_ws(')'):
                 break
-            else:
-                self.fail("Expected identifier, ')', or ',' in macro parameter list.")
+            self.fail("Expected identifier, ')', or ',' in macro parameter list.")
         return ASTMacro(ident, args)
 
     def _parse_struct(self) -> ASTStruct:
@@ -3041,6 +3061,7 @@
 
     def _parse_enumerator(self) -> ASTEnumerator:
         name = self._parse_nested_name()
+        attrs = self._parse_attribute_list()
         self.skip_ws()
         init = None
         if self.skip_string('='):
@@ -3051,24 +3072,7 @@
 
             initVal = self._parse_expression_fallback(, parser)
             init = ASTInitializer(initVal)
-        return ASTEnumerator(name, init)
-
-    def parse_pre_v3_type_definition(self) -> ASTDeclaration:
-        self.skip_ws()
-        declaration: DeclarationType = None
-        if self.skip_word('struct'):
-            typ = 'struct'
-            declaration = self._parse_struct()
-        elif self.skip_word('union'):
-            typ = 'union'
-            declaration = self._parse_union()
-        elif self.skip_word('enum'):
-            typ = 'enum'
-            declaration = self._parse_enum()
-        else:
-            self.fail("Could not parse pre-v3 type directive."
-                      " Must start with 'struct', 'union', or 'enum'.")
-        return ASTDeclaration(typ, typ, declaration, False)
+        return ASTEnumerator(name, init, attrs)
 
     def parse_declaration(self, objectType: str, directiveType: str) -> ASTDeclaration:
         if objectType not in ('function', 'member',
@@ -3096,7 +3100,7 @@
         elif objectType == 'type':
             declaration = self._parse_type(named=True, outer='type')
         else:
-            assert False
+            raise AssertionError()
         if objectType != 'macro':
             self.skip_ws()
             semicolon = self.skip_string(';')
@@ -3115,9 +3119,9 @@
         self.assert_end()
         return name
 
-    def parse_expression(self) -> UnionASTExpression, ASTType:
+    def parse_expression(self) -> ASTExpression | ASTType:
         pos = self.pos
-        res: UnionASTExpression, ASTType = None
+        res: ASTExpression | ASTType = None
         try:
             res = self._parse_expression()
             self.skip_ws()
@@ -3148,6 +3152,7 @@
 
     option_spec: OptionSpec = {
         'noindexentry': directives.flag,
+        'nocontentsentry': directives.flag,
     }
 
     def _add_enumerator_to_parent(self, ast: ASTDeclaration) -> None:
@@ -3233,14 +3238,11 @@
     def parse_definition(self, parser: DefinitionParser) -> ASTDeclaration:
         return parser.parse_declaration(self.object_type, self.objtype)
 
-    def parse_pre_v3_type_definition(self, parser: DefinitionParser) -> ASTDeclaration:
-        return parser.parse_pre_v3_type_definition()
-
     def describe_signature(self, signode: TextElement, ast: ASTDeclaration,
-                           options: Dict) -> None:
+                           options: dict) -> None:
         ast.describe_signature(signode, 'lastIsName', self.env, options)
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         env = self.state.document.settings.env  # from ObjectDescription.run
         if 'c:parent_symbol' not in env.temp_data:
             root = env.domaindata'c''root_symbol'
@@ -3258,27 +3260,8 @@
 
         parser = DefinitionParser(sig, location=signode, config=self.env.config)
         try:
-            try:
-                ast = self.parse_definition(parser)
-                parser.assert_end()
-            except DefinitionError as eOrig:
-                if not self.env.config'c_allow_pre_v3':
-                    raise
-                if self.objtype != 'type':
-                    raise
-                try:
-                    ast = self.parse_pre_v3_type_definition(parser)
-                    parser.assert_end()
-                except DefinitionError:
-                    raise eOrig
-                self.object_type = ast.objectType  # type: ignore
-                if self.env.config'c_warn_on_allowed_pre_v3':
-                    msg = "{}: Pre-v3 C type directive '.. c:type:: {}' converted to " \
-                          "'.. c:{}:: {}'." \
-                          "\nThe original parsing error was:\n{}"
-                    msg = msg.format(RemovedInSphinx50Warning.__name__,
-                                     sig, ast.objectType, ast, eOrig)
-                    logger.warning(msg, location=signode)
+            ast = self.parse_definition(parser)
+            parser.assert_end()
         except DefinitionError as e:
             logger.warning(e, location=signode)
             # It is easier to assume some phony name than handling the error in
@@ -3329,14 +3312,6 @@
         self.env.temp_data'c:parent_symbol' = self.oldParentSymbol
         self.env.ref_context'c:parent_key' = self.oldParentKey
 
-    def make_old_id(self, name: str) -> str:
-        """Generate old styled node_id for C objects.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return 'c.' + name
-
 
 class CMemberObject(CObject):
     object_type = 'member'
@@ -3406,11 +3381,11 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         rootSymbol = self.env.domaindata'c''root_symbol'
         if self.arguments0.strip() in ('NULL', '0', 'nullptr'):
             symbol = rootSymbol
-            stack: ListSymbol = 
+            stack: listSymbol = 
         else:
             parser = DefinitionParser(self.arguments0,
                                       location=self.get_location(),
@@ -3436,7 +3411,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if self.arguments0.strip() in ('NULL', '0', 'nullptr'):
             return 
         parser = DefinitionParser(self.arguments0,
@@ -3467,7 +3442,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         stack = self.env.temp_data.get('c:namespace_stack', None)
         if not stack or len(stack) == 0:
             logger.warning("C namespace pop on empty stack. Defaulting to global scope.",
@@ -3486,9 +3461,14 @@
 
 
 class AliasNode(nodes.Element):
-    def __init__(self, sig: str, aliasOptions: dict,
-                 document: Any, env: "BuildEnvironment" = None,
-                 parentKey: LookupKey = None) -> None:
+    def __init__(
+        self,
+        sig: str,
+        aliasOptions: dict,
+        document: Any,
+        env: BuildEnvironment | None = None,
+        parentKey: LookupKey | None = None,
+    ) -> None:
         super().__init__()
         self.sig = sig
         self.aliasOptions = aliasOptions
@@ -3503,7 +3483,7 @@
             assert parentKey is not None
             self.parentKey = parentKey
 
-    def copy(self) -> 'AliasNode':
+    def copy(self) -> AliasNode:
         return self.__class__(self.sig, self.aliasOptions, self.document,
                               env=None, parentKey=self.parentKey)
 
@@ -3513,7 +3493,7 @@
 
     def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool,
                        aliasOptions: dict, renderOptions: dict,
-                       document: Any) -> ListNode:
+                       document: Any) -> listNode:
         if maxdepth == 0:
             recurse = True
         elif maxdepth == 1:
@@ -3522,7 +3502,7 @@
             maxdepth -= 1
             recurse = True
 
-        nodes: ListNode = 
+        nodes: listNode = 
         if not skipThis:
             signode = addnodes.desc_signature('', '')
             nodes.append(signode)
@@ -3530,7 +3510,7 @@
 
         if recurse:
             if skipThis:
-                childContainer: UnionListNode, addnodes.desc = nodes
+                childContainer: listNode | addnodes.desc = nodes
             else:
                 content = addnodes.desc_content()
                 desc = addnodes.desc()
@@ -3557,7 +3537,6 @@
 
     def apply(self, **kwargs: Any) -> None:
         for node in self.document.findall(AliasNode):
-            node = cast(AliasNode, node)
             sig = node.sig
             parentKey = node.parentKey
             try:
@@ -3615,7 +3594,7 @@
             nodes = self._render_symbol(s, maxdepth=node.aliasOptions'maxdepth',
                                         skipThis=node.aliasOptions'noroot',
                                         aliasOptions=node.aliasOptions,
-                                        renderOptions=dict(), document=node.document)
+                                        renderOptions={}, document=node.document)
             node.replace_self(nodes)
 
 
@@ -3625,7 +3604,7 @@
         'noroot': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         """
         On purpose this doesn't call the ObjectDescription version, but is based on it.
         Each alias signature may expand into multiple real signatures if 'noroot'.
@@ -3643,7 +3622,7 @@
         node'objtype' = node'desctype' = self.objtype
         node'noindex' = True
 
-        self.names: Liststr = 
+        self.names: liststr = 
         aliasOptions = {
             'maxdepth': self.options.get('maxdepth', 1),
             'noroot': 'noroot' in self.options,
@@ -3661,7 +3640,7 @@
 
 class CXRefRole(XRefRole):
     def process_link(self, env: BuildEnvironment, refnode: Element,
-                     has_explicit_title: bool, title: str, target: str) -> Tuplestr, str:
+                     has_explicit_title: bool, title: str, target: str) -> tuplestr, str:
         refnode.attributes.update(env.ref_context)
 
         if not has_explicit_title:
@@ -3680,39 +3659,6 @@
                     title = titledot + 1:
         return title, target
 
-    def run(self) -> TupleListNode, Listsystem_message:
-        if not self.env.config'c_allow_pre_v3':
-            return super().run()
-
-        text = self.text.replace('\n', ' ')
-        parser = DefinitionParser(text, location=self.get_location(),
-                                  config=self.env.config)
-        try:
-            parser.parse_xref_object()
-            # it succeeded, so let it through
-            return super().run()
-        except DefinitionError as eOrig:
-            # try as if it was an c:expr
-            parser.pos = 0
-            try:
-                ast = parser.parse_expression()
-            except DefinitionError:
-                # that didn't go well, just default back
-                return super().run()
-            classes = 'xref', 'c', 'c-texpr'
-            parentSymbol = self.env.temp_data.get('cpp:parent_symbol', None)
-            if parentSymbol is None:
-                parentSymbol = self.env.domaindata'c''root_symbol'
-            signode = nodes.inline(classes=classes)
-            ast.describe_signature(signode, 'markType', self.env, parentSymbol)
-
-            if self.env.config'c_warn_on_allowed_pre_v3':
-                msg = "{}: Pre-v3 C type role ':c:type:`{}`' converted to ':c:expr:`{}`'."
-                msg += "\nThe original parsing error was:\n{}"
-                msg = msg.format(RemovedInSphinx50Warning.__name__, text, text, eOrig)
-                logger.warning(msg, location=self.get_location())
-            return signode, 
-
 
 class CExprRole(SphinxRole):
     def __init__(self, asCode: bool) -> None:
@@ -3724,7 +3670,7 @@
             # render the expression as inline text
             self.class_type = 'c-texpr'
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         text = self.text.replace('\n', ' ')
         parser = DefinitionParser(text, location=self.get_location(),
                                   config=self.env.config)
@@ -3762,7 +3708,7 @@
         'enumerator': ObjType(_('enumerator'), 'enumerator',    'identifier'),
         'type': ObjType(_('type'),                              'identifier', 'type'),
         # generated object types
-        'functionParam': ObjType(_('function parameter'),       'identifier', 'var', 'member', 'data'),  # noqa
+        'functionParam': ObjType(_('function parameter'),       'identifier', 'var', 'member', 'data'),  # noqa: E501
     }
 
     directives = {
@@ -3780,7 +3726,7 @@
         'namespace-push': CNamespacePushObject,
         'namespace-pop': CNamespacePopObject,
         # other
-        'alias': CAliasObject
+        'alias': CAliasObject,
     }
     roles = {
         'member': CXRefRole(),
@@ -3794,9 +3740,9 @@
         'enumerator': CXRefRole(),
         'type': CXRefRole(),
         'expr': CExprRole(asCode=True),
-        'texpr': CExprRole(asCode=False)
+        'texpr': CExprRole(asCode=False),
     }
-    initial_data: Dictstr, UnionSymbol, Dictstr, Tuplestr, str, str = {
+    initial_data: dictstr, Symbol | dictstr, tuplestr, str, str = {
         'root_symbol': Symbol(None, None, None, None, None),
         'objects': {},  # fullname -> docname, node_id, objtype
     }
@@ -3827,7 +3773,7 @@
     def process_field_xref(self, pnode: pending_xref) -> None:
         pnode.attributes.update(self.env.ref_context)
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dict) -> None:
         if Symbol.debug_show_tree:
             print("merge_domaindata:")
             print("\tself:")
@@ -3849,7 +3795,7 @@
 
     def _resolve_xref_inner(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
                             typ: str, target: str, node: pending_xref,
-                            contnode: Element) -> TupleOptionalElement, Optionalstr:
+                            contnode: Element) -> tupleElement | None, str | None:
         parser = DefinitionParser(target, location=node, config=env.config)
         try:
             name = parser.parse_xref_object()
@@ -3881,18 +3827,18 @@
         assert docname
 
         return make_refnode(builder, fromdocname, docname,
-                            declaration.get_newest_id(), contnode, displayName
+                            declaration.get_newest_id(), contnode, displayName,
                             ), declaration.objectType
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
                      typ: str, target: str, node: pending_xref,
-                     contnode: Element) -> OptionalElement:
+                     contnode: Element) -> Element | None:
         return self._resolve_xref_inner(env, fromdocname, builder, typ,
                                         target, node, contnode)0
 
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         with logging.suppress_logging():
             retnode, objtype = self._resolve_xref_inner(env, fromdocname, builder,
                                                         'any', target, node, contnode)
@@ -3900,7 +3846,7 @@
             return ('c:' + self.role_for_objtype(objtype), retnode)
         return 
 
-    def get_objects(self) -> IteratorTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iteratortuplestr, str, str, str, str, int:
         rootSymbol = self.data'root_symbol'
         for symbol in rootSymbol.get_all_symbols():
             if symbol.declaration is None:
@@ -3915,16 +3861,13 @@
             yield (name, dispname, objectType, docname, newestId, 1)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(CDomain)
     app.add_config_value("c_id_attributes", , 'env')
     app.add_config_value("c_paren_attributes", , 'env')
     app.add_config_value("c_extra_keywords", _macroKeywords, 'env')
     app.add_post_transform(AliasTransform)
 
-    app.add_config_value("c_allow_pre_v3", False, 'env')
-    app.add_config_value("c_warn_on_allowed_pre_v3", True, 'env')
-
     return {
         'version': 'builtin',
         'env_version': 2,

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/changeset.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/changeset.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.domains.changeset
-    ~~~~~~~~~~~~~~~~~~~~~~~~
+"""The changeset domain."""
 
-    The changeset domain.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Dict, List, NamedTuple, cast
+from typing import TYPE_CHECKING, Any, NamedTuple, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -41,8 +35,8 @@
     type: str
     docname: str
     lineno: int
-    module: str
-    descname: str
+    module: str | None
+    descname: str | None
     content: str
 
 
@@ -56,7 +50,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = addnodes.versionmodified()
         node.document = self.state.document
         self.set_source_info(node)
@@ -84,7 +78,7 @@
                 content += node0.children
                 node0.replace_self(nodes.paragraph('', '', content, translatable=False))
 
-            para = cast(nodes.paragraph, node0)
+            para = node0
             para.insert(0, nodes.inline('', '%s: ' % text, classes=classes))
         elif len(node) > 0:
             # the contents do not starts with a paragraph
@@ -102,7 +96,7 @@
         domain = cast(ChangeSetDomain, self.env.get_domain('changeset'))
         domain.note_changeset(node)
 
-        ret: ListNode = node
+        ret: listNode = node
         ret += messages
         return ret
 
@@ -113,12 +107,12 @@
     name = 'changeset'
     label = 'changeset'
 
-    initial_data: Dict = {
+    initial_data: dictstr, Any = {
         'changes': {},      # version -> list of ChangeSet
     }
 
     @property
-    def changesets(self) -> Dictstr, ListChangeSet:
+    def changesets(self) -> dictstr, listChangeSet:
         return self.data.setdefault('changes', {})  # version -> list of ChangeSet
 
     def note_changeset(self, node: addnodes.versionmodified) -> None:
@@ -135,7 +129,7 @@
                 if changeset.docname == docname:
                     changes.remove(changeset)
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, Any) -> None:
         # XXX duplicates?
         for version, otherchanges in otherdata'changes'.items():
             changes = self.changesets.setdefault(version, )
@@ -143,14 +137,16 @@
                 if changeset.docname in docnames:
                     changes.append(changeset)
 
-    def process_doc(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None:  # NOQA
+    def process_doc(
+        self, env: BuildEnvironment, docname: str, document: nodes.document,
+    ) -> None:
         pass  # nothing to do here. All changesets are registered on calling directive.
 
-    def get_changesets_for(self, version: str) -> ListChangeSet:
+    def get_changesets_for(self, version: str) -> listChangeSet:
         return self.changesets.get(version, )
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(ChangeSetDomain)
     app.add_directive('deprecated', VersionChange)
     app.add_directive('versionadded', VersionChange)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/citation.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/citation.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.domains.citation
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""The citation domain."""
 
-    The citation domain.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Set, Tuple, cast
+from typing import TYPE_CHECKING, Any, cast
 
 from docutils import nodes
 from docutils.nodes import Element
@@ -40,11 +34,11 @@
     }
 
     @property
-    def citations(self) -> Dictstr, Tuplestr, str, int:
+    def citations(self) -> dictstr, tuplestr, str, int:
         return self.data.setdefault('citations', {})
 
     @property
-    def citation_refs(self) -> Dictstr, Setstr:
+    def citation_refs(self) -> dictstr, setstr:
         return self.data.setdefault('citation_refs', {})
 
     def clear_doc(self, docname: str) -> None:
@@ -57,7 +51,7 @@
             elif docname in docnames:
                 docnames.remove(docname)
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, Any) -> None:
         # XXX duplicates?
         for key, data in otherdata'citations'.items():
             if data0 in docnames:
@@ -86,9 +80,9 @@
                 logger.warning(__('Citation %s is not referenced.'), name,
                                type='ref', subtype='citation', location=(docname, lineno))
 
-    def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder",
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+    def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         docname, labelid, lineno = self.citations.get(target, ('', '', 0))
         if not docname:
             return None
@@ -96,9 +90,9 @@
         return make_refnode(builder, fromdocname, docname,
                             labelid, contnode)
 
-    def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder",
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+    def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         refnode = self.resolve_xref(env, fromdocname, builder, 'ref', target, node, contnode)
         if refnode is None:
             return 
@@ -146,7 +140,7 @@
             domain.note_citation_reference(ref)
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(CitationDomain)
     app.add_transform(CitationDefinitionTransform)
     app.add_transform(CitationReferenceTransform)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/cpp.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/cpp.py Changed

@@ -1,16 +1,9 @@
-"""
-    sphinx.domains.cpp
-    ~~~~~~~~~~~~~~~~~~
-
-    The C++ language domain.
+"""The C++ language domain."""
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple, TypeVar,
-                    Union, cast)
+from typing import Any, Callable, Generator, Iterator, TypeVar
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement, system_message
@@ -29,13 +22,27 @@
 from sphinx.transforms import SphinxTransform
 from sphinx.transforms.post_transforms import ReferencesResolver
 from sphinx.util import logging
-from sphinx.util.cfamily import (ASTAttribute, ASTBaseBase, ASTBaseParenExprList, BaseParser,
-                                 DefinitionError, NoOldIdError, StringifyTransform,
-                                 UnsupportedMultiCharacterCharLiteral, anon_identifier_re,
-                                 binary_literal_re, char_literal_re, float_literal_re,
-                                 float_literal_suffix_re, hex_literal_re, identifier_re,
-                                 integer_literal_re, integers_literal_suffix_re,
-                                 octal_literal_re, verify_description_mode)
+from sphinx.util.cfamily import (
+    ASTAttributeList,
+    ASTBaseBase,
+    ASTBaseParenExprList,
+    BaseParser,
+    DefinitionError,
+    NoOldIdError,
+    StringifyTransform,
+    UnsupportedMultiCharacterCharLiteral,
+    anon_identifier_re,
+    binary_literal_re,
+    char_literal_re,
+    float_literal_re,
+    float_literal_suffix_re,
+    hex_literal_re,
+    identifier_re,
+    integer_literal_re,
+    integers_literal_suffix_re,
+    octal_literal_re,
+    verify_description_mode,
+)
 from sphinx.util.docfields import Field, GroupedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import make_refnode
@@ -267,7 +274,8 @@
     class_object:
         goal: a class declaration, but with specification of a base class
         grammar:
-              nested-name "final"opt (":" base-specifier-list)opt
+              attribute-specifier-seqopt
+                  nested-name "final"opt (":" base-specifier-list)opt
             base-specifier-list ->
               base-specifier "..."opt
             | base-specifier-list, base-specifier "..."opt
@@ -281,7 +289,8 @@
         goal: an unscoped enum or a scoped enum, optionally with the underlying
               type specified
         grammar:
-            ("class" | "struct")opt visibilityopt nested-name (":" type)opt
+            ("class" | "struct")opt visibilityopt
+                attribute-specifier-seqopt nested-name (":" type)opt
     enumerator_object:
         goal: an element in a scoped or unscoped enum. The name should be
               injected according to the scopedness.
@@ -294,13 +303,13 @@
             nested-name
 """
 
-udl_identifier_re = re.compile(r'''(?x)
+udl_identifier_re = re.compile(r'''
     a-zA-Z_a-zA-Z0-9_*\b   # note, no word boundary in the beginning
-''')
+''', re.VERBOSE)
 _string_re = re.compile(r"LuU8?('(^'\\*(?:\\.^'\\*)*)'"
                         r'|"(^"\\*(?:\\.^"\\*)*)")', re.S)
 _visibility_re = re.compile(r'\b(public|private|protected)\b')
-_operator_re = re.compile(r'''(?x)
+_operator_re = re.compile(r'''
         \\s*\
     |   $\s*$
     |   \+\+ | --
@@ -309,13 +318,13 @@
     |   <=>
     |   !<>=/*%+|&^~-=?
     |   (\b(and|and_eq|bitand|bitor|compl|not|not_eq|or|or_eq|xor|xor_eq)\b)
-''')
-_fold_operator_re = re.compile(r'''(?x)
+''', re.VERBOSE)
+_fold_operator_re = re.compile(r'''
         ->\*    |    \.\*    |    \,
     |   (<<|>>)=?    |    &&    |    \|\|
     |   !=
     |   <>=/*%+|&^~-=?
-''')
+''', re.VERBOSE)
 # see https://en.cppreference.com/w/cpp/keyword
 _keywords = 
     'alignas', 'alignof', 'and', 'and_eq', 'asm', 'auto', 'bitand', 'bitor',
@@ -331,11 +340,11 @@
     'static_assert', 'static_cast', 'struct', 'switch', 'template', 'this',
     'thread_local', 'throw', 'true', 'try', 'typedef', 'typeid', 'typename',
     'union', 'unsigned', 'using', 'virtual', 'void', 'volatile', 'wchar_t',
-    'while', 'xor', 'xor_eq'
+    'while', 'xor', 'xor_eq',
 
 
 
-_simple_type_specifiers_re = re.compile(r"""(?x)
+_simple_type_specifiers_re = re.compile(r"""
     \b(
     auto|void|bool
     |signed|unsigned
@@ -347,7 +356,7 @@
     |__float80|_Float64x|__float128|_Float128  # extension
     |_Complex|_Imaginary  # extension
     )\b
-""")
+""", re.VERBOSE)
 
 _max_id = 4
 _id_prefix = None, '', '_CPPv2', '_CPPv3', '_CPPv4'
@@ -368,7 +377,7 @@
     'long': 'l',
     'signed long': 'l',
     'unsigned long': 'L',
-    'bool': 'b'
+    'bool': 'b',
 }
 _id_shorthands_v1 = {
     'std::string': 'ss',
@@ -376,7 +385,7 @@
     'std::istream': 'is',
     'std::iostream': 'ios',
     'std::vector': 'v',
-    'std::map': 'm'
+    'std::map': 'm',
 }
 _id_operator_v1 = {
     'new': 'new-operator',
@@ -425,7 +434,7 @@
     '->*': 'pointer-by-pointer-operator',
     '->': 'pointer-operator',
     '()': 'call-operator',
-    '': 'subscript-operator'
+    '': 'subscript-operator',
 }
 
 # ------------------------------------------------------------------------------
@@ -483,7 +492,7 @@
     '_Imaginary long double': 'e',
     'auto': 'Da',
     'decltype(auto)': 'Dc',
-    'std::nullptr_t': 'Dn'
+    'std::nullptr_t': 'Dn',
 }
 _id_operator_v2 = {
     'new': 'nw',
@@ -535,7 +544,8 @@
     '->': 'pt',
     '()': 'cl',
     '': 'ix',
-    '.*': 'ds'  # this one is not overloadable, but we need it for expressions
+    '.*': 'ds',  # this one is not overloadable, but we need it for expressions
+    '?': 'qu',
 }
 _id_operator_unary_v2 = {
     '++': 'pp_',
@@ -545,11 +555,11 @@
     '+': 'ps',
     '-': 'ng',
     '!': 'nt', 'not': 'nt',
-    '~': 'co', 'compl': 'co'
+    '~': 'co', 'compl': 'co',
 }
-_id_char_from_prefix: DictOptionalstr, str = {
+_id_char_from_prefix: dictstr | None, str = {
     None: 'c', 'u8': 'c',
-    'u': 'Ds', 'U': 'Di', 'L': 'w'
+    'u': 'Ds', 'U': 'Di', 'L': 'w',
 }
 # these are ordered by preceedence
 _expression_bin_ops = 
@@ -563,7 +573,7 @@
     '<<', '>>',
     '+', '-',
     '*', '/', '%',
-    '.*', '->*'
+    '.*', '->*',
 
 _expression_unary_ops = "++", "--", "*", "&", "+", "-", "!", "not", "~", "compl"
 _expression_assignment_ops = "=", "*=", "/=", "%=", "+=", "-=",
@@ -572,12 +582,12 @@
     'dynamic_cast': 'dc',
     'static_cast': 'sc',
     'const_cast': 'cc',
-    'reinterpret_cast': 'rc'
+    'reinterpret_cast': 'rc',
 }
 
 
 class _DuplicateSymbolError(Exception):
-    def __init__(self, symbol: "Symbol", declaration: "ASTDeclaration") -> None:
+    def __init__(self, symbol: Symbol, declaration: ASTDeclaration) -> None:
         assert symbol
         assert declaration
         self.symbol = symbol
@@ -630,8 +640,8 @@
     def get_display_string(self) -> str:
         return "anonymous" if self.is_anon() else self.identifier
 
-    def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment",
-                           prefix: str, templateArgs: str, symbol: "Symbol") -> None:
+    def describe_signature(self, signode: TextElement, mode: str, env: BuildEnvironment,
+                           prefix: str, templateArgs: str, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.is_anon():
             node = addnodes.desc_sig_name(text="anonymous")
@@ -673,8 +683,8 @@
 
 
 class ASTNestedNameElement(ASTBase):
-    def __init__(self, identOrOp: UnionASTIdentifier, "ASTOperator",
-                 templateArgs: "ASTTemplateArgs") -> None:
+    def __init__(self, identOrOp: ASTIdentifier | ASTOperator,
+                 templateArgs: ASTTemplateArgs) -> None:
         self.identOrOp = identOrOp
         self.templateArgs = templateArgs
 
@@ -694,7 +704,7 @@
         return res
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", prefix: str, symbol: "Symbol") -> None:
+                           env: BuildEnvironment, prefix: str, symbol: Symbol) -> None:
         tArgs = str(self.templateArgs) if self.templateArgs is not None else ''
         self.identOrOp.describe_signature(signode, mode, env, prefix, tArgs, symbol)
         if self.templateArgs is not None:
@@ -702,8 +712,8 @@
 
 
 class ASTNestedName(ASTBase):
-    def __init__(self, names: ListASTNestedNameElement,
-                 templates: Listbool, rooted: bool) -> None:
+    def __init__(self, names: listASTNestedNameElement,
+                 templates: listbool, rooted: bool) -> None:
         assert len(names) > 0
         self.names = names
         self.templates = templates
@@ -711,7 +721,7 @@
         self.rooted = rooted
 
     @property
-    def name(self) -> "ASTNestedName":
+    def name(self) -> ASTNestedName:
         return self
 
     def num_templates(self) -> int:
@@ -754,20 +764,20 @@
         return '::'.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         # just print the name part, with template args, not template params
         if mode == 'noneIsName':
             if self.rooted:
-                assert False, "Can this happen?"  # TODO
+                raise AssertionError("Can this happen?")  # TODO
                 signode += nodes.Text('::')
             for i in range(len(self.names)):
                 if i != 0:
-                    assert False, "Can this happen?"  # TODO
+                    raise AssertionError("Can this happen?")  # TODO
                     signode += nodes.Text('::blah')
                 n = self.namesi
                 if self.templatesi:
-                    assert False, "Can this happen?"  # TODO
+                    raise AssertionError("Can this happen?")  # TODO
                     signode += nodes.Text("template")
                     signode += nodes.Text(" ")
                 n.describe_signature(signode, mode, env, '', symbol)
@@ -781,7 +791,7 @@
             # prefix. however, only the identifier part should be a link, such
             # that template args can be a link as well.
             # For 'lastIsName' we should also prepend template parameter lists.
-            templateParams: ListAny = 
+            templateParams: listAny = 
             if mode == 'lastIsName':
                 assert symbol is not None
                 if symbol.declaration.templatePrefix is not None:
@@ -843,7 +853,7 @@
         raise NotImplementedError(repr(self))
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         raise NotImplementedError(repr(self))
 
 
@@ -862,7 +872,7 @@
         return 'LDnE'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('nullptr', 'nullptr')
 
 
@@ -883,7 +893,7 @@
             return 'L0E'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword(str(self), str(self))
 
 
@@ -899,7 +909,7 @@
         return "L%sE" % self.data.replace("'", "")
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_literal_number(self.data, self.data)
 
 
@@ -915,7 +925,7 @@
         return "LA%d_KcE" % (len(self.data) - 2)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_literal_string(self.data, self.data)
 
 
@@ -942,7 +952,7 @@
         return self.type + str(self.value)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.prefix is not None:
             signode += addnodes.desc_sig_keyword(self.prefix, self.prefix)
         txt = "'" + self.data + "'"
@@ -959,10 +969,10 @@
 
     def get_id(self, version: int) -> str:
         # mangle as if it was a function call: ident(literal)
-        return 'clL_Zli{}E{}E'.format(self.ident.get_id(version), self.literal.get_id(version))
+        return f'clL_Zli{self.ident.get_id(version)}E{self.literal.get_id(version)}E'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.literal.describe_signature(signode, mode, env, symbol)
         self.ident.describe_signature(signode, "udl", env, "", "", symbol)
 
@@ -977,7 +987,7 @@
         return "fpT"
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('this', 'this')
 
 
@@ -1027,7 +1037,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('(', '(')
         if self.leftExpr:
             self.leftExpr.describe_signature(signode, mode, env, symbol)
@@ -1054,7 +1064,7 @@
         return self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation(')', ')')
@@ -1072,7 +1082,7 @@
         return self.name.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.name.describe_signature(signode, mode, env, symbol)
 
 
@@ -1084,7 +1094,7 @@
         raise NotImplementedError(repr(self))
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         raise NotImplementedError(repr(self))
 
 
@@ -1099,7 +1109,7 @@
         return 'ix' + idPrefix + self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('', '')
         self.expr.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation('', '')
@@ -1116,7 +1126,7 @@
         return 'dt' + idPrefix + self.name.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('.', '.')
         self.name.describe_signature(signode, 'noneIsName', env, symbol)
 
@@ -1132,7 +1142,7 @@
         return 'pt' + idPrefix + self.name.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_operator('->', '->')
         self.name.describe_signature(signode, 'noneIsName', env, symbol)
 
@@ -1145,7 +1155,7 @@
         return 'pp' + idPrefix
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_operator('++', '++')
 
 
@@ -1157,12 +1167,12 @@
         return 'mm' + idPrefix
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_operator('--', '--')
 
 
 class ASTPostfixCallExpr(ASTPostfixOp):
-    def __init__(self, lst: Union"ASTParenExprList", "ASTBracedInitList") -> None:
+    def __init__(self, lst: ASTParenExprList | ASTBracedInitList) -> None:
         self.lst = lst
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1176,12 +1186,12 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.lst.describe_signature(signode, mode, env, symbol)
 
 
 class ASTPostfixExpr(ASTExpression):
-    def __init__(self, prefix: "ASTType", postFixes: ListASTPostfixOp):
+    def __init__(self, prefix: ASTType, postFixes: listASTPostfixOp):
         self.prefix = prefix
         self.postFixes = postFixes
 
@@ -1198,14 +1208,14 @@
         return id
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.prefix.describe_signature(signode, mode, env, symbol)
         for p in self.postFixes:
             p.describe_signature(signode, mode, env, symbol)
 
 
 class ASTExplicitCast(ASTExpression):
-    def __init__(self, cast: str, typ: "ASTType", expr: ASTExpression):
+    def __init__(self, cast: str, typ: ASTType, expr: ASTExpression):
         assert cast in _id_explicit_cast
         self.cast = cast
         self.typ = typ
@@ -1226,7 +1236,7 @@
                 self.expr.get_id(version))
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword(self.cast, self.cast)
         signode += addnodes.desc_sig_punctuation('<', '<')
         self.typ.describe_signature(signode, mode, env, symbol)
@@ -1237,7 +1247,7 @@
 
 
 class ASTTypeId(ASTExpression):
-    def __init__(self, typeOrExpr: Union"ASTType", ASTExpression, isType: bool):
+    def __init__(self, typeOrExpr: ASTType | ASTExpression, isType: bool):
         self.typeOrExpr = typeOrExpr
         self.isType = isType
 
@@ -1249,7 +1259,7 @@
         return prefix + self.typeOrExpr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('typeid', 'typeid')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typeOrExpr.describe_signature(signode, mode, env, symbol)
@@ -1274,7 +1284,7 @@
         return _id_operator_unary_v2self.op + self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.op0 in 'cn':
             signode += addnodes.desc_sig_keyword(self.op, self.op)
             signode += addnodes.desc_sig_space()
@@ -1294,7 +1304,7 @@
         return 'sZ' + self.identifier.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
         signode += addnodes.desc_sig_punctuation('...', '...')
         signode += addnodes.desc_sig_punctuation('(', '(')
@@ -1304,7 +1314,7 @@
 
 
 class ASTSizeofType(ASTExpression):
-    def __init__(self, typ: "ASTType"):
+    def __init__(self, typ: ASTType):
         self.typ = typ
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1314,7 +1324,7 @@
         return 'st' + self.typ.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
@@ -1332,14 +1342,14 @@
         return 'sz' + self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('sizeof', 'sizeof')
         signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTAlignofExpr(ASTExpression):
-    def __init__(self, typ: "ASTType"):
+    def __init__(self, typ: ASTType):
         self.typ = typ
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -1349,7 +1359,7 @@
         return 'at' + self.typ.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('alignof', 'alignof')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
@@ -1367,7 +1377,7 @@
         return 'nx' + self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('noexcept', 'noexcept')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
@@ -1375,8 +1385,8 @@
 
 
 class ASTNewExpr(ASTExpression):
-    def __init__(self, rooted: bool, isNewTypeId: bool, typ: "ASTType",
-                 initList: Union"ASTParenExprList", "ASTBracedInitList") -> None:
+    def __init__(self, rooted: bool, isNewTypeId: bool, typ: ASTType,
+                 initList: ASTParenExprList | ASTBracedInitList) -> None:
         self.rooted = rooted
         self.isNewTypeId = isNewTypeId
         self.typ = typ
@@ -1391,7 +1401,7 @@
         if self.isNewTypeId:
             res.append(transform(self.typ))
         else:
-            assert False
+            raise AssertionError()
         if self.initList is not None:
             res.append(transform(self.initList))
         return ''.join(res)
@@ -1409,7 +1419,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.rooted:
             signode += addnodes.desc_sig_punctuation('::', '::')
         signode += addnodes.desc_sig_keyword('new', 'new')
@@ -1418,7 +1428,7 @@
         if self.isNewTypeId:
             self.typ.describe_signature(signode, mode, env, symbol)
         else:
-            assert False
+            raise AssertionError()
         if self.initList is not None:
             self.initList.describe_signature(signode, mode, env, symbol)
 
@@ -1447,7 +1457,7 @@
         return id + self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.rooted:
             signode += addnodes.desc_sig_punctuation('::', '::')
         signode += addnodes.desc_sig_keyword('delete', 'delete')
@@ -1462,7 +1472,7 @@
 ################################################################################
 
 class ASTCastExpr(ASTExpression):
-    def __init__(self, typ: "ASTType", expr: ASTExpression):
+    def __init__(self, typ: ASTType, expr: ASTExpression):
         self.typ = typ
         self.expr = expr
 
@@ -1477,7 +1487,7 @@
         return 'cv' + self.typ.get_id(version) + self.expr.get_id(version)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.typ.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation(')', ')')
@@ -1485,7 +1495,7 @@
 
 
 class ASTBinOpExpr(ASTExpression):
-    def __init__(self, exprs: ListASTExpression, ops: Liststr):
+    def __init__(self, exprs: listASTExpression, ops: liststr):
         assert len(exprs) > 0
         assert len(exprs) == len(ops) + 1
         self.exprs = exprs
@@ -1511,7 +1521,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.exprs0.describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
             signode += addnodes.desc_sig_space()
@@ -1524,8 +1534,46 @@
             self.exprsi.describe_signature(signode, mode, env, symbol)
 
 
+class ASTConditionalExpr(ASTExpression):
+    def __init__(self, ifExpr: ASTExpression, thenExpr: ASTExpression,
+                 elseExpr: ASTExpression):
+        self.ifExpr = ifExpr
+        self.thenExpr = thenExpr
+        self.elseExpr = elseExpr
+
+    def _stringify(self, transform: StringifyTransform) -> str:
+        res = 
+        res.append(transform(self.ifExpr))
+        res.append(' ? ')
+        res.append(transform(self.thenExpr))
+        res.append(' : ')
+        res.append(transform(self.elseExpr))
+        return ''.join(res)
+
+    def get_id(self, version: int) -> str:
+        assert version >= 2
+        res = 
+        res.append(_id_operator_v2'?')
+        res.append(self.ifExpr.get_id(version))
+        res.append(self.thenExpr.get_id(version))
+        res.append(self.elseExpr.get_id(version))
+        return ''.join(res)
+
+    def describe_signature(self, signode: TextElement, mode: str,
+                           env: BuildEnvironment, symbol: Symbol) -> None:
+        self.ifExpr.describe_signature(signode, mode, env, symbol)
+        signode += addnodes.desc_sig_space()
+        signode += addnodes.desc_sig_operator('?', '?')
+        signode += addnodes.desc_sig_space()
+        self.thenExpr.describe_signature(signode, mode, env, symbol)
+        signode += addnodes.desc_sig_space()
+        signode += addnodes.desc_sig_operator(':', ':')
+        signode += addnodes.desc_sig_space()
+        self.elseExpr.describe_signature(signode, mode, env, symbol)
+
+
 class ASTBracedInitList(ASTBase):
-    def __init__(self, exprs: ListUnionASTExpression, "ASTBracedInitList",
+    def __init__(self, exprs: listASTExpression | ASTBracedInitList,
                  trailingComma: bool) -> None:
         self.exprs = exprs
         self.trailingComma = trailingComma
@@ -1534,12 +1582,12 @@
         return "il%sE" % ''.join(e.get_id(version) for e in self.exprs)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        exprs = transform(e) for e in self.exprs
+        exprs = ', '.join(transform(e) for e in self.exprs)
         trailingComma = ',' if self.trailingComma else ''
-        return '{%s%s}' % (', '.join(exprs), trailingComma)
+        return f'{{{exprs}{trailingComma}}}'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('{', '{')
         first = True
@@ -1556,46 +1604,43 @@
 
 
 class ASTAssignmentExpr(ASTExpression):
-    def __init__(self, exprs: ListUnionASTExpression, ASTBracedInitList, ops: Liststr):
-        assert len(exprs) > 0
-        assert len(exprs) == len(ops) + 1
-        self.exprs = exprs
-        self.ops = ops
+    def __init__(self, leftExpr: ASTExpression, op: str,
+                 rightExpr: ASTExpression | ASTBracedInitList):
+        self.leftExpr = leftExpr
+        self.op = op
+        self.rightExpr = rightExpr
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = 
-        res.append(transform(self.exprs0))
-        for i in range(1, len(self.exprs)):
-            res.append(' ')
-            res.append(self.opsi - 1)
-            res.append(' ')
-            res.append(transform(self.exprsi))
+        res.append(transform(self.leftExpr))
+        res.append(' ')
+        res.append(self.op)
+        res.append(' ')
+        res.append(transform(self.rightExpr))
         return ''.join(res)
 
     def get_id(self, version: int) -> str:
+        # we end up generating the ID from left to right, instead of right to left
         res = 
-        for i in range(len(self.ops)):
-            res.append(_id_operator_v2self.opsi)
-            res.append(self.exprsi.get_id(version))
-        res.append(self.exprs-1.get_id(version))
+        res.append(_id_operator_v2self.op)
+        res.append(self.leftExpr.get_id(version))
+        res.append(self.rightExpr.get_id(version))
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
-        self.exprs0.describe_signature(signode, mode, env, symbol)
-        for i in range(1, len(self.exprs)):
-            signode += addnodes.desc_sig_space()
-            op = self.opsi - 1
-            if ord(op0) >= ord('a') and ord(op0) <= ord('z'):
-                signode += addnodes.desc_sig_keyword(op, op)
-            else:
-                signode += addnodes.desc_sig_operator(op, op)
-            signode += addnodes.desc_sig_space()
-            self.exprsi.describe_signature(signode, mode, env, symbol)
+                           env: BuildEnvironment, symbol: Symbol) -> None:
+        self.leftExpr.describe_signature(signode, mode, env, symbol)
+        signode += addnodes.desc_sig_space()
+        if ord(self.op0) >= ord('a') and ord(self.op0) <= ord('z'):
+            signode += addnodes.desc_sig_keyword(self.op, self.op)
+        else:
+            signode += addnodes.desc_sig_operator(self.op, self.op)
+        signode += addnodes.desc_sig_space()
+        self.rightExpr.describe_signature(signode, mode, env, symbol)
 
 
 class ASTCommaExpr(ASTExpression):
-    def __init__(self, exprs: ListASTExpression):
+    def __init__(self, exprs: listASTExpression):
         assert len(exprs) > 0
         self.exprs = exprs
 
@@ -1612,7 +1657,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.exprs0.describe_signature(signode, mode, env, symbol)
         for i in range(1, len(self.exprs)):
             signode += addnodes.desc_sig_punctuation(',', ',')
@@ -1631,7 +1676,7 @@
         return str(self.expr)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += nodes.literal(self.expr, self.expr)
 
 
@@ -1653,13 +1698,13 @@
         raise NotImplementedError()
 
     def _describe_identifier(self, signode: TextElement, identnode: TextElement,
-                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+                             env: BuildEnvironment, symbol: Symbol) -> None:
         """Render the prefix into signode, and the last part into identnode."""
         raise NotImplementedError()
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", prefix: str, templateArgs: str,
-                           symbol: "Symbol") -> None:
+                           env: BuildEnvironment, prefix: str, templateArgs: str,
+                           symbol: Symbol) -> None:
         verify_description_mode(mode)
         if mode == 'lastIsName':
             mainName = addnodes.desc_name()
@@ -1710,7 +1755,7 @@
             return 'operator' + self.op
 
     def _describe_identifier(self, signode: TextElement, identnode: TextElement,
-                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+                             env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('operator', 'operator')
         if self.op in ('new', 'new', 'delete', 'delete') or self.op0 in "abcnox":
             signode += addnodes.desc_sig_space()
@@ -1724,21 +1769,20 @@
     def get_id(self, version: int) -> str:
         if version == 1:
             raise NoOldIdError()
-        else:
-            return 'li' + self.identifier.get_id(version)
+        return 'li' + self.identifier.get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
         return 'operator""' + transform(self.identifier)
 
     def _describe_identifier(self, signode: TextElement, identnode: TextElement,
-                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+                             env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('operator', 'operator')
         signode += addnodes.desc_sig_literal_string('""', '""')
         self.identifier.describe_signature(identnode, 'markType', env, '', '', symbol)
 
 
 class ASTOperatorType(ASTOperator):
-    def __init__(self, type: "ASTType") -> None:
+    def __init__(self, type: ASTType) -> None:
         self.type = type
 
     def get_id(self, version: int) -> str:
@@ -1754,7 +1798,7 @@
         return str(self)
 
     def _describe_identifier(self, signode: TextElement, identnode: TextElement,
-                             env: "BuildEnvironment", symbol: "Symbol") -> None:
+                             env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('operator', 'operator')
         signode += addnodes.desc_sig_space()
         self.type.describe_signature(identnode, 'markType', env, symbol)
@@ -1775,13 +1819,13 @@
         return 'X' + self.value.get_id(version) + 'E'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.value.describe_signature(signode, mode, env, symbol)
 
 
 class ASTTemplateArgs(ASTBase):
-    def __init__(self, args: ListUnion"ASTType", ASTTemplateArgConstant,
+    def __init__(self, args: listASTType | ASTTemplateArgConstant,
                  packExpansion: bool) -> None:
         assert args is not None
         self.args = args
@@ -1815,7 +1859,7 @@
         return '<' + res + '>'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('<', '<')
         first = True
@@ -1838,12 +1882,12 @@
         raise NotImplementedError(repr(self))
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         raise NotImplementedError(repr(self))
 
 
 class ASTTrailingTypeSpecFundamental(ASTTrailingTypeSpec):
-    def __init__(self, names: Liststr, canonNames: Liststr) -> None:
+    def __init__(self, names: liststr, canonNames: liststr) -> None:
         assert len(names) != 0
         assert len(names) == len(canonNames), (names, canonNames)
         self.names = names
@@ -1872,7 +1916,7 @@
         return _id_fundamental_v2txt
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         first = True
         for n in self.names:
             if not first:
@@ -1892,7 +1936,7 @@
         return 'Dc'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('decltype', 'decltype')
         signode += addnodes.desc_sig_punctuation('(', '(')
         signode += addnodes.desc_sig_keyword('auto', 'auto')
@@ -1912,7 +1956,7 @@
         return 'DT' + self.expr.get_id(version) + "E"
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('decltype', 'decltype')
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.expr.describe_signature(signode, mode, env, symbol)
@@ -1921,7 +1965,7 @@
 
 class ASTTrailingTypeSpecName(ASTTrailingTypeSpec):
     def __init__(self, prefix: str, nestedName: ASTNestedName,
-                 placeholderType: Optionalstr) -> None:
+                 placeholderType: str | None) -> None:
         self.prefix = prefix
         self.nestedName = nestedName
         self.placeholderType = placeholderType
@@ -1945,7 +1989,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.prefix:
             signode += addnodes.desc_sig_keyword(self.prefix, self.prefix)
             signode += addnodes.desc_sig_space()
@@ -1960,17 +2004,16 @@
                 signode += addnodes.desc_sig_keyword('auto', 'auto')
                 signode += addnodes.desc_sig_punctuation(')', ')')
             else:
-                assert False, self.placeholderType
+                raise AssertionError(self.placeholderType)
 
 
 class ASTFunctionParameter(ASTBase):
-    def __init__(self, arg: Union"ASTTypeWithInit",
-                                  "ASTTemplateParamConstrainedTypeWithInit",
+    def __init__(self, arg: ASTTypeWithInit | ASTTemplateParamConstrainedTypeWithInit,
                  ellipsis: bool = False) -> None:
         self.arg = arg
         self.ellipsis = ellipsis
 
-    def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str:
+    def get_id(self, version: int, objectType: str = None, symbol: Symbol = None) -> str:
         # this is not part of the normal name mangling in C++
         if symbol:
             # the anchor will be our parent
@@ -1988,7 +2031,7 @@
             return transform(self.arg)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.ellipsis:
             signode += addnodes.desc_sig_punctuation('...', '...')
@@ -1997,7 +2040,7 @@
 
 
 class ASTNoexceptSpec(ASTBase):
-    def __init__(self, expr: OptionalASTExpression):
+    def __init__(self, expr: ASTExpression | None):
         self.expr = expr
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -2006,7 +2049,7 @@
         return 'noexcept'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('noexcept', 'noexcept')
         if self.expr:
             signode += addnodes.desc_sig_punctuation('(', '(')
@@ -2015,11 +2058,11 @@
 
 
 class ASTParametersQualifiers(ASTBase):
-    def __init__(self, args: ListASTFunctionParameter, volatile: bool, const: bool,
-                 refQual: Optionalstr, exceptionSpec: ASTNoexceptSpec,
-                 trailingReturn: "ASTType",
-                 override: bool, final: bool, attrs: ListASTAttribute,
-                 initializer: Optionalstr) -> None:
+    def __init__(self, args: listASTFunctionParameter, volatile: bool, const: bool,
+                 refQual: str | None, exceptionSpec: ASTNoexceptSpec,
+                 trailingReturn: ASTType,
+                 override: bool, final: bool, attrs: ASTAttributeList,
+                 initializer: str | None) -> None:
         self.args = args
         self.volatile = volatile
         self.const = const
@@ -2032,7 +2075,7 @@
         self.initializer = initializer
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.args
 
     def get_modifiers_id(self, version: int) -> str:
@@ -2088,16 +2131,16 @@
             res.append(' final')
         if self.override:
             res.append(' override')
-        for attr in self.attrs:
+        if len(self.attrs) != 0:
             res.append(' ')
-            res.append(transform(attr))
+            res.append(transform(self.attrs))
         if self.initializer:
             res.append(' = ')
             res.append(self.initializer)
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         # only use the desc_parameterlist for the outer list, not for inner lists
         if mode == 'lastIsName':
@@ -2141,9 +2184,9 @@
             _add_anno(signode, 'final')
         if self.override:
             _add_anno(signode, 'override')
-        for attr in self.attrs:
+        if len(self.attrs) != 0:
             signode += addnodes.desc_sig_space()
-            attr.describe_signature(signode)
+            self.attrs.describe_signature(signode)
         if self.initializer:
             signode += addnodes.desc_sig_space()
             signode += addnodes.desc_sig_punctuation('=', '=')
@@ -2156,7 +2199,7 @@
 
 
 class ASTExplicitSpec(ASTBase):
-    def __init__(self, expr: OptionalASTExpression) -> None:
+    def __init__(self, expr: ASTExpression | None) -> None:
         self.expr = expr
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -2168,7 +2211,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('explicit', 'explicit')
         if self.expr is not None:
             signode += addnodes.desc_sig_punctuation('(', '(')
@@ -2178,10 +2221,10 @@
 
 class ASTDeclSpecsSimple(ASTBase):
     def __init__(self, storage: str, threadLocal: bool, inline: bool, virtual: bool,
-                 explicitSpec: OptionalASTExplicitSpec,
+                 explicitSpec: ASTExplicitSpec | None,
                  consteval: bool, constexpr: bool, constinit: bool,
                  volatile: bool, const: bool, friend: bool,
-                 attrs: ListASTAttribute) -> None:
+                 attrs: ASTAttributeList) -> None:
         self.storage = storage
         self.threadLocal = threadLocal
         self.inline = inline
@@ -2195,7 +2238,7 @@
         self.friend = friend
         self.attrs = attrs
 
-    def mergeWith(self, other: "ASTDeclSpecsSimple") -> "ASTDeclSpecsSimple":
+    def mergeWith(self, other: ASTDeclSpecsSimple) -> ASTDeclSpecsSimple:
         if not other:
             return self
         return ASTDeclSpecsSimple(self.storage or other.storage,
@@ -2212,8 +2255,9 @@
                                   self.attrs + other.attrs)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res: Liststr = 
-        res.extend(transform(attr) for attr in self.attrs)
+        res: liststr = 
+        if len(self.attrs) != 0:
+            res.append(transform(self.attrs))
         if self.storage:
             res.append(self.storage)
         if self.threadLocal:
@@ -2239,13 +2283,9 @@
         return ' '.join(res)
 
     def describe_signature(self, signode: TextElement,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
-        addSpace = False
-        for attr in self.attrs:
-            if addSpace:
-                signode += addnodes.desc_sig_space()
-            addSpace = True
-            attr.describe_signature(signode)
+                           env: BuildEnvironment, symbol: Symbol) -> None:
+        self.attrs.describe_signature(signode)
+        addSpace = len(self.attrs) != 0
 
         def _add(signode: TextElement, text: str) -> bool:
             if addSpace:
@@ -2311,7 +2351,7 @@
         return ''.join(res)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        res: Liststr = 
+        res: liststr = 
         l = transform(self.leftSpecs)
         if len(l) > 0:
             res.append(l)
@@ -2327,7 +2367,7 @@
         return "".join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         numChildren = len(signode)
         self.leftSpecs.describe_signature(signode, env, symbol)
@@ -2374,7 +2414,7 @@
             return 'A_'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('', '')
         if self.size:
@@ -2396,11 +2436,11 @@
         raise NotImplementedError(repr(self))
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         raise NotImplementedError(repr(self))
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         raise NotImplementedError(repr(self))
 
     def require_space_after_declSpecs(self) -> bool:
@@ -2422,13 +2462,13 @@
         raise NotImplementedError(repr(self))
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         raise NotImplementedError(repr(self))
 
 
 class ASTDeclaratorNameParamQual(ASTDeclarator):
     def __init__(self, declId: ASTNestedName,
-                 arrayOps: ListASTArray,
+                 arrayOps: listASTArray,
                  paramQual: ASTParametersQualifiers) -> None:
         self.declId = declId
         self.arrayOps = arrayOps
@@ -2447,11 +2487,11 @@
         return False
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.paramQual.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.paramQual.trailingReturn
 
     # only the modifiers for a function, e.g.,
@@ -2504,7 +2544,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.declId:
             self.declId.describe_signature(signode, mode, env, symbol)
@@ -2550,7 +2590,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.declId:
             self.declId.describe_signature(signode, mode, env, symbol)
@@ -2562,7 +2602,7 @@
 
 class ASTDeclaratorPtr(ASTDeclarator):
     def __init__(self, next: ASTDeclarator, volatile: bool, const: bool,
-                 attrs: ListASTAttribute) -> None:
+                 attrs: ASTAttributeList) -> None:
         assert next
         self.next = next
         self.volatile = volatile
@@ -2578,11 +2618,15 @@
         self.next.name = name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def isPack(self) -> bool:
+        return self.next.isPack
+
+    @property
+    def function_params(self) -> listASTFunctionParameter:
         return self.next.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.next.trailingReturn
 
     def require_space_after_declSpecs(self) -> bool:
@@ -2590,9 +2634,8 @@
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = '*'
-        for a in self.attrs:
-            res.append(transform(a))
-        if len(self.attrs) > 0 and (self.volatile or self.const):
+        res.append(transform(self.attrs))
+        if len(self.attrs) != 0 and (self.volatile or self.const):
             res.append(' ')
         if self.volatile:
             res.append('volatile')
@@ -2644,12 +2687,11 @@
         return self.next.is_function_type()
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('*', '*')
-        for a in self.attrs:
-            a.describe_signature(signode)
-        if len(self.attrs) > 0 and (self.volatile or self.const):
+        self.attrs.describe_signature(signode)
+        if len(self.attrs) != 0 and (self.volatile or self.const):
             signode += addnodes.desc_sig_space()
 
         def _add_anno(signode: TextElement, text: str) -> None:
@@ -2667,7 +2709,7 @@
 
 
 class ASTDeclaratorRef(ASTDeclarator):
-    def __init__(self, next: ASTDeclarator, attrs: ListASTAttribute) -> None:
+    def __init__(self, next: ASTDeclarator, attrs: ASTAttributeList) -> None:
         assert next
         self.next = next
         self.attrs = attrs
@@ -2682,14 +2724,14 @@
 
     @property
     def isPack(self) -> bool:
-        return True
+        return self.next.isPack
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.next.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.next.trailingReturn
 
     def require_space_after_declSpecs(self) -> bool:
@@ -2697,9 +2739,8 @@
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = '&'
-        for a in self.attrs:
-            res.append(transform(a))
-        if len(self.attrs) > 0 and self.next.require_space_after_declSpecs():
+        res.append(transform(self.attrs))
+        if len(self.attrs) != 0 and self.next.require_space_after_declSpecs():
             res.append(' ')
         res.append(transform(self.next))
         return ''.join(res)
@@ -2725,11 +2766,10 @@
         return self.next.is_function_type()
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('&', '&')
-        for a in self.attrs:
-            a.describe_signature(signode)
+        self.attrs.describe_signature(signode)
         if len(self.attrs) > 0 and self.next.require_space_after_declSpecs():
             signode += addnodes.desc_sig_space()
         self.next.describe_signature(signode, mode, env, symbol)
@@ -2749,13 +2789,17 @@
         self.next.name = name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.next.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.next.trailingReturn
 
+    @property
+    def isPack(self) -> bool:
+        return True
+
     def require_space_after_declSpecs(self) -> bool:
         return False
 
@@ -2786,7 +2830,7 @@
         return self.next.is_function_type()
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('...', '...')
         if self.next.name:
@@ -2813,11 +2857,15 @@
         self.next.name = name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def isPack(self):
+        return self.next.isPack
+
+    @property
+    def function_params(self) -> listASTFunctionParameter:
         return self.next.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.next.trailingReturn
 
     def require_space_after_declSpecs(self) -> bool:
@@ -2841,21 +2889,18 @@
     def get_modifiers_id(self, version: int) -> str:
         if version == 1:
             raise NoOldIdError()
-        else:
-            return self.next.get_modifiers_id(version)
+        return self.next.get_modifiers_id(version)
 
     def get_param_id(self, version: int) -> str:  # only the parameters (if any)
         if version == 1:
             raise NoOldIdError()
-        else:
-            return self.next.get_param_id(version)
+        return self.next.get_param_id(version)
 
     def get_ptr_suffix_id(self, version: int) -> str:
         if version == 1:
             raise NoOldIdError()
-        else:
-            raise NotImplementedError()
-            return self.next.get_ptr_suffix_id(version) + 'Dp'
+        raise NotImplementedError()
+        return self.next.get_ptr_suffix_id(version) + 'Dp'
 
     def get_type_id(self, version: int, returnTypeId: str) -> str:
         assert version >= 2
@@ -2874,7 +2919,7 @@
         return self.next.is_function_type()
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.className.describe_signature(signode, 'markType', env, symbol)
         signode += addnodes.desc_sig_punctuation('::', '::')
@@ -2910,11 +2955,15 @@
         self.inner.name = name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def isPack(self):
+        return self.inner.isPack or self.next.isPack
+
+    @property
+    def function_params(self) -> listASTFunctionParameter:
         return self.inner.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.inner.trailingReturn
 
     def require_space_after_declSpecs(self) -> bool:
@@ -2938,9 +2987,8 @@
             raise NoOldIdError()  # TODO: was this implemented before?
             return self.next.get_ptr_suffix_id(version) + \
                 self.inner.get_ptr_suffix_id(version)
-        else:
-            return self.inner.get_ptr_suffix_id(version) + \
-                self.next.get_ptr_suffix_id(version)
+        return self.inner.get_ptr_suffix_id(version) + \
+            self.next.get_ptr_suffix_id(version)
 
     def get_type_id(self, version: int, returnTypeId: str) -> str:
         assert version >= 2
@@ -2952,7 +3000,7 @@
         return self.inner.is_function_type()
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('(', '(')
         self.inner.describe_signature(signode, mode, env, symbol)
@@ -2964,7 +3012,7 @@
 ##############################################################################################
 
 class ASTPackExpansionExpr(ASTExpression):
-    def __init__(self, expr: UnionASTExpression, ASTBracedInitList):
+    def __init__(self, expr: ASTExpression | ASTBracedInitList):
         self.expr = expr
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -2975,13 +3023,13 @@
         return 'sp' + id
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.expr.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation('...', '...')
 
 
 class ASTParenExprList(ASTBaseParenExprList):
-    def __init__(self, exprs: ListUnionASTExpression, ASTBracedInitList) -> None:
+    def __init__(self, exprs: listASTExpression | ASTBracedInitList) -> None:
         self.exprs = exprs
 
     def get_id(self, version: int) -> str:
@@ -2992,7 +3040,7 @@
         return '(%s)' % ', '.join(exprs)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         signode += addnodes.desc_sig_punctuation('(', '(')
         first = True
@@ -3007,7 +3055,7 @@
 
 
 class ASTInitializer(ASTBase):
-    def __init__(self, value: UnionASTExpression, ASTBracedInitList,
+    def __init__(self, value: ASTExpression | ASTBracedInitList,
                  hasAssign: bool = True) -> None:
         self.value = value
         self.hasAssign = hasAssign
@@ -3020,7 +3068,7 @@
             return val
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.hasAssign:
             signode += addnodes.desc_sig_space()
@@ -3049,15 +3097,15 @@
         return self.decl.isPack
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         return self.decl.function_params
 
     @property
-    def trailingReturn(self) -> "ASTType":
+    def trailingReturn(self) -> ASTType:
         return self.decl.trailingReturn
 
     def get_id(self, version: int, objectType: str = None,
-               symbol: "Symbol" = None) -> str:
+               symbol: Symbol = None) -> str:
         if version == 1:
             res = 
             if objectType:  # needs the name
@@ -3072,8 +3120,7 @@
                 elif objectType == 'type':  # just the name
                     res.append(symbol.get_full_nested_name().get_id(version))
                 else:
-                    print(objectType)
-                    assert False
+                    raise AssertionError(objectType)
             else:  # only type encoding
                 if self.decl.is_function_type():
                     raise NoOldIdError()
@@ -3102,8 +3149,7 @@
             elif objectType == 'type':  # just the name
                 res.append(symbol.get_full_nested_name().get_id(version))
             else:
-                print(objectType)
-                assert False
+                raise AssertionError(objectType)
         else:  # only type encoding
             # the 'returnType' of a non-function type is simply just the last
             # type, i.e., for 'int*' it is 'int'
@@ -3128,7 +3174,7 @@
             return 'type'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.declSpecs.describe_signature(signode, 'markType', env, symbol)
         if (self.decl.require_space_after_declSpecs() and
@@ -3155,7 +3201,7 @@
     def isPack(self) -> bool:
         return self.type.isPack
 
-    def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str:
+    def get_id(self, version: int, objectType: str = None, symbol: Symbol = None) -> str:
         # this is not part of the normal name mangling in C++
         assert version >= 2
         if symbol:
@@ -3172,7 +3218,7 @@
         return res
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.type.describe_signature(signode, mode, env, symbol)
         if self.init:
             signode += addnodes.desc_sig_space()
@@ -3195,7 +3241,7 @@
         return self.type.isPack
 
     def get_id(self, version: int, objectType: str = None,
-               symbol: "Symbol" = None) -> str:
+               symbol: Symbol = None) -> str:
         if objectType != 'member':
             return self.type.get_id(version, objectType)
         if version == 1:
@@ -3211,7 +3257,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.type.describe_signature(signode, mode, env, symbol)
         if self.init:
@@ -3224,7 +3270,7 @@
         self.type = type
 
     def get_id(self, version: int, objectType: str = None,
-               symbol: "Symbol" = None) -> str:
+               symbol: Symbol = None) -> str:
         if version == 1:
             raise NoOldIdError()
         return symbol.get_full_nested_name().get_id(version)
@@ -3241,7 +3287,7 @@
         return 'using'
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol=symbol)
         if self.type:
@@ -3264,7 +3310,7 @@
         return self.nestedName
 
     def get_id(self, version: int, objectType: str = None,
-               symbol: "Symbol" = None) -> str:
+               symbol: Symbol = None) -> str:
         if version == 1:
             raise NoOldIdError()
         return symbol.get_full_nested_name().get_id(version)
@@ -3276,7 +3322,7 @@
         return res
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.nestedName.describe_signature(signode, mode, env, symbol)
         if self.initializer:
             self.initializer.describe_signature(signode, mode, env, symbol)
@@ -3303,7 +3349,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         if self.visibility is not None:
             signode += addnodes.desc_sig_keyword(self.visibility,
@@ -3318,16 +3364,21 @@
 
 
 class ASTClass(ASTBase):
-    def __init__(self, name: ASTNestedName, final: bool, bases: ListASTBaseClass) -> None:
+    def __init__(self, name: ASTNestedName, final: bool, bases: listASTBaseClass,
+                 attrs: ASTAttributeList) -> None:
         self.name = name
         self.final = final
         self.bases = bases
+        self.attrs = attrs
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
         res = 
+        res.append(transform(self.attrs))
+        if len(self.attrs) != 0:
+            res.append(' ')
         res.append(transform(self.name))
         if self.final:
             res.append(' final')
@@ -3342,8 +3393,11 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
+        self.attrs.describe_signature(signode)
+        if len(self.attrs) != 0:
+            signode += addnodes.desc_sig_space()
         self.name.describe_signature(signode, mode, env, symbol=symbol)
         if self.final:
             signode += addnodes.desc_sig_space()
@@ -3361,31 +3415,41 @@
 
 
 class ASTUnion(ASTBase):
-    def __init__(self, name: ASTNestedName) -> None:
+    def __init__(self, name: ASTNestedName, attrs: ASTAttributeList) -> None:
         self.name = name
+        self.attrs = attrs
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         if version == 1:
             raise NoOldIdError()
         return symbol.get_full_nested_name().get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        return transform(self.name)
+        res = 
+        res.append(transform(self.attrs))
+        if len(self.attrs) != 0:
+            res.append(' ')
+        res.append(transform(self.name))
+        return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
+        self.attrs.describe_signature(signode)
+        if len(self.attrs) != 0:
+            signode += addnodes.desc_sig_space()
         self.name.describe_signature(signode, mode, env, symbol=symbol)
 
 
 class ASTEnum(ASTBase):
-    def __init__(self, name: ASTNestedName, scoped: str,
-                 underlyingType: ASTType) -> None:
+    def __init__(self, name: ASTNestedName, scoped: str, underlyingType: ASTType,
+                 attrs: ASTAttributeList) -> None:
         self.name = name
         self.scoped = scoped
         self.underlyingType = underlyingType
+        self.attrs = attrs
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         if version == 1:
             raise NoOldIdError()
         return symbol.get_full_nested_name().get_id(version)
@@ -3395,6 +3459,9 @@
         if self.scoped:
             res.append(self.scoped)
             res.append(' ')
+        res.append(transform(self.attrs))
+        if len(self.attrs) != 0:
+            res.append(' ')
         res.append(transform(self.name))
         if self.underlyingType:
             res.append(' : ')
@@ -3402,9 +3469,12 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         # self.scoped has been done by the CPPEnumObject
+        self.attrs.describe_signature(signode)
+        if len(self.attrs) != 0:
+            signode += addnodes.desc_sig_space()
         self.name.describe_signature(signode, mode, env, symbol=symbol)
         if self.underlyingType:
             signode += addnodes.desc_sig_space()
@@ -3415,11 +3485,13 @@
 
 
 class ASTEnumerator(ASTBase):
-    def __init__(self, name: ASTNestedName, init: ASTInitializer) -> None:
+    def __init__(self, name: ASTNestedName, init: ASTInitializer | None,
+                 attrs: ASTAttributeList) -> None:
         self.name = name
         self.init = init
+        self.attrs = attrs
 
-    def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str:
+    def get_id(self, version: int, objectType: str, symbol: Symbol) -> str:
         if version == 1:
             raise NoOldIdError()
         return symbol.get_full_nested_name().get_id(version)
@@ -3427,14 +3499,20 @@
     def _stringify(self, transform: StringifyTransform) -> str:
         res = 
         res.append(transform(self.name))
+        if len(self.attrs) != 0:
+            res.append(' ')
+            res.append(transform(self.attrs))
         if self.init:
             res.append(transform(self.init))
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         verify_description_mode(mode)
         self.name.describe_signature(signode, mode, env, symbol)
+        if len(self.attrs) != 0:
+            signode += addnodes.desc_sig_space()
+            self.attrs.describe_signature(signode)
         if self.init:
             self.init.describe_signature(signode, 'markType', env, symbol)
 
@@ -3454,7 +3532,15 @@
         raise NotImplementedError(repr(self))
 
     def describe_signature(self, parentNode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
+        raise NotImplementedError(repr(self))
+
+    @property
+    def isPack(self) -> bool:
+        raise NotImplementedError(repr(self))
+
+    @property
+    def name(self) -> ASTNestedName:
         raise NotImplementedError(repr(self))
 
 
@@ -3498,7 +3584,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword(self.key, self.key)
         if self.parameterPack:
             if self.identifier:
@@ -3532,7 +3618,7 @@
     def get_identifier(self) -> ASTIdentifier:
         return self.data.get_identifier()
 
-    def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str:
+    def get_id(self, version: int, objectType: str = None, symbol: Symbol = None) -> str:
         # this is not part of the normal name mangling in C++
         assert version >= 2
         if symbol:
@@ -3545,12 +3631,12 @@
         return transform(self.data)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.data.describe_signature(signode, mode, env, symbol)
 
 
 class ASTTemplateParamTemplateType(ASTTemplateParam):
-    def __init__(self, nestedParams: "ASTTemplateParams",
+    def __init__(self, nestedParams: ASTTemplateParams,
                  data: ASTTemplateKeyParamPackIdDefault) -> None:
         assert nestedParams
         assert data
@@ -3569,7 +3655,9 @@
     def get_identifier(self) -> ASTIdentifier:
         return self.data.get_identifier()
 
-    def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str:
+    def get_id(
+        self, version: int, objectType: str | None = None, symbol: Symbol | None = None,
+    ) -> str:
         assert version >= 2
         # this is not part of the normal name mangling in C++
         if symbol:
@@ -3582,7 +3670,7 @@
         return transform(self.nestedParams) + transform(self.data)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.nestedParams.describe_signature(signode, 'noneIsName', env, symbol)
         signode += addnodes.desc_sig_space()
         self.data.describe_signature(signode, mode, env, symbol)
@@ -3590,10 +3678,11 @@
 
 class ASTTemplateParamNonType(ASTTemplateParam):
     def __init__(self,
-                 param: UnionASTTypeWithInit,
-                              ASTTemplateParamConstrainedTypeWithInit) -> None:
+                 param: ASTTypeWithInit | ASTTemplateParamConstrainedTypeWithInit,
+                 parameterPack: bool = False) -> None:
         assert param
         self.param = param
+        self.parameterPack = parameterPack
 
     @property
     def name(self) -> ASTNestedName:
@@ -3602,7 +3691,7 @@
 
     @property
     def isPack(self) -> bool:
-        return self.param.isPack
+        return self.param.isPack or self.parameterPack
 
     def get_identifier(self) -> ASTIdentifier:
         name = self.param.name
@@ -3616,35 +3705,49 @@
         else:
             return None
 
-    def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str:
+    def get_id(self, version: int, objectType: str = None, symbol: Symbol = None) -> str:
         assert version >= 2
         # this is not part of the normal name mangling in C++
         if symbol:
             # the anchor will be our parent
             return symbol.parent.declaration.get_id(version, prefixed=None)
         else:
-            return '_' + self.param.get_id(version)
+            res = '_'
+            if self.parameterPack:
+                res += 'Dp'
+            return res + self.param.get_id(version)
 
     def _stringify(self, transform: StringifyTransform) -> str:
-        return transform(self.param)
+        res = transform(self.param)
+        if self.parameterPack:
+            res += '...'
+        return res
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         self.param.describe_signature(signode, mode, env, symbol)
+        if self.parameterPack:
+            signode += addnodes.desc_sig_punctuation('...', '...')
 
 
 class ASTTemplateParams(ASTBase):
-    def __init__(self, params: ListASTTemplateParam) -> None:
+    def __init__(self, params: listASTTemplateParam,
+                 requiresClause: ASTRequiresClause | None) -> None:
         assert params is not None
         self.params = params
+        self.requiresClause = requiresClause
 
-    def get_id(self, version: int) -> str:
+    def get_id(self, version: int, excludeRequires: bool = False) -> str:
         assert version >= 2
         res = 
         res.append("I")
         for param in self.params:
             res.append(param.get_id(version))
         res.append("E")
+        if not excludeRequires and self.requiresClause:
+            res.append('IQ')
+            res.append(self.requiresClause.expr.get_id(version))
+            res.append('E')
         return ''.join(res)
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -3652,10 +3755,13 @@
         res.append("template<")
         res.append(", ".join(transform(a) for a in self.params))
         res.append("> ")
+        if self.requiresClause is not None:
+            res.append(transform(self.requiresClause))
+            res.append(" ")
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('template', 'template')
         signode += addnodes.desc_sig_punctuation('<', '<')
         first = True
@@ -3666,10 +3772,13 @@
             first = False
             param.describe_signature(signode, mode, env, symbol)
         signode += addnodes.desc_sig_punctuation('>', '>')
+        if self.requiresClause is not None:
+            signode += addnodes.desc_sig_space()
+            self.requiresClause.describe_signature(signode, mode, env, symbol)
 
     def describe_signature_as_introducer(
-            self, parentNode: desc_signature, mode: str, env: "BuildEnvironment",
-            symbol: "Symbol", lineSpec: bool) -> None:
+            self, parentNode: desc_signature, mode: str, env: BuildEnvironment,
+            symbol: Symbol, lineSpec: bool) -> None:
         def makeLine(parentNode: desc_signature) -> addnodes.desc_signature_line:
             signode = addnodes.desc_signature_line()
             parentNode += signode
@@ -3690,6 +3799,11 @@
         if lineSpec and not first:
             lineNode = makeLine(parentNode)
         lineNode += addnodes.desc_sig_punctuation('>', '>')
+        if self.requiresClause:
+            reqNode = addnodes.desc_signature_line()
+            reqNode.sphinx_line_type = 'requiresClause'
+            parentNode += reqNode
+            self.requiresClause.describe_signature(reqNode, 'markType', env, symbol)
 
 
 # Template introducers
@@ -3712,7 +3826,7 @@
     def get_identifier(self) -> ASTIdentifier:
         return self.identifier
 
-    def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str:
+    def get_id(self, version: int, objectType: str = None, symbol: Symbol = None) -> str:
         assert version >= 2
         # this is not part of the normal name mangling in C++
         if symbol:
@@ -3741,7 +3855,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: TextElement, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         if self.parameterPack:
             signode += addnodes.desc_sig_punctuation('...', '...')
         self.identifier.describe_signature(signode, mode, env, '', '', symbol)
@@ -3749,7 +3863,7 @@
 
 class ASTTemplateIntroduction(ASTBase):
     def __init__(self, concept: ASTNestedName,
-                 params: ListASTTemplateIntroductionParameter) -> None:
+                 params: listASTTemplateIntroductionParameter) -> None:
         assert len(params) > 0
         self.concept = concept
         self.params = params
@@ -3782,7 +3896,7 @@
 
     def describe_signature_as_introducer(
             self, parentNode: desc_signature, mode: str,
-            env: "BuildEnvironment", symbol: "Symbol", lineSpec: bool) -> None:
+            env: BuildEnvironment, symbol: Symbol, lineSpec: bool) -> None:
         # Note: 'lineSpec' has no effect on template introductions.
         signode = addnodes.desc_signature_line()
         parentNode += signode
@@ -3803,17 +3917,28 @@
 
 class ASTTemplateDeclarationPrefix(ASTBase):
     def __init__(self,
-                 templates: ListUnionASTTemplateParams,
-                                       ASTTemplateIntroduction) -> None:
+                 templates: listASTTemplateParams | ASTTemplateIntroduction) -> None:
         # templates is None means it's an explicit instantiation of a variable
         self.templates = templates
 
-    def get_id(self, version: int) -> str:
+    def get_requires_clause_in_last(self) -> ASTRequiresClause | None:
+        if self.templates is None:
+            return None
+        lastList = self.templates-1
+        if not isinstance(lastList, ASTTemplateParams):
+            return None
+        return lastList.requiresClause  # which may be None
+
+    def get_id_except_requires_clause_in_last(self, version: int) -> str:
         assert version >= 2
-        # this is not part of a normal name mangling system
+        # This is not part of the Itanium ABI mangling system.
         res = 
-        for t in self.templates:
-            res.append(t.get_id(version))
+        lastIndex = len(self.templates) - 1
+        for i, t in enumerate(self.templates):
+            if isinstance(t, ASTTemplateParams):
+                res.append(t.get_id(version, excludeRequires=(i == lastIndex)))
+            else:
+                res.append(t.get_id(version))
         return ''.join(res)
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -3823,7 +3948,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: desc_signature, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol", lineSpec: bool) -> None:
+                           env: BuildEnvironment, symbol: Symbol, lineSpec: bool) -> None:
         verify_description_mode(mode)
         for t in self.templates:
             t.describe_signature_as_introducer(signode, 'lastIsName', env, symbol, lineSpec)
@@ -3836,8 +3961,8 @@
     def _stringify(self, transform: StringifyTransform) -> str:
         return 'requires ' + transform(self.expr)
 
-    def describe_signature(self, signode: addnodes.desc_signature_line, mode: str,
-                           env: "BuildEnvironment", symbol: "Symbol") -> None:
+    def describe_signature(self, signode: nodes.TextElement, mode: str,
+                           env: BuildEnvironment, symbol: Symbol) -> None:
         signode += addnodes.desc_sig_keyword('requires', 'requires')
         signode += addnodes.desc_sig_space()
         self.expr.describe_signature(signode, mode, env, symbol)
@@ -3847,16 +3972,16 @@
 ################################################################################
 
 class ASTDeclaration(ASTBase):
-    def __init__(self, objectType: str, directiveType: str, visibility: str,
-                 templatePrefix: ASTTemplateDeclarationPrefix,
-                 requiresClause: ASTRequiresClause, declaration: Any,
-                 trailingRequiresClause: ASTRequiresClause,
+    def __init__(self, objectType: str, directiveType: str | None = None,
+                 visibility: str | None = None,
+                 templatePrefix: ASTTemplateDeclarationPrefix | None = None,
+                 declaration: Any = None,
+                 trailingRequiresClause: ASTRequiresClause | None = None,
                  semicolon: bool = False) -> None:
         self.objectType = objectType
         self.directiveType = directiveType
         self.visibility = visibility
         self.templatePrefix = templatePrefix
-        self.requiresClause = requiresClause
         self.declaration = declaration
         self.trailingRequiresClause = trailingRequiresClause
         self.semicolon = semicolon
@@ -3865,13 +3990,12 @@
         # set by CPPObject._add_enumerator_to_parent
         self.enumeratorScopedSymbol: Symbol = None
 
-    def clone(self) -> "ASTDeclaration":
+    def clone(self) -> ASTDeclaration:
         templatePrefixClone = self.templatePrefix.clone() if self.templatePrefix else None
-        requiresClasueClone = self.requiresClause.clone() if self.requiresClause else None
         trailingRequiresClasueClone = self.trailingRequiresClause.clone() \
             if self.trailingRequiresClause else None
         return ASTDeclaration(self.objectType, self.directiveType, self.visibility,
-                              templatePrefixClone, requiresClasueClone,
+                              templatePrefixClone,
                               self.declaration.clone(), trailingRequiresClasueClone,
                               self.semicolon)
 
@@ -3880,14 +4004,14 @@
         return self.declaration.name
 
     @property
-    def function_params(self) -> ListASTFunctionParameter:
+    def function_params(self) -> listASTFunctionParameter:
         if self.objectType != 'function':
             return None
         return self.declaration.function_params
 
     def get_id(self, version: int, prefixed: bool = True) -> str:
         if version == 1:
-            if self.templatePrefix:
+            if self.templatePrefix or self.trailingRequiresClause:
                 raise NoOldIdError()
             if self.objectType == 'enumerator' and self.enumeratorScopedSymbol:
                 return self.enumeratorScopedSymbol.declaration.get_id(version)
@@ -3899,16 +4023,31 @@
             res = _id_prefixversion
         else:
             res = 
-        if self.templatePrefix:
-            res.append(self.templatePrefix.get_id(version))
-        if self.requiresClause or self.trailingRequiresClause:
+        # (See also https://github.com/sphinx-doc/sphinx/pull/10286#issuecomment-1168102147)
+        # The first implementation of requires clauses only supported a single clause after the
+        # template prefix, and no trailing clause. It put the ID after the template parameter
+        # list, i.e.,
+        #    "I" + template_parameter_list_id + "E" + "IQ" + requires_clause_id + "E"
+        # but the second implementation associates the requires clause with each list, i.e.,
+        #    "I" + template_parameter_list_id + "IQ" + requires_clause_id + "E" + "E"
+        # To avoid making a new ID version, we make an exception for the last requires clause
+        # in the template prefix, and still put it in the end.
+        # As we now support trailing requires clauses we add that as if it was a conjunction.
+        if self.templatePrefix is not None:
+            res.append(self.templatePrefix.get_id_except_requires_clause_in_last(version))
+            requiresClauseInLast = self.templatePrefix.get_requires_clause_in_last()
+        else:
+            requiresClauseInLast = None
+
+        if requiresClauseInLast or self.trailingRequiresClause:
             if version < 4:
                 raise NoOldIdError()
             res.append('IQ')
-            if self.requiresClause and self.trailingRequiresClause:
+            if requiresClauseInLast and self.trailingRequiresClause:
+                # make a conjunction of them
                 res.append('aa')
-            if self.requiresClause:
-                res.append(self.requiresClause.expr.get_id(version))
+            if requiresClauseInLast:
+                res.append(requiresClauseInLast.expr.get_id(version))
             if self.trailingRequiresClause:
                 res.append(self.trailingRequiresClause.expr.get_id(version))
             res.append('E')
@@ -3925,9 +4064,6 @@
             res.append(' ')
         if self.templatePrefix:
             res.append(transform(self.templatePrefix))
-        if self.requiresClause:
-            res.append(transform(self.requiresClause))
-            res.append(' ')
         res.append(transform(self.declaration))
         if self.trailingRequiresClause:
             res.append(' ')
@@ -3937,7 +4073,7 @@
         return ''.join(res)
 
     def describe_signature(self, signode: desc_signature, mode: str,
-                           env: "BuildEnvironment", options: Dict) -> None:
+                           env: BuildEnvironment, options: dict) -> None:
         verify_description_mode(mode)
         assert self.symbol
         # The caller of the domain added a desc_signature node.
@@ -3952,11 +4088,6 @@
             self.templatePrefix.describe_signature(signode, mode, env,
                                                    symbol=self.symbol,
                                                    lineSpec=options.get('tparam-line-spec'))
-        if self.requiresClause:
-            reqNode = addnodes.desc_signature_line()
-            reqNode.sphinx_line_type = 'requiresClause'
-            signode.append(reqNode)
-            self.requiresClause.describe_signature(reqNode, 'markType', env, self.symbol)
         signode += mainDeclNode
         if self.visibility and self.visibility != "public":
             mainDeclNode += addnodes.desc_sig_keyword(self.visibility, self.visibility)
@@ -3968,9 +4099,7 @@
         elif self.objectType == 'concept':
             mainDeclNode += addnodes.desc_sig_keyword('concept', 'concept')
             mainDeclNode += addnodes.desc_sig_space()
-        elif self.objectType == 'member':
-            pass
-        elif self.objectType == 'function':
+        elif self.objectType in {'member', 'function'}:
             pass
         elif self.objectType == 'class':
             assert self.directiveType in ('class', 'struct')
@@ -3994,7 +4123,7 @@
             mainDeclNode += addnodes.desc_sig_keyword('enumerator', 'enumerator')
             mainDeclNode += addnodes.desc_sig_space()
         else:
-            assert False, self.objectType
+            raise AssertionError(self.objectType)
         self.declaration.describe_signature(mainDeclNode, mode, env, self.symbol)
         lastDeclNode = mainDeclNode
         if self.trailingRequiresClause:
@@ -4023,8 +4152,8 @@
 
 
 class SymbolLookupResult:
-    def __init__(self, symbols: Iterator"Symbol", parentSymbol: "Symbol",
-                 identOrOp: UnionASTIdentifier, ASTOperator, templateParams: Any,
+    def __init__(self, symbols: IteratorSymbol, parentSymbol: Symbol,
+                 identOrOp: ASTIdentifier | ASTOperator, templateParams: Any,
                  templateArgs: ASTTemplateArgs) -> None:
         self.symbols = symbols
         self.parentSymbol = parentSymbol
@@ -4034,13 +4163,37 @@
 
 
 class LookupKey:
-    def __init__(self, data: ListTupleASTNestedNameElement,
-                                        UnionASTTemplateParams,
-                                              ASTTemplateIntroduction,
+    def __init__(self, data: listtupleASTNestedNameElement,
+                                        ASTTemplateParams | ASTTemplateIntroduction,
                                         str) -> None:
         self.data = data
 
 
+def _is_specialization(templateParams: ASTTemplateParams | ASTTemplateIntroduction,
+                       templateArgs: ASTTemplateArgs) -> bool:
+    # Checks if `templateArgs` does not exactly match `templateParams`.
+    # the names of the template parameters must be given exactly as args
+    # and params that are packs must in the args be the name expanded
+    if len(templateParams.params) != len(templateArgs.args):
+        return True
+    # having no template params and no arguments is also a specialization
+    if len(templateParams.params) == 0:
+        return True
+    for i in range(len(templateParams.params)):
+        param = templateParams.paramsi
+        arg = templateArgs.argsi
+        # TODO: doing this by string manipulation is probably not the most efficient
+        paramName = str(param.name)
+        argTxt = str(arg)
+        isArgPackExpansion = argTxt.endswith('...')
+        if param.isPack != isArgPackExpansion:
+            return True
+        argName = argTxt:-3 if isArgPackExpansion else argTxt
+        if paramName != argName:
+            return True
+    return False
+
+
 class Symbol:
     debug_indent = 0
     debug_indent_string = "  "
@@ -4048,14 +4201,13 @@
     debug_show_tree = False  # overridden by the corresponding config value
 
     def __copy__(self):
-        assert False  # shouldn't happen
+        raise AssertionError()  # shouldn't happen
 
     def __deepcopy__(self, memo):
         if self.parent:
-            assert False  # shouldn't happen
-        else:
-            # the domain base class makes a copy of the initial data, which is fine
-            return Symbol(None, None, None, None, None, None, None)
+            raise AssertionError()  # shouldn't happen
+        # the domain base class makes a copy of the initial data, which is fine
+        return Symbol(None, None, None, None, None, None, None)
 
     @staticmethod
     def debug_print(*args: Any) -> None:
@@ -4076,19 +4228,29 @@
 
     def __setattr__(self, key: str, value: Any) -> None:
         if key == "children":
-            assert False
-        else:
-            return super().__setattr__(key, value)
+            raise AssertionError()
+        return super().__setattr__(key, value)
 
-    def __init__(self, parent: "Symbol", identOrOp: UnionASTIdentifier, ASTOperator,
-                 templateParams: UnionASTTemplateParams, ASTTemplateIntroduction,
-                 templateArgs: Any, declaration: ASTDeclaration,
-                 docname: str, line: int) -> None:
+    def __init__(self, parent: Symbol | None,
+                 identOrOp: ASTIdentifier | ASTOperator | None,
+                 templateParams: ASTTemplateParams | ASTTemplateIntroduction | None,
+                 templateArgs: Any, declaration: ASTDeclaration | None,
+                 docname: str | None, line: int | None) -> None:
         self.parent = parent
         # declarations in a single directive are linked together
-        self.siblingAbove: Symbol = None
-        self.siblingBelow: Symbol = None
+        self.siblingAbove: Symbol | None = None
+        self.siblingBelow: Symbol | None = None
         self.identOrOp = identOrOp
+        # Ensure the same symbol for `A` is created for:
+        #
+        #     .. cpp:class:: template <typename T> class A
+        #
+        # and
+        #
+        #     .. cpp:function:: template <typename T> int A<T>::foo()
+        if (templateArgs is not None and
+                not _is_specialization(templateParams, templateArgs)):
+            templateArgs = None
         self.templateParams = templateParams  # template<templateParams>
         self.templateArgs = templateArgs  # identifier<templateArgs>
         self.declaration = declaration
@@ -4098,8 +4260,8 @@
         self._assert_invariants()
 
         # Remember to modify Symbol.remove if modifications to the parent change.
-        self._children: ListSymbol = 
-        self._anonChildren: ListSymbol = 
+        self._children: listSymbol = 
+        self._anonChildren: listSymbol = 
         # note: _children includes _anonChildren
         if self.parent:
             self.parent._children.append(self)
@@ -4139,7 +4301,7 @@
                     continue
                 # only add a declaration if we our self are from a declaration
                 if self.declaration:
-                    decl = ASTDeclaration('templateParam', None, None, None, None, tp, None)
+                    decl = ASTDeclaration(objectType='templateParam', declaration=tp)
                 else:
                     decl = None
                 nne = ASTNestedNameElement(tp.get_identifier(), None)
@@ -4154,7 +4316,7 @@
                 if nn is None:
                     continue
                 # (comparing to the template params: we have checked that we are a declaration)
-                decl = ASTDeclaration('functionParam', None, None, None, None, fp, None)
+                decl = ASTDeclaration(objectType='functionParam', declaration=fp)
                 assert not nn.rooted
                 assert len(nn.names) == 1
                 self._add_symbols(nn, , decl, self.docname, self.line)
@@ -4169,7 +4331,7 @@
         self.parent = None
 
     def clear_doc(self, docname: str) -> None:
-        newChildren: ListSymbol = 
+        newChildren: listSymbol = 
         for sChild in self._children:
             sChild.clear_doc(docname)
             if sChild.declaration and sChild.docname == docname:
@@ -4191,7 +4353,7 @@
             yield from sChild.get_all_symbols()
 
     @property
-    def children_recurse_anon(self) -> Generator"Symbol", None, None:
+    def children_recurse_anon(self) -> GeneratorSymbol, None, None:
         for c in self._children:
             yield c
             if not c.identOrOp.is_anon():
@@ -4199,7 +4361,7 @@
 
             yield from c.children_recurse_anon
 
-    def get_lookup_key(self) -> "LookupKey":
+    def get_lookup_key(self) -> LookupKey:
         # The pickle files for the environment and for each document are distinct.
         # The environment has all the symbols, but the documents has xrefs that
         # must know their scope. A lookup key is essentially a specification of
@@ -4233,11 +4395,11 @@
             templates.append(False)
         return ASTNestedName(names, templates, rooted=False)
 
-    def _find_first_named_symbol(self, identOrOp: UnionASTIdentifier, ASTOperator,
+    def _find_first_named_symbol(self, identOrOp: ASTIdentifier | ASTOperator,
                                  templateParams: Any, templateArgs: ASTTemplateArgs,
                                  templateShorthand: bool, matchSelf: bool,
-                                 recurseInAnon: bool, correctPrimaryTemplateArgs: bool
-                                 ) -> "Symbol":
+                                 recurseInAnon: bool, correctPrimaryTemplateArgs: bool,
+                                 ) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_print("_find_first_named_symbol ->")
         res = self._find_named_symbols(identOrOp, templateParams, templateArgs,
@@ -4249,11 +4411,11 @@
         except StopIteration:
             return None
 
-    def _find_named_symbols(self, identOrOp: UnionASTIdentifier, ASTOperator,
+    def _find_named_symbols(self, identOrOp: ASTIdentifier | ASTOperator,
                             templateParams: Any, templateArgs: ASTTemplateArgs,
                             templateShorthand: bool, matchSelf: bool,
                             recurseInAnon: bool, correctPrimaryTemplateArgs: bool,
-                            searchInSiblings: bool) -> Iterator"Symbol":
+                            searchInSiblings: bool) -> IteratorSymbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("_find_named_symbols:")
@@ -4269,36 +4431,15 @@
             Symbol.debug_print("correctPrimaryTemplateAargs:", correctPrimaryTemplateArgs)
             Symbol.debug_print("searchInSiblings:           ", searchInSiblings)
 
-        def isSpecialization() -> bool:
-            # the names of the template parameters must be given exactly as args
-            # and params that are packs must in the args be the name expanded
-            if len(templateParams.params) != len(templateArgs.args):
-                return True
-            # having no template params and no arguments is also a specialization
-            if len(templateParams.params) == 0:
-                return True
-            for i in range(len(templateParams.params)):
-                param = templateParams.paramsi
-                arg = templateArgs.argsi
-                # TODO: doing this by string manipulation is probably not the most efficient
-                paramName = str(param.name)
-                argTxt = str(arg)
-                isArgPackExpansion = argTxt.endswith('...')
-                if param.isPack != isArgPackExpansion:
-                    return True
-                argName = argTxt:-3 if isArgPackExpansion else argTxt
-                if paramName != argName:
-                    return True
-            return False
         if correctPrimaryTemplateArgs:
             if templateParams is not None and templateArgs is not None:
                 # If both are given, but it's not a specialization, then do lookup as if
                 # there is no argument list.
                 # For example: template<typename T> int A<T>::var;
-                if not isSpecialization():
+                if not _is_specialization(templateParams, templateArgs):
                     templateArgs = None
 
-        def matches(s: "Symbol") -> bool:
+        def matches(s: Symbol) -> bool:
             if s.identOrOp != identOrOp:
                 return False
             if (s.templateParams is None) != (templateParams is None):
@@ -4355,12 +4496,18 @@
         if Symbol.debug_lookup:
             Symbol.debug_indent -= 2
 
-    def _symbol_lookup(self, nestedName: ASTNestedName, templateDecls: ListAny,
-                       onMissingQualifiedSymbol: Callable"Symbol", UnionASTIdentifier, ASTOperator, Any, ASTTemplateArgs, "Symbol",  # NOQA
-                       strictTemplateParamArgLists: bool, ancestorLookupType: str,
-                       templateShorthand: bool, matchSelf: bool,
-                       recurseInAnon: bool, correctPrimaryTemplateArgs: bool,
-                       searchInSiblings: bool) -> SymbolLookupResult:
+    def _symbol_lookup(
+        self,
+        nestedName: ASTNestedName,
+        templateDecls: listAny,
+        onMissingQualifiedSymbol: Callable
+            Symbol, ASTIdentifier | ASTOperator, Any, ASTTemplateArgs, Symbol | None,
+        ,
+        strictTemplateParamArgLists: bool, ancestorLookupType: str,
+        templateShorthand: bool, matchSelf: bool,
+        recurseInAnon: bool, correctPrimaryTemplateArgs: bool,
+        searchInSiblings: bool,
+    ) -> SymbolLookupResult:
         # ancestorLookupType: if not None, specifies the target type of the lookup
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
@@ -4484,8 +4631,8 @@
         return SymbolLookupResult(symbols, parentSymbol,
                                   identOrOp, templateParams, templateArgs)
 
-    def _add_symbols(self, nestedName: ASTNestedName, templateDecls: ListAny,
-                     declaration: ASTDeclaration, docname: str, line: int) -> "Symbol":
+    def _add_symbols(self, nestedName: ASTNestedName, templateDecls: listAny,
+                     declaration: ASTDeclaration, docname: str, line: int) -> Symbol:
         # Used for adding a whole path of symbols, where the last may or may not
         # be an actual declaration.
 
@@ -4496,12 +4643,12 @@
             Symbol.debug_print("tdecls:", ",".join(str(t) for t in templateDecls))
             Symbol.debug_print("nn:       ", nestedName)
             Symbol.debug_print("decl:     ", declaration)
-            Symbol.debug_print("location: {}:{}".format(docname, line))
+            Symbol.debug_print(f"location: {docname}:{line}")
 
-        def onMissingQualifiedSymbol(parentSymbol: "Symbol",
-                                     identOrOp: UnionASTIdentifier, ASTOperator,
-                                     templateParams: Any, templateArgs: ASTTemplateArgs
-                                     ) -> "Symbol":
+        def onMissingQualifiedSymbol(parentSymbol: Symbol,
+                                     identOrOp: ASTIdentifier | ASTOperator,
+                                     templateParams: Any, templateArgs: ASTTemplateArgs,
+                                     ) -> Symbol | None:
             if Symbol.debug_lookup:
                 Symbol.debug_indent += 1
                 Symbol.debug_print("_add_symbols, onMissingQualifiedSymbol:")
@@ -4534,7 +4681,7 @@
                 Symbol.debug_print("identOrOp:     ", lookupResult.identOrOp)
                 Symbol.debug_print("templateArgs:  ", lookupResult.templateArgs)
                 Symbol.debug_print("declaration:   ", declaration)
-                Symbol.debug_print("location:      {}:{}".format(docname, line))
+                Symbol.debug_print(f"location:      {docname}:{line}")
                 Symbol.debug_indent -= 1
             symbol = Symbol(parent=lookupResult.parentSymbol,
                             identOrOp=lookupResult.identOrOp,
@@ -4582,7 +4729,7 @@
         # First check if one of those with a declaration matches.
         # If it's a function, we need to compare IDs,
         # otherwise there should be only one symbol with a declaration.
-        def makeCandSymbol() -> "Symbol":
+        def makeCandSymbol() -> Symbol:
             if Symbol.debug_lookup:
                 Symbol.debug_print("begin: creating candidate symbol")
             symbol = Symbol(parent=lookupResult.parentSymbol,
@@ -4599,7 +4746,7 @@
         else:
             candSymbol = makeCandSymbol()
 
-            def handleDuplicateDeclaration(symbol: "Symbol", candSymbol: "Symbol") -> None:
+            def handleDuplicateDeclaration(symbol: Symbol, candSymbol: Symbol) -> None:
                 if Symbol.debug_lookup:
                     Symbol.debug_indent += 1
                     Symbol.debug_print("redeclaration")
@@ -4649,7 +4796,10 @@
                 return makeCandSymbol()
         else:
             if Symbol.debug_lookup:
-                Symbol.debug_print("no match, but fill an empty declaration, candSybmol is not None?:", candSymbol is not None)  # NOQA
+                Symbol.debug_print(
+                    "no match, but fill an empty declaration, candSybmol is not None?:",
+                    candSymbol is not None,
+                )
                 Symbol.debug_indent -= 2
             if candSymbol is not None:
                 candSymbol.remove()
@@ -4665,8 +4815,8 @@
             symbol._fill_empty(declaration, docname, line)
             return symbol
 
-    def merge_with(self, other: "Symbol", docnames: Liststr,
-                   env: "BuildEnvironment") -> None:
+    def merge_with(self, other: Symbol, docnames: liststr,
+                   env: BuildEnvironment) -> None:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("merge_with:")
@@ -4724,7 +4874,7 @@
                     if symbol.declaration is None:
                         if Symbol.debug_lookup:
                             Symbol.debug_print("empty candidate")
-                        # if in the end we have non matching, but have an empty one,
+                        # if in the end we have non-matching, but have an empty one,
                         # then just continue with that
                         ourChild = symbol
                         continue
@@ -4751,20 +4901,29 @@
                                  ourChild.declaration.directiveType, name)
                     logger.warning(msg, location=(otherChild.docname, otherChild.line))
                 else:
-                    # Both have declarations, and in the same docname.
-                    # This can apparently happen, it should be safe to
-                    # just ignore it, right?
-                    # Hmm, only on duplicate declarations, right?
-                    msg = "Internal C++ domain error during symbol merging.\n"
-                    msg += "ourChild:\n" + ourChild.to_string(1)
-                    msg += "\notherChild:\n" + otherChild.to_string(1)
-                    logger.warning(msg, location=otherChild.docname)
+                    if (otherChild.declaration.objectType ==
+                            ourChild.declaration.objectType and
+                            otherChild.declaration.objectType in
+                            ('templateParam', 'functionParam') and
+                            ourChild.parent.declaration == otherChild.parent.declaration):
+                        # `ourChild` was just created during merging by the call
+                        # to `_fill_empty` on the parent and can be ignored.
+                        pass
+                    else:
+                        # Both have declarations, and in the same docname.
+                        # This can apparently happen, it should be safe to
+                        # just ignore it, right?
+                        # Hmm, only on duplicate declarations, right?
+                        msg = "Internal C++ domain error during symbol merging.\n"
+                        msg += "ourChild:\n" + ourChild.to_string(1)
+                        msg += "\notherChild:\n" + otherChild.to_string(1)
+                        logger.warning(msg, location=otherChild.docname)
             ourChild.merge_with(otherChild, docnames, env)
         if Symbol.debug_lookup:
             Symbol.debug_indent -= 2
 
     def add_name(self, nestedName: ASTNestedName,
-                 templatePrefix: ASTTemplateDeclarationPrefix = None) -> "Symbol":
+                 templatePrefix: ASTTemplateDeclarationPrefix = None) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("add_name:")
@@ -4779,7 +4938,7 @@
         return res
 
     def add_declaration(self, declaration: ASTDeclaration,
-                        docname: str, line: int) -> "Symbol":
+                        docname: str, line: int) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("add_declaration:")
@@ -4796,9 +4955,9 @@
             Symbol.debug_indent -= 1
         return res
 
-    def find_identifier(self, identOrOp: UnionASTIdentifier, ASTOperator,
-                        matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool
-                        ) -> "Symbol":
+    def find_identifier(self, identOrOp: ASTIdentifier | ASTOperator,
+                        matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool,
+                        ) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("find_identifier:")
@@ -4827,7 +4986,7 @@
             current = current.siblingAbove
         return None
 
-    def direct_lookup(self, key: "LookupKey") -> "Symbol":
+    def direct_lookup(self, key: LookupKey) -> Symbol:
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
             Symbol.debug_print("direct_lookup:")
@@ -4868,9 +5027,9 @@
             Symbol.debug_indent -= 2
         return s
 
-    def find_name(self, nestedName: ASTNestedName, templateDecls: ListAny,
+    def find_name(self, nestedName: ASTNestedName, templateDecls: listAny,
                   typ: str, templateShorthand: bool, matchSelf: bool,
-                  recurseInAnon: bool, searchInSiblings: bool) -> TupleList"Symbol", str:
+                  recurseInAnon: bool, searchInSiblings: bool) -> tuplelistSymbol, str:
         # templateShorthand: missing template parameter lists for templates is ok
         # If the first component is None,
         # then the second component _may_ be a string explaining why.
@@ -4891,10 +5050,10 @@
         class QualifiedSymbolIsTemplateParam(Exception):
             pass
 
-        def onMissingQualifiedSymbol(parentSymbol: "Symbol",
-                                     identOrOp: UnionASTIdentifier, ASTOperator,
+        def onMissingQualifiedSymbol(parentSymbol: Symbol,
+                                     identOrOp: ASTIdentifier | ASTOperator,
                                      templateParams: Any,
-                                     templateArgs: ASTTemplateArgs) -> "Symbol":
+                                     templateArgs: ASTTemplateArgs) -> Symbol | None:
             # TODO: Maybe search without template args?
             #       Though, the correctPrimaryTemplateArgs does
             #       that for primary templates.
@@ -4946,7 +5105,7 @@
             return None, None
 
     def find_declaration(self, declaration: ASTDeclaration, typ: str, templateShorthand: bool,
-                         matchSelf: bool, recurseInAnon: bool) -> "Symbol":
+                         matchSelf: bool, recurseInAnon: bool) -> Symbol:
         # templateShorthand: missing template parameter lists for templates is ok
         if Symbol.debug_lookup:
             Symbol.debug_indent += 1
@@ -4957,10 +5116,10 @@
         else:
             templateDecls = 
 
-        def onMissingQualifiedSymbol(parentSymbol: "Symbol",
-                                     identOrOp: UnionASTIdentifier, ASTOperator,
+        def onMissingQualifiedSymbol(parentSymbol: Symbol,
+                                     identOrOp: ASTIdentifier | ASTOperator,
                                      templateParams: Any,
-                                     templateArgs: ASTTemplateArgs) -> "Symbol":
+                                     templateArgs: ASTTemplateArgs) -> Symbol | None:
             return None
 
         lookupResult = self._symbol_lookup(nestedName, templateDecls,
@@ -5018,6 +5177,7 @@
                 res.append(": ")
                 if self.isRedeclaration:
                     res.append('!!duplicate!! ')
+                res.append("{" + self.declaration.objectType + "} ")
                 res.append(str(self.declaration))
         if self.docname:
             res.append('\t(')
@@ -5167,7 +5327,7 @@
             except DefinitionError as eExpr:
                 raise self._make_multi_error(
                     (eFold, "If fold expression"),
-                    (eExpr, "If parenthesized expression")
+                    (eExpr, "If parenthesized expression"),
                 , "Error in fold expression or parenthesized expression.") from eExpr
             return ASTParenExpr(res)
         # now it definitely is a fold expression
@@ -5207,9 +5367,8 @@
             return ASTIdExpression(nn)
         return None
 
-    def _parse_initializer_list(self, name: str, open: str, close: str
-                                ) -> TupleListUnionASTExpression,
-                                                      ASTBracedInitList,
+    def _parse_initializer_list(self, name: str, open: str, close: str,
+                                ) -> tuplelistASTExpression | ASTBracedInitList,
                                            bool:
         # Parse open and close with the actual initializer-list in between
         # -> initializer-clause '...'opt
@@ -5220,7 +5379,7 @@
         if self.skip_string(close):
             return , False
 
-        exprs: ListUnionASTExpression, ASTBracedInitList = 
+        exprs: listASTExpression | ASTBracedInitList = 
         trailingComma = False
         while True:
             self.skip_ws()
@@ -5234,7 +5393,7 @@
             if self.skip_string(close):
                 break
             if not self.skip_string_and_ws(','):
-                self.fail("Error in %s, expected ',' or '%s'." % (name, close))
+                self.fail(f"Error in {name}, expected ',' or '{close}'.")
             if self.current_char == close and close == '}':
                 self.pos += 1
                 trailingComma = True
@@ -5254,7 +5413,7 @@
             return None
         return ASTParenExprList(exprs)
 
-    def _parse_initializer_clause(self) -> UnionASTExpression, ASTBracedInitList:
+    def _parse_initializer_clause(self) -> ASTExpression | ASTBracedInitList:
         bracedInitList = self._parse_braced_init_list()
         if bracedInitList is not None:
             return bracedInitList
@@ -5269,8 +5428,8 @@
         return ASTBracedInitList(exprs, trailingComma)
 
     def _parse_expression_list_or_braced_init_list(
-        self
-    ) -> UnionASTParenExprList, ASTBracedInitList:
+        self,
+    ) -> ASTParenExprList | ASTBracedInitList:
         paren = self._parse_paren_expression_list()
         if paren is not None:
             return paren
@@ -5382,7 +5541,7 @@
                     raise self._make_multi_error(errors, header) from eInner
 
         # and now parse postfixes
-        postFixes: ListASTPostfixOp = 
+        postFixes: listASTPostfixOp = 
         while True:
             self.skip_ws()
             if prefixType in ('expr', 'cast', 'typeid'):
@@ -5598,50 +5757,60 @@
             return ASTBinOpExpr(exprs, ops)
         return _parse_bin_op_expr(self, 0, inTemplate=inTemplate)
 
-    def _parse_conditional_expression_tail(self, orExprHead: Any) -> None:
+    def _parse_conditional_expression_tail(self, orExprHead: ASTExpression,
+                                           inTemplate: bool) -> ASTConditionalExpr | None:
+        # Consumes the orExprHead on success.
+
         # -> "?" expression ":" assignment-expression
-        return None
+        self.skip_ws()
+        if not self.skip_string("?"):
+            return None
+        thenExpr = self._parse_expression()
+        self.skip_ws()
+        if not self.skip_string(":"):
+            self.fail('Expected ":" after then-expression in conditional expression.')
+        elseExpr = self._parse_assignment_expression(inTemplate)
+        return ASTConditionalExpr(orExprHead, thenExpr, elseExpr)
 
     def _parse_assignment_expression(self, inTemplate: bool) -> ASTExpression:
         # -> conditional-expression
         #  | logical-or-expression assignment-operator initializer-clause
-        #  | throw-expression
-        # TODO: parse throw-expression: "throw" assignment-expression opt
-        # if not a throw expression, then:
-        # -> conditional-expression ->
+        #  | yield-expression -> "co_yield" assignment-expression
+        #                      | "co_yield" braced-init-list
+        #  | throw-expression -> "throw" assignment-expressionopt
+        # TODO: yield-expression
+        # TODO: throw-expression
+
+        # Now we have (after expanding conditional-expression:
         #     logical-or-expression
         #   | logical-or-expression "?" expression ":" assignment-expression
         #   | logical-or-expression assignment-operator initializer-clause
-        exprs: ListUnionASTExpression, ASTBracedInitList = 
-        ops = 
-        orExpr = self._parse_logical_or_expression(inTemplate=inTemplate)
-        exprs.append(orExpr)
-        # TODO: handle ternary with _parse_conditional_expression_tail
-        while True:
-            oneMore = False
-            self.skip_ws()
-            for op in _expression_assignment_ops:
-                if op0 in 'anox':
-                    if not self.skip_word(op):
-                        continue
-                else:
-                    if not self.skip_string(op):
-                        continue
-                expr = self._parse_initializer_clause()
-                exprs.append(expr)
-                ops.append(op)
-                oneMore = True
-            if not oneMore:
-                break
-        if len(ops) == 0:
-            return orExpr
-        else:
-            return ASTAssignmentExpr(exprs, ops)
+        leftExpr = self._parse_logical_or_expression(inTemplate=inTemplate)
+        # the ternary operator
+        condExpr = self._parse_conditional_expression_tail(leftExpr, inTemplate)
+        if condExpr is not None:
+            return condExpr
+        # and actual assignment
+        for op in _expression_assignment_ops:
+            if op0 in 'anox':
+                if not self.skip_word(op):
+                    continue
+            else:
+                if not self.skip_string(op):
+                    continue
+            rightExpr = self._parse_initializer_clause()
+            return ASTAssignmentExpr(leftExpr, op, rightExpr)
+        # just a logical-or-expression
+        return leftExpr
 
     def _parse_constant_expression(self, inTemplate: bool) -> ASTExpression:
-        # -> conditional-expression
+        # -> conditional-expression ->
+        #    logical-or-expression
+        #  | logical-or-expression "?" expression ":" assignment-expression
         orExpr = self._parse_logical_or_expression(inTemplate=inTemplate)
-        # TODO: use _parse_conditional_expression_tail
+        condExpr = self._parse_conditional_expression_tail(orExpr, inTemplate)
+        if condExpr is not None:
+            return condExpr
         return orExpr
 
     def _parse_expression(self) -> ASTExpression:
@@ -5658,7 +5827,7 @@
         else:
             return ASTCommaExpr(exprs)
 
-    def _parse_expression_fallback(self, end: Liststr,
+    def _parse_expression_fallback(self, end: liststr,
                                    parser: Callable, ASTExpression,
                                    allow: bool = True) -> ASTExpression:
         # Stupidly "parse" an expression.
@@ -5685,11 +5854,11 @@
         else:
             # TODO: add handling of more bracket-like things, and quote handling
             brackets = {'(': ')', '{': '}', '': '', '<': '>'}
-            symbols: Liststr = 
+            symbols: liststr = 
             while not self.eof:
                 if (len(symbols) == 0 and self.current_char in end):
                     break
-                if self.current_char in brackets.keys():
+                if self.current_char in brackets:
                     symbols.append(bracketsself.current_char)
                 elif len(symbols) > 0 and self.current_char == symbols-1:
                     symbols.pop()
@@ -5748,7 +5917,7 @@
         if self.skip_string('>'):
             return ASTTemplateArgs(, False)
         prevErrors = 
-        templateArgs: ListUnionASTType, ASTTemplateArgConstant = 
+        templateArgs: listASTType | ASTTemplateArgConstant = 
         packExpansion = False
         while 1:
             pos = self.pos
@@ -5795,13 +5964,12 @@
             if parsedEnd:
                 assert not parsedComma
                 break
-            else:
-                assert not packExpansion
+            assert not packExpansion
         return ASTTemplateArgs(templateArgs, packExpansion)
 
     def _parse_nested_name(self, memberPointer: bool = False) -> ASTNestedName:
-        names: ListASTNestedNameElement = 
-        templates: Listbool = 
+        names: listASTNestedNameElement = 
+        templates: listbool = 
 
         self.skip_ws()
         rooted = False
@@ -5814,7 +5982,7 @@
             else:
                 template = False
             templates.append(template)
-            identOrOp: UnionASTIdentifier, ASTOperator = None
+            identOrOp: ASTIdentifier | ASTOperator = None
             if self.skip_word_and_ws('operator'):
                 identOrOp = self._parse_operator()
             else:
@@ -5850,11 +6018,11 @@
     # ==========================================================================
 
     def _parse_simple_type_specifiers(self) -> ASTTrailingTypeSpecFundamental:
-        modifier: Optionalstr = None
-        signedness: Optionalstr = None
-        width: Liststr = 
-        typ: Optionalstr = None
-        names: Liststr =   # the parsed sequence
+        modifier: str | None = None
+        signedness: str | None = None
+        width: liststr = 
+        typ: str | None = None
+        names: liststr =   # the parsed sequence
 
         self.skip_ws()
         while self.match(_simple_type_specifiers_re):
@@ -5866,23 +6034,23 @@
                      'float', 'double',
                      '__float80', '_Float64x', '__float128', '_Float128'):
                 if typ is not None:
-                    self.fail("Can not have both {} and {}.".format(t, typ))
+                    self.fail(f"Can not have both {t} and {typ}.")
                 typ = t
             elif t in ('signed', 'unsigned'):
                 if signedness is not None:
-                    self.fail("Can not have both {} and {}.".format(t, signedness))
+                    self.fail(f"Can not have both {t} and {signedness}.")
                 signedness = t
             elif t == 'short':
                 if len(width) != 0:
-                    self.fail("Can not have both {} and {}.".format(t, width0))
+                    self.fail(f"Can not have both {t} and {width0}.")
                 width.append(t)
             elif t == 'long':
                 if len(width) != 0 and width0 != 'long':
-                    self.fail("Can not have both {} and {}.".format(t, width0))
+                    self.fail(f"Can not have both {t} and {width0}.")
                 width.append(t)
             elif t in ('_Imaginary', '_Complex'):
                 if modifier is not None:
-                    self.fail("Can not have both {} and {}.".format(t, modifier))
+                    self.fail(f"Can not have both {t} and {modifier}.")
                 modifier = t
             self.skip_ws()
         if len(names) == 0:
@@ -5892,43 +6060,43 @@
                    'wchar_t', 'char8_t', 'char16_t', 'char32_t',
                    '__float80', '_Float64x', '__float128', '_Float128'):
             if modifier is not None:
-                self.fail("Can not have both {} and {}.".format(typ, modifier))
+                self.fail(f"Can not have both {typ} and {modifier}.")
             if signedness is not None:
-                self.fail("Can not have both {} and {}.".format(typ, signedness))
+                self.fail(f"Can not have both {typ} and {signedness}.")
             if len(width) != 0:
-                self.fail("Can not have both {} and {}.".format(typ, ' '.join(width)))
+                self.fail(f"Can not have both {typ} and {' '.join(width)}.")
         elif typ == 'char':
             if modifier is not None:
-                self.fail("Can not have both {} and {}.".format(typ, modifier))
+                self.fail(f"Can not have both {typ} and {modifier}.")
             if len(width) != 0:
-                self.fail("Can not have both {} and {}.".format(typ, ' '.join(width)))
+                self.fail(f"Can not have both {typ} and {' '.join(width)}.")
         elif typ == 'int':
             if modifier is not None:
-                self.fail("Can not have both {} and {}.".format(typ, modifier))
+                self.fail(f"Can not have both {typ} and {modifier}.")
         elif typ in ('__int64', '__int128'):
             if modifier is not None:
-                self.fail("Can not have both {} and {}.".format(typ, modifier))
+                self.fail(f"Can not have both {typ} and {modifier}.")
             if len(width) != 0:
-                self.fail("Can not have both {} and {}.".format(typ, ' '.join(width)))
+                self.fail(f"Can not have both {typ} and {' '.join(width)}.")
         elif typ == 'float':
             if signedness is not None:
-                self.fail("Can not have both {} and {}.".format(typ, signedness))
+                self.fail(f"Can not have both {typ} and {signedness}.")
             if len(width) != 0:
-                self.fail("Can not have both {} and {}.".format(typ, ' '.join(width)))
+                self.fail(f"Can not have both {typ} and {' '.join(width)}.")
         elif typ == 'double':
             if signedness is not None:
-                self.fail("Can not have both {} and {}.".format(typ, signedness))
+                self.fail(f"Can not have both {typ} and {signedness}.")
             if len(width) > 1:
-                self.fail("Can not have both {} and {}.".format(typ, ' '.join(width)))
+                self.fail(f"Can not have both {typ} and {' '.join(width)}.")
             if len(width) == 1 and width0 != 'long':
-                self.fail("Can not have both {} and {}.".format(typ, ' '.join(width)))
+                self.fail(f"Can not have both {typ} and {' '.join(width)}.")
         elif typ is None:
             if modifier is not None:
-                self.fail("Can not have {} without a floating point type.".format(modifier))
+                self.fail(f"Can not have {modifier} without a floating point type.")
         else:
-            assert False, "Unhandled type {}".format(typ)
+            raise AssertionError(f"Unhandled type {typ}")
 
-        canonNames: Liststr = 
+        canonNames: liststr = 
         if modifier is not None:
             canonNames.append(modifier)
         if signedness is not None:
@@ -6013,12 +6181,10 @@
                 self.skip_ws()
                 if self.skip_string(','):
                     continue
-                elif self.skip_string(')'):
+                if self.skip_string(')'):
                     break
-                else:
-                    self.fail(
-                        'Expecting "," or ")" in parameters-and-qualifiers, '
-                        'got "%s".' % self.current_char)
+                self.fail('Expecting "," or ")" in parameters-and-qualifiers, '
+                          f'got "{self.current_char}".')
 
         self.skip_ws()
         const = self.skip_word_and_ws('const')
@@ -6057,12 +6223,7 @@
             override = self.skip_word_and_ws(
                 'override')  # they can be permuted
 
-        attrs = 
-        while True:
-            attr = self._parse_attribute()
-            if attr is None:
-                break
-            attrs.append(attr)
+        attrs = self._parse_attribute_list()
 
         self.skip_ws()
         initializer = None
@@ -6174,7 +6335,7 @@
             break
         return ASTDeclSpecsSimple(storage, threadLocal, inline, virtual,
                                   explicitSpec, consteval, constexpr, constinit,
-                                  volatile, const, friend, attrs)
+                                  volatile, const, friend, ASTAttributeList(attrs))
 
     def _parse_decl_specs(self, outer: str, typed: bool = True) -> ASTDeclSpecs:
         if outer:
@@ -6204,8 +6365,8 @@
         return ASTDeclSpecs(outer, leftSpecs, rightSpecs, trailing)
 
     def _parse_declarator_name_suffix(
-        self, named: Unionbool, str, paramMode: str, typed: bool
-    ) -> UnionASTDeclaratorNameParamQual, ASTDeclaratorNameBitField:
+        self, named: bool | str, paramMode: str, typed: bool,
+    ) -> ASTDeclaratorNameParamQual | ASTDeclaratorNameBitField:
         # now we should parse the name, and then suffixes
         if named == 'maybe':
             pos = self.pos
@@ -6245,8 +6406,7 @@
                     self.fail("Expected '' in end of array operator.")
                 arrayOps.append(ASTArray(value))
                 continue
-            else:
-                break
+            break
         paramQual = self._parse_parameters_and_qualifiers(paramMode)
         if paramQual is None and len(arrayOps) == 0:
             # perhaps a bit-field
@@ -6258,8 +6418,8 @@
         return ASTDeclaratorNameParamQual(declId=declId, arrayOps=arrayOps,
                                           paramQual=paramQual)
 
-    def _parse_declarator(self, named: Unionbool, str, paramMode: str,
-                          typed: bool = True
+    def _parse_declarator(self, named: bool | str, paramMode: str,
+                          typed: bool = True,
                           ) -> ASTDeclarator:
         # 'typed' here means 'parse return type stuff'
         if paramMode not in ('type', 'function', 'operatorCast', 'new'):
@@ -6271,7 +6431,7 @@
             self.skip_ws()
             volatile = False
             const = False
-            attrs = 
+            attrList = 
             while 1:
                 if not volatile:
                     volatile = self.skip_word_and_ws('volatile')
@@ -6283,19 +6443,15 @@
                         continue
                 attr = self._parse_attribute()
                 if attr is not None:
-                    attrs.append(attr)
+                    attrList.append(attr)
                     continue
                 break
             next = self._parse_declarator(named, paramMode, typed)
-            return ASTDeclaratorPtr(next=next, volatile=volatile, const=const, attrs=attrs)
+            return ASTDeclaratorPtr(next=next, volatile=volatile, const=const,
+                                    attrs=ASTAttributeList(attrList))
         # TODO: shouldn't we parse an R-value ref here first?
         if typed and self.skip_string("&"):
-            attrs = 
-            while 1:
-                attr = self._parse_attribute()
-                if attr is None:
-                    break
-                attrs.append(attr)
+            attrs = self._parse_attribute_list()
             next = self._parse_declarator(named, paramMode, typed)
             return ASTDeclaratorRef(next=next, attrs=attrs)
         if typed and self.skip_string("..."):
@@ -6377,7 +6533,7 @@
             header = "Error in declarator or parameters-and-qualifiers"
             raise self._make_multi_error(prevErrors, header) from e
 
-    def _parse_initializer(self, outer: str = None, allowFallback: bool = True
+    def _parse_initializer(self, outer: str = None, allowFallback: bool = True,
                            ) -> ASTInitializer:
         # initializer                           # global vars
         # -> brace-or-equal-initializer
@@ -6410,7 +6566,7 @@
             return ASTInitializer(bracedInit)
 
         if outer == 'member':
-            fallbackEnd: Liststr = 
+            fallbackEnd: liststr = 
         elif outer == 'templateParam':
             fallbackEnd = ',', '>'
         elif outer is None:  # function parameter
@@ -6426,7 +6582,7 @@
         value = self._parse_expression_fallback(fallbackEnd, parser, allow=allowFallback)
         return ASTInitializer(value)
 
-    def _parse_type(self, named: Unionbool, str, outer: str = None) -> ASTType:
+    def _parse_type(self, named: bool | str, outer: str = None) -> ASTType:
         """
         named=False|'maybe'|True: 'maybe' is e.g., for function objects which
         doesn't need to name the arguments
@@ -6450,14 +6606,21 @@
                 declSpecs = self._parse_decl_specs(outer=outer, typed=False)
                 decl = self._parse_declarator(named=True, paramMode=outer,
                                               typed=False)
-                self.assert_end(allowSemicolon=True)
+                mustEnd = True
+                if outer == 'function':
+                    # Allow trailing requires on functions.
+                    self.skip_ws()
+                    if re.compile(r'requires\b').match(self.definition, self.pos):
+                        mustEnd = False
+                if mustEnd:
+                    self.assert_end(allowSemicolon=True)
             except DefinitionError as exUntyped:
                 if outer == 'type':
                     desc = "If just a name"
                 elif outer == 'function':
                     desc = "If the function has no return type"
                 else:
-                    assert False
+                    raise AssertionError()
                 prevErrors.append((exUntyped, desc))
                 self.pos = startPos
                 try:
@@ -6470,7 +6633,7 @@
                     elif outer == 'function':
                         desc = "If the function has a return type"
                     else:
-                        assert False
+                        raise AssertionError()
                     prevErrors.append((exTyped, desc))
                     # Retain the else branch for easier debugging.
                     # TODO: it would be nice to save the previous stacktrace
@@ -6482,9 +6645,9 @@
                         elif outer == 'function':
                             header = "Error when parsing function declaration."
                         else:
-                            assert False
+                            raise AssertionError()
                         raise self._make_multi_error(prevErrors, header) from exTyped
-                    else:
+                    else:  # NoQA: RET506
                         # For testing purposes.
                         # do it again to get the proper traceback (how do you
                         # reliably save a traceback when an exception is
@@ -6508,8 +6671,8 @@
         return ASTType(declSpecs, decl)
 
     def _parse_type_with_init(
-            self, named: Unionbool, str,
-            outer: str) -> UnionASTTypeWithInit, ASTTemplateParamConstrainedTypeWithInit:
+            self, named: bool | str,
+            outer: str) -> ASTTypeWithInit | ASTTemplateParamConstrainedTypeWithInit:
         if outer:
             assert outer in ('type', 'member', 'function', 'templateParam')
         type = self._parse_type(outer=outer, named=named)
@@ -6567,6 +6730,7 @@
         return ASTConcept(nestedName, initializer)
 
     def _parse_class(self) -> ASTClass:
+        attrs = self._parse_attribute_list()
         name = self._parse_nested_name()
         self.skip_ws()
         final = self.skip_word_and_ws('final')
@@ -6592,26 +6756,27 @@
                 self.skip_ws()
                 if self.skip_string(','):
                     continue
-                else:
-                    break
-        return ASTClass(name, final, bases)
+                break
+        return ASTClass(name, final, bases, attrs)
 
     def _parse_union(self) -> ASTUnion:
+        attrs = self._parse_attribute_list()
         name = self._parse_nested_name()
-        return ASTUnion(name)
+        return ASTUnion(name, attrs)
 
     def _parse_enum(self) -> ASTEnum:
         scoped = None  # is set by CPPEnumObject
-        self.skip_ws()
+        attrs = self._parse_attribute_list()
         name = self._parse_nested_name()
         self.skip_ws()
         underlyingType = None
         if self.skip_string(':'):
             underlyingType = self._parse_type(named=False)
-        return ASTEnum(name, scoped, underlyingType)
+        return ASTEnum(name, scoped, underlyingType, attrs)
 
     def _parse_enumerator(self) -> ASTEnumerator:
         name = self._parse_nested_name()
+        attrs = self._parse_attribute_list()
         self.skip_ws()
         init = None
         if self.skip_string('='):
@@ -6621,14 +6786,14 @@
                 return self._parse_constant_expression(inTemplate=False)
             initVal = self._parse_expression_fallback(, parser)
             init = ASTInitializer(initVal)
-        return ASTEnumerator(name, init)
+        return ASTEnumerator(name, init, attrs)
 
     # ==========================================================================
 
     def _parse_template_parameter(self) -> ASTTemplateParam:
         self.skip_ws()
         if self.skip_word('template'):
-            # declare a tenplate template parameter
+            # declare a template template parameter
             nestedParams = self._parse_template_parameter_list()
         else:
             nestedParams = None
@@ -6675,7 +6840,9 @@
                 # non-type parameter or constrained type parameter
                 self.pos = pos
                 param = self._parse_type_with_init('maybe', 'templateParam')
-                return ASTTemplateParamNonType(param)
+                self.skip_ws()
+                parameterPack = self.skip_string('...')
+                return ASTTemplateParamNonType(param, parameterPack)
             except DefinitionError as eNonType:
                 self.pos = pos
                 header = "Error when parsing template parameter."
@@ -6689,7 +6856,7 @@
     def _parse_template_parameter_list(self) -> ASTTemplateParams:
         # only: '<' parameter-list '>'
         # we assume that 'template' has just been parsed
-        templateParams: ListASTTemplateParam = 
+        templateParams: listASTTemplateParam = 
         self.skip_ws()
         if not self.skip_string("<"):
             self.fail("Expected '<' after 'template'")
@@ -6704,7 +6871,8 @@
                 err = eParam
             self.skip_ws()
             if self.skip_string('>'):
-                return ASTTemplateParams(templateParams)
+                requiresClause = self._parse_requires_clause()
+                return ASTTemplateParams(templateParams, requiresClause)
             elif self.skip_string(','):
                 continue
             else:
@@ -6750,14 +6918,12 @@
             self.skip_ws()
             if self.skip_string('}'):
                 break
-            elif self.skip_string(','):
+            if self.skip_string(','):
                 continue
-            else:
-                self.fail("Error in template introduction list. "
-                          'Expected ",", or "}".')
+            self.fail('Error in template introduction list. Expected ",", or "}".')
         return ASTTemplateIntroduction(concept, params)
 
-    def _parse_requires_clause(self) -> OptionalASTRequiresClause:
+    def _parse_requires_clause(self) -> ASTRequiresClause | None:
         # requires-clause -> 'requires' constraint-logical-or-expression
         # constraint-logical-or-expression
         #   -> constraint-logical-and-expression
@@ -6810,13 +6976,13 @@
         else:
             return ASTRequiresClause(ASTBinOpExpr(orExprs, ops))
 
-    def _parse_template_declaration_prefix(self, objectType: str
-                                           ) -> OptionalASTTemplateDeclarationPrefix:
-        templates: ListUnionASTTemplateParams, ASTTemplateIntroduction = 
+    def _parse_template_declaration_prefix(self, objectType: str,
+                                           ) -> ASTTemplateDeclarationPrefix | None:
+        templates: listASTTemplateParams | ASTTemplateIntroduction = 
         while 1:
             self.skip_ws()
             # the saved position is only used to provide a better error message
-            params: UnionASTTemplateParams, ASTTemplateIntroduction = None
+            params: ASTTemplateParams | ASTTemplateIntroduction = None
             pos = self.pos
             if self.skip_word("template"):
                 try:
@@ -6826,6 +6992,8 @@
                         return ASTTemplateDeclarationPrefix(None)
                     else:
                         raise e
+                if objectType == 'concept' and params.requiresClause is not None:
+                    self.fail('requires-clause not allowed for concept')
             else:
                 params = self._parse_template_introduction()
                 if not params:
@@ -6843,7 +7011,7 @@
 
     def _check_template_consistency(self, nestedName: ASTNestedName,
                                     templatePrefix: ASTTemplateDeclarationPrefix,
-                                    fullSpecShorthand: bool, isMember: bool = False
+                                    fullSpecShorthand: bool, isMember: bool = False,
                                     ) -> ASTTemplateDeclarationPrefix:
         numArgs = nestedName.num_templates()
         isMemberInstantiation = False
@@ -6872,9 +7040,9 @@
                 msg += str(nestedName)
                 self.warn(msg)
 
-            newTemplates: ListUnionASTTemplateParams, ASTTemplateIntroduction = 
+            newTemplates: listASTTemplateParams | ASTTemplateIntroduction = 
             for _i in range(numExtra):
-                newTemplates.append(ASTTemplateParams())
+                newTemplates.append(ASTTemplateParams(, requiresClause=None))
             if templatePrefix and not isMemberInstantiation:
                 newTemplates.extend(templatePrefix.templates)
             templatePrefix = ASTTemplateDeclarationPrefix(newTemplates)
@@ -6890,7 +7058,6 @@
             raise Exception('Internal error, unknown directiveType "%s".' % directiveType)
         visibility = None
         templatePrefix = None
-        requiresClause = None
         trailingRequiresClause = None
         declaration: Any = None
 
@@ -6898,10 +7065,8 @@
         if self.match(_visibility_re):
             visibility = self.matched_text
 
-        if objectType in ('type', 'concept', 'member', 'function', 'class'):
+        if objectType in ('type', 'concept', 'member', 'function', 'class', 'union'):
             templatePrefix = self._parse_template_declaration_prefix(objectType)
-            if objectType == 'function' and templatePrefix is not None:
-                requiresClause = self._parse_requires_clause()
 
         if objectType == 'type':
             prevErrors = 
@@ -6927,8 +7092,7 @@
             declaration = self._parse_type_with_init(named=True, outer='member')
         elif objectType == 'function':
             declaration = self._parse_type(named=True, outer='function')
-            if templatePrefix is not None:
-                trailingRequiresClause = self._parse_requires_clause()
+            trailingRequiresClause = self._parse_requires_clause()
         elif objectType == 'class':
             declaration = self._parse_class()
         elif objectType == 'union':
@@ -6938,7 +7102,7 @@
         elif objectType == 'enumerator':
             declaration = self._parse_enumerator()
         else:
-            assert False
+            raise AssertionError()
         templatePrefix = self._check_template_consistency(declaration.name,
                                                           templatePrefix,
                                                           fullSpecShorthand=False,
@@ -6946,7 +7110,7 @@
         self.skip_ws()
         semicolon = self.skip_string(';')
         return ASTDeclaration(objectType, directiveType, visibility,
-                              templatePrefix, requiresClause, declaration,
+                              templatePrefix, declaration,
                               trailingRequiresClause, semicolon)
 
     def parse_namespace_object(self) -> ASTNamespace:
@@ -6958,7 +7122,7 @@
         res.objectType = 'namespace'  # type: ignore
         return res
 
-    def parse_xref_object(self) -> TupleUnionASTNamespace, ASTDeclaration, bool:
+    def parse_xref_object(self) -> tupleASTNamespace | ASTDeclaration, bool:
         pos = self.pos
         try:
             templatePrefix = self._parse_template_declaration_prefix(objectType="xref")
@@ -6988,7 +7152,7 @@
                 msg = "Error in cross-reference."
                 raise self._make_multi_error(errs, msg) from e2
 
-    def parse_expression(self) -> UnionASTExpression, ASTType:
+    def parse_expression(self) -> ASTExpression | ASTType:
         pos = self.pos
         try:
             expr = self._parse_expression()
@@ -7018,7 +7182,7 @@
 class CPPObject(ObjectDescriptionASTDeclaration):
     """Description of a C++ language object."""
 
-    doc_field_types: ListField = 
+    doc_field_types: listField = 
         GroupedField('template parameter', label=_('Template Parameters'),
                      names=('tparam', 'template parameter'),
                      can_collapse=True),
@@ -7026,6 +7190,7 @@
 
     option_spec: OptionSpec = {
         'noindexentry': directives.flag,
+        'nocontentsentry': directives.flag,
         'tparam-line-spec': directives.flag,
     }
 
@@ -7142,10 +7307,10 @@
         return parser.parse_declaration(self.object_type, self.objtype)
 
     def describe_signature(self, signode: desc_signature,
-                           ast: ASTDeclaration, options: Dict) -> None:
+                           ast: ASTDeclaration, options: dict) -> None:
         ast.describe_signature(signode, 'lastIsName', self.env, options)
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         env = self.state.document.settings.env  # from ObjectDescription.run
         if 'cpp:parent_symbol' not in env.temp_data:
             root = env.domaindata'cpp''root_symbol'
@@ -7166,12 +7331,10 @@
         parentSymbol = env.temp_data'cpp:parent_symbol'
         parentDecl = parentSymbol.declaration
         if parentDecl is not None and parentDecl.objectType == 'function':
-            msg = "C++ declarations inside functions are not supported." \
-                  " Parent function: {}\nDirective name: {}\nDirective arg: {}"
-            logger.warning(msg.format(
-                str(parentSymbol.get_full_nested_name()),
-                self.name, self.arguments0
-            ), location=self.get_location())
+            msg = ("C++ declarations inside functions are not supported. "
+                   f"Parent function: {parentSymbol.get_full_nested_name()}\n"
+                   f"Directive name: {self.name}\nDirective arg: {self.arguments0}")
+            logger.warning(msg, location=self.get_location())
             name = _make_phony_error_name()
             symbol = parentSymbol.add_name(name)
             env.temp_data'cpp:last_symbol' = symbol
@@ -7306,11 +7469,11 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         rootSymbol = self.env.domaindata'cpp''root_symbol'
         if self.arguments0.strip() in ('NULL', '0', 'nullptr'):
             symbol = rootSymbol
-            stack: ListSymbol = 
+            stack: listSymbol = 
         else:
             parser = DefinitionParser(self.arguments0,
                                       location=self.get_location(),
@@ -7337,7 +7500,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if self.arguments0.strip() in ('NULL', '0', 'nullptr'):
             return 
         parser = DefinitionParser(self.arguments0,
@@ -7369,7 +7532,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         stack = self.env.temp_data.get('cpp:namespace_stack', None)
         if not stack or len(stack) == 0:
             logger.warning("C++ namespace pop on empty stack. Defaulting to global scope.",
@@ -7389,7 +7552,7 @@
 
 class AliasNode(nodes.Element):
     def __init__(self, sig: str, aliasOptions: dict,
-                 env: "BuildEnvironment" = None,
+                 env: BuildEnvironment = None,
                  parentKey: LookupKey = None) -> None:
         super().__init__()
         self.sig = sig
@@ -7404,7 +7567,7 @@
             assert parentKey is not None
             self.parentKey = parentKey
 
-    def copy(self) -> 'AliasNode':
+    def copy(self) -> AliasNode:
         return self.__class__(self.sig, self.aliasOptions,
                               env=None, parentKey=self.parentKey)
 
@@ -7414,7 +7577,7 @@
 
     def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool,
                        aliasOptions: dict, renderOptions: dict,
-                       document: Any) -> ListNode:
+                       document: Any) -> listNode:
         if maxdepth == 0:
             recurse = True
         elif maxdepth == 1:
@@ -7423,7 +7586,7 @@
             maxdepth -= 1
             recurse = True
 
-        nodes: ListNode = 
+        nodes: listNode = 
         if not skipThis:
             signode = addnodes.desc_signature('', '')
             nodes.append(signode)
@@ -7431,7 +7594,7 @@
 
         if recurse:
             if skipThis:
-                childContainer: UnionListNode, addnodes.desc = nodes
+                childContainer: listNode | addnodes.desc = nodes
             else:
                 content = addnodes.desc_content()
                 desc = addnodes.desc()
@@ -7460,7 +7623,6 @@
 
     def apply(self, **kwargs: Any) -> None:
         for node in self.document.findall(AliasNode):
-            node = cast(AliasNode, node)
             sig = node.sig
             parentKey = node.parentKey
             try:
@@ -7488,7 +7650,7 @@
                 print(rootSymbol.dump(1))
             assert parentSymbol  # should be there
 
-            symbols: ListSymbol = 
+            symbols: listSymbol = 
             if isShorthand:
                 assert isinstance(ast, ASTNamespace)
                 ns = ast
@@ -7550,7 +7712,7 @@
         'noroot': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         """
         On purpose this doesn't call the ObjectDescription version, but is based on it.
         Each alias signature may expand into multiple real signatures (an overload set).
@@ -7567,7 +7729,7 @@
         # 'desctype' is a backwards compatible attribute
         node'objtype' = node'desctype' = self.objtype
 
-        self.names: Liststr = 
+        self.names: liststr = 
         aliasOptions = {
             'maxdepth': self.options.get('maxdepth', 1),
             'noroot': 'noroot' in self.options,
@@ -7593,7 +7755,7 @@
 
 class CPPXRefRole(XRefRole):
     def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool,
-                     title: str, target: str) -> Tuplestr, str:
+                     title: str, target: str) -> tuplestr, str:
         refnode.attributes.update(env.ref_context)
 
         if not has_explicit_title:
@@ -7631,7 +7793,7 @@
             # render the expression as inline text
             self.class_type = 'cpp-texpr'
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         text = self.text.replace('\n', ' ')
         parser = DefinitionParser(text,
                                   location=self.get_location(),
@@ -7678,9 +7840,9 @@
         'enum':       ObjType(_('enum'),       'enum',              'identifier', 'type'),
         'enumerator': ObjType(_('enumerator'), 'enumerator',        'identifier'),
         # generated object types
-        'functionParam': ObjType(_('function parameter'),           'identifier', 'member', 'var'),  # noqa
+        'functionParam': ObjType(_('function parameter'),           'identifier', 'member', 'var'),  # noqa: E501
         'templateParam': ObjType(_('template parameter'),
-                                 'identifier', 'class', 'struct', 'union', 'member', 'var', 'type'),  # noqa
+                                 'identifier', 'class', 'struct', 'union', 'member', 'var', 'type'),  # noqa: E501
     }
 
     directives = {
@@ -7702,7 +7864,7 @@
         'namespace-push': CPPNamespacePushObject,
         'namespace-pop': CPPNamespacePopObject,
         # other
-        'alias': CPPAliasObject
+        'alias': CPPAliasObject,
     }
     roles = {
         'any': CPPXRefRole(),
@@ -7717,11 +7879,11 @@
         'enum': CPPXRefRole(),
         'enumerator': CPPXRefRole(),
         'expr': CPPExprRole(asCode=True),
-        'texpr': CPPExprRole(asCode=False)
+        'texpr': CPPExprRole(asCode=False),
     }
     initial_data = {
         'root_symbol': Symbol(None, None, None, None, None, None, None),
-        'names': {}  # full name for indexing -> docname
+        'names': {},  # full name for indexing -> docname
     }
 
     def clear_doc(self, docname: str) -> None:
@@ -7753,7 +7915,7 @@
     def process_field_xref(self, pnode: pending_xref) -> None:
         pnode.attributes.update(self.env.ref_context)
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dict) -> None:
         if Symbol.debug_show_tree:
             print("merge_domaindata:")
             print("\tself:")
@@ -7779,7 +7941,7 @@
 
     def _resolve_xref_inner(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
                             typ: str, target: str, node: pending_xref,
-                            contnode: Element) -> TupleOptionalElement, Optionalstr:
+                            contnode: Element) -> tupleElement | None, str | None:
         # add parens again for those that could be functions
         if typ in ('any', 'func'):
             target += '()'
@@ -7788,7 +7950,7 @@
             ast, isShorthand = parser.parse_xref_object()
         except DefinitionError as e:
             # as arg to stop flake8 from complaining
-            def findWarning(e: Exception) -> Tuplestr, Exception:
+            def findWarning(e: Exception) -> tuplestr, Exception:
                 if typ != 'any' and typ != 'func':
                     return target, e
                 # hax on top of the paren hax to try to get correct errors
@@ -7865,8 +8027,8 @@
             objtypes = self.objtypes_for_role(typ)
             if objtypes:
                 return declTyp in objtypes
-            print("Type is %s, declaration type is %s" % (typ, declTyp))
-            assert False
+            print(f"Type is {typ}, declaration type is {declTyp}")
+            raise AssertionError()
         if not checkType():
             logger.warning("cpp:%s targets a %s (%s).",
                            typ, s.declaration.objectType,
@@ -7922,19 +8084,19 @@
             # and reconstruct the title again
             contnode += nodes.Text(title)
         res = make_refnode(builder, fromdocname, docname,
-                           declaration.get_newest_id(), contnode, displayName
+                           declaration.get_newest_id(), contnode, displayName,
                            ), declaration.objectType
         return res
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         return self._resolve_xref_inner(env, fromdocname, builder, typ,
                                         target, node, contnode)0
 
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         with logging.suppress_logging():
             retnode, objtype = self._resolve_xref_inner(env, fromdocname, builder,
                                                         'any', target, node, contnode)
@@ -7945,7 +8107,7 @@
                 return ('cpp:' + self.role_for_objtype(objtype), retnode)
         return 
 
-    def get_objects(self) -> IteratorTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iteratortuplestr, str, str, str, str, int:
         rootSymbol = self.data'root_symbol'
         for symbol in rootSymbol.get_all_symbols():
             if symbol.declaration is None:
@@ -7973,7 +8135,7 @@
         return '::'.join(str(parentName), target)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(CPPDomain)
     app.add_config_value("cpp_index_common_prefix", , 'env')
     app.add_config_value("cpp_id_attributes", , 'env')
@@ -7992,7 +8154,7 @@
 
     return {
         'version': 'builtin',
-        'env_version': 4,
+        'env_version': 8,
         'parallel_read_safe': True,
         'parallel_write_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/index.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/index.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.domains.index
-    ~~~~~~~~~~~~~~~~~~~~
+"""The index domain."""
 
-    The index domain.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Tuple
+from typing import TYPE_CHECKING, Any, Iterable
 
 from docutils import nodes
 from docutils.nodes import Node, system_message
@@ -35,13 +29,13 @@
     label = 'index'
 
     @property
-    def entries(self) -> Dictstr, ListTuplestr, str, str, str, str:
+    def entries(self) -> dictstr, listtuplestr, str, str, str, str:
         return self.data.setdefault('entries', {})
 
     def clear_doc(self, docname: str) -> None:
         self.entries.pop(docname, None)
 
-    def merge_domaindata(self, docnames: Iterablestr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: Iterablestr, otherdata: dictstr, Any) -> None:
         for docname in docnames:
             self.entriesdocname = otherdata'entries'docname
 
@@ -72,7 +66,7 @@
         'name': directives.unchanged,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         arguments = self.arguments0.split('\n')
 
         if 'name' in self.options:
@@ -93,7 +87,7 @@
 
 
 class IndexRole(ReferenceRole):
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         target_id = 'index-%s' % self.env.new_serialno('index')
         if self.has_explicit_title:
             # if an explicit target is given, process it as a full entry
@@ -110,12 +104,12 @@
 
         index = addnodes.index(entries=entries)
         target = nodes.target('', '', ids=target_id)
-        text = nodes.Text(title, title)
+        text = nodes.Text(title)
         self.set_source_info(index)
         return index, target, text, 
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(IndexDomain)
     app.add_directive('index', IndexDirective)
     app.add_role('index', IndexRole())

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/javascript.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/javascript.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.domains.javascript
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The JavaScript domain."""
 
-    The JavaScript domain.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, Iterator, List, Optional, Tuple, cast
+from typing import Any, Iterator, Tuple, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -27,7 +21,7 @@
 from sphinx.util import logging
 from sphinx.util.docfields import Field, GroupedField, TypedField
 from sphinx.util.docutils import SphinxDirective
-from sphinx.util.nodes import make_id, make_refnode
+from sphinx.util.nodes import make_id, make_refnode, nested_parse_with_titles
 from sphinx.util.typing import OptionSpec
 
 logger = logging.getLogger(__name__)
@@ -48,13 +42,14 @@
     option_spec: OptionSpec = {
         'noindex': directives.flag,
         'noindexentry': directives.flag,
+        'nocontentsentry': directives.flag,
     }
 
-    def get_display_prefix(self) -> ListNode:
+    def get_display_prefix(self) -> listNode:
         #: what is displayed right before the documentation entry
         return 
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         """Breaks down construct signatures
 
         Parses out prefix and argument list from construct definition. The
@@ -116,19 +111,23 @@
                 _pseudo_parse_arglist(signode, arglist)
         return fullname, prefix
 
-    def add_target_and_index(self, name_obj: Tuplestr, str, sig: str,
+    def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuplestr, ...:
+        if 'fullname' not in sig_node:
+            return ()
+        modname = sig_node.get('module')
+        fullname = sig_node'fullname'
+
+        if modname:
+            return (modname, *fullname.split('.'))
+        else:
+            return tuple(fullname.split('.'))
+
+    def add_target_and_index(self, name_obj: tuplestr, str, sig: str,
                              signode: desc_signature) -> None:
         mod_name = self.env.ref_context.get('js:module')
         fullname = (mod_name + '.' if mod_name else '') + name_obj0
         node_id = make_id(self.env, self.state.document, '', fullname)
         signode'ids'.append(node_id)
-
-        # Assign old styled node_id not to break old hyperlinks (if possible)
-        # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-        old_node_id = self.make_old_id(fullname)
-        if old_node_id not in self.state.document.ids and old_node_id not in signode'ids':
-            signode'ids'.append(old_node_id)
-
         self.state.document.note_explicit_target(signode)
 
         domain = cast(JavaScriptDomain, self.env.get_domain('js'))
@@ -139,7 +138,7 @@
             if indextext:
                 self.indexnode'entries'.append(('single', indextext, node_id, '', None))
 
-    def get_index_text(self, objectname: str, name_obj: Tuplestr, str) -> str:
+    def get_index_text(self, objectname: str, name_obj: tuplestr, str) -> str:
         name, obj = name_obj
         if self.objtype == 'function':
             if not obj:
@@ -208,13 +207,24 @@
         self.env.ref_context'js:object' = (objects-1 if len(objects) > 0
                                              else None)
 
-    def make_old_id(self, fullname: str) -> str:
-        """Generate old styled node_id for JS objects.
+    def _toc_entry_name(self, sig_node: desc_signature) -> str:
+        if not sig_node.get('_toc_parts'):
+            return ''
 
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return fullname.replace('$', '_S_')
+        config = self.env.app.config
+        objtype = sig_node.parent.get('objtype')
+        if config.add_function_parentheses and objtype in {'function', 'method'}:
+            parens = '()'
+        else:
+            parens = ''
+        *parents, name = sig_node'_toc_parts'
+        if config.toc_object_entries_show_parents == 'domain':
+            return sig_node.get('fullname', name) + parens
+        if config.toc_object_entries_show_parents == 'hide':
+            return name + parens
+        if config.toc_object_entries_show_parents == 'all':
+            return '.'.join(parents + name + parens)
+        return ''
 
 
 class JSCallable(JSObject):
@@ -240,7 +250,7 @@
 
     allow_nesting = True
 
-    def get_display_prefix(self) -> ListNode:
+    def get_display_prefix(self) -> listNode:
         return addnodes.desc_sig_keyword('class', 'class'),
                 addnodes.desc_sig_space()
 
@@ -264,19 +274,26 @@
     :param mod_name: Module name
     """
 
-    has_content = False
+    has_content = True
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
     option_spec: OptionSpec = {
-        'noindex': directives.flag
+        'noindex': directives.flag,
+        'nocontentsentry': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         mod_name = self.arguments0.strip()
         self.env.ref_context'js:module' = mod_name
         noindex = 'noindex' in self.options
-        ret: ListNode = 
+
+        content_node: Element = nodes.section()
+        # necessary so that the child nodes get the right source/line set
+        content_node.document = self.state.document
+        nested_parse_with_titles(self.state, self.content, content_node, self.content_offset)
+
+        ret: listNode = 
         if not noindex:
             domain = cast(JavaScriptDomain, self.env.get_domain('js'))
 
@@ -288,32 +305,18 @@
                                location=(self.env.docname, self.lineno))
 
             target = nodes.target('', '', ids=node_id, ismod=True)
-
-            # Assign old styled node_id not to break old hyperlinks (if possible)
-            # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-            old_node_id = self.make_old_id(mod_name)
-            if old_node_id not in self.state.document.ids and old_node_id not in target'ids':
-                target'ids'.append(old_node_id)
-
             self.state.document.note_explicit_target(target)
             ret.append(target)
             indextext = _('%s (module)') % mod_name
             inode = addnodes.index(entries=('single', indextext, node_id, '', None))
             ret.append(inode)
+        ret.extend(content_node.children)
         return ret
 
-    def make_old_id(self, modname: str) -> str:
-        """Generate old styled node_id for JS modules.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return 'module-' + modname
-
 
 class JSXRefRole(XRefRole):
     def process_link(self, env: BuildEnvironment, refnode: Element,
-                     has_explicit_title: bool, title: str, target: str) -> Tuplestr, str:
+                     has_explicit_title: bool, title: str, target: str) -> tuplestr, str:
         # basically what sphinx.domains.python.PyXRefRole does
         refnode'js:object' = env.ref_context.get('js:object')
         refnode'js:module' = env.ref_context.get('js:module')
@@ -360,13 +363,13 @@
         'attr':  JSXRefRole(),
         'mod':   JSXRefRole(),
     }
-    initial_data: Dictstr, Dictstr, Tuplestr, str = {
+    initial_data: dictstr, dictstr, tuplestr, str = {
         'objects': {},  # fullname -> docname, node_id, objtype
         'modules': {},  # modname  -> docname, node_id
     }
 
     @property
-    def objects(self) -> Dictstr, Tuplestr, str, str:
+    def objects(self) -> dictstr, tuplestr, str, str:
         return self.data.setdefault('objects', {})  # fullname -> docname, node_id, objtype
 
     def note_object(self, fullname: str, objtype: str, node_id: str,
@@ -378,7 +381,7 @@
         self.objectsfullname = (self.env.docname, node_id, objtype)
 
     @property
-    def modules(self) -> Dictstr, Tuplestr, str:
+    def modules(self) -> dictstr, tuplestr, str:
         return self.data.setdefault('modules', {})  # modname -> docname, node_id
 
     def note_module(self, modname: str, node_id: str) -> None:
@@ -392,7 +395,7 @@
             if pkg_docname == docname:
                 del self.modulesmodname
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, Any) -> None:
         # XXX check duplicates
         for fullname, (fn, node_id, objtype) in otherdata'objects'.items():
             if fn in docnames:
@@ -401,8 +404,15 @@
             if pkg_docname in docnames:
                 self.modulesmod_name = (pkg_docname, node_id)
 
-    def find_obj(self, env: BuildEnvironment, mod_name: str, prefix: str, name: str,
-                 typ: str, searchorder: int = 0) -> Tuplestr, Tuplestr, str, str:
+    def find_obj(
+        self,
+        env: BuildEnvironment,
+        mod_name: str,
+        prefix: str,
+        name: str,
+        typ: str | None,
+        searchorder: int = 0,
+    ) -> tuplestr | None, tuplestr, str, str | None:
         if name-2: == '()':
             name = name:-2
 
@@ -426,8 +436,8 @@
         return newname, self.objects.get(newname)
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         mod_name = node.get('js:module')
         prefix = node.get('js:object')
         searchorder = 1 if node.hasattr('refspecific') else 0
@@ -437,8 +447,8 @@
         return make_refnode(builder, fromdocname, obj0, obj1, contnode, name)
 
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         mod_name = node.get('js:module')
         prefix = node.get('js:object')
         name, obj = self.find_obj(env, mod_name, prefix, target, None, 1)
@@ -447,11 +457,11 @@
         return ('js:' + self.role_for_objtype(obj2),
                  make_refnode(builder, fromdocname, obj0, obj1, contnode, name))
 
-    def get_objects(self) -> IteratorTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iteratortuplestr, str, str, str, str, int:
         for refname, (docname, node_id, typ) in list(self.objects.items()):
             yield refname, refname, typ, docname, node_id, 1
 
-    def get_full_qualified_name(self, node: Element) -> str:
+    def get_full_qualified_name(self, node: Element) -> str | None:
         modname = node.get('js:module')
         prefix = node.get('js:object')
         target = node.get('reftarget')
@@ -461,7 +471,7 @@
             return '.'.join(filter(None, modname, prefix, target))
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(JavaScriptDomain)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/math.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/math.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.domains.math
-    ~~~~~~~~~~~~~~~~~~~
+"""The math domain."""
 
-    The math domain.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple
+from typing import TYPE_CHECKING, Any, Iterable
 
 from docutils import nodes
 from docutils.nodes import Element, Node, make_id, system_message
@@ -31,7 +25,7 @@
 
 class MathReferenceRole(XRefRole):
     def result_nodes(self, document: nodes.document, env: BuildEnvironment, node: Element,
-                     is_ref: bool) -> TupleListNode, Listsystem_message:
+                     is_ref: bool) -> tuplelistNode, listsystem_message:
         node'refdomain' = 'math'
         return node, 
 
@@ -41,7 +35,7 @@
     name = 'math'
     label = 'mathematics'
 
-    initial_data: Dict = {
+    initial_data: dictstr, Any = {
         'objects': {},  # labelid -> (docname, eqno)
         'has_equations': {},  # docname -> bool
     }
@@ -56,7 +50,7 @@
     }
 
     @property
-    def equations(self) -> Dictstr, Tuplestr, int:
+    def equations(self) -> dictstr, tuplestr, int:
         return self.data.setdefault('objects', {})  # labelid -> (docname, eqno)
 
     def note_equation(self, docname: str, labelid: str, location: Any = None) -> None:
@@ -67,7 +61,7 @@
 
         self.equationslabelid = (docname, self.env.new_serialno('eqno') + 1)
 
-    def get_equation_number_for(self, labelid: str) -> int:
+    def get_equation_number_for(self, labelid: str) -> int | None:
         if labelid in self.equations:
             return self.equationslabelid1
         else:
@@ -87,7 +81,7 @@
 
         self.data'has_equations'.pop(docname, None)
 
-    def merge_domaindata(self, docnames: Iterablestr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: Iterablestr, otherdata: dictstr, Any) -> None:
         for labelid, (doc, eqno) in otherdata'objects'.items():
             if doc in docnames:
                 self.equationslabelid = (doc, eqno)
@@ -95,12 +89,13 @@
         for docname in docnames:
             self.data'has_equations'docname = otherdata'has_equations'docname
 
-    def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: "Builder",
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+    def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         assert typ in ('eq', 'numref')
-        docname, number = self.equations.get(target, (None, None))
-        if docname:
+        result = self.equations.get(target)
+        if result:
+            docname, number = result
             # TODO: perhaps use rather a sphinx-core provided prefix here?
             node_id = make_id('equation-%s' % target)
             if env.config.math_numfig and env.config.numfig:
@@ -124,26 +119,26 @@
         else:
             return None
 
-    def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: "Builder",
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+    def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         refnode = self.resolve_xref(env, fromdocname, builder, 'eq', target, node, contnode)
         if refnode is None:
             return 
         else:
             return ('eq', refnode)
 
-    def get_objects(self) -> List:
+    def get_objects(self) -> Iterabletuplestr, str, str, str, str, int:
         return 
 
-    def has_equations(self, docname: str = None) -> bool:
+    def has_equations(self, docname: str | None = None) -> bool:
         if docname:
             return self.data'has_equations'.get(docname, False)
         else:
             return any(self.data'has_equations'.values())
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(MathDomain)
     app.add_role('eq', MathReferenceRole(warn_dangling=True))

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/python.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/python.py Changed

@@ -1,21 +1,14 @@
-"""
-    sphinx.domains.python
-    ~~~~~~~~~~~~~~~~~~~~~
+"""The Python domain."""
 
-    The Python domain.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import ast
 import builtins
 import inspect
 import re
-import sys
 import typing
-import warnings
 from inspect import Parameter
-from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Optional, Tuple, Type, cast
+from typing import Any, Iterable, Iterator, List, NamedTuple, Tuple, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -26,19 +19,21 @@
 from sphinx.addnodes import desc_signature, pending_xref, pending_xref_condition
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
 from sphinx.directives import ObjectDescription
 from sphinx.domains import Domain, Index, IndexEntry, ObjType
 from sphinx.environment import BuildEnvironment
 from sphinx.locale import _, __
-from sphinx.pycode.ast import ast
-from sphinx.pycode.ast import parse as ast_parse
 from sphinx.roles import XRefRole
 from sphinx.util import logging
 from sphinx.util.docfields import Field, GroupedField, TypedField
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.inspect import signature_from_str
-from sphinx.util.nodes import find_pending_xref_condition, make_id, make_refnode
+from sphinx.util.nodes import (
+    find_pending_xref_condition,
+    make_id,
+    make_refnode,
+    nested_parse_with_titles,
+)
 from sphinx.util.typing import OptionSpec, TextlikeNode
 
 logger = logging.getLogger(__name__)
@@ -80,8 +75,8 @@
     deprecated: bool
 
 
-def parse_reftarget(reftarget: str, suppress_prefix: bool = False
-                    ) -> Tuplestr, str, str, bool:
+def parse_reftarget(reftarget: str, suppress_prefix: bool = False,
+                    ) -> tuplestr, str, str, bool:
     """Parse a type string and return (reftype, reftarget, title, refspecific flag)"""
     refspecific = False
     if reftarget.startswith('.'):
@@ -107,8 +102,8 @@
     return reftype, reftarget, title, refspecific
 
 
-def type_to_xref(target: str, env: BuildEnvironment = None, suppress_prefix: bool = False
-                 ) -> addnodes.pending_xref:
+def type_to_xref(target: str, env: BuildEnvironment | None = None,
+                 suppress_prefix: bool = False) -> addnodes.pending_xref:
     """Convert a type string to a cross reference node."""
     if env:
         kwargs = {'py:module': env.ref_context.get('py:module'),
@@ -123,7 +118,7 @@
         # nested classes.  But python domain can't access the real python object because this
         # module should work not-dynamically.
         shortname = title.split('.')-1
-        contnodes: ListNode = pending_xref_condition('', shortname, condition='resolved'),
+        contnodes: listNode = pending_xref_condition('', shortname, condition='resolved'),
                                  pending_xref_condition('', title, condition='*')
     else:
         contnodes = nodes.Text(title)
@@ -133,40 +128,42 @@
                         refspecific=refspecific, **kwargs)
 
 
-def _parse_annotation(annotation: str, env: BuildEnvironment = None) -> ListNode:
+def _parse_annotation(annotation: str, env: BuildEnvironment | None) -> listNode:
     """Parse type annotation."""
-    def unparse(node: ast.AST) -> ListNode:
+    short_literals = env.config.python_display_short_literal_types
+
+    def unparse(node: ast.AST) -> listNode:
         if isinstance(node, ast.Attribute):
-            return nodes.Text("%s.%s" % (unparse(node.value)0, node.attr))
-        elif isinstance(node, ast.BinOp):
-            result: ListNode = unparse(node.left)
+            return nodes.Text(f"{unparse(node.value)0}.{node.attr}")
+        if isinstance(node, ast.BinOp):
+            result: listNode = unparse(node.left)
             result.extend(unparse(node.op))
             result.extend(unparse(node.right))
             return result
-        elif isinstance(node, ast.BitOr):
+        if isinstance(node, ast.BitOr):
             return addnodes.desc_sig_space(),
                     addnodes.desc_sig_punctuation('', '|'),
                     addnodes.desc_sig_space()
-        elif isinstance(node, ast.Constant):  # type: ignore
+        if isinstance(node, ast.Constant):
             if node.value is Ellipsis:
                 return addnodes.desc_sig_punctuation('', "...")
-            elif isinstance(node.value, bool):
+            if isinstance(node.value, bool):
                 return addnodes.desc_sig_keyword('', repr(node.value))
-            elif isinstance(node.value, int):
+            if isinstance(node.value, int):
                 return addnodes.desc_sig_literal_number('', repr(node.value))
-            elif isinstance(node.value, str):
+            if isinstance(node.value, str):
                 return addnodes.desc_sig_literal_string('', repr(node.value))
             else:
                 # handles None, which is further handled by type_to_xref later
                 # and fallback for other types that should be converted
                 return nodes.Text(repr(node.value))
-        elif isinstance(node, ast.Expr):
+        if isinstance(node, ast.Expr):
             return unparse(node.value)
-        elif isinstance(node, ast.Index):
+        if isinstance(node, ast.Index):
             return unparse(node.value)
-        elif isinstance(node, ast.Invert):
+        if isinstance(node, ast.Invert):
             return addnodes.desc_sig_punctuation('', '~')
-        elif isinstance(node, ast.List):
+        if isinstance(node, ast.List):
             result = addnodes.desc_sig_punctuation('', '')
             if node.elts:
                 # check if there are elements in node.elts to only pop the
@@ -180,11 +177,15 @@
                 result.pop()
             result.append(addnodes.desc_sig_punctuation('', ''))
             return result
-        elif isinstance(node, ast.Module):
+        if isinstance(node, ast.Module):
             return sum((unparse(e) for e in node.body), )
-        elif isinstance(node, ast.Name):
+        if isinstance(node, ast.Name):
             return nodes.Text(node.id)
-        elif isinstance(node, ast.Subscript):
+        if isinstance(node, ast.Subscript):
+            if getattr(node.value, 'id', '') in {'Optional', 'Union'}:
+                return _unparse_pep_604_annotation(node)
+            if short_literals and getattr(node.value, 'id', '') == 'Literal':
+                return _unparse_pep_604_annotation(node)
             result = unparse(node.value)
             result.append(addnodes.desc_sig_punctuation('', ''))
             result.extend(unparse(node.slice))
@@ -196,9 +197,9 @@
                     if isinstance(subnode, nodes.Text):
                         resulti = nodes.literal('', '', subnode)
             return result
-        elif isinstance(node, ast.UnaryOp):
+        if isinstance(node, ast.UnaryOp):
             return unparse(node.op) + unparse(node.operand)
-        elif isinstance(node, ast.Tuple):
+        if isinstance(node, ast.Tuple):
             if node.elts:
                 result = 
                 for elem in node.elts:
@@ -212,28 +213,33 @@
                           addnodes.desc_sig_punctuation('', ')')
 
             return result
+        raise SyntaxError  # unsupported syntax
+
+    def _unparse_pep_604_annotation(node: ast.Subscript) -> listNode:
+        subscript = node.slice
+        if isinstance(subscript, ast.Index):
+            # py38 only
+            subscript = subscript.value  # type: ignoreassignment
+
+        flattened: listNode = 
+        if isinstance(subscript, ast.Tuple):
+            flattened.extend(unparse(subscript.elts0))
+            for elt in subscript.elts1::
+                flattened.extend(unparse(ast.BitOr()))
+                flattened.extend(unparse(elt))
         else:
-            if sys.version_info < (3, 8):
-                if isinstance(node, ast.Bytes):
-                    return addnodes.desc_sig_literal_string('', repr(node.s))
-                elif isinstance(node, ast.Ellipsis):
-                    return addnodes.desc_sig_punctuation('', "...")
-                elif isinstance(node, ast.NameConstant):
-                    return nodes.Text(node.value)
-                elif isinstance(node, ast.Num):
-                    return addnodes.desc_sig_literal_string('', repr(node.n))
-                elif isinstance(node, ast.Str):
-                    return addnodes.desc_sig_literal_string('', repr(node.s))
-
-            raise SyntaxError  # unsupported syntax
-
-    if env is None:
-        warnings.warn("The env parameter for _parse_annotation becomes required now.",
-                      RemovedInSphinx50Warning, stacklevel=2)
+            # e.g. a Union inside an Optional
+            flattened.extend(unparse(subscript))
+
+        if getattr(node.value, 'id', '') == 'Optional':
+            flattened.extend(unparse(ast.BitOr()))
+            flattened.append(nodes.Text('None'))
+
+        return flattened
 
     try:
-        tree = ast_parse(annotation)
-        result: ListNode = 
+        tree = ast.parse(annotation, type_comments=True)
+        result: listNode = 
         for node in unparse(tree):
             if isinstance(node, nodes.literal):
                 result.append(node0)
@@ -251,7 +257,9 @@
         return type_to_xref(annotation, env)
 
 
-def _parse_arglist(arglist: str, env: BuildEnvironment = None) -> addnodes.desc_parameterlist:
+def _parse_arglist(
+    arglist: str, env: BuildEnvironment | None = None,
+) -> addnodes.desc_parameterlist:
     """Parse a list of arguments using AST parser"""
     params = addnodes.desc_parameterlist(arglist)
     sig = signature_from_str('(%s)' % arglist)
@@ -309,7 +317,7 @@
     string literal (e.g. default argument value).
     """
     paramlist = addnodes.desc_parameterlist()
-    stack: ListElement = paramlist
+    stack: listElement = paramlist
     try:
         for argument in arglist.split(','):
             argument = argument.strip()
@@ -353,10 +361,17 @@
 # This override allows our inline type specifiers to behave like :class: link
 # when it comes to handling "." and "~" prefixes.
 class PyXrefMixin:
-    def make_xref(self, rolename: str, domain: str, target: str,
-                  innernode: TypeTextlikeNode = nodes.emphasis,
-                  contnode: Node = None, env: BuildEnvironment = None,
-                  inliner: Inliner = None, location: Node = None) -> Node:
+    def make_xref(
+        self,
+        rolename: str,
+        domain: str,
+        target: str,
+        innernode: typeTextlikeNode = nodes.emphasis,
+        contnode: Node | None = None,
+        env: BuildEnvironment | None = None,
+        inliner: Inliner | None = None,
+        location: Node | None = None,
+    ) -> Node:
         # we use inliner=None to make sure we get the old behaviour with a single
         # pending_xref node
         result = super().make_xref(rolename, domain, target,  # type: ignore
@@ -386,11 +401,18 @@
 
         return result
 
-    def make_xrefs(self, rolename: str, domain: str, target: str,
-                   innernode: TypeTextlikeNode = nodes.emphasis,
-                   contnode: Node = None, env: BuildEnvironment = None,
-                   inliner: Inliner = None, location: Node = None) -> ListNode:
-        delims = r'(\s*\\,(?:\s*or\s)?\s*|\s+or\s+|\s*\|\s*|\.\.\.)'
+    def make_xrefs(
+        self,
+        rolename: str,
+        domain: str,
+        target: str,
+        innernode: typeTextlikeNode = nodes.emphasis,
+        contnode: Node | None = None,
+        env: BuildEnvironment | None = None,
+        inliner: Inliner | None = None,
+        location: Node | None = None,
+    ) -> listNode:
+        delims = r'(\s*\\,(?:\s*orf\s)?\s*|\s+orf\s+|\s*\|\s*|\.\.\.)'
         delims_re = re.compile(delims)
         sub_targets = re.split(delims, target)
 
@@ -408,7 +430,7 @@
                 results.append(self.make_xref(rolename, domain, sub_target,
                                               innernode, contnode, env, inliner, location))
 
-            if sub_target in ('Literal', 'typing.Literal'):
+            if sub_target in ('Literal', 'typing.Literal', '~typing.Literal'):
                 in_literal = True
 
         return results
@@ -436,6 +458,7 @@
     option_spec: OptionSpec = {
         'noindex': directives.flag,
         'noindexentry': directives.flag,
+        'nocontentsentry': directives.flag,
         'module': directives.unchanged,
         'canonical': directives.unchanged,
         'annotation': directives.unchanged,
@@ -462,7 +485,7 @@
 
     allow_nesting = False
 
-    def get_signature_prefix(self, sig: str) -> Listnodes.Node:
+    def get_signature_prefix(self, sig: str) -> listnodes.Node:
         """May return a prefix to put before the object name in the
         signature.
         """
@@ -474,7 +497,7 @@
         """
         return False
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         """Transform a Python signature into RST nodes.
 
         Return (fully qualified name of the thing, classname if any).
@@ -521,16 +544,11 @@
         sig_prefix = self.get_signature_prefix(sig)
         if sig_prefix:
             if type(sig_prefix) is str:
-                warnings.warn(
+                raise TypeError(
                     "Python directive method get_signature_prefix()"
-                    " returning a string is deprecated."
-                    " It must now return a list of nodes."
-                    " Return value was '{}'.".format(sig_prefix),
-                    RemovedInSphinx60Warning)
-                signode += addnodes.desc_annotation(sig_prefix, '',  # type: ignore
-                                                    nodes.Text(sig_prefix))  # type: ignore
-            else:
-                signode += addnodes.desc_annotation(str(sig_prefix), '', *sig_prefix)
+                    " must return a list of nodes."
+                    f" Return value was '{sig_prefix}'.")
+            signode += addnodes.desc_annotation(str(sig_prefix), '', *sig_prefix)
 
         if prefix:
             signode += addnodes.desc_addname(prefix, prefix)
@@ -567,22 +585,27 @@
 
         return fullname, prefix
 
-    def get_index_text(self, modname: str, name: Tuplestr, str) -> str:
+    def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuplestr, ...:
+        if 'fullname' not in sig_node:
+            return ()
+        modname = sig_node.get('module')
+        fullname = sig_node'fullname'
+
+        if modname:
+            return (modname, *fullname.split('.'))
+        else:
+            return tuple(fullname.split('.'))
+
+    def get_index_text(self, modname: str, name: tuplestr, str) -> str:
         """Return the text for the index entry of the object."""
         raise NotImplementedError('must be implemented in subclasses')
 
-    def add_target_and_index(self, name_cls: Tuplestr, str, sig: str,
+    def add_target_and_index(self, name_cls: tuplestr, str, sig: str,
                              signode: desc_signature) -> None:
         modname = self.options.get('module', self.env.ref_context.get('py:module'))
         fullname = (modname + '.' if modname else '') + name_cls0
         node_id = make_id(self.env, self.state.document, '', fullname)
         signode'ids'.append(node_id)
-
-        # Assign old styled node_id(fullname) not to break old hyperlinks (if possible)
-        # Note: Will removed in Sphinx-5.0  (RemovedInSphinx50Warning)
-        if node_id != fullname and fullname not in self.state.document.ids:
-            signode'ids'.append(fullname)
-
         self.state.document.note_explicit_target(signode)
 
         domain = cast(PythonDomain, self.env.get_domain('py'))
@@ -656,6 +679,25 @@
             else:
                 self.env.ref_context.pop('py:module')
 
+    def _toc_entry_name(self, sig_node: desc_signature) -> str:
+        if not sig_node.get('_toc_parts'):
+            return ''
+
+        config = self.env.app.config
+        objtype = sig_node.parent.get('objtype')
+        if config.add_function_parentheses and objtype in {'function', 'method'}:
+            parens = '()'
+        else:
+            parens = ''
+        *parents, name = sig_node'_toc_parts'
+        if config.toc_object_entries_show_parents == 'domain':
+            return sig_node.get('fullname', name) + parens
+        if config.toc_object_entries_show_parents == 'hide':
+            return name + parens
+        if config.toc_object_entries_show_parents == 'all':
+            return '.'.join(parents + name + parens)
+        return ''
+
 
 class PyFunction(PyObject):
     """Description of a function."""
@@ -665,7 +707,7 @@
         'async': directives.flag,
     })
 
-    def get_signature_prefix(self, sig: str) -> Listnodes.Node:
+    def get_signature_prefix(self, sig: str) -> listnodes.Node:
         if 'async' in self.options:
             return addnodes.desc_sig_keyword('', 'async'),
                     addnodes.desc_sig_space()
@@ -675,7 +717,7 @@
     def needs_arglist(self) -> bool:
         return True
 
-    def add_target_and_index(self, name_cls: Tuplestr, str, sig: str,
+    def add_target_and_index(self, name_cls: tuplestr, str, sig: str,
                              signode: desc_signature) -> None:
         super().add_target_and_index(name_cls, sig, signode)
         if 'noindexentry' not in self.options:
@@ -687,10 +729,10 @@
                 text = _('%s() (in module %s)') % (name, modname)
                 self.indexnode'entries'.append(('single', text, node_id, '', None))
             else:
-                text = '%s; %s()' % (pairindextypes'builtin', name)
+                text = f'{pairindextypes"builtin"}; {name}()'
                 self.indexnode'entries'.append(('pair', text, node_id, '', None))
 
-    def get_index_text(self, modname: str, name_cls: Tuplestr, str) -> str:
+    def get_index_text(self, modname: str, name_cls: tuplestr, str) -> str | None:
         # add index in own add_target_and_index() instead.
         return None
 
@@ -698,12 +740,12 @@
 class PyDecoratorFunction(PyFunction):
     """Description of a decorator."""
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         # a decorator function is a function after all
         self.name = 'py:function'
         return super().run()
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         ret = super().handle_signature(sig, signode)
         signode.insert(0, addnodes.desc_addname('@', '@'))
         return ret
@@ -721,7 +763,7 @@
         'value': directives.unchanged,
     })
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         fullname, prefix = super().handle_signature(sig, signode)
 
         typ = self.options.get('type')
@@ -741,7 +783,7 @@
 
         return fullname, prefix
 
-    def get_index_text(self, modname: str, name_cls: Tuplestr, str) -> str:
+    def get_index_text(self, modname: str, name_cls: tuplestr, str) -> str:
         name, cls = name_cls
         if modname:
             return _('%s (in module %s)') % (name, modname)
@@ -761,14 +803,14 @@
 
     allow_nesting = True
 
-    def get_signature_prefix(self, sig: str) -> Listnodes.Node:
+    def get_signature_prefix(self, sig: str) -> listnodes.Node:
         if 'final' in self.options:
             return nodes.Text('final'), addnodes.desc_sig_space(),
                     nodes.Text(self.objtype), addnodes.desc_sig_space()
         else:
             return nodes.Text(self.objtype), addnodes.desc_sig_space()
 
-    def get_index_text(self, modname: str, name_cls: Tuplestr, str) -> str:
+    def get_index_text(self, modname: str, name_cls: tuplestr, str) -> str:
         if self.objtype == 'class':
             if not modname:
                 return _('%s (built-in class)') % name_cls0
@@ -788,18 +830,14 @@
         'async': directives.flag,
         'classmethod': directives.flag,
         'final': directives.flag,
-        'property': directives.flag,
         'staticmethod': directives.flag,
     })
 
     def needs_arglist(self) -> bool:
-        if 'property' in self.options:
-            return False
-        else:
-            return True
+        return True
 
-    def get_signature_prefix(self, sig: str) -> Listnodes.Node:
-        prefix: Listnodes.Node = 
+    def get_signature_prefix(self, sig: str) -> listnodes.Node:
+        prefix: listnodes.Node = 
         if 'final' in self.options:
             prefix.append(nodes.Text('final'))
             prefix.append(addnodes.desc_sig_space())
@@ -812,15 +850,12 @@
         if 'classmethod' in self.options:
             prefix.append(nodes.Text('classmethod'))
             prefix.append(addnodes.desc_sig_space())
-        if 'property' in self.options:
-            prefix.append(nodes.Text('property'))
-            prefix.append(addnodes.desc_sig_space())
         if 'staticmethod' in self.options:
             prefix.append(nodes.Text('static'))
             prefix.append(addnodes.desc_sig_space())
         return prefix
 
-    def get_index_text(self, modname: str, name_cls: Tuplestr, str) -> str:
+    def get_index_text(self, modname: str, name_cls: tuplestr, str) -> str:
         name, cls = name_cls
         try:
             clsname, methname = name.rsplit('.', 1)
@@ -834,8 +869,6 @@
 
         if 'classmethod' in self.options:
             return _('%s() (%s class method)') % (methname, clsname)
-        elif 'property' in self.options:
-            return _('%s (%s property)') % (methname, clsname)
         elif 'staticmethod' in self.options:
             return _('%s() (%s static method)') % (methname, clsname)
         else:
@@ -847,7 +880,7 @@
 
     option_spec: OptionSpec = PyObject.option_spec.copy()
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         self.name = 'py:method'
         self.options'classmethod' = True
 
@@ -859,7 +892,7 @@
 
     option_spec: OptionSpec = PyObject.option_spec.copy()
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         self.name = 'py:method'
         self.options'staticmethod' = True
 
@@ -869,11 +902,11 @@
 class PyDecoratorMethod(PyMethod):
     """Description of a decoratormethod."""
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         self.name = 'py:method'
         return super().run()
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         ret = super().handle_signature(sig, signode)
         signode.insert(0, addnodes.desc_addname('@', '@'))
         return ret
@@ -891,7 +924,7 @@
         'value': directives.unchanged,
     })
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         fullname, prefix = super().handle_signature(sig, signode)
 
         typ = self.options.get('type')
@@ -912,7 +945,7 @@
 
         return fullname, prefix
 
-    def get_index_text(self, modname: str, name_cls: Tuplestr, str) -> str:
+    def get_index_text(self, modname: str, name_cls: tuplestr, str) -> str:
         name, cls = name_cls
         try:
             clsname, attrname = name.rsplit('.', 1)
@@ -937,7 +970,7 @@
         'type': directives.unchanged,
     })
 
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
+    def handle_signature(self, sig: str, signode: desc_signature) -> tuplestr, str:
         fullname, prefix = super().handle_signature(sig, signode)
 
         typ = self.options.get('type')
@@ -950,8 +983,8 @@
 
         return fullname, prefix
 
-    def get_signature_prefix(self, sig: str) -> Listnodes.Node:
-        prefix: Listnodes.Node = 
+    def get_signature_prefix(self, sig: str) -> listnodes.Node:
+        prefix: listnodes.Node = 
         if 'abstractmethod' in self.options:
             prefix.append(nodes.Text('abstract'))
             prefix.append(addnodes.desc_sig_space())
@@ -963,7 +996,7 @@
         prefix.append(addnodes.desc_sig_space())
         return prefix
 
-    def get_index_text(self, modname: str, name_cls: Tuplestr, str) -> str:
+    def get_index_text(self, modname: str, name_cls: tuplestr, str) -> str:
         name, cls = name_cls
         try:
             clsname, attrname = name.rsplit('.', 1)
@@ -978,35 +1011,12 @@
         return _('%s (%s property)') % (attrname, clsname)
 
 
-class PyDecoratorMixin:
-    """
-    Mixin for decorator directives.
-    """
-    def handle_signature(self, sig: str, signode: desc_signature) -> Tuplestr, str:
-        for cls in self.__class__.__mro__:
-            if cls.__name__ != 'DirectiveAdapter':
-                warnings.warn('PyDecoratorMixin is deprecated. '
-                              'Please check the implementation of %s' % cls,
-                              RemovedInSphinx50Warning, stacklevel=2)
-                break
-        else:
-            warnings.warn('PyDecoratorMixin is deprecated',
-                          RemovedInSphinx50Warning, stacklevel=2)
-
-        ret = super().handle_signature(sig, signode)  # type: ignore
-        signode.insert(0, addnodes.desc_addname('@', '@'))
-        return ret
-
-    def needs_arglist(self) -> bool:
-        return False
-
-
 class PyModule(SphinxDirective):
     """
     Directive to mark description of a new module.
     """
 
-    has_content = False
+    has_content = True
     required_arguments = 1
     optional_arguments = 0
     final_argument_whitespace = False
@@ -1014,28 +1024,28 @@
         'platform': lambda x: x,
         'synopsis': lambda x: x,
         'noindex': directives.flag,
+        'nocontentsentry': directives.flag,
         'deprecated': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         domain = cast(PythonDomain, self.env.get_domain('py'))
 
         modname = self.arguments0.strip()
         noindex = 'noindex' in self.options
         self.env.ref_context'py:module' = modname
-        ret: ListNode = 
+
+        content_node: Element = nodes.section()
+        # necessary so that the child nodes get the right source/line set
+        content_node.document = self.state.document
+        nested_parse_with_titles(self.state, self.content, content_node, self.content_offset)
+
+        ret: listNode = 
         if not noindex:
             # note module to the domain
             node_id = make_id(self.env, self.state.document, 'module', modname)
             target = nodes.target('', '', ids=node_id, ismod=True)
             self.set_source_info(target)
-
-            # Assign old styled node_id not to break old hyperlinks (if possible)
-            # Note: Will removed in Sphinx-5.0  (RemovedInSphinx50Warning)
-            old_node_id = self.make_old_id(modname)
-            if node_id != old_node_id and old_node_id not in self.state.document.ids:
-                target'ids'.append(old_node_id)
-
             self.state.document.note_explicit_target(target)
 
             domain.note_module(modname,
@@ -1048,21 +1058,12 @@
             # the platform and synopsis aren't printed; in fact, they are only
             # used in the modindex currently
             ret.append(target)
-            indextext = '%s; %s' % (pairindextypes'module', modname)
+            indextext = f'{pairindextypes"module"}; {modname}'
             inode = addnodes.index(entries=('pair', indextext, node_id, '', None))
             ret.append(inode)
+        ret.extend(content_node.children)
         return ret
 
-    def make_old_id(self, name: str) -> str:
-        """Generate old styled node_id.
-
-        Old styled node_id is incompatible with docutils' node_id.
-        It can contain dots and hyphens.
-
-        .. note:: Old styled node_id was mainly used until Sphinx-3.0.
-        """
-        return 'module-%s' % name
-
 
 class PyCurrentModule(SphinxDirective):
     """
@@ -1076,7 +1077,7 @@
     final_argument_whitespace = False
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         modname = self.arguments0.strip()
         if modname == 'None':
             self.env.ref_context.pop('py:module', None)
@@ -1087,7 +1088,7 @@
 
 class PyXRefRole(XRefRole):
     def process_link(self, env: BuildEnvironment, refnode: Element,
-                     has_explicit_title: bool, title: str, target: str) -> Tuplestr, str:
+                     has_explicit_title: bool, title: str, target: str) -> tuplestr, str:
         refnode'py:module' = env.ref_context.get('py:module')
         refnode'py:class' = env.ref_context.get('py:class')
         if not has_explicit_title:
@@ -1116,11 +1117,11 @@
     for node in content:
         if isinstance(node, nodes.field_list):
             fields = cast(Listnodes.field, node)
-            for field in fields:
+            # removing list items while iterating the list needs reversed()
+            for field in reversed(fields):
                 field_name = cast(nodes.field_body, field0).astext().strip()
                 if field_name == 'meta' or field_name.startswith('meta '):
                     node.remove(field)
-                    break
 
 
 class PythonModuleIndex(Index):
@@ -1132,11 +1133,11 @@
     localname = _('Python Module Index')
     shortname = _('modules')
 
-    def generate(self, docnames: Iterablestr = None
-                 ) -> TupleListTuplestr, ListIndexEntry, bool:
-        content: Dictstr, ListIndexEntry = {}
+    def generate(self, docnames: Iterablestr | None = None,
+                 ) -> tuplelisttuplestr, listIndexEntry, bool:
+        content: dictstr, listIndexEntry = {}
         # list of prefixes to ignore
-        ignores: Liststr = self.domain.env.config'modindex_common_prefix'
+        ignores: liststr = self.domain.env.config'modindex_common_prefix'
         ignores = sorted(ignores, key=len, reverse=True)
         # list of all modules, sorted by module name
         modules = sorted(self.domain.data'modules'.items(),
@@ -1199,7 +1200,7 @@
     """Python language domain."""
     name = 'py'
     label = 'Python'
-    object_types: Dictstr, ObjType = {
+    object_types: dictstr, ObjType = {
         'function':     ObjType(_('function'),      'func', 'obj'),
         'data':         ObjType(_('data'),          'data', 'obj'),
         'class':        ObjType(_('class'),         'class', 'exc', 'obj'),
@@ -1238,7 +1239,7 @@
         'mod':   PyXRefRole(),
         'obj':   PyXRefRole(),
     }
-    initial_data: Dictstr, Dictstr, TupleAny = {
+    initial_data: dictstr, dictstr, tupleAny = {
         'objects': {},  # fullname -> docname, objtype
         'modules': {},  # modname -> docname, synopsis, platform, deprecated
     }
@@ -1247,7 +1248,7 @@
     
 
     @property
-    def objects(self) -> Dictstr, ObjectEntry:
+    def objects(self) -> dictstr, ObjectEntry:
         return self.data.setdefault('objects', {})  # fullname -> ObjectEntry
 
     def note_object(self, name: str, objtype: str, node_id: str,
@@ -1272,7 +1273,7 @@
         self.objectsname = ObjectEntry(self.env.docname, node_id, objtype, aliased)
 
     @property
-    def modules(self) -> Dictstr, ModuleEntry:
+    def modules(self) -> dictstr, ModuleEntry:
         return self.data.setdefault('modules', {})  # modname -> ModuleEntry
 
     def note_module(self, name: str, node_id: str, synopsis: str,
@@ -1292,7 +1293,7 @@
             if mod.docname == docname:
                 del self.modulesmodname
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, Any) -> None:
         # XXX check duplicates?
         for fullname, obj in otherdata'objects'.items():
             if obj.docname in docnames:
@@ -1302,8 +1303,8 @@
                 self.modulesmodname = mod
 
     def find_obj(self, env: BuildEnvironment, modname: str, classname: str,
-                 name: str, type: str, searchmode: int = 0
-                 ) -> ListTuplestr, ObjectEntry:
+                 name: str, type: str | None, searchmode: int = 0,
+                 ) -> listtuplestr, ObjectEntry:
         """Find a Python object for "name", perhaps using the given module
         and/or classname.  Returns a list of (name, object entry) tuples.
         """
@@ -1314,7 +1315,7 @@
         if not name:
             return 
 
-        matches: ListTuplestr, ObjectEntry = 
+        matches: listtuplestr, ObjectEntry = 
 
         newname = None
         if searchmode == 1:
@@ -1358,8 +1359,8 @@
         return matches
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                     type: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+                     type: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         modname = node.get('py:module')
         clsname = node.get('py:class')
         searchmode = 1 if node.hasattr('refspecific') else 0
@@ -1367,7 +1368,7 @@
                                 type, searchmode)
 
         if not matches and type == 'attr':
-            # fallback to meth (for property; Sphinx-2.4.x)
+            # fallback to meth (for property; Sphinx 2.4.x)
             # this ensures that `:attr:` role continues to refer to the old property entry
             # that defined by ``method`` directive in old reST files.
             matches = self.find_obj(env, modname, clsname, target, 'meth', searchmode)
@@ -1405,15 +1406,22 @@
             return make_refnode(builder, fromdocname, obj0, obj1, children, name)
 
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
         modname = node.get('py:module')
         clsname = node.get('py:class')
-        results: ListTuplestr, Element = 
+        results: listtuplestr, Element = 
 
         # always search in "refspecific" mode with the :any: role
         matches = self.find_obj(env, modname, clsname, target, None, 1)
+        multiple_matches = len(matches) > 1
+
         for name, obj in matches:
+
+            if multiple_matches and obj.aliased:
+                # Skip duplicated matches
+                continue
+
             if obj2 == 'module':
                 results.append(('py:mod',
                                 self._make_module_refnode(builder, fromdocname,
@@ -1446,7 +1454,7 @@
         return make_refnode(builder, fromdocname, module.docname, module.node_id,
                             contnode, title)
 
-    def get_objects(self) -> IteratorTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iteratortuplestr, str, str, str, str, int:
         for modname, mod in self.modules.items():
             yield (modname, modname, 'module', mod.docname, mod.node_id, 0)
         for refname, obj in self.objects.items():
@@ -1457,7 +1465,7 @@
                 else:
                     yield (refname, refname, obj.objtype, obj.docname, obj.node_id, 1)
 
-    def get_full_qualified_name(self, node: Element) -> Optionalstr:
+    def get_full_qualified_name(self, node: Element) -> str | None:
         modname = node.get('py:module')
         clsname = node.get('py:class')
         target = node.get('reftarget')
@@ -1468,13 +1476,13 @@
 
 
 def builtin_resolver(app: Sphinx, env: BuildEnvironment,
-                     node: pending_xref, contnode: Element) -> Element:
+                     node: pending_xref, contnode: Element) -> Element | None:
     """Do not emit nitpicky warnings for built-in types."""
     def istyping(s: str) -> bool:
         if s.startswith('typing.'):
             s = s.split('.', 1)1
 
-        return s in typing.__all__  # type: ignore
+        return s in typing.__all__
 
     if node.get('refdomain') != 'py':
         return None
@@ -1485,18 +1493,19 @@
         if inspect.isclass(getattr(builtins, reftarget, None)):
             # built-in class
             return contnode
-        elif istyping(reftarget):
+        if istyping(reftarget):
             # typing class
             return contnode
 
     return None
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.setup_extension('sphinx.directives')
 
     app.add_domain(PythonDomain)
     app.add_config_value('python_use_unqualified_type_names', False, 'env')
+    app.add_config_value('python_display_short_literal_types', False, 'env')
     app.connect('object-description-transform', filter_meta_fields)
     app.connect('missing-reference', builtin_resolver, priority=900)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/rst.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/rst.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.domains.rst
-    ~~~~~~~~~~~~~~~~~~
+"""The reStructuredText domain."""
 
-    The reStructuredText domain.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import Any, Dict, Iterator, List, Optional, Tuple, cast
+from typing import Any, Iterator, cast
 
 from docutils.nodes import Element
 from docutils.parsers.rst import directives
@@ -36,39 +30,56 @@
     """
     Description of generic reST markup.
     """
+    option_spec: OptionSpec = {
+        'noindex': directives.flag,
+        'noindexentry': directives.flag,
+        'nocontentsentry': directives.flag,
+    }
 
     def add_target_and_index(self, name: str, sig: str, signode: desc_signature) -> None:
         node_id = make_id(self.env, self.state.document, self.objtype, name)
         signode'ids'.append(node_id)
-
-        # Assign old styled node_id not to break old hyperlinks (if possible)
-        # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-        old_node_id = self.make_old_id(name)
-        if old_node_id not in self.state.document.ids and old_node_id not in signode'ids':
-            signode'ids'.append(old_node_id)
-
         self.state.document.note_explicit_target(signode)
 
         domain = cast(ReSTDomain, self.env.get_domain('rst'))
         domain.note_object(self.objtype, name, node_id, location=signode)
 
-        indextext = self.get_index_text(self.objtype, name)
-        if indextext:
-            self.indexnode'entries'.append(('single', indextext, node_id, '', None))
+        if 'noindexentry' not in self.options:
+            indextext = self.get_index_text(self.objtype, name)
+            if indextext:
+                self.indexnode'entries'.append(('single', indextext, node_id, '', None))
 
     def get_index_text(self, objectname: str, name: str) -> str:
         return ''
 
-    def make_old_id(self, name: str) -> str:
-        """Generate old styled node_id for reST markups.
+    def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuplestr, ...:
+        if 'fullname' not in sig_node:
+            return ()
+        directive_names = 
+        for parent in self.env.ref_context.get('rst:directives', ()):
+            directive_names += parent.split(':')
+        name = sig_node'fullname'
+        return tuple(directive_names + name.split(':'))
+
+    def _toc_entry_name(self, sig_node: desc_signature) -> str:
+        if not sig_node.get('_toc_parts'):
+            return ''
 
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return self.objtype + '-' + name
+        config = self.env.app.config
+        objtype = sig_node.parent.get('objtype')
+        *parents, name = sig_node'_toc_parts'
+        if objtype == 'directive:option':
+            return f':{name}:'
+        if config.toc_object_entries_show_parents in {'domain', 'all'}:
+            name = ':'.join(sig_node'_toc_parts')
+        if objtype == 'role':
+            return f':{name}:'
+        if objtype == 'directive':
+            return f'.. {name}::'
+        return ''
 
 
-def parse_directive(d: str) -> Tuplestr, str:
+def parse_directive(d: str) -> tuplestr, str:
     """Parse a directive signature.
 
     Returns (directive, arguments) string tuple.  If no arguments are given,
@@ -94,7 +105,8 @@
     """
     def handle_signature(self, sig: str, signode: desc_signature) -> str:
         name, args = parse_directive(sig)
-        desc_name = '.. %s::' % name
+        desc_name = f'.. {name}::'
+        signode'fullname' = name.strip()
         signode += addnodes.desc_name(desc_name, desc_name)
         if len(args) > 0:
             signode += addnodes.desc_addname(args, args)
@@ -129,7 +141,9 @@
         except ValueError:
             name, argument = sig, None
 
-        signode += addnodes.desc_name(':%s:' % name, ':%s:' % name)
+        desc_name = f':{name}:'
+        signode'fullname' = name.strip()
+        signode += addnodes.desc_name(desc_name, desc_name)
         if argument:
             signode += addnodes.desc_annotation(' ' + argument, ' ' + argument)
         if self.options.get('type'):
@@ -150,13 +164,6 @@
 
         node_id = make_id(self.env, self.state.document, prefix, name)
         signode'ids'.append(node_id)
-
-        # Assign old styled node_id not to break old hyperlinks (if possible)
-        # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-        old_node_id = self.make_old_id(name)
-        if old_node_id not in self.state.document.ids and old_node_id not in signode'ids':
-            signode'ids'.append(old_node_id)
-
         self.state.document.note_explicit_target(signode)
         domain.note_object(self.objtype, objname, node_id, location=signode)
 
@@ -178,21 +185,15 @@
         else:
             return ''
 
-    def make_old_id(self, name: str) -> str:
-        """Generate old styled node_id for directive options.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return '-'.join(self.objtype, self.current_directive, name)
-
 
 class ReSTRole(ReSTMarkup):
     """
     Description of a reST role.
     """
     def handle_signature(self, sig: str, signode: desc_signature) -> str:
-        signode += addnodes.desc_name(':%s:' % sig, ':%s:' % sig)
+        desc_name = f':{sig}:'
+        signode'fullname' = sig.strip()
+        signode += addnodes.desc_name(desc_name, desc_name)
         return sig
 
     def get_index_text(self, objectname: str, name: str) -> str:
@@ -218,12 +219,12 @@
         'dir':  XRefRole(),
         'role': XRefRole(),
     }
-    initial_data: Dictstr, DictTuplestr, str, str = {
+    initial_data: dictstr, dicttuplestr, str, str = {
         'objects': {},  # fullname -> docname, objtype
     }
 
     @property
-    def objects(self) -> DictTuplestr, str, Tuplestr, str:
+    def objects(self) -> dicttuplestr, str, tuplestr, str:
         return self.data.setdefault('objects', {})  # (objtype, fullname) -> (docname, node_id)
 
     def note_object(self, objtype: str, name: str, node_id: str, location: Any = None) -> None:
@@ -239,41 +240,43 @@
             if doc == docname:
                 del self.objectstyp, name
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, Any) -> None:
         # XXX check duplicates
         for (typ, name), (doc, node_id) in otherdata'objects'.items():
             if doc in docnames:
                 self.objectstyp, name = (doc, node_id)
 
     def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         objtypes = self.objtypes_for_role(typ)
         for objtype in objtypes:
-            todocname, node_id = self.objects.get((objtype, target), (None, None))
-            if todocname:
+            result = self.objects.get((objtype, target))
+            if result:
+                todocname, node_id = result
                 return make_refnode(builder, fromdocname, todocname, node_id,
                                     contnode, target + ' ' + objtype)
         return None
 
     def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
-                         target: str, node: pending_xref, contnode: Element
-                         ) -> ListTuplestr, Element:
-        results: ListTuplestr, Element = 
+                         target: str, node: pending_xref, contnode: Element,
+                         ) -> listtuplestr, Element:
+        results: listtuplestr, Element = 
         for objtype in self.object_types:
-            todocname, node_id = self.objects.get((objtype, target), (None, None))
-            if todocname:
+            result = self.objects.get((objtype, target))
+            if result:
+                todocname, node_id = result
                 results.append(('rst:' + self.role_for_objtype(objtype),
                                 make_refnode(builder, fromdocname, todocname, node_id,
                                              contnode, target + ' ' + objtype)))
         return results
 
-    def get_objects(self) -> IteratorTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iteratortuplestr, str, str, str, str, int:
         for (typ, name), (docname, node_id) in self.data'objects'.items():
             yield name, name, typ, docname, node_id, 1
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(ReSTDomain)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/domains/std.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/domains/std.py Changed

@@ -1,18 +1,10 @@
-"""
-    sphinx.domains.std
-    ~~~~~~~~~~~~~~~~~~
+"""The standard domain."""
 
-    The standard domain.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-import warnings
 from copy import copy
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, Iterator, List, Optional,
-                    Tuple, Type, Union, cast)
+from typing import TYPE_CHECKING, Any, Callable, Final, Iterable, Iterator, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, system_message
@@ -21,11 +13,10 @@
 
 from sphinx import addnodes
 from sphinx.addnodes import desc_signature, pending_xref
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.directives import ObjectDescription
-from sphinx.domains import Domain, ObjType
+from sphinx.domains import Domain, ObjType, TitleGetter
 from sphinx.locale import _, __
-from sphinx.roles import XRefRole
+from sphinx.roles import EmphasizedLiteral, XRefRole
 from sphinx.util import docname_join, logging, ws_re
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.nodes import clean_astext, make_id, make_refnode
@@ -38,19 +29,20 @@
 
 logger = logging.getLogger(__name__)
 
-
 # RE for option descriptions
 option_desc_re = re.compile(r'((?:/|--|-|\+)?^\s=+)(=?\s*.*)')
 # RE for grammar tokens
 token_re = re.compile(r'`((~?\w*:)?\w+)`', re.U)
 
+samp_role = EmphasizedLiteral()
+
 
 class GenericObject(ObjectDescriptionstr):
     """
     A generic x-ref directive registered with Sphinx.add_object_type().
     """
     indextemplate: str = ''
-    parse_node: Callable"GenericObject", "BuildEnvironment", str, desc_signature, str = None  # NOQA
+    parse_node: CallableBuildEnvironment, str, desc_signature, str | None = None
 
     def handle_signature(self, sig: str, signode: desc_signature) -> str:
         if self.parse_node:
@@ -65,13 +57,6 @@
     def add_target_and_index(self, name: str, sig: str, signode: desc_signature) -> None:
         node_id = make_id(self.env, self.state.document, self.objtype, name)
         signode'ids'.append(node_id)
-
-        # Assign old styled node_id not to break old hyperlinks (if possible)
-        # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-        old_node_id = self.make_old_id(name)
-        if old_node_id not in self.state.document.ids and old_node_id not in signode'ids':
-            signode'ids'.append(old_node_id)
-
         self.state.document.note_explicit_target(signode)
 
         if self.indextemplate:
@@ -87,14 +72,6 @@
         std = cast(StandardDomain, self.env.get_domain('std'))
         std.note_object(self.objtype, name, node_id, location=signode)
 
-    def make_old_id(self, name: str) -> str:
-        """Generate old styled node_id for generic objects.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return self.objtype + '-' + name
-
 
 class EnvVar(GenericObject):
     indextemplate = _('environment variable; %s')
@@ -105,8 +82,8 @@
     Cross-referencing role for environment variables (adds an index entry).
     """
 
-    def result_nodes(self, document: nodes.document, env: "BuildEnvironment", node: Element,
-                     is_ref: bool) -> TupleListNode, Listsystem_message:
+    def result_nodes(self, document: nodes.document, env: BuildEnvironment, node: Element,
+                     is_ref: bool) -> tuplelistNode, listsystem_message:
         if not is_ref:
             return node, 
         varname = node'reftarget'
@@ -114,7 +91,7 @@
         indexnode = addnodes.index()
         indexnode'entries' = 
             ('single', varname, tgtid, '', None),
-            ('single', _('environment variable; %s') % varname, tgtid, '', None)
+            ('single', _('environment variable; %s') % varname, tgtid, '', None),
         
         targetnode = nodes.target('', '', ids=tgtid)
         document.note_explicit_target(targetnode)
@@ -133,21 +110,14 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         # normalize whitespace in fullname like XRefRole does
         fullname = ws_re.sub(' ', self.arguments0.strip())
         node_id = make_id(self.env, self.state.document, self.name, fullname)
         node = nodes.target('', '', ids=node_id)
         self.set_source_info(node)
-
-        # Assign old styled node_id not to break old hyperlinks (if possible)
-        # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-        old_node_id = self.make_old_id(fullname)
-        if old_node_id not in self.state.document.ids and old_node_id not in node'ids':
-            node'ids'.append(old_node_id)
-
         self.state.document.note_explicit_target(node)
-        ret: ListNode = node
+        ret: listNode = node
         if self.indextemplate:
             indexentry = self.indextemplate % (fullname,)
             indextype = 'single'
@@ -166,14 +136,6 @@
 
         return ret
 
-    def make_old_id(self, name: str) -> str:
-        """Generate old styled node_id for targets.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return self.name + '-' + name
-
 
 class Cmdoption(ObjectDescriptionstr):
     """
@@ -194,15 +156,40 @@
                                location=signode)
                 continue
             optname, args = m.groups()
-            if optname.endswith('') and args.endswith(''):
+            if optname-1 == '' and args-1 == '':
                 # optional value surrounded by brackets (ex. foo=bar)
                 optname = optname:-1
                 args = '' + args
 
             if count:
-                signode += addnodes.desc_addname(', ', ', ')
+                if self.env.config.option_emphasise_placeholders:
+                    signode += addnodes.desc_sig_punctuation(',', ',')
+                    signode += addnodes.desc_sig_space()
+                else:
+                    signode += addnodes.desc_addname(', ', ', ')
             signode += addnodes.desc_name(optname, optname)
-            signode += addnodes.desc_addname(args, args)
+            if self.env.config.option_emphasise_placeholders:
+                add_end_bracket = False
+                if args:
+                    if args0 == '' and args-1 == '':
+                        add_end_bracket = True
+                        signode += addnodes.desc_sig_punctuation('', '')
+                        args = args1:-1
+                    elif args0 == ' ':
+                        signode += addnodes.desc_sig_space()
+                        args = args.strip()
+                    elif args0 == '=':
+                        signode += addnodes.desc_sig_punctuation('=', '=')
+                        args = args1:
+                    for part in samp_role.parse(args):
+                        if isinstance(part, nodes.Text):
+                            signode += nodes.Text(part.astext())
+                        else:
+                            signode += part
+                if add_end_bracket:
+                    signode += addnodes.desc_sig_punctuation('', '')
+            else:
+                signode += addnodes.desc_addname(args, args)
             if not count:
                 firstname = optname
                 signode'allnames' = optname
@@ -225,11 +212,6 @@
             node_id = make_id(self.env, self.state.document, prefix, optname)
             signode'ids'.append(node_id)
 
-            old_node_id = self.make_old_id(prefix, optname)
-            if old_node_id not in self.state.document.ids and \
-               old_node_id not in signode'ids':
-                signode'ids'.append(old_node_id)
-
         self.state.document.note_explicit_target(signode)
 
         domain = cast(StandardDomain, self.env.get_domain('std'))
@@ -246,14 +228,6 @@
             entry = '; '.join(descr, option)
             self.indexnode'entries'.append(('pair', entry, signode'ids'0, '', None))
 
-    def make_old_id(self, prefix: str, optname: str) -> str:
-        """Generate old styled node_id for cmdoption.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return nodes.make_id(prefix + '-' + optname)
-
 
 class Program(SphinxDirective):
     """
@@ -266,7 +240,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         program = ws_re.sub('-', self.arguments0.strip())
         if program == 'None':
             self.env.ref_context.pop('std:program', None)
@@ -276,20 +250,20 @@
 
 
 class OptionXRefRole(XRefRole):
-    def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool,
-                     title: str, target: str) -> Tuplestr, str:
+    def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool,
+                     title: str, target: str) -> tuplestr, str:
         refnode'std:program' = env.ref_context.get('std:program')
         return title, target
 
 
-def split_term_classifiers(line: str) -> ListOptionalstr:
+def split_term_classifiers(line: str) -> liststr | None:
     # split line into a term and classifiers. if no classifier, None is used..
-    parts: ListOptionalstr = re.split(' +: +', line) + None
+    parts: liststr | None = re.split(' +: +', line) + None
     return parts
 
 
-def make_glossary_term(env: "BuildEnvironment", textnodes: IterableNode, index_key: str,
-                       source: str, lineno: int, node_id: str, document: nodes.document
+def make_glossary_term(env: BuildEnvironment, textnodes: IterableNode, index_key: str,
+                       source: str, lineno: int, node_id: str | None, document: nodes.document,
                        ) -> nodes.term:
     # get a text-only representation of the term and register it
     # as a cross-reference target
@@ -332,7 +306,7 @@
         'sorted': directives.flag,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = addnodes.glossary()
         node.document = self.state.document
         node'sorted' = ('sorted' in self.options)
@@ -343,11 +317,11 @@
         # be* a definition list.
 
         # first, collect single entries
-        entries: ListTupleListTuplestr, str, int, StringList = 
+        entries: listtuplelisttuplestr, str, int, StringList = 
         in_definition = True
         in_comment = False
         was_empty = True
-        messages: ListNode = 
+        messages: listNode = 
         for line, (source, lineno) in zip(self.content, self.content.items):
             # empty line -> add to last definition
             if not line:
@@ -361,8 +335,7 @@
                 if line.startswith('.. '):
                     in_comment = True
                     continue
-                else:
-                    in_comment = False
+                in_comment = False
 
                 # first term of definition
                 if in_definition:
@@ -400,10 +373,10 @@
             was_empty = False
 
         # now, parse all the entries into a big definition list
-        items: Listnodes.definition_list_item = 
+        items: listnodes.definition_list_item = 
         for terms, definition in entries:
-            termnodes: ListNode = 
-            system_messages: ListNode = 
+            termnodes: listNode = 
+            system_messages: listNode = 
             for line, source, lineno in terms:
                 parts = split_term_classifiers(line)
                 # parse the term with inline markup
@@ -432,15 +405,15 @@
         return messages + node
 
 
-def token_xrefs(text: str, productionGroup: str = '') -> ListNode:
+def token_xrefs(text: str, productionGroup: str = '') -> listNode:
     if len(productionGroup) != 0:
         productionGroup += ':'
-    retnodes: ListNode = 
+    retnodes: listNode = 
     pos = 0
     for m in token_re.finditer(text):
         if m.start() > pos:
             txt = textpos:m.start()
-            retnodes.append(nodes.Text(txt, txt))
+            retnodes.append(nodes.Text(txt))
         token = m.group(1)
         if ':' in token:
             if token0 == '~':
@@ -461,7 +434,7 @@
         retnodes.append(refnode)
         pos = m.end()
     if pos < len(text):
-        retnodes.append(nodes.Text(textpos:, textpos:))
+        retnodes.append(nodes.Text(textpos:))
     return retnodes
 
 
@@ -476,7 +449,7 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         domain = cast(StandardDomain, self.env.get_domain('std'))
         node: Element = addnodes.productionlist()
         self.set_source_info(node)
@@ -485,12 +458,12 @@
         lines = nl_escape_re.sub('', self.arguments0).split('\n')
 
         productionGroup = ""
-        i = 0
+        first_rule_seen = False
         for rule in lines:
-            if i == 0 and ':' not in rule:
+            if not first_rule_seen and ':' not in rule:
                 productionGroup = rule.strip()
                 continue
-            i += 1
+            first_rule_seen = True
             try:
                 name, tokens = rule.split(':', 1)
             except ValueError:
@@ -502,18 +475,10 @@
                 prefix = 'grammar-token-%s' % productionGroup
                 node_id = make_id(self.env, self.state.document, prefix, name)
                 subnode'ids'.append(node_id)
-
-                # Assign old styled node_id not to break old hyperlinks (if possible)
-                # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning)
-                old_node_id = self.make_old_id(name)
-                if (old_node_id not in self.state.document.ids and
-                        old_node_id not in subnode'ids'):
-                    subnode'ids'.append(old_node_id)
-
                 self.state.document.note_implicit_target(subnode, subnode)
 
                 if len(productionGroup) != 0:
-                    objName = "%s:%s" % (productionGroup, name)
+                    objName = f"{productionGroup}:{name}"
                 else:
                     objName = name
                 domain.note_object('token', objName, node_id, location=node)
@@ -521,18 +486,10 @@
             node.append(subnode)
         return node
 
-    def make_old_id(self, token: str) -> str:
-        """Generate old styled node_id for tokens.
-
-        .. note:: Old Styled node_id was used until Sphinx-3.0.
-                  This will be removed in Sphinx-5.0.
-        """
-        return nodes.make_id('grammar-token-' + token)
-
 
 class TokenXRefRole(XRefRole):
-    def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool,
-                     title: str, target: str) -> Tuplestr, str:
+    def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool,
+                     title: str, target: str) -> tuplestr, str:
         target = target.lstrip('~')  # a title-specific thing
         if not self.has_explicit_title and title0 == '~':
             if ':' in title:
@@ -551,17 +508,17 @@
     name = 'std'
     label = 'Default'
 
-    object_types: Dictstr, ObjType = {
+    object_types: dictstr, ObjType = {
         'term': ObjType(_('glossary term'), 'term', searchprio=-1),
         'token': ObjType(_('grammar token'), 'token', searchprio=-1),
         'label': ObjType(_('reference label'), 'ref', 'keyword',
                          searchprio=-1),
         'envvar': ObjType(_('environment variable'), 'envvar'),
         'cmdoption': ObjType(_('program option'), 'option'),
-        'doc': ObjType(_('document'), 'doc', searchprio=-1)
+        'doc': ObjType(_('document'), 'doc', searchprio=-1),
     }
 
-    directives: Dictstr, TypeDirective = {
+    directives: dictstr, typeDirective = {
         'program': Program,
         'cmdoption': Cmdoption,  # old name for backwards compatibility
         'option': Cmdoption,
@@ -569,7 +526,7 @@
         'glossary': Glossary,
         'productionlist': ProductionList,
     }
-    roles: Dictstr, UnionRoleFunction, XRefRole = {
+    roles: dictstr, RoleFunction | XRefRole = {
         'option':  OptionXRefRole(warn_dangling=True),
         'envvar':  EnvVarXRefRole(),
         # links to tokens in grammar productions
@@ -589,7 +546,7 @@
         'doc':     XRefRole(warn_dangling=True, innernodeclass=nodes.inline),
     }
 
-    initial_data = {
+    initial_data: Final = {  # type: ignoremisc
         'progoptions': {},      # (program, name) -> docname, labelid
         'objects': {},          # (type, name) -> docname, labelid
         'labels': {             # labelname -> docname, labelid, sectionname
@@ -604,22 +561,28 @@
         },
     }
 
+    _virtual_doc_names: dictstr, tuplestr, str = {  # labelname -> docname, sectionname
+        'genindex': ('genindex', _('Index')),
+        'modindex': ('py-modindex', _('Module Index')),
+        'search': ('search', _('Search Page')),
+    }
+
     dangling_warnings = {
-        'term': 'term not in glossary: %(target)s',
-        'numref':  'undefined label: %(target)s',
-        'keyword': 'unknown keyword: %(target)s',
-        'doc': 'unknown document: %(target)s',
-        'option': 'unknown option: %(target)s',
+        'term': 'term not in glossary: %(target)r',
+        'numref':  'undefined label: %(target)r',
+        'keyword': 'unknown keyword: %(target)r',
+        'doc': 'unknown document: %(target)r',
+        'option': 'unknown option: %(target)r',
     }
 
     # node_class -> (figtype, title_getter)
-    enumerable_nodes: DictTypeNode, Tuplestr, OptionalCallable = {
+    enumerable_nodes: dicttypeNode, tuplestr, TitleGetter | None = {
         nodes.figure: ('figure', None),
         nodes.table: ('table', None),
         nodes.container: ('code-block', None),
     }
 
-    def __init__(self, env: "BuildEnvironment") -> None:
+    def __init__(self, env: BuildEnvironment) -> None:
         super().__init__(env)
 
         # set up enumerable nodes
@@ -652,10 +615,10 @@
             self.labelsname = (docname, node_id, title)
 
     @property
-    def objects(self) -> DictTuplestr, str, Tuplestr, str:
+    def objects(self) -> dicttuplestr, str, tuplestr, str:
         return self.data.setdefault('objects', {})  # (objtype, name) -> docname, labelid
 
-    def note_object(self, objtype: str, name: str, labelid: str, location: Any = None
+    def note_object(self, objtype: str, name: str, labelid: str, location: Any = None,
                     ) -> None:
         """Note a generic object for cross reference.
 
@@ -667,13 +630,8 @@
                            objtype, name, docname, location=location)
         self.objectsobjtype, name = (self.env.docname, labelid)
 
-    def add_object(self, objtype: str, name: str, docname: str, labelid: str) -> None:
-        warnings.warn('StandardDomain.add_object() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        self.objectsobjtype, name = (docname, labelid)
-
     @property
-    def _terms(self) -> Dictstr, Tuplestr, str:
+    def _terms(self) -> dictstr, tuplestr, str:
         """.. note:: Will be removed soon. internal use only."""
         return self.data.setdefault('terms', {})  # (name) -> docname, labelid
 
@@ -687,15 +645,15 @@
         self._termsterm.lower() = (self.env.docname, labelid)
 
     @property
-    def progoptions(self) -> DictTuplestr, str, Tuplestr, str:
+    def progoptions(self) -> dicttuplestr, str, tuplestr, str:
         return self.data.setdefault('progoptions', {})  # (program, name) -> docname, labelid
 
     @property
-    def labels(self) -> Dictstr, Tuplestr, str, str:
+    def labels(self) -> dictstr, tuplestr, str, str:
         return self.data.setdefault('labels', {})  # labelname -> docname, labelid, sectionname
 
     @property
-    def anonlabels(self) -> Dictstr, Tuplestr, str:
+    def anonlabels(self) -> dictstr, tuplestr, str:
         return self.data.setdefault('anonlabels', {})  # labelname -> docname, labelid
 
     def clear_doc(self, docname: str) -> None:
@@ -716,7 +674,7 @@
             if fn == docname:
                 del self.anonlabelskey
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, Any) -> None:
         # XXX duplicates?
         for key, data in otherdata'progoptions'.items():
             if data0 in docnames:
@@ -734,7 +692,9 @@
             if data0 in docnames:
                 self.anonlabelskey = data
 
-    def process_doc(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None:  # NOQA
+    def process_doc(
+        self, env: BuildEnvironment, docname: str, document: nodes.document,
+    ) -> None:
         for name, explicit in document.nametypes.items():
             if not explicit:
                 continue
@@ -759,29 +719,38 @@
             self.anonlabelsname = docname, labelid
             if node.tagname == 'section':
                 title = cast(nodes.title, node0)
-                sectname = clean_astext(title)
+                sectname: str | None = clean_astext(title)
             elif node.tagname == 'rubric':
                 sectname = clean_astext(node)
-            elif node.tagname == 'target' and len(node) > 0:
-                # inline target (ex: blah _`blah` blah)
-                sectname = clean_astext(node)
             elif self.is_enumerable_node(node):
                 sectname = self.get_numfig_title(node)
+                if not sectname:
+                    continue
             else:
-                toctree = next(node.findall(addnodes.toctree), None)
-                if toctree and toctree.get('caption'):
-                    sectname = toctree.get('caption')
+                if (isinstance(node, (nodes.definition_list,
+                                      nodes.field_list)) and
+                        node.children):
+                    node = cast(nodes.Element, node.children0)
+                if isinstance(node, (nodes.field, nodes.definition_list_item)):
+                    node = cast(nodes.Element, node.children0)
+                if isinstance(node, (nodes.term, nodes.field_name)):
+                    sectname = clean_astext(node)
                 else:
-                    # anonymous-only labels
-                    continue
-            if sectname:
-                self.labelsname = docname, labelid, sectname
+                    toctree = next(node.findall(addnodes.toctree), None)
+                    if toctree and toctree.get('caption'):
+                        sectname = toctree.get('caption')
+                    else:
+                        # anonymous-only labels
+                        continue
+            self.labelsname = docname, labelid, sectname
 
     def add_program_option(self, program: str, name: str, docname: str, labelid: str) -> None:
-        self.progoptionsprogram, name = (docname, labelid)
+        # prefer first command option entry
+        if (program, name) not in self.progoptions:
+            self.progoptionsprogram, name = (docname, labelid)
 
-    def build_reference_node(self, fromdocname: str, builder: "Builder", docname: str,
-                             labelid: str, sectname: str, rolename: str, **options: Any
+    def build_reference_node(self, fromdocname: str, builder: Builder, docname: str,
+                             labelid: str, sectname: str, rolename: str, **options: Any,
                              ) -> Element:
         nodeclass = options.pop('nodeclass', nodes.reference)
         newnode = nodeclass('', '', internal=True, **options)
@@ -805,9 +774,9 @@
         newnode.append(innernode)
         return newnode
 
-    def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder",
-                     typ: str, target: str, node: pending_xref, contnode: Element
-                     ) -> OptionalElement:
+    def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder,
+                     typ: str, target: str, node: pending_xref, contnode: Element,
+                     ) -> Element | None:
         if typ == 'ref':
             resolver = self._resolve_ref_xref
         elif typ == 'numref':
@@ -825,9 +794,9 @@
 
         return resolver(env, fromdocname, builder, typ, target, node, contnode)
 
-    def _resolve_ref_xref(self, env: "BuildEnvironment", fromdocname: str,
-                          builder: "Builder", typ: str, target: str, node: pending_xref,
-                          contnode: Element) -> OptionalElement:
+    def _resolve_ref_xref(self, env: BuildEnvironment, fromdocname: str,
+                          builder: Builder, typ: str, target: str, node: pending_xref,
+                          contnode: Element) -> Element | None:
         if node'refexplicit':
             # reference to anonymous label; the reference uses
             # the supplied link caption
@@ -843,9 +812,9 @@
         return self.build_reference_node(fromdocname, builder,
                                          docname, labelid, sectname, 'ref')
 
-    def _resolve_numref_xref(self, env: "BuildEnvironment", fromdocname: str,
-                             builder: "Builder", typ: str, target: str,
-                             node: pending_xref, contnode: Element) -> OptionalElement:
+    def _resolve_numref_xref(self, env: BuildEnvironment, fromdocname: str,
+                             builder: Builder, typ: str, target: str,
+                             node: pending_xref, contnode: Element) -> Element | None:
         if target in self.labels:
             docname, labelid, figname = self.labels.get(target, ('', '', ''))
         else:
@@ -906,9 +875,9 @@
                                          nodeclass=addnodes.number_reference,
                                          title=title)
 
-    def _resolve_keyword_xref(self, env: "BuildEnvironment", fromdocname: str,
-                              builder: "Builder", typ: str, target: str,
-                              node: pending_xref, contnode: Element) -> OptionalElement:
+    def _resolve_keyword_xref(self, env: BuildEnvironment, fromdocname: str,
+                              builder: Builder, typ: str, target: str,
+                              node: pending_xref, contnode: Element) -> Element | None:
         # keywords are oddballs: they are referenced by named labels
         docname, labelid, _ = self.labels.get(target, ('', '', ''))
         if not docname:
@@ -916,9 +885,9 @@
         return make_refnode(builder, fromdocname, docname,
                             labelid, contnode)
 
-    def _resolve_doc_xref(self, env: "BuildEnvironment", fromdocname: str,
-                          builder: "Builder", typ: str, target: str,
-                          node: pending_xref, contnode: Element) -> OptionalElement:
+    def _resolve_doc_xref(self, env: BuildEnvironment, fromdocname: str,
+                          builder: Builder, typ: str, target: str,
+                          node: pending_xref, contnode: Element) -> Element | None:
         # directly reference to document by source name; can be absolute or relative
         refdoc = node.get('refdoc', fromdocname)
         docname = docname_join(refdoc, node'reftarget')
@@ -933,13 +902,24 @@
             innernode = nodes.inline(caption, caption, classes='doc')
             return make_refnode(builder, fromdocname, docname, None, innernode)
 
-    def _resolve_option_xref(self, env: "BuildEnvironment", fromdocname: str,
-                             builder: "Builder", typ: str, target: str,
-                             node: pending_xref, contnode: Element) -> OptionalElement:
+    def _resolve_option_xref(self, env: BuildEnvironment, fromdocname: str,
+                             builder: Builder, typ: str, target: str,
+                             node: pending_xref, contnode: Element) -> Element | None:
         progname = node.get('std:program')
         target = target.strip()
         docname, labelid = self.progoptions.get((progname, target), ('', ''))
         if not docname:
+            # Support also reference that contain an option value:
+            # * :option:`-foo=bar`
+            # * :option:`-foo=bar`
+            # * :option:`-foo bar`
+            for needle in {'=', '=', ' '}:
+                if needle in target:
+                    stem, _, _ = target.partition(needle)
+                    docname, labelid = self.progoptions.get((progname, stem), ('', ''))
+                    if docname:
+                        break
+        if not docname:
             commands = 
             while ws_re.search(target):
                 subcommand, target = ws_re.split(target, 1)
@@ -955,24 +935,24 @@
         return make_refnode(builder, fromdocname, docname,
                             labelid, contnode)
 
-    def _resolve_term_xref(self, env: "BuildEnvironment", fromdocname: str,
-                           builder: "Builder", typ: str, target: str,
-                           node: pending_xref, contnode: Element) -> Element:
+    def _resolve_term_xref(self, env: BuildEnvironment, fromdocname: str,
+                           builder: Builder, typ: str, target: str,
+                           node: pending_xref, contnode: Element) -> Element | None:
         result = self._resolve_obj_xref(env, fromdocname, builder, typ,
                                         target, node, contnode)
         if result:
             return result
         else:
-            # fallback to case insentive match
+            # fallback to case insensitive match
             if target.lower() in self._terms:
                 docname, labelid = self._termstarget.lower()
                 return make_refnode(builder, fromdocname, docname, labelid, contnode)
             else:
                 return None
 
-    def _resolve_obj_xref(self, env: "BuildEnvironment", fromdocname: str,
-                          builder: "Builder", typ: str, target: str,
-                          node: pending_xref, contnode: Element) -> OptionalElement:
+    def _resolve_obj_xref(self, env: BuildEnvironment, fromdocname: str,
+                          builder: Builder, typ: str, target: str,
+                          node: pending_xref, contnode: Element) -> Element | None:
         objtypes = self.objtypes_for_role(typ) or 
         for objtype in objtypes:
             if (objtype, target) in self.objects:
@@ -985,10 +965,10 @@
         return make_refnode(builder, fromdocname, docname,
                             labelid, contnode)
 
-    def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str,
-                         builder: "Builder", target: str, node: pending_xref,
-                         contnode: Element) -> ListTuplestr, Element:
-        results: ListTuplestr, Element = 
+    def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str,
+                         builder: Builder, target: str, node: pending_xref,
+                         contnode: Element) -> listtuplestr, Element:
+        results: listtuplestr, Element = 
         ltarget = target.lower()  # :ref: lowercases its target automatically
         for role in ('ref', 'option'):  # do not try "keyword"
             res = self.resolve_xref(env, fromdocname, builder, role,
@@ -1008,7 +988,7 @@
                                              labelid, contnode)))
         return results
 
-    def get_objects(self) -> IteratorTuplestr, str, str, str, str, int:
+    def get_objects(self) -> Iteratortuplestr, str, str, str, str, int:
         # handle the special 'doc' reference here
         for doc in self.env.all_docs:
             yield (doc, clean_astext(self.env.titlesdoc), 'doc', doc, '', -1)
@@ -1036,7 +1016,7 @@
     def is_enumerable_node(self, node: Node) -> bool:
         return node.__class__ in self.enumerable_nodes
 
-    def get_numfig_title(self, node: Node) -> Optionalstr:
+    def get_numfig_title(self, node: Node) -> str | None:
         """Get the title of enumerable nodes to refer them using its title"""
         if self.is_enumerable_node(node):
             elem = cast(Element, node)
@@ -1050,9 +1030,9 @@
 
         return None
 
-    def get_enumerable_node_type(self, node: Node) -> Optionalstr:
+    def get_enumerable_node_type(self, node: Node) -> str | None:
         """Get type of enumerable nodes."""
-        def has_child(node: Element, cls: Type) -> bool:
+        def has_child(node: Element, cls: type) -> bool:
             return any(isinstance(child, cls) for child in node)
 
         if isinstance(node, nodes.section):
@@ -1066,11 +1046,17 @@
             figtype, _ = self.enumerable_nodes.get(node.__class__, (None, None))
             return figtype
 
-    def get_fignumber(self, env: "BuildEnvironment", builder: "Builder",
-                      figtype: str, docname: str, target_node: Element) -> Tupleint, ...:
+    def get_fignumber(
+        self,
+        env: BuildEnvironment,
+        builder: Builder,
+        figtype: str,
+        docname: str,
+        target_node: Element,
+    ) -> tupleint, ... | None:
         if figtype == 'section':
             if builder.name == 'latex':
-                return tuple()
+                return ()
             elif docname not in env.toc_secnumbers:
                 raise ValueError  # no number assigned
             else:
@@ -1089,7 +1075,7 @@
                 # Maybe it is defined in orphaned document.
                 raise ValueError from exc
 
-    def get_full_qualified_name(self, node: Element) -> Optionalstr:
+    def get_full_qualified_name(self, node: Element) -> str | None:
         if node.get('reftype') == 'option':
             progname = node.get('std:program')
             command = ws_re.split(node.get('reftarget'))
@@ -1104,22 +1090,22 @@
             return None
 
 
-def warn_missing_reference(app: "Sphinx", domain: Domain, node: pending_xref
-                           ) -> Optionalbool:
+def warn_missing_reference(app: Sphinx, domain: Domain, node: pending_xref,
+                           ) -> bool | None:
     if (domain and domain.name != 'std') or node'reftype' != 'ref':
         return None
     else:
         target = node'reftarget'
         if target not in domain.anonlabels:  # type: ignore
-            msg = __('undefined label: %s')
+            msg = __('undefined label: %r')
         else:
-            msg = __('Failed to create a cross reference. A title or caption not found: %s')
+            msg = __('Failed to create a cross reference. A title or caption not found: %r')
 
         logger.warning(msg % target, location=node, type='ref', subtype=node'reftype')
         return True
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(StandardDomain)
     app.connect('warn-missing-reference', warn_missing_reference)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/__init__.py Changed

@@ -1,29 +1,21 @@
-"""
-    sphinx.environment
-    ~~~~~~~~~~~~~~~~~~
+"""Global creation environment."""
 
-    Global creation environment.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import functools
 import os
 import pickle
-import warnings
 from collections import defaultdict
 from copy import copy
 from datetime import datetime
 from os import path
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Generator, Iterator, List, Optional,
-                    Set, Tuple, Union)
+from typing import TYPE_CHECKING, Any, Callable, Generator, Iterator
 
 from docutils import nodes
 from docutils.nodes import Node
 
 from sphinx import addnodes
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.domains import Domain
 from sphinx.environment.adapters.toctree import TocTree
 from sphinx.errors import BuildEnvironmentError, DocumentError, ExtensionError, SphinxError
@@ -41,15 +33,14 @@
     from sphinx.application import Sphinx
     from sphinx.builders import Builder
 
-
 logger = logging.getLogger(__name__)
 
-default_settings: Dictstr, Any = {
+default_settings: dictstr, Any = {
     'auto_id_prefix': 'id',
-    'embed_images': False,
+    'image_loading': 'link',
     'embed_stylesheet': False,
     'cloak_email_addresses': True,
-    'pep_base_url': 'https://www.python.org/dev/peps/',
+    'pep_base_url': 'https://peps.python.org/',
     'pep_references': None,
     'rfc_base_url': 'https://datatracker.ietf.org/doc/html/',
     'rfc_references': None,
@@ -64,7 +55,7 @@
 
 # This is increased every time an environment attribute is added
 # or changed to properly invalidate pickle files.
-ENV_VERSION = 56
+ENV_VERSION = 57
 
 # config status
 CONFIG_OK = 1
@@ -79,11 +70,65 @@
 }
 
 
-versioning_conditions: Dictstr, Unionbool, Callable = {
+versioning_conditions: dictstr, bool | Callable = {
     'none': False,
     'text': is_translatable,
 }
 
+if TYPE_CHECKING:
+    from typing import Literal, MutableMapping
+
+    from typing_extensions import overload
+
+    from sphinx.domains.c import CDomain
+    from sphinx.domains.changeset import ChangeSetDomain
+    from sphinx.domains.citation import CitationDomain
+    from sphinx.domains.cpp import CPPDomain
+    from sphinx.domains.index import IndexDomain
+    from sphinx.domains.javascript import JavaScriptDomain
+    from sphinx.domains.math import MathDomain
+    from sphinx.domains.python import PythonDomain
+    from sphinx.domains.rst import ReSTDomain
+    from sphinx.domains.std import StandardDomain
+    from sphinx.ext.duration import DurationDomain
+    from sphinx.ext.todo import TodoDomain
+
+    class _DomainsType(MutableMappingstr, Domain):
+        @overload
+        def __getitem__(self, key: Literal"c") -> CDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"cpp") -> CPPDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"changeset") -> ChangeSetDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"citation") -> CitationDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"index") -> IndexDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"js") -> JavaScriptDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"math") -> MathDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"py") -> PythonDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"rst") -> ReSTDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"std") -> StandardDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"duration") -> DurationDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: Literal"todo") -> TodoDomain: ...  # NoQA: E704
+        @overload
+        def __getitem__(self, key: str) -> Domain: ...  # NoQA: E704
+        def __getitem__(self, key): raise NotImplementedError  # NoQA: E704
+        def __setitem__(self, key, value): raise NotImplementedError  # NoQA: E704
+        def __delitem__(self, key): raise NotImplementedError  # NoQA: E704
+        def __iter__(self): raise NotImplementedError  # NoQA: E704
+        def __len__(self): raise NotImplementedError  # NoQA: E704
+
+else:
+    _DomainsType = dict
+
 
 class BuildEnvironment:
     """
@@ -92,11 +137,11 @@
     transformations to resolve links to them.
     """
 
-    domains: Dictstr, Domain
+    domains: _DomainsType
 
     # --------- ENVIRONMENT INITIALIZATION -------------------------------------
 
-    def __init__(self, app: "Sphinx" = None):
+    def __init__(self, app: Sphinx):
         self.app: Sphinx = None
         self.doctreedir: str = None
         self.srcdir: str = None
@@ -105,14 +150,14 @@
         self.config_status_extra: str = None
         self.events: EventManager = None
         self.project: Project = None
-        self.version: Dictstr, str = None
+        self.version: dictstr, str = None
 
         # the method of doctree versioning; see set_versioning_method
-        self.versioning_condition: Unionbool, Callable = None
+        self.versioning_condition: bool | Callable = None
         self.versioning_compare: bool = None
 
         # all the registered domains, set by the application
-        self.domains = {}
+        self.domains = _DomainsType()
 
         # the docutils settings for building
         self.settings = default_settings.copy()
@@ -123,50 +168,56 @@
 
         # docname -> mtime at the time of reading
         # contains all read docnames
-        self.all_docs: Dictstr, float = {}
+        self.all_docs: dictstr, float = {}
         # docname -> set of dependent file
         # names, relative to documentation root
-        self.dependencies: Dictstr, Setstr = defaultdict(set)
+        self.dependencies: dictstr, setstr = defaultdict(set)
         # docname -> set of included file
         # docnames included from other documents
-        self.included: Dictstr, Setstr = defaultdict(set)
+        self.included: dictstr, setstr = defaultdict(set)
         # docnames to re-read unconditionally on next build
-        self.reread_always: Setstr = set()
+        self.reread_always: setstr = set()
+
+        # docname -> pickled doctree
+        self._pickled_doctree_cache: dictstr, bytes = {}
+
+        # docname -> doctree
+        self._write_doc_doctree_cache: dictstr, nodes.document = {}
 
         # File metadata
         # docname -> dict of metadata items
-        self.metadata: Dictstr, Dictstr, Any = defaultdict(dict)
+        self.metadata: dictstr, dictstr, Any = defaultdict(dict)
 
         # TOC inventory
         # docname -> title node
-        self.titles: Dictstr, nodes.title = {}
+        self.titles: dictstr, nodes.title = {}
         # docname -> title node; only different if
         # set differently with title directive
-        self.longtitles: Dictstr, nodes.title = {}
+        self.longtitles: dictstr, nodes.title = {}
         # docname -> table of contents nodetree
-        self.tocs: Dictstr, nodes.bullet_list = {}
+        self.tocs: dictstr, nodes.bullet_list = {}
         # docname -> number of real entries
-        self.toc_num_entries: Dictstr, int = {}
+        self.toc_num_entries: dictstr, int = {}
 
         # used to determine when to show the TOC
         # in a sidebar (don't show if it's only one item)
         # docname -> dict of sectionid -> number
-        self.toc_secnumbers: Dictstr, Dictstr, Tupleint, ... = {}
+        self.toc_secnumbers: dictstr, dictstr, tupleint, ... = {}
         # docname -> dict of figtype -> dict of figureid -> number
-        self.toc_fignumbers: Dictstr, Dictstr, Dictstr, Tupleint, ... = {}
+        self.toc_fignumbers: dictstr, dictstr, dictstr, tupleint, ... = {}
 
         # docname -> list of toctree includefiles
-        self.toctree_includes: Dictstr, Liststr = {}
+        self.toctree_includes: dictstr, liststr = {}
         # docname -> set of files (containing its TOCs) to rebuild too
-        self.files_to_rebuild: Dictstr, Setstr = {}
+        self.files_to_rebuild: dictstr, setstr = {}
         # docnames that have :glob: toctrees
-        self.glob_toctrees: Setstr = set()
+        self.glob_toctrees: setstr = set()
         # docnames that have :numbered: toctrees
-        self.numbered_toctrees: Setstr = set()
+        self.numbered_toctrees: setstr = set()
 
         # domain-specific inventories, here to be pickled
         # domainname -> domain-specific dict
-        self.domaindata: Dictstr, Dict = {}
+        self.domaindata: dictstr, dict = {}
 
         # these map absolute path -> (docnames, unique filename)
         self.images: FilenameUniqDict = FilenameUniqDict()
@@ -174,36 +225,51 @@
         self.dlfiles: DownloadFiles = DownloadFiles()
 
         # the original URI for images
-        self.original_image_uri: Dictstr, str = {}
+        self.original_image_uri: dictstr, str = {}
 
         # temporary data storage while reading a document
-        self.temp_data: Dictstr, Any = {}
+        self.temp_data: dictstr, Any = {}
         # context for cross-references (e.g. current module or class)
         # this is similar to temp_data, but will for example be copied to
         # attributes of "any" cross references
-        self.ref_context: Dictstr, Any = {}
+        self.ref_context: dictstr, Any = {}
+
+        # search index data
+
+        # docname -> title
+        self._search_index_titles: dictstr, str = {}
+        # docname -> filename
+        self._search_index_filenames: dictstr, str = {}
+        # stemmed words -> set(docname)
+        self._search_index_mapping: dictstr, setstr = {}
+        # stemmed words in titles -> set(docname)
+        self._search_index_title_mapping: dictstr, setstr = {}
+        # docname -> all titles in document
+        self._search_index_all_titles: dictstr, listtuplestr, str = {}
+        # docname -> list(index entry)
+        self._search_index_index_entries: dictstr, listtuplestr, str, str = {}
+        # objtype -> index
+        self._search_index_objtypes: dicttuplestr, str, int = {}
+        # objtype index -> (domain, type, objname (localized))
+        self._search_index_objnames: dictint, tuplestr, str, str = {}
 
         # set up environment
-        if app:
-            self.setup(app)
-        else:
-            warnings.warn("The 'app' argument for BuildEnvironment() becomes required now.",
-                          RemovedInSphinx60Warning, stacklevel=2)
+        self.setup(app)
 
-    def __getstate__(self) -> Dict:
+    def __getstate__(self) -> dict:
         """Obtains serializable data for pickling."""
         __dict__ = self.__dict__.copy()
         __dict__.update(app=None, domains={}, events=None)  # clear unpickable attributes
         return __dict__
 
-    def __setstate__(self, state: Dict) -> None:
+    def __setstate__(self, state: dict) -> None:
         self.__dict__.update(state)
 
-    def setup(self, app: "Sphinx") -> None:
+    def setup(self, app: Sphinx) -> None:
         """Set up BuildEnvironment object."""
         if self.version and self.version != app.registry.get_envversion(app):
             raise BuildEnvironmentError(__('build environment version not current'))
-        elif self.srcdir and self.srcdir != app.srcdir:
+        if self.srcdir and self.srcdir != app.srcdir:
             raise BuildEnvironmentError(__('source directory has changed'))
 
         if self.project:
@@ -217,7 +283,7 @@
         self.version = app.registry.get_envversion(app)
 
         # initialize domains
-        self.domains = {}
+        self.domains = _DomainsType()
         for domain in app.registry.create_domains(self):
             self.domainsdomain.name = domain
 
@@ -245,14 +311,14 @@
                 extension = extensions0
             else:
                 extension = '%d' % (len(extensions),)
-            self.config_status_extra = ' (%r)' % (extension,)
+            self.config_status_extra = f' ({extension!r})'
         else:
             # check if a config value was changed that affects how
             # doctrees are read
             for item in config.filter('env'):
                 if self.configitem.name != item.value:
                     self.config_status = CONFIG_CHANGED
-                    self.config_status_extra = ' (%r)' % (item.name,)
+                    self.config_status_extra = f' ({item.name!r})'
                     break
 
         self.config = config
@@ -261,12 +327,12 @@
         """Update settings by new config."""
         self.settings'input_encoding' = config.source_encoding
         self.settings'trim_footnote_reference_space' = config.trim_footnote_reference_space
-        self.settings'language_code' = config.language or 'en'
+        self.settings'language_code' = config.language
 
         # Allow to disable by 3rd party extension (workaround)
         self.settings.setdefault('smart_quotes', True)
 
-    def set_versioning_method(self, method: Unionstr, Callable, compare: bool) -> None:
+    def set_versioning_method(self, method: str | Callable, compare: bool) -> None:
         """This sets the doctree versioning method for this environment.
 
         Versioning methods are a builder property; only builders with the same
@@ -274,7 +340,7 @@
         raise an exception if the user tries to use an environment with an
         incompatible versioning method.
         """
-        condition: Unionbool, Callable
+        condition: bool | Callable
         if callable(method):
             condition = method
         else:
@@ -299,8 +365,8 @@
         for domain in self.domains.values():
             domain.clear_doc(docname)
 
-    def merge_info_from(self, docnames: Liststr, other: "BuildEnvironment",
-                        app: "Sphinx") -> None:
+    def merge_info_from(self, docnames: liststr, other: BuildEnvironment,
+                        app: Sphinx) -> None:
         """Merge global information gathered about *docnames* while reading them
         from the *other* environment.
 
@@ -317,7 +383,7 @@
             domain.merge_domaindata(docnames, other.domaindatadomainname)
         self.events.emit('env-merge-info', self, docnames, other)
 
-    def path2doc(self, filename: str) -> Optionalstr:
+    def path2doc(self, filename: str) -> str | None:
         """Return the docname for the filename if the file is document.
 
         *filename* should be absolute or relative to the source directory.
@@ -332,7 +398,7 @@
         """
         return self.project.doc2path(docname, base)
 
-    def relfn2path(self, filename: str, docname: str = None) -> Tuplestr, str:
+    def relfn2path(self, filename: str, docname: str | None = None) -> tuplestr, str:
         """Return paths to a file referenced from a document, relative to
         documentation root and absolute.
 
@@ -341,22 +407,22 @@
         containing document.
         """
         filename = os_path(filename)
-        if filename.startswith('/') or filename.startswith(os.sep):
+        if filename.startswith(('/', os.sep)):
             rel_fn = filename1:
         else:
             docdir = path.dirname(self.doc2path(docname or self.docname,
-                                                base=None))
+                                                base=False))
             rel_fn = path.join(docdir, filename)
 
         return (canon_path(path.normpath(rel_fn)),
                 path.normpath(path.join(self.srcdir, rel_fn)))
 
     @property
-    def found_docs(self) -> Setstr:
+    def found_docs(self) -> setstr:
         """contains all existing docnames."""
         return self.project.docnames
 
-    def find_files(self, config: Config, builder: "Builder") -> None:
+    def find_files(self, config: Config, builder: Builder) -> None:
         """Find all source files in the source dir and put them in
         self.found_docs.
         """
@@ -364,7 +430,7 @@
             exclude_paths = (self.config.exclude_patterns +
                              self.config.templates_path +
                              builder.get_asset_paths())
-            self.project.discover(exclude_paths)
+            self.project.discover(exclude_paths, self.config.include_patterns)
 
             # Current implementation is applying translated messages in the reading
             # phase.Therefore, in order to apply the updated message catalog, it is
@@ -385,13 +451,13 @@
             raise DocumentError(__('Failed to scan documents in %s: %r') %
                                 (self.srcdir, exc)) from exc
 
-    def get_outdated_files(self, config_changed: bool) -> TupleSetstr, Setstr, Setstr:
+    def get_outdated_files(self, config_changed: bool) -> tuplesetstr, setstr, setstr:
         """Return (added, changed, removed) sets."""
         # clear all files no longer present
         removed = set(self.all_docs) - self.found_docs
 
-        added: Setstr = set()
-        changed: Setstr = set()
+        added: setstr = set()
+        changed: setstr = set()
 
         if config_changed:
             # config values affect e.g. substitutions
@@ -442,8 +508,8 @@
 
         return added, changed, removed
 
-    def check_dependents(self, app: "Sphinx", already: Setstr) -> Generatorstr, None, None:
-        to_rewrite: Liststr = 
+    def check_dependents(self, app: Sphinx, already: setstr) -> Generatorstr, None, None:
+        to_rewrite: liststr = 
         for docnames in self.events.emit('env-get-updated', self):
             to_rewrite.extend(docnames)
         for docname in set(to_rewrite):
@@ -493,7 +559,9 @@
 
         *filename* should be absolute or relative to the source directory.
         """
-        self.includedself.docname.add(self.path2doc(filename))
+        doc = self.path2doc(filename)
+        if doc:
+            self.includedself.docname.add(doc)
 
     def note_reread(self) -> None:
         """Add the current document to the list of documents that will
@@ -515,21 +583,40 @@
 
     def get_doctree(self, docname: str) -> nodes.document:
         """Read the doctree for a file from the pickle and return it."""
-        filename = path.join(self.doctreedir, docname + '.doctree')
-        with open(filename, 'rb') as f:
-            doctree = pickle.load(f)
+        try:
+            serialised = self._pickled_doctree_cachedocname
+        except KeyError:
+            filename = path.join(self.doctreedir, docname + '.doctree')
+            with open(filename, 'rb') as f:
+                serialised = self._pickled_doctree_cachedocname = f.read()
+
+        doctree = pickle.loads(serialised)
         doctree.settings.env = self
         doctree.reporter = LoggingReporter(self.doc2path(docname))
         return doctree
 
-    def get_and_resolve_doctree(self, docname: str, builder: "Builder",
-                                doctree: nodes.document = None, prune_toctrees: bool = True,
-                                includehidden: bool = False) -> nodes.document:
+    @functools.cached_property
+    def master_doctree(self) -> nodes.document:
+        return self.get_doctree(self.config.root_doc)
+
+    def get_and_resolve_doctree(
+        self,
+        docname: str,
+        builder: Builder,
+        doctree: nodes.document | None = None,
+        prune_toctrees: bool = True,
+        includehidden: bool = False,
+    ) -> nodes.document:
         """Read the doctree from the pickle, resolve cross-references and
         toctrees and return it.
         """
         if doctree is None:
-            doctree = self.get_doctree(docname)
+            try:
+                doctree = self._write_doc_doctree_cache.pop(docname)
+                doctree.settings.env = self
+                doctree.reporter = LoggingReporter(self.doc2path(docname))
+            except KeyError:
+                doctree = self.get_doctree(docname)
 
         # resolve all pending cross-references
         self.apply_post_transforms(doctree, docname)
@@ -546,9 +633,9 @@
 
         return doctree
 
-    def resolve_toctree(self, docname: str, builder: "Builder", toctree: addnodes.toctree,
+    def resolve_toctree(self, docname: str, builder: Builder, toctree: addnodes.toctree,
                         prune: bool = True, maxdepth: int = 0, titles_only: bool = False,
-                        collapse: bool = False, includehidden: bool = False) -> Node:
+                        collapse: bool = False, includehidden: bool = False) -> Node | None:
         """Resolve a *toctree* node into individual bullet lists with titles
         as items, returning None (if no containing titles are found) or
         a new node.
@@ -565,7 +652,7 @@
                                      includehidden)
 
     def resolve_references(self, doctree: nodes.document, fromdocname: str,
-                           builder: "Builder") -> None:
+                           builder: Builder) -> None:
         self.apply_post_transforms(doctree, fromdocname)
 
     def apply_post_transforms(self, doctree: nodes.document, docname: str) -> None:
@@ -585,10 +672,12 @@
         # allow custom references to be resolved
         self.events.emit('doctree-resolved', doctree, docname)
 
-    def collect_relations(self) -> Dictstr, ListOptionalstr:
+    def collect_relations(self) -> dictstr, liststr | None:
         traversed = set()
 
-        def traverse_toctree(parent: str, docname: str) -> IteratorTuplestr, str:
+        def traverse_toctree(
+            parent: str | None, docname: str,
+        ) -> Iteratortuplestr | None, str:
             if parent == docname:
                 logger.warning(__('self referenced toctree found. Ignored.'),
                                location=docname, type='toc',
@@ -632,7 +721,7 @@
                     continue
                 if 'orphan' in self.metadatadocname:
                     continue
-                logger.warning(__('document isn\'t included in any toctree'),
+                logger.warning(__("document isn't included in any toctree"),
                                location=docname)
 
         # call check-consistency for all extensions

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/adapters/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/adapters/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/adapters/asset.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/adapters/asset.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/adapters/indexentries.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/adapters/indexentries.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.environment.adapters.indexentries
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Index entries adapters for sphinx.environment."""
 
-    Index entries adapters for sphinx.environment.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 import unicodedata
 from itertools import groupby
-from typing import Any, Dict, List, Pattern, Tuple, cast
+from typing import Any, cast
 
 from sphinx.builders import Builder
 from sphinx.domains.index import IndexDomain
@@ -28,13 +22,13 @@
         self.env = env
 
     def create_index(self, builder: Builder, group_entries: bool = True,
-                     _fixre: Pattern = re.compile(r'(.*) ((^()*))')
-                     ) -> ListTuplestr, ListTuplestr, Any:
+                     _fixre: re.Pattern = re.compile(r'(.*) ((^()*))'),
+                     ) -> listtuplestr, listtuplestr, Any:
         """Create the real index from the collected index entries."""
-        new: Dictstr, List = {}
+        new: dictstr, list = {}
 
-        def add_entry(word: str, subword: str, main: str, link: bool = True,
-                      dic: Dict = new, key: str = None) -> None:
+        def add_entry(word: str, subword: str, main: str | None, link: bool = True,
+                      dic: dictstr, list = new, key: str | None = None) -> None:
             # Force the word to be unicode if it's a ASCII bytestring.
             # This will solve problems with unicode normalization later.
             # For instance the RFC role will add bytestrings at the moment
@@ -87,7 +81,7 @@
                     logger.warning(str(err), location=fn)
 
         # sort the index entries for same keyword.
-        def keyfunc0(entry: Tuplestr, str) -> Tuplebool, str:
+        def keyfunc0(entry: tuplestr, str) -> tuplebool, str:
             main, uri = entry
             return (not main, uri)  # show main entries at first
 
@@ -97,7 +91,7 @@
                 subentry0.sort(key=keyfunc0)  # type: ignore
 
         # sort the index entries
-        def keyfunc(entry: Tuplestr, List) -> TupleTupleint, str, str:
+        def keyfunc(entry: tuplestr, list) -> tupletupleint, str, str:
             key, (void, void, category_key) = entry
             if category_key:
                 # using specified category key to sort
@@ -126,7 +120,7 @@
             #     (in module foo)
             #     (in module bar)
             oldkey = ''
-            oldsubitems: Dictstr, List = None
+            oldsubitems: dictstr, list | None = None
             i = 0
             while i < len(newlist):
                 key, (targets, subitems, _key) = newlisti
@@ -148,7 +142,7 @@
                 i += 1
 
         # sort the sub-index entries
-        def keyfunc2(entry: Tuplestr, List) -> str:
+        def keyfunc2(entry: tuplestr, list) -> str:
             key = unicodedata.normalize('NFD', entry0.lower())
             if key.startswith('\N{RIGHT-TO-LEFT MARK}'):
                 key = key1:
@@ -157,7 +151,7 @@
             return key
 
         # group the entries by letter
-        def keyfunc3(item: Tuplestr, List) -> str:
+        def keyfunc3(item: tuplestr, list) -> str:
             # hack: mutating the subitems dicts to a list in the keyfunc
             k, v = item
             v1 = sorted(((si, se) for (si, (se, void, void)) in v1.items()),

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/adapters/toctree.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/adapters/toctree.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.environment.adapters.toctree
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Toctree adapter for sphinx.environment."""
 
-    Toctree adapter for sphinx.environment.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Iterable, List, Optional, cast
+from typing import TYPE_CHECKING, Any, Iterable, TypeVar, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -28,7 +22,7 @@
 
 
 class TocTree:
-    def __init__(self, env: "BuildEnvironment") -> None:
+    def __init__(self, env: BuildEnvironment) -> None:
         self.env = env
 
     def note(self, docname: str, toctreenode: addnodes.toctree) -> None:
@@ -46,9 +40,9 @@
             self.env.files_to_rebuild.setdefault(includefile, set()).add(docname)
         self.env.toctree_includes.setdefault(docname, ).extend(includefiles)
 
-    def resolve(self, docname: str, builder: "Builder", toctree: addnodes.toctree,
+    def resolve(self, docname: str, builder: Builder, toctree: addnodes.toctree,
                 prune: bool = True, maxdepth: int = 0, titles_only: bool = False,
-                collapse: bool = False, includehidden: bool = False) -> OptionalElement:
+                collapse: bool = False, includehidden: bool = False) -> Element | None:
         """Resolve a *toctree* node into individual bullet lists with titles
         as items, returning None (if no containing titles are found) or
         a new node.
@@ -62,6 +56,7 @@
         """
         if toctree.get('hidden', False) and not includehidden:
             return None
+        generated_docnames: dictstr, tuplestr, str = self.env.domains'std'._virtual_doc_names.copy()  # NoQA: E501
 
         # For reading the following two helper function, it is useful to keep
         # in mind the node structure of a toctree (using HTML-like node names
@@ -82,6 +77,7 @@
         # interactions between marking and pruning the tree (see bug #1046).
 
         toctree_ancestors = self.get_toctree_ancestors(docname)
+        included = Matcher(self.env.config.include_patterns)
         excluded = Matcher(self.env.config.exclude_patterns)
 
         def _toctree_add_classes(node: Element, depth: int) -> None:
@@ -90,7 +86,7 @@
                 if isinstance(subnode, (addnodes.compact_paragraph,
                                         nodes.list_item)):
                     # for <p> and <li>, indicate the depth level and recurse
-                    subnode'classes'.append('toctree-l%d' % (depth - 1))
+                    subnode'classes'.append(f'toctree-l{depth - 1}')
                     _toctree_add_classes(subnode, depth)
                 elif isinstance(subnode, nodes.bullet_list):
                     # for <ul>, just recurse
@@ -114,12 +110,11 @@
                             subnode'iscurrent' = True
                             subnode = subnode.parent
 
-        def _entries_from_toctree(toctreenode: addnodes.toctree, parents: Liststr,
-                                  separate: bool = False, subtree: bool = False
-                                  ) -> ListElement:
+        def _entries_from_toctree(toctreenode: addnodes.toctree, parents: liststr,
+                                  subtree: bool = False) -> listElement:
             """Return TOC entries for a toctree node."""
             refs = (e0, e1) for e in toctreenode'entries'
-            entries: ListElement = 
+            entries: listElement = 
             for (title, ref) in refs:
                 try:
                     refdoc = None
@@ -146,6 +141,16 @@
                         item = nodes.list_item('', para)
                         # don't show subitems
                         toc = nodes.bullet_list('', item)
+                    elif ref in generated_docnames:
+                        docname, sectionname = generated_docnamesref
+                        if not title:
+                            title = sectionname
+                        reference = nodes.reference('', title, internal=True,
+                                                    refuri=docname, anchorname='')
+                        para = addnodes.compact_paragraph('', '', reference)
+                        item = nodes.list_item('', para)
+                        # don't show subitems
+                        toc = nodes.bullet_list('', item)
                     else:
                         if ref in parents:
                             logger.warning(__('circular toctree references '
@@ -154,10 +159,12 @@
                                            location=ref, type='toc', subtype='circular')
                             continue
                         refdoc = ref
-                        toc = self.env.tocsref.deepcopy()
                         maxdepth = self.env.metadataref.get('tocdepth', 0)
+                        toc = self.env.tocsref
                         if ref not in toctree_ancestors or (prune and maxdepth > 0):
-                            self._toctree_prune(toc, 2, maxdepth, collapse)
+                            toc = self._toctree_copy(toc, 2, maxdepth, collapse)
+                        else:
+                            toc = toc.deepcopy()
                         process_only_nodes(toc, builder.tags)
                         if title and toc.children and len(toc.children) == 1:
                             child = toc.children0
@@ -168,26 +175,28 @@
                     if not toc.children:
                         # empty toc means: no titles will show up in the toctree
                         logger.warning(__('toctree contains reference to document %r that '
-                                          'doesn\'t have a title: no link will be generated'),
+                                          "doesn't have a title: no link will be generated"),
                                        ref, location=toctreenode)
                 except KeyError:
                     # this is raised if the included file does not exist
-                    if excluded(self.env.doc2path(ref, None)):
+                    if excluded(self.env.doc2path(ref, False)):
                         message = __('toctree contains reference to excluded document %r')
+                    elif not included(self.env.doc2path(ref, False)):
+                        message = __('toctree contains reference to non-included document %r')
                     else:
                         message = __('toctree contains reference to nonexisting document %r')
 
                     logger.warning(message, ref, location=toctreenode)
                 else:
+                    # children of toc are:
+                    # - list_item + compact_paragraph + (reference and subtoc)
+                    # - only + subtoc
+                    # - toctree
+                    children = cast(Iterablenodes.Element, toc)
+
                     # if titles_only is given, only keep the main title and
                     # sub-toctrees
                     if titles_only:
-                        # children of toc are:
-                        # - list_item + compact_paragraph + (reference and subtoc)
-                        # - only + subtoc
-                        # - toctree
-                        children = cast(Iterablenodes.Element, toc)
-
                         # delete everything but the toplevel title(s)
                         # and toctrees
                         for toplevel in children:
@@ -199,22 +208,19 @@
                                 else:
                                     toplevel.pop(1)
                     # resolve all sub-toctrees
-                    for subtocnode in list(toc.findall(addnodes.toctree)):
-                        if not (subtocnode.get('hidden', False) and
-                                not includehidden):
-                            i = subtocnode.parent.index(subtocnode) + 1
-                            for entry in _entries_from_toctree(
-                                    subtocnode, refdoc + parents,
-                                    subtree=True):
-                                subtocnode.parent.insert(i, entry)
-                                i += 1
-                            subtocnode.parent.remove(subtocnode)
-                    if separate:
-                        entries.append(toc)
-                    else:
-                        children = cast(Iterablenodes.Element, toc)
-                        entries.extend(children)
-            if not subtree and not separate:
+                    for sub_toc_node in list(toc.findall(addnodes.toctree)):
+                        if sub_toc_node.get('hidden', False) and not includehidden:
+                            continue
+                        for i, entry in enumerate(
+                            _entries_from_toctree(sub_toc_node, refdoc + parents,
+                                                  subtree=True),
+                            start=sub_toc_node.parent.index(sub_toc_node) + 1,
+                        ):
+                            sub_toc_node.parent.insert(i, entry)
+                        sub_toc_node.parent.remove(sub_toc_node)
+
+                    entries.extend(children)
+            if not subtree:
                 ret = nodes.bullet_list()
                 ret += entries
                 return ret
@@ -226,10 +232,7 @@
         if not includehidden and toctree.get('includehidden', False):
             includehidden = True
 
-        # NOTE: previously, this was separate=True, but that leads to artificial
-        # separation when two or more toctree entries form a logical unit, so
-        # separating mode is no longer used -- it's kept here for history's sake
-        tocentries = _entries_from_toctree(toctree, , separate=False)
+        tocentries = _entries_from_toctree(toctree, )
         if not tocentries:
             return None
 
@@ -243,14 +246,14 @@
             if hasattr(toctree, 'uid'):
                 # move uid to caption_node to translate it
                 caption_node.uid = toctree.uid  # type: ignore
-                del toctree.uid  # type: ignore
+                del toctree.uid
             newnode += caption_node
         newnode.extend(tocentries)
         newnode'toctree' = True
 
         # prune the tree to maxdepth, also set toc depth and current classes
         _toctree_add_classes(newnode, 1)
-        self._toctree_prune(newnode, 1, maxdepth if prune else 0, collapse)
+        newnode = self._toctree_copy(newnode, 1, maxdepth if prune else 0, collapse)
 
         if isinstance(newnode-1, nodes.Element) and len(newnode-1) == 0:  # No titles found
             return None
@@ -263,46 +266,47 @@
                     docname, refnode'refuri') + refnode'anchorname'
         return newnode
 
-    def get_toctree_ancestors(self, docname: str) -> Liststr:
+    def get_toctree_ancestors(self, docname: str) -> liststr:
         parent = {}
         for p, children in self.env.toctree_includes.items():
             for child in children:
                 parentchild = p
-        ancestors: Liststr = 
+        ancestors: liststr = 
         d = docname
         while d in parent and d not in ancestors:
             ancestors.append(d)
             d = parentd
         return ancestors
 
-    def _toctree_prune(self, node: Element, depth: int, maxdepth: int, collapse: bool = False
-                       ) -> None:
-        """Utility: Cut a TOC at a specified depth."""
-        for subnode in node.children::
-            if isinstance(subnode, (addnodes.compact_paragraph,
-                                    nodes.list_item)):
+    ET = TypeVar('ET', bound=Element)
+
+    def _toctree_copy(self, node: ET, depth: int, maxdepth: int, collapse: bool) -> ET:
+        """Utility: Cut and deep-copy a TOC at a specified depth."""
+        keep_bullet_list_sub_nodes = (depth <= 1
+                                      or ((depth <= maxdepth or maxdepth <= 0)
+                                          and (not collapse or 'iscurrent' in node)))
+
+        copy = node.copy()
+        for subnode in node.children:
+            if isinstance(subnode, (addnodes.compact_paragraph, nodes.list_item)):
                 # for <p> and <li>, just recurse
-                self._toctree_prune(subnode, depth, maxdepth, collapse)
+                copy.append(self._toctree_copy(subnode, depth, maxdepth, collapse))
             elif isinstance(subnode, nodes.bullet_list):
-                # for <ul>, determine if the depth is too large or if the
-                # entry is to be collapsed
-                if maxdepth > 0 and depth > maxdepth:
-                    subnode.parent.replace(subnode, )
-                else:
-                    # cull sub-entries whose parents aren't 'current'
-                    if (collapse and depth > 1 and
-                            'iscurrent' not in subnode.parent):
-                        subnode.parent.remove(subnode)
-                    else:
-                        # recurse on visible children
-                        self._toctree_prune(subnode, depth + 1, maxdepth,  collapse)
+                # for <ul>, copy if the entry is top-level
+                # or, copy if the depth is within bounds and;
+                # collapsing is disabled or the sub-entry's parent is 'current'.
+                # The boolean is constant so is calculated outwith the loop.
+                if keep_bullet_list_sub_nodes:
+                    copy.append(self._toctree_copy(subnode, depth + 1, maxdepth, collapse))
+            else:
+                copy.append(subnode.deepcopy())
+        return copy
 
-    def get_toc_for(self, docname: str, builder: "Builder") -> Node:
+    def get_toc_for(self, docname: str, builder: Builder) -> Node:
         """Return a TOC nodetree -- for use on the same page only!"""
         tocdepth = self.env.metadatadocname.get('tocdepth', 0)
         try:
-            toc = self.env.tocsdocname.deepcopy()
-            self._toctree_prune(toc, 2, tocdepth)
+            toc = self._toctree_copy(self.env.tocsdocname, 2, tocdepth, False)
         except KeyError:
             # the document does not exist anymore: return a dummy node that
             # renders to nothing
@@ -312,11 +316,11 @@
             node'refuri' = node'anchorname' or '#'
         return toc
 
-    def get_toctree_for(self, docname: str, builder: "Builder", collapse: bool,
-                        **kwargs: Any) -> OptionalElement:
+    def get_toctree_for(self, docname: str, builder: Builder, collapse: bool,
+                        **kwargs: Any) -> Element | None:
         """Return the global TOC nodetree."""
-        doctree = self.env.get_doctree(self.env.config.root_doc)
-        toctrees: ListElement = 
+        doctree = self.env.master_doctree
+        toctrees: listElement = 
         if 'includehidden' not in kwargs:
             kwargs'includehidden' = True
         if 'maxdepth' not in kwargs or not kwargs'maxdepth':

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/collectors/__init__.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.environment.collectors
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The data collector components for sphinx.environment."""
 
-    The data collector components for sphinx.environment.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Dict, List, Optional, Set
+from typing import TYPE_CHECKING
 
 from docutils import nodes
 
@@ -27,9 +21,9 @@
     entries and toctrees, etc.
     """
 
-    listener_ids: OptionalDictstr, int = None
+    listener_ids: dictstr, int | None = None
 
-    def enable(self, app: "Sphinx") -> None:
+    def enable(self, app: Sphinx) -> None:
         assert self.listener_ids is None
         self.listener_ids = {
             'doctree-read':     app.connect('doctree-read', self.process_doc),
@@ -39,39 +33,39 @@
             'env-get-outdated': app.connect('env-get-outdated', self.get_outdated_docs),
         }
 
-    def disable(self, app: "Sphinx") -> None:
+    def disable(self, app: Sphinx) -> None:
         assert self.listener_ids is not None
         for listener_id in self.listener_ids.values():
             app.disconnect(listener_id)
         self.listener_ids = None
 
-    def clear_doc(self, app: "Sphinx", env: BuildEnvironment, docname: str) -> None:
+    def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None:
         """Remove specified data of a document.
 
         This method is called on the removal of the document."""
         raise NotImplementedError
 
-    def merge_other(self, app: "Sphinx", env: BuildEnvironment,
-                    docnames: Setstr, other: BuildEnvironment) -> None:
+    def merge_other(self, app: Sphinx, env: BuildEnvironment,
+                    docnames: setstr, other: BuildEnvironment) -> None:
         """Merge in specified data regarding docnames from a different `BuildEnvironment`
         object which coming from a subprocess in parallel builds."""
         raise NotImplementedError
 
-    def process_doc(self, app: "Sphinx", doctree: nodes.document) -> None:
+    def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
         """Process a document and gather specific data from it.
 
         This method is called after the document is read."""
         raise NotImplementedError
 
-    def get_updated_docs(self, app: "Sphinx", env: BuildEnvironment) -> Liststr:
+    def get_updated_docs(self, app: Sphinx, env: BuildEnvironment) -> liststr:
         """Return a list of docnames to re-read.
 
         This methods is called after reading the whole of documents (experimental).
         """
         return 
 
-    def get_outdated_docs(self, app: "Sphinx", env: BuildEnvironment,
-                          added: Setstr, changed: Setstr, removed: Setstr) -> Liststr:
+    def get_outdated_docs(self, app: Sphinx, env: BuildEnvironment,
+                          added: setstr, changed: setstr, removed: setstr) -> liststr:
         """Return a list of docnames to re-read.
 
         This methods is called before reading the documents.

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors/asset.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/collectors/asset.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.environment.collectors.asset
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The image collector for sphinx.environment."""
 
-    The image collector for sphinx.environment.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 from glob import glob
 from os import path
-from typing import Any, Dict, List, Set
+from typing import Any
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -36,7 +30,7 @@
         env.images.purge_doc(docname)
 
     def merge_other(self, app: Sphinx, env: BuildEnvironment,
-                    docnames: Setstr, other: BuildEnvironment) -> None:
+                    docnames: setstr, other: BuildEnvironment) -> None:
         env.images.merge_other(docnames, other.images)
 
     def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
@@ -48,13 +42,13 @@
             # choose the best image from these candidates.  The special key * is
             # set if there is only single candidate to be used by a writer.
             # The special key ? is set for nonlocal URIs.
-            candidates: Dictstr, str = {}
+            candidates: dictstr, str = {}
             node'candidates' = candidates
             imguri = node'uri'
             if imguri.startswith('data:'):
                 candidates'?' = imguri
                 continue
-            elif imguri.find('://') != -1:
+            if imguri.find('://') != -1:
                 candidates'?' = imguri
                 continue
 
@@ -64,18 +58,16 @@
                 rel_imgpath, full_imgpath = app.env.relfn2path(imguri, docname)
                 node'uri' = rel_imgpath
 
-                if app.config.language:
-                    # Search language-specific figures at first
-                    i18n_imguri = get_image_filename_for_language(imguri, app.env)
-                    _, full_i18n_imgpath = app.env.relfn2path(i18n_imguri, docname)
-                    self.collect_candidates(app.env, full_i18n_imgpath, candidates, node)
+                # Search language-specific figures at first
+                i18n_imguri = get_image_filename_for_language(imguri, app.env)
+                _, full_i18n_imgpath = app.env.relfn2path(i18n_imguri, docname)
+                self.collect_candidates(app.env, full_i18n_imgpath, candidates, node)
 
                 self.collect_candidates(app.env, full_imgpath, candidates, node)
             else:
-                if app.config.language:
-                    # substitute imguri by figure_language_filename
-                    # (ex. foo.png -> foo.en.png)
-                    imguri = search_image_for_language(imguri, app.env)
+                # substitute imguri by figure_language_filename
+                # (ex. foo.png -> foo.en.png)
+                imguri = search_image_for_language(imguri, app.env)
 
                 # Update `node'uri'` to a relative path from srcdir
                 # from a relative path from current document.
@@ -93,8 +85,8 @@
                 app.env.images.add_file(docname, imgpath)
 
     def collect_candidates(self, env: BuildEnvironment, imgpath: str,
-                           candidates: Dictstr, str, node: Node) -> None:
-        globbed: Dictstr, Liststr = {}
+                           candidates: dictstr, str, node: Node) -> None:
+        globbed: dictstr, liststr = {}
         for filename in glob(imgpath):
             new_imgpath = relative_path(path.join(env.srcdir, 'dummy'),
                                         filename)
@@ -119,7 +111,7 @@
         env.dlfiles.purge_doc(docname)
 
     def merge_other(self, app: Sphinx, env: BuildEnvironment,
-                    docnames: Setstr, other: BuildEnvironment) -> None:
+                    docnames: setstr, other: BuildEnvironment) -> None:
         env.dlfiles.merge_other(docnames, other.dlfiles)
 
     def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
@@ -138,7 +130,7 @@
                 node'filename' = app.env.dlfiles.add_file(app.env.docname, rel_filename)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_env_collector(ImageCollector)
     app.add_env_collector(DownloadFileCollector)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors/dependencies.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/collectors/dependencies.py Changed

@@ -1,16 +1,10 @@
-"""
-    sphinx.environment.collectors.dependencies
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The dependencies collector components for sphinx.environment."""
 
-    The dependencies collector components for sphinx.environment.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 from os import path
-from typing import Any, Dict, Set
+from typing import Any
 
 from docutils import nodes
 from docutils.utils import relative_path
@@ -28,7 +22,7 @@
         env.dependencies.pop(docname, None)
 
     def merge_other(self, app: Sphinx, env: BuildEnvironment,
-                    docnames: Setstr, other: BuildEnvironment) -> None:
+                    docnames: setstr, other: BuildEnvironment) -> None:
         for docname in docnames:
             if docname in other.dependencies:
                 env.dependenciesdocname = other.dependenciesdocname
@@ -50,7 +44,7 @@
             app.env.dependenciesapp.env.docname.add(relpath)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_env_collector(DependenciesCollector)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors/metadata.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/collectors/metadata.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.environment.collectors.metadata
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The metadata collector components for sphinx.environment."""
 
-    The metadata collector components for sphinx.environment.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, List, Set, cast
+from typing import Any, List, cast
 
 from docutils import nodes
 
@@ -24,7 +18,7 @@
         env.metadata.pop(docname, None)
 
     def merge_other(self, app: Sphinx, env: BuildEnvironment,
-                    docnames: Setstr, other: BuildEnvironment) -> None:
+                    docnames: setstr, other: BuildEnvironment) -> None:
         for docname in docnames:
             env.metadatadocname = other.metadatadocname
 
@@ -50,7 +44,7 @@
                     mdfield_name.astext() = field_body.astext()
                 elif isinstance(node, nodes.TextElement):
                     # other children must be TextElement
-                    # see: https://docutils.sourceforge.io/docs/ref/doctree.html#bibliographic-elements  # NOQA
+                    # see: https://docutils.sourceforge.io/docs/ref/doctree.html#bibliographic-elements  # noqa: E501
                     mdnode.__class__.__name__ = node.astext()
 
             for name, value in md.items():
@@ -64,7 +58,7 @@
             doctree.pop(index)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_env_collector(MetadataCollector)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors/title.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/collectors/title.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.environment.collectors.title
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""The title collector components for sphinx.environment."""
 
-    The title collector components for sphinx.environment.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, Set
+from typing import Any
 
 from docutils import nodes
 
@@ -26,7 +20,7 @@
         env.longtitles.pop(docname, None)
 
     def merge_other(self, app: Sphinx, env: BuildEnvironment,
-                    docnames: Setstr, other: BuildEnvironment) -> None:
+                    docnames: setstr, other: BuildEnvironment) -> None:
         for docname in docnames:
             env.titlesdocname = other.titlesdocname
             env.longtitlesdocname = other.longtitlesdocname
@@ -55,7 +49,7 @@
         app.env.longtitlesapp.env.docname = longtitlenode
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_env_collector(TitleCollector)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/environment/collectors/toctree.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/environment/collectors/toctree.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.environment.collectors.toctree
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Toctree collector for sphinx.environment."""
 
-    Toctree collector for sphinx.environment.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, List, Set, Tuple, Type, TypeVar, cast
+from typing import Any, Sequence, TypeVar, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -42,7 +36,7 @@
             if not fnset:
                 del env.files_to_rebuildsubfn
 
-    def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Setstr,
+    def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: setstr,
                     other: BuildEnvironment) -> None:
         for docname in docnames:
             env.tocsdocname = other.tocsdocname
@@ -62,20 +56,14 @@
         docname = app.env.docname
         numentries = 0  # nonlocal again...
 
-        def traverse_in_section(node: Element, cls: TypeN) -> ListN:
-            """Like traverse(), but stay within the same section."""
-            result: ListN = 
-            if isinstance(node, cls):
-                result.append(node)
-            for child in node.children:
-                if isinstance(child, nodes.section):
-                    continue
-                elif isinstance(child, nodes.Element):
-                    result.extend(traverse_in_section(child, cls))
-            return result
-
-        def build_toc(node: Element, depth: int = 1) -> nodes.bullet_list:
-            entries: ListElement = 
+        def build_toc(
+            node: Element | SequenceElement,
+            depth: int = 1,
+        ) -> nodes.bullet_list | None:
+            # list of table of contents entries
+            entries: listElement = 
+            # cache of parents -> list item
+            memo_parents: dicttuplestr, ..., nodes.list_item = {}
             for sectionnode in node:
                 # find all toctree nodes in this section and add them
                 # to the toc (just copying the toctree node which is then
@@ -87,13 +75,7 @@
                     visitor = SphinxContentsFilter(doctree)
                     title.walkabout(visitor)
                     nodetext = visitor.get_entry_text()
-                    if not numentries0:
-                        # for the very first toc entry, don't add an anchor
-                        # as it is the file's title anyway
-                        anchorname = ''
-                    else:
-                        anchorname = '#' + sectionnode'ids'0
-                    numentries0 += 1
+                    anchorname = _make_anchor_name(sectionnode'ids', numentries)
                     # make these nodes:
                     # list_item -> compact_paragraph -> reference
                     reference = nodes.reference(
@@ -105,22 +87,70 @@
                     if sub_item:
                         item += sub_item
                     entries.append(item)
+                # Wrap items under an ``.. only::`` directive in a node for
+                # post-processing
                 elif isinstance(sectionnode, addnodes.only):
                     onlynode = addnodes.only(expr=sectionnode'expr')
                     blist = build_toc(sectionnode, depth)
                     if blist:
                         onlynode += blist.children
                         entries.append(onlynode)
+                # check within the section for other node types
                 elif isinstance(sectionnode, nodes.Element):
-                    for toctreenode in traverse_in_section(sectionnode,
-                                                           addnodes.toctree):
-                        item = toctreenode.copy()
-                        entries.append(item)
-                        # important: do the inventory stuff
-                        TocTree(app.env).note(docname, toctreenode)
+                    toctreenode: nodes.Node
+                    for toctreenode in sectionnode.findall():
+                        if isinstance(toctreenode, nodes.section):
+                            continue
+                        if isinstance(toctreenode, addnodes.toctree):
+                            item = toctreenode.copy()
+                            entries.append(item)
+                            # important: do the inventory stuff
+                            TocTree(app.env).note(docname, toctreenode)
+                        # add object signatures within a section to the ToC
+                        elif isinstance(toctreenode, addnodes.desc):
+                            for sig_node in toctreenode:
+                                if not isinstance(sig_node, addnodes.desc_signature):
+                                    continue
+                                # Skip if no name set
+                                if not sig_node.get('_toc_name', ''):
+                                    continue
+                                # Skip if explicitly disabled
+                                if sig_node.parent.get('nocontentsentry'):
+                                    continue
+                                # Skip entries with no ID (e.g. with :noindex: set)
+                                ids = sig_node'ids'
+                                if not ids:
+                                    continue
+
+                                anchorname = _make_anchor_name(ids, numentries)
+
+                                reference = nodes.reference(
+                                    '', '', nodes.literal('', sig_node'_toc_name'),
+                                    internal=True, refuri=docname, anchorname=anchorname)
+                                para = addnodes.compact_paragraph('', '', reference,
+                                                                  skip_section_number=True)
+                                entry = nodes.list_item('', para)
+                                *parents, _ = sig_node'_toc_parts'
+                                parents = tuple(parents)
+
+                                # Cache parents tuple
+                                memo_parentssig_node'_toc_parts' = entry
+
+                                # Nest children within parents
+                                if parents and parents in memo_parents:
+                                    root_entry = memo_parentsparents
+                                    if isinstance(root_entry-1, nodes.bullet_list):
+                                        root_entry-1.append(entry)
+                                    else:
+                                        root_entry.append(nodes.bullet_list('', entry))
+                                    continue
+
+                                entries.append(entry)
+
             if entries:
                 return nodes.bullet_list('', *entries)
             return None
+
         toc = build_toc(doctree)
         if toc:
             app.env.tocsdocname = toc
@@ -128,19 +158,21 @@
             app.env.tocsdocname = nodes.bullet_list('')
         app.env.toc_num_entriesdocname = numentries0
 
-    def get_updated_docs(self, app: Sphinx, env: BuildEnvironment) -> Liststr:
+    def get_updated_docs(self, app: Sphinx, env: BuildEnvironment) -> liststr:
         return self.assign_section_numbers(env) + self.assign_figure_numbers(env)
 
-    def assign_section_numbers(self, env: BuildEnvironment) -> Liststr:
+    def assign_section_numbers(self, env: BuildEnvironment) -> liststr:
         """Assign a section number to each heading under a numbered toctree."""
         # a list of all docnames whose section numbers changed
         rewrite_needed = 
 
-        assigned: Setstr = set()
+        assigned: setstr = set()
         old_secnumbers = env.toc_secnumbers
         env.toc_secnumbers = {}
 
-        def _walk_toc(node: Element, secnums: Dict, depth: int, titlenode: nodes.title = None) -> None:  # NOQA
+        def _walk_toc(
+            node: Element, secnums: dict, depth: int, titlenode: nodes.title | None = None,
+        ) -> None:
             # titlenode is the title of the document, it will get assigned a
             # secnumber too, so that it shows up in next/prev/parent rellinks
             for subnode in node.children:
@@ -149,7 +181,7 @@
                     _walk_toc(subnode, secnums, depth - 1, titlenode)
                     numstack.pop()
                     titlenode = None
-                elif isinstance(subnode, nodes.list_item):
+                elif isinstance(subnode, nodes.list_item):  # NoQA: SIM114
                     _walk_toc(subnode, secnums, depth, titlenode)
                     titlenode = None
                 elif isinstance(subnode, addnodes.only):
@@ -159,6 +191,8 @@
                     _walk_toc(subnode, secnums, depth, titlenode)
                     titlenode = None
                 elif isinstance(subnode, addnodes.compact_paragraph):
+                    if 'skip_section_number' in subnode:
+                        continue
                     numstack-1 += 1
                     reference = cast(nodes.reference, subnode0)
                     if depth > 0:
@@ -181,12 +215,12 @@
                 if url_re.match(ref) or ref == 'self':
                     # don't mess with those
                     continue
-                elif ref in assigned:
+                if ref in assigned:
                     logger.warning(__('%s is already assigned section numbers '
                                       '(nested numbered toctree?)'), ref,
                                    location=toctreenode, type='toc', subtype='secnum')
                 elif ref in env.tocs:
-                    secnums: Dictstr, Tupleint, ... = {}
+                    secnums: dictstr, tupleint, ... = {}
                     env.toc_secnumbersref = secnums
                     assigned.add(ref)
                     _walk_toc(env.tocsref, secnums, depth, env.titles.get(ref))
@@ -205,20 +239,22 @@
 
         return rewrite_needed
 
-    def assign_figure_numbers(self, env: BuildEnvironment) -> Liststr:
+    def assign_figure_numbers(self, env: BuildEnvironment) -> liststr:
         """Assign a figure number to each figure under a numbered toctree."""
+        generated_docnames = frozenset(env.domains'std'._virtual_doc_names)
 
         rewrite_needed = 
 
-        assigned: Setstr = set()
+        assigned: setstr = set()
         old_fignumbers = env.toc_fignumbers
         env.toc_fignumbers = {}
-        fignum_counter: Dictstr, DictTupleint, ..., int = {}
+        fignum_counter: dictstr, dicttupleint, ..., int = {}
 
-        def get_figtype(node: Node) -> str:
+        def get_figtype(node: Node) -> str | None:
             for domain in env.domains.values():
                 figtype = domain.get_enumerable_node_type(node)
-                if domain.name == 'std' and not domain.get_numfig_title(node):  # type: ignore
+                if (domain.name == 'std'
+                        and not domain.get_numfig_title(node)):  # type: ignoreattr-defined  # NoQA: E501
                     # Skip if uncaptioned node
                     continue
 
@@ -227,7 +263,7 @@
 
             return None
 
-        def get_section_number(docname: str, section: nodes.section) -> Tupleint, ...:
+        def get_section_number(docname: str, section: nodes.section) -> tupleint, ...:
             anchorname = '#' + section'ids'0
             secnumbers = env.toc_secnumbers.get(docname, {})
             if anchorname in secnumbers:
@@ -235,16 +271,16 @@
             else:
                 secnum = secnumbers.get('')
 
-            return secnum or tuple()
+            return secnum or ()
 
-        def get_next_fignumber(figtype: str, secnum: Tupleint, ...) -> Tupleint, ...:
+        def get_next_fignumber(figtype: str, secnum: tupleint, ...) -> tupleint, ...:
             counter = fignum_counter.setdefault(figtype, {})
 
             secnum = secnum:env.config.numfig_secnum_depth
             countersecnum = counter.get(secnum, 0) + 1
             return secnum + (countersecnum,)
 
-        def register_fignumber(docname: str, secnum: Tupleint, ...,
+        def register_fignumber(docname: str, secnum: tupleint, ...,
                                figtype: str, fignode: Element) -> None:
             env.toc_fignumbers.setdefault(docname, {})
             fignumbers = env.toc_fignumbersdocname.setdefault(figtype, {})
@@ -252,7 +288,8 @@
 
             fignumbersfigure_id = get_next_fignumber(figtype, secnum)
 
-        def _walk_doctree(docname: str, doctree: Element, secnum: Tupleint, ...) -> None:
+        def _walk_doctree(docname: str, doctree: Element, secnum: tupleint, ...) -> None:
+            nonlocal generated_docnames
             for subnode in doctree.children:
                 if isinstance(subnode, nodes.section):
                     next_secnum = get_section_number(docname, subnode)
@@ -265,6 +302,9 @@
                         if url_re.match(subdocname) or subdocname == 'self':
                             # don't mess with those
                             continue
+                        if subdocname in generated_docnames:
+                            # or these
+                            continue
 
                         _walk_doc(subdocname, secnum)
                 elif isinstance(subnode, nodes.Element):
@@ -274,14 +314,14 @@
 
                     _walk_doctree(docname, subnode, secnum)
 
-        def _walk_doc(docname: str, secnum: Tupleint, ...) -> None:
+        def _walk_doc(docname: str, secnum: tupleint, ...) -> None:
             if docname not in assigned:
                 assigned.add(docname)
                 doctree = env.get_doctree(docname)
                 _walk_doctree(docname, doctree, secnum)
 
         if env.config.numfig:
-            _walk_doc(env.config.root_doc, tuple())
+            _walk_doc(env.config.root_doc, ())
             for docname, fignums in env.toc_fignumbers.items():
                 if fignums != old_fignumbers.get(docname):
                     rewrite_needed.append(docname)
@@ -289,7 +329,18 @@
         return rewrite_needed
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def _make_anchor_name(ids: liststr, num_entries: listint) -> str:
+    if not num_entries0:
+        # for the very first toc entry, don't add an anchor
+        # as it is the file's title anyway
+        anchorname = ''
+    else:
+        anchorname = '#' + ids0
+    num_entries0 += 1
+    return anchorname
+
+
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_env_collector(TocTreeCollector)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/errors.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/errors.py Changed

@@ -1,13 +1,6 @@
-"""
-    sphinx.errors
-    ~~~~~~~~~~~~~
+"""Contains SphinxError and a few subclasses."""
 
-    Contains SphinxError and a few subclasses (in an extra module to avoid
-    circular import problems).
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from typing import Any
 
@@ -48,7 +41,9 @@
 class ExtensionError(SphinxError):
     """Extension error."""
 
-    def __init__(self, message: str, orig_exc: Exception = None, modname: str = None) -> None:
+    def __init__(
+        self, message: str, orig_exc: Exception | None = None, modname: str | None = None,
+    ) -> None:
         super().__init__(message)
         self.message = message
         self.orig_exc = orig_exc
@@ -63,14 +58,13 @@
 
     def __repr__(self) -> str:
         if self.orig_exc:
-            return '%s(%r, %r)' % (self.__class__.__name__,
-                                   self.message, self.orig_exc)
-        return '%s(%r)' % (self.__class__.__name__, self.message)
+            return f'{self.__class__.__name__}({self.message!r}, {self.orig_exc!r})'
+        return f'{self.__class__.__name__}({self.message!r})'
 
     def __str__(self) -> str:
         parent_str = super().__str__()
         if self.orig_exc:
-            return '%s (exception: %s)' % (parent_str, self.orig_exc)
+            return f'{parent_str} (exception: {self.orig_exc})'
         return parent_str

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/events.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/events.py Changed

@@ -1,18 +1,13 @@
-"""
-    sphinx.events
-    ~~~~~~~~~~~~~
-
-    Sphinx core events.
+"""Sphinx core events.
 
-    Gracefully adapted from the TextPress system by Armin.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Gracefully adapted from the TextPress system by Armin.
 """
 
+from __future__ import annotations
+
 from collections import defaultdict
 from operator import attrgetter
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, NamedTuple, Tuple, Type
+from typing import TYPE_CHECKING, Any, Callable, NamedTuple
 
 from sphinx.errors import ExtensionError, SphinxError
 from sphinx.locale import __
@@ -55,10 +50,10 @@
 class EventManager:
     """Event manager for Sphinx."""
 
-    def __init__(self, app: "Sphinx") -> None:
+    def __init__(self, app: Sphinx) -> None:
         self.app = app
         self.events = core_events.copy()
-        self.listeners: Dictstr, ListEventListener = defaultdict(list)
+        self.listeners: dictstr, listEventListener = defaultdict(list)
         self.next_listener_id = 0
 
     def add(self, name: str) -> None:
@@ -85,7 +80,7 @@
                     listeners.remove(listener)
 
     def emit(self, name: str, *args: Any,
-             allowed_exceptions: TupleTypeException, ... = ()) -> List:
+             allowed_exceptions: tupletypeException, ... = ()) -> list:
         """Emit a Sphinx event."""
         try:
             logger.debug('app emitting event: %r%s', name, repr(args):100)
@@ -105,13 +100,16 @@
             except SphinxError:
                 raise
             except Exception as exc:
+                if self.app.pdb:
+                    # Just pass through the error, so that it can be debugged.
+                    raise
                 modname = safe_getattr(listener.handler, '__module__', None)
                 raise ExtensionError(__("Handler %r for event %r threw an exception") %
                                      (listener.handler, name), exc, modname=modname) from exc
         return results
 
     def emit_firstresult(self, name: str, *args: Any,
-                         allowed_exceptions: TupleTypeException, ... = ()) -> Any:
+                         allowed_exceptions: tupletypeException, ... = ()) -> Any:
         """Emit a Sphinx event and returns first result.
 
         This returns the result of the first handler that doesn't return ``None``.

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/apidoc.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/apidoc.py Changed

@@ -1,19 +1,16 @@
-"""
-    sphinx.ext.apidoc
-    ~~~~~~~~~~~~~~~~~
-
-    Parses a directory tree looking for Python modules and packages and creates
-    ReST files appropriately to create code documentation with Sphinx.  It also
-    creates a modules index (named modules.<suffix>).
+"""Creates reST files corresponding to Python modules for code documentation.
 
-    This is derived from the "sphinx-autopackage" script, which is:
-    Copyright 2008 Société des arts technologiques (SAT),
-    https://sat.qc.ca/
+Parses a directory tree looking for Python modules and packages and creates
+ReST files appropriately to create code documentation with Sphinx.  It also
+creates a modules index (named modules.<suffix>).
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This is derived from the "sphinx-autopackage" script, which is:
+Copyright 2008 Société des arts technologiques (SAT),
+https://sat.qc.ca/
 """
 
+from __future__ import annotations
+
 import argparse
 import glob
 import locale
@@ -23,7 +20,7 @@
 from fnmatch import fnmatch
 from importlib.machinery import EXTENSION_SUFFIXES
 from os import path
-from typing import Any, Generator, List, Tuple
+from typing import Any, Generator
 
 import sphinx.locale
 from sphinx import __display_version__, package_dir
@@ -51,11 +48,10 @@
 def is_initpy(filename: str) -> bool:
     """Check *filename* is __init__ file or not."""
     basename = path.basename(filename)
-    for suffix in sorted(PY_SUFFIXES, key=len, reverse=True):
-        if basename == '__init__' + suffix:
-            return True
-    else:
-        return False
+    return any(
+        basename == '__init__' + suffix
+        for suffix in sorted(PY_SUFFIXES, key=len, reverse=True)
+    )
 
 
 def module_join(*modnames: str) -> str:
@@ -63,7 +59,7 @@
     return '.'.join(filter(None, modnames))
 
 
-def is_packagedir(dirname: str = None, files: Liststr = None) -> bool:
+def is_packagedir(dirname: str | None = None, files: liststr | None = None) -> bool:
     """Check given *files* contains __init__ file."""
     if files is None and dirname is None:
         return False
@@ -77,7 +73,7 @@
     """Write the output file for module/package <name>."""
     quiet = getattr(opts, 'quiet', None)
 
-    fname = path.join(opts.destdir, '%s.%s' % (name, opts.suffix))
+    fname = path.join(opts.destdir, f'{name}.{opts.suffix}')
     if opts.dryrun:
         if not quiet:
             print(__('Would create file %s.') % fname)
@@ -93,7 +89,7 @@
 
 
 def create_module_file(package: str, basename: str, opts: Any,
-                       user_template_dir: str = None) -> None:
+                       user_template_dir: str | None = None) -> None:
     """Build the text of the file and write the file."""
     options = copy(OPTIONS)
     if opts.includeprivate and 'private-members' not in options:
@@ -110,9 +106,10 @@
     write_file(qualname, text, opts)
 
 
-def create_package_file(root: str, master_package: str, subroot: str, py_files: Liststr,
-                        opts: Any, subs: Liststr, is_namespace: bool,
-                        excludes: Liststr = , user_template_dir: str = None) -> None:
+def create_package_file(root: str, master_package: str, subroot: str, py_files: liststr,
+                        opts: Any, subs: liststr, is_namespace: bool,
+                        excludes: liststr = , user_template_dir: str | None = None,
+                        ) -> None:
     """Build the text of the file and write the file."""
     # build a list of sub packages (directories containing an __init__ file)
     subpackages = module_join(master_package, subroot, pkgname)
@@ -122,6 +119,7 @@
     submodules = sub.split('.')0 for sub in py_files
                   if not is_skipped_module(path.join(root, sub), opts, excludes) and
                   not is_initpy(sub)
+    submodules = sorted(set(submodules))
     submodules = module_join(master_package, subroot, modname)
                   for modname in submodules
     options = copy(OPTIONS)
@@ -148,8 +146,8 @@
             create_module_file(None, submodule, opts, user_template_dir)
 
 
-def create_modules_toc_file(modules: Liststr, opts: Any, name: str = 'modules',
-                            user_template_dir: str = None) -> None:
+def create_modules_toc_file(modules: liststr, opts: Any, name: str = 'modules',
+                            user_template_dir: str | None = None) -> None:
     """Create the module's index."""
     modules.sort()
     prev_module = ''
@@ -169,7 +167,7 @@
     write_file(name, text, opts)
 
 
-def is_skipped_package(dirname: str, opts: Any, excludes: Liststr = ) -> bool:
+def is_skipped_package(dirname: str, opts: Any, excludes: liststr = ) -> bool:
     """Check if we want to skip this module."""
     if not path.isdir(dirname):
         return False
@@ -177,31 +175,26 @@
     files = glob.glob(path.join(dirname, '*.py'))
     regular_package = any(f for f in files if is_initpy(f))
     if not regular_package and not opts.implicit_namespaces:
-        # *dirname* is not both a regular package and an implicit namespace pacage
+        # *dirname* is not both a regular package and an implicit namespace package
         return True
 
     # Check there is some showable module inside package
-    if all(is_excluded(path.join(dirname, f), excludes) for f in files):
-        # all submodules are excluded
-        return True
-    else:
-        return False
+    return all(is_excluded(path.join(dirname, f), excludes) for f in files)
 
 
-def is_skipped_module(filename: str, opts: Any, excludes: Liststr) -> bool:
+def is_skipped_module(filename: str, opts: Any, excludes: liststr) -> bool:
     """Check if we want to skip this module."""
     if not path.exists(filename):
         # skip if the file doesn't exist
         return True
-    elif path.basename(filename).startswith('_') and not opts.includeprivate:
+    if path.basename(filename).startswith('_') and not opts.includeprivate:
         # skip if the module has a "private" name
         return True
-    else:
-        return False
+    return False
 
 
-def walk(rootpath: str, excludes: Liststr, opts: Any
-         ) -> GeneratorTuplestr, Liststr, Liststr, None, None:
+def walk(rootpath: str, excludes: liststr, opts: Any,
+         ) -> Generatortuplestr, liststr, liststr, None, None:
     """Walk through the directory and list files and subdirectories up."""
     followlinks = getattr(opts, 'followlinks', False)
     includeprivate = getattr(opts, 'includeprivate', False)
@@ -215,7 +208,7 @@
         # remove hidden ('.') and private ('_') directories, as well as
         # excluded dirs
         if includeprivate:
-            exclude_prefixes: Tuplestr, ... = ('.',)
+            exclude_prefixes: tuplestr, ... = ('.',)
         else:
             exclude_prefixes = ('.', '_')
 
@@ -225,17 +218,16 @@
         yield root, subs, files
 
 
-def has_child_module(rootpath: str, excludes: Liststr, opts: Any) -> bool:
+def has_child_module(rootpath: str, excludes: liststr, opts: Any) -> bool:
     """Check the given directory contains child module/s (at least one)."""
-    for _root, _subs, files in walk(rootpath, excludes, opts):
-        if files:
-            return True
-
-    return False
+    return any(
+        files
+        for _root, _subs, files in walk(rootpath, excludes, opts)
+    )
 
 
-def recurse_tree(rootpath: str, excludes: Liststr, opts: Any,
-                 user_template_dir: str = None) -> Liststr:
+def recurse_tree(rootpath: str, excludes: liststr, opts: Any,
+                 user_template_dir: str | None = None) -> liststr:
     """
     Look for every file in the directory tree and create the corresponding
     ReST files.
@@ -278,7 +270,8 @@
                     toplevels.append(module_join(root_package, subpackage))
         else:
             # if we are at the root level, we don't require it to be a package
-            assert root == rootpath and root_package is None
+            assert root == rootpath
+            assert root_package is None
             for py_file in files:
                 if not is_skipped_module(path.join(rootpath, py_file), opts, excludes):
                     module = py_file.split('.')0
@@ -288,16 +281,16 @@
     return toplevels
 
 
-def is_excluded(root: str, excludes: Liststr) -> bool:
+def is_excluded(root: str, excludes: liststr) -> bool:
     """Check if the directory is in the exclude list.
 
     Note: by having trailing slashes, we avoid common prefix issues, like
           e.g. an exclude "foo" also accidentally excluding "foobar".
     """
-    for exclude in excludes:
-        if fnmatch(root, exclude):
-            return True
-    return False
+    return any(
+        fnmatch(root, exclude)
+        for exclude in excludes
+    )
 
 
 def get_parser() -> argparse.ArgumentParser:
@@ -397,10 +390,10 @@
     return parser
 
 
-def main(argv: Liststr = sys.argv1:) -> int:
+def main(argv: liststr = sys.argv1:) -> int:
     """Parse and check the command line arguments."""
-    sphinx.locale.setlocale(locale.LC_ALL, '')
-    sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx')
+    locale.setlocale(locale.LC_ALL, '')
+    sphinx.locale.init_console()
 
     parser = get_parser()
     args = parser.parse_args(argv)
@@ -415,7 +408,7 @@
         args.suffix = args.suffix1:
     if not path.isdir(rootpath):
         print(__('%s is not a directory.') % rootpath, file=sys.stderr)
-        sys.exit(1)
+        raise SystemExit(1)
     if not args.dryrun:
         ensuredir(args.destdir)
     excludes = path.abspath(exclude) for exclude in args.exclude_pattern

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/__init__.py Changed

@@ -1,44 +1,52 @@
-"""
-    sphinx.ext.autodoc
-    ~~~~~~~~~~~~~~~~~~
-
-    Automatically insert docstrings for functions, classes or whole modules into
-    the doctree, thus avoiding duplication between docstrings and documentation
-    for those who like elaborate docstrings.
+"""Extension to create automatic documentation from code docstrings.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Automatically insert docstrings for functions, classes or whole modules into
+the doctree, thus avoiding duplication between docstrings and documentation
+for those who like elaborate docstrings.
 """
 
+from __future__ import annotations
+
 import re
-import warnings
+import sys
 from inspect import Parameter, Signature
-from types import ModuleType
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Optional, Sequence,
-                    Set, Tuple, Type, TypeVar, Union)
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Iterator,
+    List,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+)
 
 from docutils.statemachine import StringList
 
 import sphinx
 from sphinx.application import Sphinx
 from sphinx.config import ENUM, Config
-from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
 from sphinx.environment import BuildEnvironment
-from sphinx.ext.autodoc.importer import (get_class_members, get_object_members, import_module,
-                                         import_object)
+from sphinx.ext.autodoc.importer import get_class_members, import_module, import_object
 from sphinx.ext.autodoc.mock import ismock, mock, undecorate
 from sphinx.locale import _, __
 from sphinx.pycode import ModuleAnalyzer, PycodeError
 from sphinx.util import inspect, logging
 from sphinx.util.docstrings import prepare_docstring, separate_metadata
-from sphinx.util.inspect import (evaluate_signature, getdoc, object_description, safe_getattr,
-                                 stringify_signature)
-from sphinx.util.typing import OptionSpec, get_type_hints, restify
-from sphinx.util.typing import stringify as stringify_typehint
+from sphinx.util.inspect import (
+    evaluate_signature,
+    getdoc,
+    object_description,
+    safe_getattr,
+    stringify_signature,
+)
+from sphinx.util.typing import OptionSpec, get_type_hints, restify, stringify_annotation
 
 if TYPE_CHECKING:
-    from sphinx.ext.autodoc.directive import DocumenterBridge
+    from types import ModuleType
 
+    from sphinx.ext.autodoc.directive import DocumenterBridge
 
 logger = logging.getLogger(__name__)
 
@@ -88,7 +96,7 @@
 SLOTSATTR = object()
 
 
-def members_option(arg: Any) -> Unionobject, Liststr:
+def members_option(arg: Any) -> object | liststr:
     """Used to convert the :members: option to auto directives."""
     if arg in (None, True):
         return ALL
@@ -98,32 +106,25 @@
         return x.strip() for x in arg.split(',') if x.strip()
 
 
-def members_set_option(arg: Any) -> Unionobject, Setstr:
-    """Used to convert the :members: option to auto directives."""
-    warnings.warn("members_set_option() is deprecated.",
-                  RemovedInSphinx50Warning, stacklevel=2)
-    if arg is None:
-        return ALL
-    return {x.strip() for x in arg.split(',') if x.strip()}
-
-
-def exclude_members_option(arg: Any) -> Unionobject, Setstr:
+def exclude_members_option(arg: Any) -> object | setstr:
     """Used to convert the :exclude-members: option."""
     if arg in (None, True):
         return EMPTY
     return {x.strip() for x in arg.split(',') if x.strip()}
 
 
-def inherited_members_option(arg: Any) -> Unionobject, Setstr:
-    """Used to convert the :members: option to auto directives."""
+def inherited_members_option(arg: Any) -> setstr:
+    """Used to convert the :inherited-members: option to auto directives."""
     if arg in (None, True):
-        return 'object'
+        return {'object'}
+    elif arg:
+        return {x.strip() for x in arg.split(',')}
     else:
-        return arg
+        return set()
 
 
-def member_order_option(arg: Any) -> Optionalstr:
-    """Used to convert the :members: option to auto directives."""
+def member_order_option(arg: Any) -> str | None:
+    """Used to convert the :member-order: option to auto directives."""
     if arg in (None, True):
         return None
     elif arg in ('alphabetical', 'bysource', 'groupwise'):
@@ -132,7 +133,7 @@
         raise ValueError(__('invalid value for member-order option: %s') % arg)
 
 
-def class_doc_from_option(arg: Any) -> Optionalstr:
+def class_doc_from_option(arg: Any) -> str | None:
     """Used to convert the :class-doc-from: option to autoclass directives."""
     if arg in ('both', 'class', 'init'):
         return arg
@@ -158,23 +159,10 @@
     return True
 
 
-def merge_special_members_option(options: Dict) -> None:
-    """Merge :special-members: option to :members: option."""
-    warnings.warn("merge_special_members_option() is deprecated.",
-                  RemovedInSphinx50Warning, stacklevel=2)
-    if 'special-members' in options and options'special-members' is not ALL:
-        if options.get('members') is ALL:
-            pass
-        elif options.get('members'):
-            for member in options'special-members':
-                if member not in options'members':
-                    options'members'.append(member)
-        else:
-            options'members' = options'special-members'
-
-
-def merge_members_option(options: Dict) -> None:
-    """Merge :*-members: option to the :members: option."""
+def merge_members_option(options: dict) -> None:
+    """Merge :private-members: and :special-members: options to the
+    :members: option.
+    """
     if options.get('members') is ALL:
         # merging is not needed when members: ALL
         return
@@ -189,7 +177,7 @@
 
 # Some useful event listener factories for autodoc-process-docstring.
 
-def cut_lines(pre: int, post: int = 0, what: str = None) -> Callable:
+def cut_lines(pre: int, post: int = 0, what: str | None = None) -> Callable:
     """Return a listener that removes the first *pre* and last *post*
     lines of every docstring.  If *what* is a sequence of strings,
     only docstrings of a type in *what* will be processed.
@@ -201,7 +189,7 @@
 
     This can (and should) be used in place of :confval:`automodule_skip_lines`.
     """
-    def process(app: Sphinx, what_: str, name: str, obj: Any, options: Any, lines: Liststr
+    def process(app: Sphinx, what_: str, name: str, obj: Any, options: Any, lines: liststr,
                 ) -> None:
         if what and what_ not in what:
             return
@@ -217,8 +205,12 @@
     return process
 
 
-def between(marker: str, what: Sequencestr = None, keepempty: bool = False,
-            exclude: bool = False) -> Callable:
+def between(
+    marker: str,
+    what: Sequencestr | None = None,
+    keepempty: bool = False,
+    exclude: bool = False,
+) -> Callable:
     """Return a listener that either keeps, or if *exclude* is True excludes,
     lines between lines that match the *marker* regular expression.  If no line
     matches, the resulting docstring would be empty, so no change will be made
@@ -229,7 +221,7 @@
     """
     marker_re = re.compile(marker)
 
-    def process(app: Sphinx, what_: str, name: str, obj: Any, options: Any, lines: Liststr
+    def process(app: Sphinx, what_: str, name: str, obj: Any, options: Any, lines: liststr,
                 ) -> None:
         if what and what_ not in what:
             return
@@ -257,7 +249,7 @@
 # But we define this class here to keep compatibility (see #4538)
 class Options(dict):
     """A dict/attribute hybrid that returns None on nonexisting keys."""
-    def copy(self) -> "Options":
+    def copy(self) -> Options:
         return Options(super().copy())
 
     def __getattr__(self, name: str) -> Any:
@@ -270,7 +262,7 @@
 class ObjectMember(tuple):
     """A member of object.
 
-    This is used for the result of `Documenter.get_object_members()` to
+    This is used for the result of `Documenter.get_module_members()` to
     represent each member of the object.
 
     .. Note::
@@ -284,7 +276,7 @@
     def __new__(cls, name: str, obj: Any, **kwargs: Any) -> Any:
         return super().__new__(cls, (name, obj))  # type: ignore
 
-    def __init__(self, name: str, obj: Any, docstring: Optionalstr = None,
+    def __init__(self, name: str, obj: Any, docstring: str | None = None,
                  class_: Any = None, skipped: bool = False) -> None:
         self.__name__ = name
         self.object = obj
@@ -321,10 +313,10 @@
     #: order if autodoc_member_order is set to 'groupwise'
     member_order = 0
     #: true if the generated content may contain titles
-    titles_allowed = False
+    titles_allowed = True
 
     option_spec: OptionSpec = {
-        'noindex': bool_option
+        'noindex': bool_option,
     }
 
     def get_attr(self, obj: Any, name: str, *defargs: Any) -> Any:
@@ -332,12 +324,12 @@
         return autodoc_attrgetter(self.env.app, obj, name, *defargs)
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         """Called to see if a member can be documented by this Documenter."""
         raise NotImplementedError('must be implemented in subclasses')
 
-    def __init__(self, directive: "DocumenterBridge", name: str, indent: str = '') -> None:
+    def __init__(self, directive: DocumenterBridge, name: str, indent: str = '') -> None:
         self.directive = directive
         self.config: Config = directive.env.config
         self.env: BuildEnvironment = directive.env
@@ -348,7 +340,7 @@
         # qualified name (all set after resolve_name succeeds)
         self.modname: str = None
         self.module: ModuleType = None
-        self.objpath: Liststr = None
+        self.objpath: liststr = None
         self.fullname: str = None
         # extra signature items (arguments and return annotation,
         # also set after resolve_name succeeds)
@@ -363,7 +355,7 @@
         self.analyzer: ModuleAnalyzer = None
 
     @property
-    def documenters(self) -> Dictstr, Type"Documenter":
+    def documenters(self) -> dictstr, typeDocumenter:
         """Returns registered Documenter classes"""
         return self.env.app.registry.documenters
 
@@ -374,8 +366,8 @@
         else:
             self.directive.result.append('', source, *lineno)
 
-    def resolve_name(self, modname: str, parents: Any, path: str, base: Any
-                     ) -> Tuplestr, Liststr:
+    def resolve_name(self, modname: str, parents: Any, path: str, base: Any,
+                     ) -> tuplestr, liststr:
         """Resolve the module and name of the object to document given by the
         arguments and the current module/class.
 
@@ -440,10 +432,9 @@
             except ImportError as exc:
                 if raiseerror:
                     raise
-                else:
-                    logger.warning(exc.args0, type='autodoc', subtype='import_object')
-                    self.env.note_reread()
-                    return False
+                logger.warning(exc.args0, type='autodoc', subtype='import_object')
+                self.env.note_reread()
+                return False
 
     def get_real_modname(self) -> str:
         """Get the real module name of an object to document.
@@ -466,12 +457,12 @@
             return False
         return True
 
-    def format_args(self, **kwargs: Any) -> str:
+    def format_args(self, **kwargs: Any) -> str | None:
         """Format the argument signature of *self.object*.
 
         Should return None if the object does not have a signature.
         """
-        return None
+        pass
 
     def format_name(self) -> str:
         """Format the name of *self.object*.
@@ -484,7 +475,7 @@
         # directives of course)
         return '.'.join(self.objpath) or self.modname
 
-    def _call_format_args(self, **kwargs: Any) -> str:
+    def _call_format_args(self, **kwargs: Any) -> str | None:
         if kwargs:
             try:
                 return self.format_args(**kwargs)
@@ -538,9 +529,9 @@
         sourcename = self.get_sourcename()
 
         # one signature per line, indented by column
-        prefix = '.. %s:%s:: ' % (domain, directive)
+        prefix = f'.. {domain}:{directive}:: '
         for i, sig_line in enumerate(sig.split("\n")):
-            self.add_line('%s%s%s' % (prefix, name, sig_line),
+            self.add_line(f'{prefix}{name}{sig_line}',
                           sourcename)
             if i == 0:
                 prefix = " " * len(prefix)
@@ -552,24 +543,20 @@
             # etc. don't support a prepended module name
             self.add_line('   :module: %s' % self.modname, sourcename)
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         """Decode and return lines of the docstring(s) for the object.
 
         When it returns None, autodoc-process-docstring will not be called for this
         object.
         """
-        if ignore is not None:
-            warnings.warn("The 'ignore' argument to autodoc.%s.get_doc() is deprecated."
-                          % self.__class__.__name__,
-                          RemovedInSphinx50Warning, stacklevel=2)
         docstring = getdoc(self.object, self.get_attr, self.config.autodoc_inherit_docstrings,
                            self.parent, self.object_name)
         if docstring:
             tab_width = self.directive.state.document.settings.tab_width
-            return prepare_docstring(docstring, ignore, tab_width)
+            return prepare_docstring(docstring, tab_width)
         return 
 
-    def process_doc(self, docstrings: ListListstr) -> Iteratorstr:
+    def process_doc(self, docstrings: listliststr) -> Iteratorstr:
         """Let the user process the docstrings before adding them."""
         for docstringlines in docstrings:
             if self.env.app:
@@ -589,22 +576,18 @@
                 inspect.safe_getattr(self.object, '__qualname__', None)):
             # Get the correct location of docstring from self.object
             # to support inherited methods
-            fullname = '%s.%s' % (self.object.__module__, self.object.__qualname__)
+            fullname = f'{self.object.__module__}.{self.object.__qualname__}'
         else:
             fullname = self.fullname
 
         if self.analyzer:
-            return '%s:docstring of %s' % (self.analyzer.srcname, fullname)
+            return f'{self.analyzer.srcname}:docstring of {fullname}'
         else:
             return 'docstring of %s' % fullname
 
-    def add_content(self, more_content: OptionalStringList, no_docstring: bool = False
-                    ) -> None:
+    def add_content(self, more_content: StringList | None) -> None:
         """Add content from docstrings, attribute documentation and user."""
-        if no_docstring:
-            warnings.warn("The 'no_docstring' argument to %s.add_content() is deprecated."
-                          % self.__class__.__name__,
-                          RemovedInSphinx50Warning, stacklevel=2)
+        docstring = True
 
         # set sourcename and add content from attribute documentation
         sourcename = self.get_sourcename()
@@ -613,7 +596,7 @@
             if self.objpath:
                 key = ('.'.join(self.objpath:-1), self.objpath-1)
                 if key in attr_docs:
-                    no_docstring = True
+                    docstring = False
                     # make a copy of docstring for attributes to avoid cache
                     # the change of autodoc-process-docstring event.
                     docstrings = list(attr_docskey)
@@ -622,7 +605,7 @@
                         self.add_line(line, sourcename, i)
 
         # add content from docstrings
-        if not no_docstring:
+        if docstring:
             docstrings = self.get_doc()
             if docstrings is None:
                 # Do not call autodoc-process-docstring on get_doc() returns None.
@@ -641,36 +624,17 @@
             for line, src in zip(more_content.data, more_content.items):
                 self.add_line(line, src0, src1)
 
-    def get_object_members(self, want_all: bool) -> Tuplebool, ObjectMembers:
+    def get_object_members(self, want_all: bool) -> tuplebool, ObjectMembers:
         """Return `(members_check_module, members)` where `members` is a
         list of `(membername, member)` pairs of the members of *self.object*.
 
         If *want_all* is True, return all members.  Else, only return those
         members given by *self.options.members* (which may also be None).
         """
-        warnings.warn('The implementation of Documenter.get_object_members() will be '
-                      'removed from Sphinx-6.0.', RemovedInSphinx60Warning)
-        members = get_object_members(self.object, self.objpath, self.get_attr, self.analyzer)
-        if not want_all:
-            if not self.options.members:
-                return False,   # type: ignore
-            # specific members given
-            selected = 
-            for name in self.options.members:  # type: str
-                if name in members:
-                    selected.append((name, membersname.value))
-                else:
-                    logger.warning(__('missing attribute %s in object %s') %
-                                   (name, self.fullname), type='autodoc')
-            return False, selected
-        elif self.options.inherited_members:
-            return False, (m.name, m.value) for m in members.values()
-        else:
-            return False, (m.name, m.value) for m in members.values()
-                           if m.directly_defined
+        raise NotImplementedError('must be implemented in subclasses')
 
-    def filter_members(self, members: ObjectMembers, want_all: bool
-                       ) -> ListTuplestr, Any, bool:
+    def filter_members(self, members: ObjectMembers, want_all: bool,
+                       ) -> listtuplestr, Any, bool:
         """Filter the given member list.
 
         Members are skipped if
@@ -685,16 +649,18 @@
         ``autodoc-skip-member`` event.
         """
         def is_filtered_inherited_member(name: str, obj: Any) -> bool:
+            inherited_members = self.options.inherited_members or set()
+
             if inspect.isclass(self.object):
                 for cls in self.object.__mro__:
-                    if cls.__name__ == self.options.inherited_members and cls != self.object:
+                    if cls.__name__ in inherited_members and cls != self.object:
                         # given member is a member of specified *super class*
                         return True
-                    elif name in cls.__dict__:
+                    if name in cls.__dict__:
                         return False
-                    elif name in self.get_attr(cls, '__annotations__', {}):
+                    if name in self.get_attr(cls, '__annotations__', {}):
                         return False
-                    elif isinstance(obj, ObjectMember) and obj.class_ is cls:
+                    if isinstance(obj, ObjectMember) and obj.class_ is cls:
                         return False
 
             return False
@@ -714,12 +680,7 @@
             try:
                 membername, member = obj
                 # if isattr is True, the member is documented as an attribute
-                if member is INSTANCEATTR:
-                    isattr = True
-                elif (namespace, membername) in attr_docs:
-                    isattr = True
-                else:
-                    isattr = False
+                isattr = member is INSTANCEATTR or (namespace, membername) in attr_docs
 
                 doc = getdoc(member, self.get_attr, self.config.autodoc_inherit_docstrings,
                              self.object, membername)
@@ -763,7 +724,7 @@
                     # special __methods__
                     if (self.options.special_members and
                             membername in self.options.special_members):
-                        if membername == '__doc__':
+                        if membername == '__doc__':  # NoQA: SIM114
                             keep = False
                         elif is_filtered_inherited_member(membername, obj):
                             keep = False
@@ -782,7 +743,7 @@
                         keep = True
                 elif want_all and isprivate:
                     if has_doc or self.options.undoc_members:
-                        if self.options.private_members is None:
+                        if self.options.private_members is None:  # NoQA: SIM114
                             keep = False
                         elif is_filtered_inherited_member(membername, obj):
                             keep = False
@@ -840,7 +801,7 @@
         members_check_module, members = self.get_object_members(want_all)
 
         # document non-skipped members
-        memberdocumenters: ListTupleDocumenter, bool = 
+        memberdocumenters: listtupleDocumenter, bool = 
         for (mname, member, isattr) in self.filter_members(members, want_all):
             classes = cls for cls in self.documenters.values()
                        if cls.can_document_member(member, mname, isattr, self)
@@ -867,33 +828,35 @@
         self.env.temp_data'autodoc:module' = None
         self.env.temp_data'autodoc:class' = None
 
-    def sort_members(self, documenters: ListTuple"Documenter", bool,
-                     order: str) -> ListTuple"Documenter", bool:
+    def sort_members(self, documenters: listtupleDocumenter, bool,
+                     order: str) -> listtupleDocumenter, bool:
         """Sort the given member list."""
         if order == 'groupwise':
             # sort by group; alphabetically within groups
             documenters.sort(key=lambda e: (e0.member_order, e0.name))
         elif order == 'bysource':
+            # By default, member discovery order matches source order,
+            # as dicts are insertion-ordered from Python 3.7.
             if self.analyzer:
                 # sort by source order, by virtue of the module analyzer
                 tagorder = self.analyzer.tagorder
 
-                def keyfunc(entry: TupleDocumenter, bool) -> int:
+                def keyfunc(entry: tupleDocumenter, bool) -> int:
                     fullname = entry0.name.split('::')1
                     return tagorder.get(fullname, len(tagorder))
                 documenters.sort(key=keyfunc)
-            else:
-                # Assume that member discovery order matches source order.
-                # This is a reasonable assumption in Python 3.6 and up, where
-                # module.__dict__ is insertion-ordered.
-                pass
         else:  # alphabetical
             documenters.sort(key=lambda e: e0.name)
 
         return documenters
 
-    def generate(self, more_content: OptionalStringList = None, real_modname: str = None,
-                 check_module: bool = False, all_members: bool = False) -> None:
+    def generate(
+        self,
+        more_content: StringList | None = None,
+        real_modname: str | None = None,
+        check_module: bool = False,
+        all_members: bool = False,
+    ) -> None:
         """Generate reST for the object given by *self.name*, and possibly for
         its members.
 
@@ -905,7 +868,7 @@
         if not self.parse_name():
             # need a module to import
             logger.warning(
-                __('don\'t know which module to import for autodocumenting '
+                __("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)') %
                 self.name, type='autodoc')
@@ -947,7 +910,7 @@
             except PycodeError:
                 pass
 
-        docstrings: Liststr = sum(self.get_doc() or , )
+        docstrings: liststr = sum(self.get_doc() or , )
         if ismock(self.object) and not docstrings:
             logger.warning(__('A mocked object is detected: %r'),
                            self.name, type='autodoc')
@@ -992,7 +955,7 @@
     """
     objtype = 'module'
     content_indent = ''
-    titles_allowed = True
+    _extra_indent = '   '
 
     option_spec: OptionSpec = {
         'members': members_option, 'undoc-members': bool_option,
@@ -1001,22 +964,32 @@
         'platform': identity, 'deprecated': bool_option,
         'member-order': member_order_option, 'exclude-members': exclude_members_option,
         'private-members': members_option, 'special-members': members_option,
-        'imported-members': bool_option, 'ignore-module-all': bool_option
+        'imported-members': bool_option, 'ignore-module-all': bool_option,
+        'no-value': bool_option,
     }
 
     def __init__(self, *args: Any) -> None:
         super().__init__(*args)
         merge_members_option(self.options)
-        self.__all__: OptionalSequencestr = None
+        self.__all__: Sequencestr | None = None
+
+    def add_content(self, more_content: StringList | None) -> None:
+        old_indent = self.indent
+        self.indent += self._extra_indent
+        super().add_content(None)
+        self.indent = old_indent
+        if more_content:
+            for line, src in zip(more_content.data, more_content.items):
+                self.add_line(line, src0, src1)
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         # don't document submodules automatically
         return False
 
-    def resolve_name(self, modname: str, parents: Any, path: str, base: Any
-                     ) -> Tuplestr, Liststr:
+    def resolve_name(self, modname: str, parents: Any, path: str, base: Any,
+                     ) -> tuplestr, liststr:
         if modname is not None:
             logger.warning(__('"::" in automodule name doesn\'t make sense'),
                            type='autodoc')
@@ -1057,14 +1030,14 @@
         if self.options.deprecated:
             self.add_line('   :deprecated:', sourcename)
 
-    def get_module_members(self) -> Dictstr, ObjectMember:
+    def get_module_members(self) -> dictstr, ObjectMember:
         """Get members of target module."""
         if self.analyzer:
             attr_docs = self.analyzer.attr_docs
         else:
             attr_docs = {}
 
-        members: Dictstr, ObjectMember = {}
+        members: dictstr, ObjectMember = {}
         for name in dir(self.object):
             try:
                 value = safe_getattr(self.object, name, None)
@@ -1084,7 +1057,7 @@
 
         return members
 
-    def get_object_members(self, want_all: bool) -> Tuplebool, ObjectMembers:
+    def get_object_members(self, want_all: bool) -> tuplebool, ObjectMembers:
         members = self.get_module_members()
         if want_all:
             if self.__all__ is None:
@@ -1110,14 +1083,14 @@
                                    type='autodoc')
             return False, ret
 
-    def sort_members(self, documenters: ListTuple"Documenter", bool,
-                     order: str) -> ListTuple"Documenter", bool:
+    def sort_members(self, documenters: listtupleDocumenter, bool,
+                     order: str) -> listtupleDocumenter, bool:
         if order == 'bysource' and self.__all__:
             # Sort alphabetically first (for members not listed on the __all__)
             documenters.sort(key=lambda e: e0.name)
 
             # Sort by __all__
-            def keyfunc(entry: TupleDocumenter, bool) -> int:
+            def keyfunc(entry: tupleDocumenter, bool) -> int:
                 name = entry0.name.split('::')1
                 if self.__all__ and name in self.__all__:
                     return self.__all__.index(name)
@@ -1135,8 +1108,8 @@
     Specialized Documenter subclass for objects on module level (functions,
     classes, data/constants).
     """
-    def resolve_name(self, modname: str, parents: Any, path: str, base: Any
-                     ) -> Tuplestr, Liststr:
+    def resolve_name(self, modname: str, parents: Any, path: str, base: Any,
+                     ) -> tuplestr, liststr:
         if modname is None:
             if path:
                 modname = path.rstrip('.')
@@ -1156,8 +1129,8 @@
     Specialized Documenter subclass for objects on class level (methods,
     attributes).
     """
-    def resolve_name(self, modname: str, parents: Any, path: str, base: Any
-                     ) -> Tuplestr, Liststr:
+    def resolve_name(self, modname: str, parents: Any, path: str, base: Any,
+                     ) -> tuplestr, liststr:
         if modname is None:
             if path:
                 mod_cls = path.rstrip('.')
@@ -1189,10 +1162,10 @@
     Mixin for FunctionDocumenter and MethodDocumenter to provide the
     feature of reading the signature from the docstring.
     """
-    _new_docstrings: ListListstr = None
-    _signatures: Liststr = None
+    _new_docstrings: listliststr = None
+    _signatures: liststr = None
 
-    def _find_signature(self) -> Tuplestr, str:
+    def _find_signature(self) -> tuplestr | None, str | None:
         # candidates of the object name
         valid_names = self.objpath-1  # type: ignore
         if isinstance(self, ClassDocumenter):
@@ -1228,14 +1201,14 @@
                 # re-prepare docstring to ignore more leading indentation
                 tab_width = self.directive.state.document.settings.tab_width  # type: ignore
                 self._new_docstringsi = prepare_docstring('\n'.join(doclinesj + 1:),
-                                                            tabsize=tab_width)
+                                                            tab_width)
 
                 if result is None:
                     # first signature
                     result = args, retann
                 else:
                     # subsequent signatures
-                    self._signatures.append("(%s) -> %s" % (args, retann))
+                    self._signatures.append(f"({args}) -> {retann}")
 
             if result:
                 # finish the loop when signature found
@@ -1243,10 +1216,10 @@
 
         return result
 
-    def get_doc(self, ignore: int = None) -> ListListstr:
+    def get_doc(self) -> listliststr:
         if self._new_docstrings is not None:
             return self._new_docstrings
-        return super().get_doc(ignore)  # type: ignore
+        return super().get_doc()  # type: ignoremisc
 
     def format_signature(self, **kwargs: Any) -> str:
         if self.args is None and self.config.autodoc_docstring_signature:  # type: ignore
@@ -1268,7 +1241,10 @@
     feature of stripping any function signature from the docstring.
     """
     def format_signature(self, **kwargs: Any) -> str:
-        if self.args is None and self.config.autodoc_docstring_signature:  # type: ignore
+        if (
+            self.args is None
+            and self.config.autodoc_docstring_signature  # type: ignoreattr-defined
+        ):
             # only act if a signature is not explicitly given already, and if
             # the feature is enabled
             result = self._find_signature()
@@ -1288,13 +1264,13 @@
     member_order = 30
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         # supports functions, builtins and bound methods exported at the module level
         return (inspect.isfunction(member) or inspect.isbuiltin(member) or
                 (inspect.isroutine(member) and isinstance(parent, ModuleDocumenter)))
 
-    def format_args(self, **kwargs: Any) -> str:
+    def format_args(self, **kwargs: Any) -> str | None:
         if self.config.autodoc_typehints in ('none', 'description'):
             kwargs.setdefault('show_annotation', False)
         if self.config.autodoc_typehints_format == "short":
@@ -1377,7 +1353,7 @@
 
         return overload.replace(parameters=parameters)
 
-    def annotate_to_first_argument(self, func: Callable, typ: Type) -> OptionalCallable:
+    def annotate_to_first_argument(self, func: Callable, typ: type) -> Callable | None:
         """Annotate type hint to the first argument of function if needed."""
         try:
             sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases)
@@ -1403,8 +1379,8 @@
             except (AttributeError, TypeError):
                 # failed to update signature (ex. built-in or extension types)
                 return None
-        else:
-            return None
+
+        return func
 
 
 class DecoratorDocumenter(FunctionDocumenter):
@@ -1453,6 +1429,11 @@
         'class-doc-from': class_doc_from_option,
     }
 
+    # Must be higher than FunctionDocumenter, ClassDocumenter, and
+    # AttributeDocumenter as NewType can be an attribute and is a class
+    # after Python 3.10. Before 3.10 it is a kind of function object
+    priority = 15
+
     _signature_class: Any = None
     _signature_method_name: str = None
 
@@ -1472,9 +1453,10 @@
         merge_members_option(self.options)
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
-        return isinstance(member, type)
+        return isinstance(member, type) or (
+            isattr and (inspect.isNewType(member) or isinstance(member, TypeVar)))
 
     def import_object(self, raiseerror: bool = False) -> bool:
         ret = super().import_object(raiseerror)
@@ -1485,9 +1467,19 @@
                 self.doc_as_attr = (self.objpath-1 != self.object.__name__)
             else:
                 self.doc_as_attr = True
+            if inspect.isNewType(self.object) or isinstance(self.object, TypeVar):
+                modname = getattr(self.object, '__module__', self.modname)
+                if modname != self.modname and self.modname.startswith(modname):
+                    bases = self.modnamelen(modname):.strip('.').split('.')
+                    self.objpath = bases + self.objpath
+                    self.modname = modname
         return ret
 
-    def _get_signature(self) -> TupleOptionalAny, Optionalstr, OptionalSignature:
+    def _get_signature(self) -> tupleAny | None, str | None, Signature | None:
+        if inspect.isNewType(self.object) or isinstance(self.object, TypeVar):
+            # Suppress signature
+            return None, None, None
+
         def get_user_defined_function_or_method(obj: Any, attr: str) -> Any:
             """ Get the `attr` function or method from `obj`, if it is user-defined. """
             if inspect.is_builtin_class_method(obj, attr):
@@ -1510,7 +1502,7 @@
         call = get_user_defined_function_or_method(type(self.object), '__call__')
 
         if call is not None:
-            if "{0.__module__}.{0.__qualname__}".format(call) in _METACLASS_CALL_BLACKLIST:
+            if f"{call.__module__}.{call.__qualname__}" in _METACLASS_CALL_BLACKLIST:
                 call = None
 
         if call is not None:
@@ -1526,7 +1518,7 @@
         new = get_user_defined_function_or_method(self.object, '__new__')
 
         if new is not None:
-            if "{0.__module__}.{0.__qualname__}".format(new) in _CLASS_NEW_BLACKLIST:
+            if f"{new.__module__}.{new.__qualname__}" in _CLASS_NEW_BLACKLIST:
                 new = None
 
         if new is not None:
@@ -1565,7 +1557,7 @@
         # with __init__ in C and no `__text_signature__`.
         return None, None, None
 
-    def format_args(self, **kwargs: Any) -> str:
+    def format_args(self, **kwargs: Any) -> str | None:
         if self.config.autodoc_typehints in ('none', 'description'):
             kwargs.setdefault('show_annotation', False)
         if self.config.autodoc_typehints_format == "short":
@@ -1584,6 +1576,20 @@
 
         return stringify_signature(sig, show_return_annotation=False, **kwargs)
 
+    def _find_signature(self) -> tuplestr, str:
+        result = super()._find_signature()
+        if result is not None:
+            # Strip a return value from signature of constructor in docstring (first entry)
+            result = (result0, None)
+
+        for i, sig in enumerate(self._signatures):
+            if sig.endswith(' -> None'):
+                # Strip a return value from signatures of constructor in docstring (subsequent
+                # entries)
+                self._signaturesi = sig:-8
+
+        return result
+
     def format_signature(self, **kwargs: Any) -> str:
         if self.doc_as_attr:
             return ''
@@ -1616,7 +1622,7 @@
 
         return "\n".join(sigs)
 
-    def get_overloaded_signatures(self) -> ListSignature:
+    def get_overloaded_signatures(self) -> listSignature:
         if self._signature_class and self._signature_method_name:
             for cls in self._signature_class.__mro__:
                 try:
@@ -1624,7 +1630,7 @@
                     analyzer.analyze()
                     qualname = '.'.join(cls.__qualname__, self._signature_method_name)
                     if qualname in analyzer.overloads:
-                        return analyzer.overloads.get(qualname)
+                        return analyzer.overloads.get(qualname, )
                     elif qualname in analyzer.tagorder:
                         # the constructor is defined in the class, but not overridden.
                         return 
@@ -1633,7 +1639,7 @@
 
         return 
 
-    def get_canonical_fullname(self) -> Optionalstr:
+    def get_canonical_fullname(self) -> str | None:
         __modname__ = safe_getattr(self.object, '__module__', self.modname)
         __qualname__ = safe_getattr(self.object, '__qualname__', None)
         if __qualname__ is None:
@@ -1654,18 +1660,22 @@
             self.directivetype = 'attribute'
         super().add_directive_header(sig)
 
+        if inspect.isNewType(self.object) or isinstance(self.object, TypeVar):
+            return
+
         if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals:
             self.add_line('   :final:', sourcename)
 
         canonical_fullname = self.get_canonical_fullname()
-        if not self.doc_as_attr and canonical_fullname and self.fullname != canonical_fullname:
+        if (not self.doc_as_attr and not inspect.isNewType(self.object)
+                and canonical_fullname and self.fullname != canonical_fullname):
             self.add_line('   :canonical: %s' % canonical_fullname, sourcename)
 
         # add inheritance info, if wanted
         if not self.doc_as_attr and self.options.show_inheritance:
             if inspect.getorigbases(self.object):
                 # A subclass of generic types
-                # refs: PEP-560 <https://www.python.org/dev/peps/pep-0560/>
+                # refs: PEP-560 <https://peps.python.org/pep-0560/>
                 bases = list(self.object.__orig_bases__)
             elif hasattr(self.object, '__bases__') and len(self.object.__bases__):
                 # A normal class
@@ -1685,14 +1695,15 @@
             self.add_line('', sourcename)
             self.add_line('   ' + _('Bases: %s') % ', '.join(base_classes), sourcename)
 
-    def get_object_members(self, want_all: bool) -> Tuplebool, ObjectMembers:
-        members = get_class_members(self.object, self.objpath, self.get_attr)
+    def get_object_members(self, want_all: bool) -> tuplebool, ObjectMembers:
+        members = get_class_members(self.object, self.objpath, self.get_attr,
+                                    self.config.autodoc_inherit_docstrings)
         if not want_all:
             if not self.options.members:
                 return False,   # type: ignore
             # specific members given
             selected = 
-            for name in self.options.members:  # type: str
+            for name in self.options.members:
                 if name in members:
                     selected.append(membersname)
                 else:
@@ -1704,7 +1715,28 @@
         else:
             return False, m for m in members.values() if m.class_ == self.object
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
+        if isinstance(self.object, TypeVar):
+            if self.object.__doc__ == TypeVar.__doc__:
+                return 
+        if sys.version_info:2 < (3, 10):
+            if inspect.isNewType(self.object) or isinstance(self.object, TypeVar):
+                parts = self.modname.strip('.').split('.')
+                orig_objpath = self.objpath
+                for i in range(len(parts)):
+                    new_modname = '.'.join(parts:len(parts) - i)
+                    new_objpath = partslen(parts) - i: + orig_objpath
+                    try:
+                        analyzer = ModuleAnalyzer.for_module(new_modname)
+                        analyzer.analyze()
+                        key = ('', new_objpath-1)
+                        comment = list(analyzer.attr_docs.get(key, ))
+                        if comment:
+                            self.objpath = new_objpath
+                            self.modname = new_modname
+                            return comment
+                    except PycodeError:
+                        pass
         if self.doc_as_attr:
             # Don't show the docstring of the class when it is an alias.
             comment = self.get_variable_comment()
@@ -1754,9 +1786,9 @@
                     docstrings.append(initdocstring)
 
         tab_width = self.directive.state.document.settings.tab_width
-        return prepare_docstring(docstring, ignore, tab_width) for docstring in docstrings
+        return prepare_docstring(docstring, tab_width) for docstring in docstrings
 
-    def get_variable_comment(self) -> OptionalListstr:
+    def get_variable_comment(self) -> liststr | None:
         try:
             key = ('', '.'.join(self.objpath))
             if self.doc_as_attr:
@@ -1768,12 +1800,43 @@
         except PycodeError:
             return None
 
-    def add_content(self, more_content: OptionalStringList, no_docstring: bool = False
-                    ) -> None:
+    def add_content(self, more_content: StringList | None) -> None:
+        if inspect.isNewType(self.object):
+            if self.config.autodoc_typehints_format == "short":
+                supertype = restify(self.object.__supertype__, "smart")
+            else:
+                supertype = restify(self.object.__supertype__)
+
+            more_content = StringList(_('alias of %s') % supertype, '', source='')
+        if isinstance(self.object, TypeVar):
+            attrs = repr(self.object.__name__)
+            for constraint in self.object.__constraints__:
+                if self.config.autodoc_typehints_format == "short":
+                    attrs.append(stringify_annotation(constraint, "smart"))
+                else:
+                    attrs.append(stringify_annotation(constraint))
+            if self.object.__bound__:
+                if self.config.autodoc_typehints_format == "short":
+                    bound = restify(self.object.__bound__, "smart")
+                else:
+                    bound = restify(self.object.__bound__)
+                attrs.append(r"bound=\ " + bound)
+            if self.object.__covariant__:
+                attrs.append("covariant=True")
+            if self.object.__contravariant__:
+                attrs.append("contravariant=True")
+
+            more_content = StringList(
+                _('alias of TypeVar(%s)') % ", ".join(attrs), '',
+                source='',
+            )
         if self.doc_as_attr and self.modname != self.get_real_modname():
-            # override analyzer to obtain doccomment around its definition.
-            self.analyzer = ModuleAnalyzer.for_module(self.modname)
-            self.analyzer.analyze()
+            try:
+                # override analyzer to obtain doccomment around its definition.
+                self.analyzer = ModuleAnalyzer.for_module(self.modname)
+                self.analyzer.analyze()
+            except PycodeError:
+                pass
 
         if self.doc_as_attr and not self.get_variable_comment():
             try:
@@ -1792,8 +1855,13 @@
             return
         super().document_members(all_members)
 
-    def generate(self, more_content: OptionalStringList = None, real_modname: str = None,
-                 check_module: bool = False, all_members: bool = False) -> None:
+    def generate(
+        self,
+        more_content: StringList | None = None,
+        real_modname: str | None = None,
+        check_module: bool = False,
+        all_members: bool = False,
+    ) -> None:
         # Do not pass real_modname and use the name from the __module__
         # attribute of the class.
         # If a class gets imported into the module real_modname
@@ -1812,10 +1880,10 @@
     member_order = 10
 
     # needs a higher priority than ClassDocumenter
-    priority = 10
+    priority = ClassDocumenter.priority + 5
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         return isinstance(member, type) and issubclass(member, BaseException)
 
@@ -1827,7 +1895,7 @@
     modname: str = None
     parent: Any = None
     object: Any = None
-    objpath: Liststr = None
+    objpath: liststr = None
 
     def should_suppress_directive_header(self) -> bool:
         """Check directive header should be suppressed."""
@@ -1838,7 +1906,7 @@
         return False
 
     def update_content(self, more_content: StringList) -> None:
-        """Update docstring for the NewType object."""
+        """Update docstring, for example with TypeVar variance."""
         pass
 
 
@@ -1865,75 +1933,6 @@
         super().update_content(more_content)
 
 
-class NewTypeMixin(DataDocumenterMixinBase):
-    """
-    Mixin for DataDocumenter and AttributeDocumenter to provide the feature for
-    supporting NewTypes.
-    """
-
-    def should_suppress_directive_header(self) -> bool:
-        return (inspect.isNewType(self.object) or
-                super().should_suppress_directive_header())
-
-    def update_content(self, more_content: StringList) -> None:
-        if inspect.isNewType(self.object):
-            if self.config.autodoc_typehints_format == "short":
-                supertype = restify(self.object.__supertype__, "smart")
-            else:
-                supertype = restify(self.object.__supertype__)
-
-            more_content.append(_('alias of %s') % supertype, '')
-            more_content.append('', '')
-
-        super().update_content(more_content)
-
-
-class TypeVarMixin(DataDocumenterMixinBase):
-    """
-    Mixin for DataDocumenter and AttributeDocumenter to provide the feature for
-    supporting TypeVars.
-    """
-
-    def should_suppress_directive_header(self) -> bool:
-        return (isinstance(self.object, TypeVar) or
-                super().should_suppress_directive_header())
-
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
-        if ignore is not None:
-            warnings.warn("The 'ignore' argument to autodoc.%s.get_doc() is deprecated."
-                          % self.__class__.__name__,
-                          RemovedInSphinx50Warning, stacklevel=2)
-
-        if isinstance(self.object, TypeVar):
-            if self.object.__doc__ != TypeVar.__doc__:
-                return super().get_doc()  # type: ignore
-            else:
-                return 
-        else:
-            return super().get_doc()  # type: ignore
-
-    def update_content(self, more_content: StringList) -> None:
-        if isinstance(self.object, TypeVar):
-            attrs = repr(self.object.__name__)
-            for constraint in self.object.__constraints__:
-                attrs.append(stringify_typehint(constraint))
-            if self.object.__bound__:
-                if self.config.autodoc_typehints_format == "short":
-                    bound = restify(self.object.__bound__, "smart")
-                else:
-                    bound = restify(self.object.__bound__)
-                attrs.append(r"bound=\ " + bound)
-            if self.object.__covariant__:
-                attrs.append("covariant=True")
-            if self.object.__contravariant__:
-                attrs.append("contravariant=True")
-
-            more_content.append(_('alias of TypeVar(%s)') % ", ".join(attrs), '')
-            more_content.append('', '')
-
-        super().update_content(more_content)
-
-
 class UninitializedGlobalVariableMixin(DataDocumenterMixinBase):
     """
     Mixin for DataDocumenter to provide the feature for supporting uninitialized
@@ -1959,23 +1958,22 @@
 
             if raiseerror:
                 raise
-            else:
-                logger.warning(exc.args0, type='autodoc', subtype='import_object')
-                self.env.note_reread()
-                return False
+            logger.warning(exc.args0, type='autodoc', subtype='import_object')
+            self.env.note_reread()
+            return False
 
     def should_suppress_value_header(self) -> bool:
         return (self.object is UNINITIALIZED_ATTR or
                 super().should_suppress_value_header())
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         if self.object is UNINITIALIZED_ATTR:
             return 
         else:
-            return super().get_doc(ignore)  # type: ignore
+            return super().get_doc()  # type: ignore
 
 
-class DataDocumenter(GenericAliasMixin, NewTypeMixin, TypeVarMixin,
+class DataDocumenter(GenericAliasMixin,
                      UninitializedGlobalVariableMixin, ModuleLevelDocumenter):
     """
     Specialized Documenter subclass for data items.
@@ -1988,7 +1986,7 @@
     option_spec"no-value" = bool_option
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         return isinstance(parent, ModuleDocumenter) and isattr
 
@@ -2038,7 +2036,12 @@
                 annotations = get_type_hints(self.parent, None,
                                              self.config.autodoc_type_aliases)
                 if self.objpath-1 in annotations:
-                    objrepr = stringify_typehint(annotations.get(self.objpath-1))
+                    if self.config.autodoc_typehints_format == "short":
+                        objrepr = stringify_annotation(annotations.get(self.objpath-1),
+                                                       "smart")
+                    else:
+                        objrepr = stringify_annotation(annotations.get(self.objpath-1),
+                                                       "fully-qualified-except-typing")
                     self.add_line('   :type: ' + objrepr, sourcename)
 
             try:
@@ -2058,7 +2061,7 @@
         real_modname = self.get_attr(self.parent or self.object, '__module__', None)
         return real_modname or self.modname
 
-    def get_module_comment(self, attrname: str) -> OptionalListstr:
+    def get_module_comment(self, attrname: str) -> liststr | None:
         try:
             analyzer = ModuleAnalyzer.for_module(self.modname)
             analyzer.analyze()
@@ -2070,16 +2073,15 @@
 
         return None
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         # Check the variable has a docstring-comment
         comment = self.get_module_comment(self.objpath-1)
         if comment:
             return comment
         else:
-            return super().get_doc(ignore)
+            return super().get_doc()
 
-    def add_content(self, more_content: OptionalStringList, no_docstring: bool = False
-                    ) -> None:
+    def add_content(self, more_content: StringList | None) -> None:
         # Disable analyzing variable comment on Documenter.add_content() to control it on
         # DataDocumenter.add_content()
         self.analyzer = None
@@ -2088,25 +2090,7 @@
             more_content = StringList()
 
         self.update_content(more_content)
-        super().add_content(more_content, no_docstring=no_docstring)
-
-
-class NewTypeDataDocumenter(DataDocumenter):
-    """
-    Specialized Documenter subclass for NewTypes.
-
-    Note: This must be invoked before FunctionDocumenter because NewType is a kind of
-    function object.
-    """
-
-    objtype = 'newtypedata'
-    directivetype = 'data'
-    priority = FunctionDocumenter.priority + 1
-
-    @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
-                            ) -> bool:
-        return inspect.isNewType(member) and isattr
+        super().add_content(more_content)
 
 
 class MethodDocumenter(DocstringSignatureMixin, ClassLevelDocumenter):  # type: ignore
@@ -2119,7 +2103,7 @@
     priority = 1  # must be more than FunctionDocumenter
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         return inspect.isroutine(member) and not isinstance(parent, ModuleDocumenter)
 
@@ -2140,7 +2124,7 @@
 
         return ret
 
-    def format_args(self, **kwargs: Any) -> str:
+    def format_args(self, **kwargs: Any) -> str | None:
         if self.config.autodoc_typehints in ('none', 'description'):
             kwargs.setdefault('show_annotation', False)
         if self.config.autodoc_typehints_format == "short":
@@ -2256,7 +2240,7 @@
 
         return overload.replace(parameters=parameters)
 
-    def annotate_to_first_argument(self, func: Callable, typ: Type) -> OptionalCallable:
+    def annotate_to_first_argument(self, func: Callable, typ: type) -> Callable | None:
         """Annotate type hint to the first argument of function if needed."""
         try:
             sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases)
@@ -2282,10 +2266,10 @@
             except (AttributeError, TypeError):
                 # failed to update signature (ex. built-in or extension types)
                 return None
-        else:
-            return None
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+        return func
+
+    def get_doc(self) -> listliststr | None:
         if self._new_docstrings is not None:
             # docstring already returned previously, then modified by
             # `DocstringSignatureMixin`.  Just return the previously-computed
@@ -2344,13 +2328,13 @@
         return (not getattr(self, 'non_data_descriptor', False) or
                 super().should_suppress_directive_header())
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         if getattr(self, 'non_data_descriptor', False):
             # the docstring of non datadescriptor is very probably the wrong thing
             # to display
             return None
         else:
-            return super().get_doc(ignore)  # type: ignore
+            return super().get_doc()  # type: ignore
 
 
 class SlotsMixin(DataDocumenterMixinBase):
@@ -2362,10 +2346,7 @@
         """Check the subject is an attribute in __slots__."""
         try:
             __slots__ = inspect.getslots(self.parent)
-            if __slots__ and self.objpath-1 in __slots__:
-                return True
-            else:
-                return False
+            return bool(__slots__) and self.objpath-1 in __slots__
         except (ValueError, TypeError):
             return False
 
@@ -2382,7 +2363,7 @@
         else:
             return super().should_suppress_value_header()
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         if self.object is SLOTSATTR:
             try:
                 __slots__ = inspect.getslots(self.parent)
@@ -2396,16 +2377,7 @@
                                (self.parent.__qualname__, exc), type='autodoc')
                 return 
         else:
-            return super().get_doc(ignore)  # type: ignore
-
-    @property
-    def _datadescriptor(self) -> bool:
-        warnings.warn('AttributeDocumenter._datadescriptor() is deprecated.',
-                      RemovedInSphinx60Warning)
-        if self.object is SLOTSATTR:
-            return True
-        else:
-            return False
+            return super().get_doc()  # type: ignore
 
 
 class RuntimeInstanceAttributeMixin(DataDocumenterMixinBase):
@@ -2427,10 +2399,9 @@
         # An instance variable defined in __init__().
         if self.get_attribute_comment(parent, self.objpath-1):  # type: ignore
             return True
-        elif self.is_runtime_instance_attribute_not_commented(parent):
+        if self.is_runtime_instance_attribute_not_commented(parent):
             return True
-        else:
-            return False
+        return False
 
     def is_runtime_instance_attribute_not_commented(self, parent: Any) -> bool:
         """Check the subject is an attribute defined in __init__() without comment."""
@@ -2471,21 +2442,20 @@
 
             if raiseerror:
                 raise
-            else:
-                logger.warning(exc.args0, type='autodoc', subtype='import_object')
-                self.env.note_reread()
-                return False
+            logger.warning(exc.args0, type='autodoc', subtype='import_object')
+            self.env.note_reread()
+            return False
 
     def should_suppress_value_header(self) -> bool:
         return (self.object is self.RUNTIME_INSTANCE_ATTRIBUTE or
                 super().should_suppress_value_header())
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         if (self.object is self.RUNTIME_INSTANCE_ATTRIBUTE and
                 self.is_runtime_instance_attribute_not_commented(self.parent)):
             return None
         else:
-            return super().get_doc(ignore)  # type: ignore
+            return super().get_doc()  # type: ignore
 
 
 class UninitializedInstanceAttributeMixin(DataDocumenterMixinBase):
@@ -2502,10 +2472,7 @@
     def is_uninitialized_instance_attribute(self, parent: Any) -> bool:
         """Check the subject is an annotation only attribute."""
         annotations = get_type_hints(parent, None, self.config.autodoc_type_aliases)
-        if self.objpath-1 in annotations:
-            return True
-        else:
-            return False
+        return self.objpath-1 in annotations
 
     def import_object(self, raiseerror: bool = False) -> bool:
         """Check the exisitence of uninitialized instance attribute when failed to import
@@ -2527,24 +2494,23 @@
 
             if raiseerror:
                 raise
-            else:
-                logger.warning(exc.args0, type='autodoc', subtype='import_object')
-                self.env.note_reread()
-                return False
+            logger.warning(exc.args0, type='autodoc', subtype='import_object')
+            self.env.note_reread()
+            return False
 
     def should_suppress_value_header(self) -> bool:
         return (self.object is UNINITIALIZED_ATTR or
                 super().should_suppress_value_header())
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         if self.object is UNINITIALIZED_ATTR:
             return None
         else:
-            return super().get_doc(ignore)  # type: ignore
+            return super().get_doc()  # type: ignore
 
 
-class AttributeDocumenter(GenericAliasMixin, NewTypeMixin, SlotsMixin,  # type: ignore
-                          TypeVarMixin, RuntimeInstanceAttributeMixin,
+class AttributeDocumenter(GenericAliasMixin, SlotsMixin,  # type: ignore
+                          RuntimeInstanceAttributeMixin,
                           UninitializedInstanceAttributeMixin, NonDataDescriptorMixin,
                           DocstringStripSignatureMixin, ClassLevelDocumenter):
     """
@@ -2565,41 +2531,19 @@
         return inspect.isfunction(obj) or inspect.isbuiltin(obj) or inspect.ismethod(obj)
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         if isinstance(parent, ModuleDocumenter):
             return False
-        elif inspect.isattributedescriptor(member):
+        if inspect.isattributedescriptor(member):
             return True
-        elif not inspect.isroutine(member) and not isinstance(member, type):
+        if not inspect.isroutine(member) and not isinstance(member, type):
             return True
-        else:
-            return False
+        return False
 
     def document_members(self, all_members: bool = False) -> None:
         pass
 
-    def isinstanceattribute(self) -> bool:
-        """Check the subject is an instance attribute."""
-        warnings.warn('AttributeDocumenter.isinstanceattribute() is deprecated.',
-                      RemovedInSphinx50Warning)
-        # uninitialized instance variable (PEP-526)
-        with mock(self.config.autodoc_mock_imports):
-            try:
-                ret = import_object(self.modname, self.objpath:-1, 'class',
-                                    attrgetter=self.get_attr,
-                                    warningiserror=self.config.autodoc_warningiserror)
-                self.parent = ret3
-                annotations = get_type_hints(self.parent, None,
-                                             self.config.autodoc_type_aliases)
-                if self.objpath-1 in annotations:
-                    self.object = UNINITIALIZED_ATTR
-                    return True
-            except ImportError:
-                pass
-
-        return False
-
     def update_annotations(self, parent: Any) -> None:
         """Update __annotations__ to support type_comment and so on."""
         try:
@@ -2660,7 +2604,12 @@
                 annotations = get_type_hints(self.parent, None,
                                              self.config.autodoc_type_aliases)
                 if self.objpath-1 in annotations:
-                    objrepr = stringify_typehint(annotations.get(self.objpath-1))
+                    if self.config.autodoc_typehints_format == "short":
+                        objrepr = stringify_annotation(annotations.get(self.objpath-1),
+                                                       "smart")
+                    else:
+                        objrepr = stringify_annotation(annotations.get(self.objpath-1),
+                                                       "fully-qualified-except-typing")
                     self.add_line('   :type: ' + objrepr, sourcename)
 
             try:
@@ -2673,7 +2622,7 @@
             except ValueError:
                 pass
 
-    def get_attribute_comment(self, parent: Any, attrname: str) -> OptionalListstr:
+    def get_attribute_comment(self, parent: Any, attrname: str) -> liststr | None:
         for cls in inspect.getmro(parent):
             try:
                 module = safe_getattr(cls, '__module__')
@@ -2690,7 +2639,7 @@
 
         return None
 
-    def get_doc(self, ignore: int = None) -> OptionalListListstr:
+    def get_doc(self) -> listliststr | None:
         # Check the attribute has a docstring-comment
         comment = self.get_attribute_comment(self.parent, self.objpath-1)
         if comment:
@@ -2702,12 +2651,11 @@
             # ref: https://github.com/sphinx-doc/sphinx/issues/7805
             orig = self.config.autodoc_inherit_docstrings
             self.config.autodoc_inherit_docstrings = False  # type: ignore
-            return super().get_doc(ignore)
+            return super().get_doc()
         finally:
             self.config.autodoc_inherit_docstrings = orig  # type: ignore
 
-    def add_content(self, more_content: OptionalStringList, no_docstring: bool = False
-                    ) -> None:
+    def add_content(self, more_content: StringList | None) -> None:
         # Disable analyzing attribute comment on Documenter.add_content() to control it on
         # AttributeDocumenter.add_content()
         self.analyzer = None
@@ -2715,7 +2663,7 @@
         if more_content is None:
             more_content = StringList()
         self.update_content(more_content)
-        super().add_content(more_content, no_docstring)
+        super().add_content(more_content)
 
 
 class PropertyDocumenter(DocstringStripSignatureMixin, ClassLevelDocumenter):  # type: ignore
@@ -2729,7 +2677,7 @@
     priority = AttributeDocumenter.priority + 1
 
     @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
+    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any,
                             ) -> bool:
         if isinstance(parent, ClassDocumenter):
             if inspect.isproperty(member):
@@ -2758,6 +2706,16 @@
         self.isclassmethod = False
         return ret
 
+    def format_args(self, **kwargs: Any) -> str | None:
+        func = self._get_property_getter()
+        if func is None:
+            return None
+
+        # update the annotations of the property getter
+        self.env.app.emit('autodoc-before-process-signature', func, False)
+        # correctly format the arguments for a property
+        return super().format_args(**kwargs)
+
     def document_members(self, all_members: bool = False) -> None:
         pass
 
@@ -2773,50 +2731,33 @@
         if self.isclassmethod:
             self.add_line('   :classmethod:', sourcename)
 
-        if safe_getattr(self.object, 'fget', None):  # property
-            func = self.object.fget
-        elif safe_getattr(self.object, 'func', None):  # cached_property
-            func = self.object.func
-        else:
-            func = None
-
-        if func and self.config.autodoc_typehints != 'none':
-            try:
-                signature = inspect.signature(func,
-                                              type_aliases=self.config.autodoc_type_aliases)
-                if signature.return_annotation is not Parameter.empty:
-                    objrepr = stringify_typehint(signature.return_annotation)
-                    self.add_line('   :type: ' + objrepr, sourcename)
-            except TypeError as exc:
-                logger.warning(__("Failed to get a function signature for %s: %s"),
-                               self.fullname, exc)
-                return None
-            except ValueError:
-                return None
-
-
-class NewTypeAttributeDocumenter(AttributeDocumenter):
-    """
-    Specialized Documenter subclass for NewTypes.
-
-    Note: This must be invoked before MethodDocumenter because NewType is a kind of
-    function object.
-    """
-
-    objtype = 'newvarattribute'
-    directivetype = 'attribute'
-    priority = MethodDocumenter.priority + 1
-
-    @classmethod
-    def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any
-                            ) -> bool:
-        return not isinstance(parent, ModuleDocumenter) and inspect.isNewType(member)
+        func = self._get_property_getter()
+        if func is None or self.config.autodoc_typehints == 'none':
+            return
 
+        try:
+            signature = inspect.signature(func,
+                                          type_aliases=self.config.autodoc_type_aliases)
+            if signature.return_annotation is not Parameter.empty:
+                if self.config.autodoc_typehints_format == "short":
+                    objrepr = stringify_annotation(signature.return_annotation, "smart")
+                else:
+                    objrepr = stringify_annotation(signature.return_annotation,
+                                                   "fully-qualified-except-typing")
+                self.add_line('   :type: ' + objrepr, sourcename)
+        except TypeError as exc:
+            logger.warning(__("Failed to get a function signature for %s: %s"),
+                           self.fullname, exc)
+            pass
+        except ValueError:
+            pass
 
-def get_documenters(app: Sphinx) -> Dictstr, TypeDocumenter:
-    """Returns registered Documenter classes"""
-    warnings.warn("get_documenters() is deprecated.", RemovedInSphinx50Warning, stacklevel=2)
-    return app.registry.documenters
+    def _get_property_getter(self):
+        if safe_getattr(self.object, 'fget', None):  # property
+            return self.object.fget
+        if safe_getattr(self.object, 'func', None):  # cached_property
+            return self.object.func
+        return None
 
 
 def autodoc_attrgetter(app: Sphinx, obj: Any, name: str, *defargs: Any) -> Any:
@@ -2828,40 +2769,20 @@
     return safe_getattr(obj, name, *defargs)
 
 
-def migrate_autodoc_member_order(app: Sphinx, config: Config) -> None:
-    if config.autodoc_member_order == 'alphabetic':
-        # RemovedInSphinx50Warning
-        logger.warning(__('autodoc_member_order now accepts "alphabetical" '
-                          'instead of "alphabetic". Please update your setting.'))
-        config.autodoc_member_order = 'alphabetical'  # type: ignore
-
-
-# for compatibility
-from sphinx.ext.autodoc.deprecated import DataDeclarationDocumenter  # NOQA
-from sphinx.ext.autodoc.deprecated import GenericAliasDocumenter  # NOQA
-from sphinx.ext.autodoc.deprecated import InstanceAttributeDocumenter  # NOQA
-from sphinx.ext.autodoc.deprecated import SingledispatchFunctionDocumenter  # NOQA
-from sphinx.ext.autodoc.deprecated import SingledispatchMethodDocumenter  # NOQA
-from sphinx.ext.autodoc.deprecated import SlotsAttributeDocumenter  # NOQA
-from sphinx.ext.autodoc.deprecated import TypeVarDocumenter  # NOQA
-
-
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_autodocumenter(ModuleDocumenter)
     app.add_autodocumenter(ClassDocumenter)
     app.add_autodocumenter(ExceptionDocumenter)
     app.add_autodocumenter(DataDocumenter)
-    app.add_autodocumenter(NewTypeDataDocumenter)
     app.add_autodocumenter(FunctionDocumenter)
     app.add_autodocumenter(DecoratorDocumenter)
     app.add_autodocumenter(MethodDocumenter)
     app.add_autodocumenter(AttributeDocumenter)
     app.add_autodocumenter(PropertyDocumenter)
-    app.add_autodocumenter(NewTypeAttributeDocumenter)
 
     app.add_config_value('autoclass_content', 'class', True, ENUM('both', 'class', 'init'))
     app.add_config_value('autodoc_member_order', 'alphabetical', True,
-                         ENUM('alphabetic', 'alphabetical', 'bysource', 'groupwise'))
+                         ENUM('alphabetical', 'bysource', 'groupwise'))
     app.add_config_value('autodoc_class_signature', 'mixed', True, ENUM('mixed', 'separated'))
     app.add_config_value('autodoc_default_options', {}, True)
     app.add_config_value('autodoc_docstring_signature', True, True)
@@ -2869,9 +2790,9 @@
     app.add_config_value('autodoc_typehints', "signature", True,
                          ENUM("signature", "description", "none", "both"))
     app.add_config_value('autodoc_typehints_description_target', 'all', True,
-                         ENUM('all', 'documented'))
+                         ENUM('all', 'documented', 'documented_params'))
     app.add_config_value('autodoc_type_aliases', {}, True)
-    app.add_config_value('autodoc_typehints_format', "fully-qualified", 'env',
+    app.add_config_value('autodoc_typehints_format', "short", 'env',
                          ENUM("fully-qualified", "short"))
     app.add_config_value('autodoc_warningiserror', True, True)
     app.add_config_value('autodoc_inherit_docstrings', True, True)
@@ -2881,8 +2802,6 @@
     app.add_event('autodoc-skip-member')
     app.add_event('autodoc-process-bases')
 
-    app.connect('config-inited', migrate_autodoc_member_order, priority=800)
-
     app.setup_extension('sphinx.ext.autodoc.preserve_defaults')
     app.setup_extension('sphinx.ext.autodoc.type_comment')
     app.setup_extension('sphinx.ext.autodoc.typehints')

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/directive.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/directive.py Changed

@@ -1,13 +1,6 @@
-"""
-    sphinx.ext.autodoc.directive
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import Any, Callable, Dict, List, Set, Type
+from typing import Any, Callable
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -16,7 +9,6 @@
 from docutils.utils import Reporter, assemble_option_dict
 
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.ext.autodoc import Documenter, Options
 from sphinx.util import logging
@@ -30,7 +22,7 @@
 AUTODOC_DEFAULT_OPTIONS = 'members', 'undoc-members', 'inherited-members',
                            'show-inheritance', 'private-members', 'special-members',
                            'ignore-module-all', 'exclude-members', 'member-order',
-                           'imported-members', 'class-doc-from'
+                           'imported-members', 'class-doc-from', 'no-value'
 
 AUTODOC_EXTENDABLE_OPTIONS = 'members', 'private-members', 'special-members',
                               'exclude-members'
@@ -50,63 +42,44 @@
 class DocumenterBridge:
     """A parameters container for Documenters."""
 
-    def __init__(self, env: BuildEnvironment, reporter: Reporter, options: Options,
+    def __init__(self, env: BuildEnvironment, reporter: Reporter | None, options: Options,
                  lineno: int, state: Any) -> None:
         self.env = env
         self._reporter = reporter
         self.genopt = options
         self.lineno = lineno
-        self.record_dependencies: Setstr = set()
+        self.record_dependencies: setstr = set()
         self.result = StringList()
         self.state = state
 
-    def warn(self, msg: str) -> None:
-        warnings.warn('DocumenterBridge.warn is deprecated.  Please use sphinx.util.logging '
-                      'module instead.',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        logger.warning(msg, location=(self.env.docname, self.lineno))
-
-    @property
-    def filename_set(self) -> Set:
-        warnings.warn('DocumenterBridge.filename_set is deprecated.',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        return self.record_dependencies
-
-    @property
-    def reporter(self) -> Reporter:
-        warnings.warn('DocumenterBridge.reporter is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self._reporter
 
-
-def process_documenter_options(documenter: TypeDocumenter, config: Config, options: Dict
+def process_documenter_options(documenter: typeDocumenter, config: Config, options: dict,
                                ) -> Options:
     """Recognize options of Documenter from user input."""
     for name in AUTODOC_DEFAULT_OPTIONS:
         if name not in documenter.option_spec:
             continue
-        else:
-            negated = options.pop('no-' + name, True) is None
-            if name in config.autodoc_default_options and not negated:
-                if name in options and isinstance(config.autodoc_default_optionsname, str):
-                    # take value from options if present or extend it
-                    # with autodoc_default_options if necessary
-                    if name in AUTODOC_EXTENDABLE_OPTIONS:
-                        if optionsname is not None and optionsname.startswith('+'):
-                            optionsname = ','.join(config.autodoc_default_optionsname,
-                                                      optionsname1:)
-                else:
-                    optionsname = config.autodoc_default_optionsname
-
-            elif options.get(name) is not None:
-                # remove '+' from option argument if there's nothing to merge it with
-                optionsname = optionsname.lstrip('+')
+        negated = options.pop('no-' + name, True) is None
+        if name in config.autodoc_default_options and not negated:
+            if name in options and isinstance(config.autodoc_default_optionsname, str):
+                # take value from options if present or extend it
+                # with autodoc_default_options if necessary
+                if name in AUTODOC_EXTENDABLE_OPTIONS:
+                    if optionsname is not None and optionsname.startswith('+'):
+                        optionsname = ','.join(config.autodoc_default_optionsname,
+                                                  optionsname1:)
+            else:
+                optionsname = config.autodoc_default_optionsname
+
+        elif options.get(name) is not None:
+            # remove '+' from option argument if there's nothing to merge it with
+            optionsname = optionsname.lstrip('+')
 
     return Options(assemble_option_dict(options.items(), documenter.option_spec))
 
 
-def parse_generated_content(state: RSTState, content: StringList, documenter: Documenter
-                            ) -> ListNode:
+def parse_generated_content(state: RSTState, content: StringList, documenter: Documenter,
+                            ) -> listNode:
     """Parse an item of content generated by Documenter."""
     with switch_source_input(state, content):
         if documenter.titles_allowed:
@@ -134,7 +107,7 @@
     optional_arguments = 0
     final_argument_whitespace = True
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         reporter = self.state.document.reporter
 
         try:

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/importer.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/importer.py Changed

@@ -1,29 +1,25 @@
-"""
-    sphinx.ext.autodoc.importer
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Importer utilities for autodoc"""
 
-    Importer utilities for autodoc
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import importlib
 import traceback
 import warnings
-from typing import Any, Callable, Dict, List, NamedTuple, Optional, Tuple
+from typing import TYPE_CHECKING, Any, Callable, NamedTuple
 
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.ext.autodoc.mock import ismock, undecorate
 from sphinx.pycode import ModuleAnalyzer, PycodeError
 from sphinx.util import logging
-from sphinx.util.inspect import (getannotations, getmro, getslots, isclass, isenumclass,
-                                 safe_getattr)
-
-if False:
-    # For type annotation
-    from typing import Type  # NOQA
-
+from sphinx.util.inspect import (
+    getannotations,
+    getmro,
+    getslots,
+    isclass,
+    isenumclass,
+    safe_getattr,
+)
+
+if TYPE_CHECKING:
     from sphinx.ext.autodoc import ObjectMember
 
 logger = logging.getLogger(__name__)
@@ -33,14 +29,14 @@
     """Mangle the given name."""
     try:
         if isclass(subject) and name.startswith('__') and not name.endswith('__'):
-            return "_%s%s" % (subject.__name__, name)
+            return f"_{subject.__name__}{name}"
     except AttributeError:
         pass
 
     return name
 
 
-def unmangle(subject: Any, name: str) -> Optionalstr:
+def unmangle(subject: Any, name: str) -> str | None:
     """Unmangle the given name."""
     try:
         if isclass(subject) and not name.endswith('__'):
@@ -74,7 +70,7 @@
         raise ImportError(exc, traceback.format_exc()) from exc
 
 
-def import_object(modname: str, objpath: Liststr, objtype: str = '',
+def import_object(modname: str, objpath: liststr, objtype: str = '',
                   attrgetter: CallableAny, str, Any = safe_getattr,
                   warningiserror: bool = False) -> Any:
     if objpath:
@@ -127,7 +123,7 @@
             errmsg = ('autodoc: failed to import %s %r from module %r' %
                       (objtype, '.'.join(objpath), modname))
         else:
-            errmsg = 'autodoc: failed to import %s %r' % (objtype, modname)
+            errmsg = f'autodoc: failed to import {objtype} {modname!r}'
 
         if isinstance(exc, ImportError):
             # import_module() raises ImportError having real exception obj and
@@ -147,44 +143,25 @@
         raise ImportError(errmsg) from exc
 
 
-def get_module_members(module: Any) -> ListTuplestr, Any:
-    """Get members of target module."""
-    from sphinx.ext.autodoc import INSTANCEATTR
-
-    warnings.warn('sphinx.ext.autodoc.importer.get_module_members() is deprecated.',
-                  RemovedInSphinx50Warning)
-
-    members: Dictstr, Tuplestr, Any = {}
-    for name in dir(module):
-        try:
-            value = safe_getattr(module, name, None)
-            membersname = (name, value)
-        except AttributeError:
-            continue
-
-    # annotation only member (ex. attr: int)
-    for name in getannotations(module):
-        if name not in members:
-            membersname = (name, INSTANCEATTR)
-
-    return sorted(list(members.values()))
-
-
 class Attribute(NamedTuple):
     name: str
     directly_defined: bool
     value: Any
 
 
-def get_object_members(subject: Any, objpath: Liststr, attrgetter: Callable,
-                       analyzer: ModuleAnalyzer = None) -> Dictstr, Attribute:
+def get_object_members(
+    subject: Any,
+    objpath: liststr,
+    attrgetter: Callable,
+    analyzer: ModuleAnalyzer | None = None,
+) -> dictstr, Attribute:
     """Get members and attributes of target object."""
     from sphinx.ext.autodoc import INSTANCEATTR
 
     # the members directly defined in the class
     obj_dict = attrgetter(subject, '__dict__', {})
 
-    members: Dictstr, Attribute = {}
+    members: dictstr, Attribute = {}
 
     # enum members
     if isenumclass(subject):
@@ -237,15 +214,15 @@
     return members
 
 
-def get_class_members(subject: Any, objpath: Liststr, attrgetter: Callable
-                      ) -> Dictstr, "ObjectMember":
+def get_class_members(subject: Any, objpath: liststr, attrgetter: Callable,
+                      inherit_docstrings: bool = True) -> dictstr, ObjectMember:
     """Get members and attributes of target class."""
     from sphinx.ext.autodoc import INSTANCEATTR, ObjectMember
 
     # the members directly defined in the class
     obj_dict = attrgetter(subject, '__dict__', {})
 
-    members: Dictstr, ObjectMember = {}
+    members: dictstr, ObjectMember = {}
 
     # enum members
     if isenumclass(subject):
@@ -312,12 +289,24 @@
                     membersname = ObjectMember(name, INSTANCEATTR, class_=cls,
                                                  docstring=docstring)
 
-            # append instance attributes (cf. self.attr1) if analyzer knows
+            # append or complete instance attributes (cf. self.attr1) if analyzer knows
             if analyzer:
                 for (ns, name), docstring in analyzer.attr_docs.items():
                     if ns == qualname and name not in members:
+                        # otherwise unknown instance attribute
                         membersname = ObjectMember(name, INSTANCEATTR, class_=cls,
                                                      docstring='\n'.join(docstring))
+                    elif (ns == qualname and docstring and
+                          isinstance(membersname, ObjectMember) and
+                          not membersname.docstring):
+                        if cls != subject and not inherit_docstrings:
+                            # If we are in the MRO of the class and not the class itself,
+                            # and we do not want to inherit docstrings, then skip setting
+                            # the docstring below
+                            continue
+                        # attribute is already known, because dir(subject) enumerates it.
+                        # But it has no docstring yet
+                        membersname.docstring = '\n'.join(docstring)
     except AttributeError:
         pass

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/mock.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/mock.py Changed

@@ -1,23 +1,17 @@
-"""
-    sphinx.ext.autodoc.mock
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""mock for autodoc"""
 
-    mock for autodoc
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import contextlib
 import os
 import sys
 from importlib.abc import Loader, MetaPathFinder
 from importlib.machinery import ModuleSpec
-from types import ModuleType
-from typing import Any, Generator, Iterator, List, Optional, Sequence, Tuple, Union
+from types import MethodType, ModuleType
+from typing import Any, Generator, Iterator, Sequence
 
 from sphinx.util import logging
-from sphinx.util.inspect import safe_getattr
+from sphinx.util.inspect import isboundmethod, safe_getattr
 
 logger = logging.getLogger(__name__)
 
@@ -28,7 +22,7 @@
     __display_name__ = '_MockObject'
     __name__ = ''
     __sphinx_mock__ = True
-    __sphinx_decorator_args__: TupleAny, ... = ()
+    __sphinx_decorator_args__: tupleAny, ... = ()
 
     def __new__(cls, *args: Any, **kwargs: Any) -> Any:
         if len(args) == 3 and isinstance(args1, tuple):
@@ -52,13 +46,13 @@
     def __iter__(self) -> Iterator:
         return iter()
 
-    def __mro_entries__(self, bases: Tuple) -> Tuple:
+    def __mro_entries__(self, bases: tuple) -> tuple:
         return (self.__class__,)
 
-    def __getitem__(self, key: Any) -> "_MockObject":
+    def __getitem__(self, key: Any) -> _MockObject:
         return _make_subclass(str(key), self.__display_name__, self.__class__)()
 
-    def __getattr__(self, key: str) -> "_MockObject":
+    def __getattr__(self, key: str) -> _MockObject:
         return _make_subclass(key, self.__display_name__, self.__class__)()
 
     def __call__(self, *args: Any, **kwargs: Any) -> Any:
@@ -71,7 +65,7 @@
 
 
 def _make_subclass(name: str, module: str, superclass: Any = _MockObject,
-                   attributes: Any = None, decorator_args: Tuple = ()) -> Any:
+                   attributes: Any = None, decorator_args: tuple = ()) -> Any:
     attrs = {'__module__': module,
              '__display_name__': module + '.' + name,
              '__name__': name,
@@ -88,8 +82,8 @@
 
     def __init__(self, name: str) -> None:
         super().__init__(name)
-        self.__all__: Liststr = 
-        self.__path__: Liststr = 
+        self.__all__: liststr = 
+        self.__path__: liststr = 
 
     def __getattr__(self, name: str) -> _MockObject:
         return _make_subclass(name, self.__name__)()
@@ -100,7 +94,7 @@
 
 class MockLoader(Loader):
     """A loader for mocking."""
-    def __init__(self, finder: "MockFinder") -> None:
+    def __init__(self, finder: MockFinder) -> None:
         super().__init__()
         self.finder = finder
 
@@ -116,14 +110,14 @@
 class MockFinder(MetaPathFinder):
     """A finder for mocking."""
 
-    def __init__(self, modnames: Liststr) -> None:
+    def __init__(self, modnames: liststr) -> None:
         super().__init__()
         self.modnames = modnames
         self.loader = MockLoader(self)
-        self.mocked_modules: Liststr = 
+        self.mocked_modules: liststr = 
 
-    def find_spec(self, fullname: str, path: OptionalSequenceUnionbytes, str,
-                  target: ModuleType = None) -> OptionalModuleSpec:
+    def find_spec(self, fullname: str, path: Sequencebytes | str | None,
+                  target: ModuleType = None) -> ModuleSpec | None:
         for modname in self.modnames:
             # check if fullname is (or is a descendant of) one of our targets
             if modname == fullname or fullname.startswith(modname + '.'):
@@ -138,7 +132,7 @@
 
 
 @contextlib.contextmanager
-def mock(modnames: Liststr) -> GeneratorNone, None, None:
+def mock(modnames: liststr) -> GeneratorNone, None, None:
     """Insert mock modules during context::
 
         with mock('target.module.name'):
@@ -154,6 +148,11 @@
         finder.invalidate_caches()
 
 
+def ismockmodule(subject: Any) -> bool:
+    """Check if the object is a mocked module."""
+    return isinstance(subject, _MockModule)
+
+
 def ismock(subject: Any) -> bool:
     """Check if the object is mocked."""
     # check the object has '__sphinx_mock__' attribute
@@ -167,9 +166,15 @@
     if isinstance(subject, _MockModule):
         return True
 
+    # check the object is bound method
+    if isinstance(subject, MethodType) and isboundmethod(subject):
+        tmp_subject = subject.__func__
+    else:
+        tmp_subject = subject
+
     try:
         # check the object is mocked object
-        __mro__ = safe_getattr(type(subject), '__mro__', )
+        __mro__ = safe_getattr(type(tmp_subject), '__mro__', )
         if len(__mro__) > 2 and __mro__-2 is _MockObject:
             # A mocked object has a MRO that ends with (..., _MockObject, object).
             return True

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/preserve_defaults.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/preserve_defaults.py Changed

@@ -1,22 +1,18 @@
-"""
-    sphinx.ext.autodoc.preserve_defaults
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Preserve the default argument values of function signatures in source code
-    and keep them not evaluated for readability.
+"""Preserve function defaults.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Preserve the default argument values of function signatures in source code
+and keep them not evaluated for readability.
 """
 
+from __future__ import annotations
+
 import ast
 import inspect
-import sys
-from typing import Any, Dict, List, Optional
+from typing import Any
 
+import sphinx
 from sphinx.application import Sphinx
 from sphinx.locale import __
-from sphinx.pycode.ast import parse as ast_parse
 from sphinx.pycode.ast import unparse as ast_unparse
 from sphinx.util import logging
 
@@ -31,7 +27,7 @@
         return self.name
 
 
-def get_function_def(obj: Any) -> ast.FunctionDef:
+def get_function_def(obj: Any) -> ast.FunctionDef | None:
     """Get FunctionDef object from living object.
     This tries to parse original code for living object and returns
     AST node for given *obj*.
@@ -41,20 +37,18 @@
         if source.startswith((' ', r'\t')):
             # subject is placed inside class or block.  To read its docstring,
             # this adds if-block before the declaration.
-            module = ast_parse('if True:\n' + source)
+            module = ast.parse('if True:\n' + source)
             return module.body0.body0  # type: ignore
         else:
-            module = ast_parse(source)
+            module = ast.parse(source)
             return module.body0  # type: ignore
     except (OSError, TypeError):  # failed to load source code
         return None
 
 
-def get_default_value(lines: Liststr, position: ast.AST) -> Optionalstr:
+def get_default_value(lines: liststr, position: ast.AST) -> str | None:
     try:
-        if sys.version_info < (3, 8):  # only for py38+
-            return None
-        elif position.lineno == position.end_lineno:
+        if position.lineno == position.end_lineno:
             line = linesposition.lineno - 1
             return lineposition.col_offset:position.end_col_offset
         else:
@@ -84,21 +78,35 @@
             kw_defaults = list(function.args.kw_defaults)
             parameters = list(sig.parameters.values())
             for i, param in enumerate(parameters):
-                if param.default is not param.empty:
+                if param.default is param.empty:
+                    if param.kind == param.KEYWORD_ONLY:
+                        # Consume kw_defaults for kwonly args
+                        kw_defaults.pop(0)
+                else:
                     if param.kind in (param.POSITIONAL_ONLY, param.POSITIONAL_OR_KEYWORD):
                         default = defaults.pop(0)
                         value = get_default_value(lines, default)
                         if value is None:
-                            value = ast_unparse(default)  # type: ignore
+                            value = ast_unparse(default)
                         parametersi = param.replace(default=DefaultValue(value))
                     else:
                         default = kw_defaults.pop(0)
                         value = get_default_value(lines, default)
                         if value is None:
-                            value = ast_unparse(default)  # type: ignore
+                            value = ast_unparse(default)
                         parametersi = param.replace(default=DefaultValue(value))
+
+            if bound_method and inspect.ismethod(obj):
+                # classmethods
+                cls = inspect.Parameter('cls', inspect.Parameter.POSITIONAL_OR_KEYWORD)
+                parameters.insert(0, cls)
+
             sig = sig.replace(parameters=parameters)
-            obj.__signature__ = sig
+            if bound_method and inspect.ismethod(obj):
+                # classmethods can't be assigned __signature__ attribute.
+                obj.__dict__'__signature__' = sig
+            else:
+                obj.__signature__ = sig
     except (AttributeError, TypeError):
         # failed to update signature (ex. built-in or extension types)
         pass
@@ -106,11 +114,11 @@
         logger.warning(__("Failed to parse a default argument value for %r: %s"), obj, exc)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_config_value('autodoc_preserve_defaults', False, True)
     app.connect('autodoc-before-process-signature', update_defvalue)
 
     return {
-        'version': '1.0',
-        'parallel_read_safe': True
+        'version': sphinx.__display_version__,
+        'parallel_read_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/type_comment.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/type_comment.py Changed

@@ -1,38 +1,31 @@
-"""
-    sphinx.ext.autodoc.type_comment
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Update annotations info of living objects using type_comments."""
 
-    Update annotations info of living objects using type_comments.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import ast
 from inspect import Parameter, Signature, getsource
-from typing import Any, Dict, List, cast
+from typing import Any, cast
 
 import sphinx
 from sphinx.application import Sphinx
 from sphinx.locale import __
-from sphinx.pycode.ast import ast
-from sphinx.pycode.ast import parse as ast_parse
 from sphinx.pycode.ast import unparse as ast_unparse
 from sphinx.util import inspect, logging
 
 logger = logging.getLogger(__name__)
 
 
-def not_suppressed(argtypes: Listast.AST = ) -> bool:
+def not_suppressed(argtypes: listast.AST = ) -> bool:
     """Check given *argtypes* is suppressed type_comment or not."""
     if len(argtypes) == 0:  # no argtypees
         return False
-    elif len(argtypes) == 1 and ast_unparse(argtypes0) == "...":  # suppressed
+    if len(argtypes) == 1 and ast_unparse(argtypes0) == "...":  # suppressed
         # Note: To support multiple versions of python, this uses ``ast_unparse()`` for
         # comparison with Ellipsis.  Since 3.8, ast.Constant has been used to represent
         # Ellipsis node instead of ast.Ellipsis.
         return False
-    else:  # not suppressed
-        return True
+    # not suppressed
+    return True
 
 
 def signature_from_ast(node: ast.FunctionDef, bound_method: bool,
@@ -42,10 +35,9 @@
     :param bound_method: Specify *node* is a bound method or not
     """
     params = 
-    if hasattr(node.args, "posonlyargs"):  # for py38+
-        for arg in node.args.posonlyargs:  # type: ignore
-            param = Parameter(arg.arg, Parameter.POSITIONAL_ONLY, annotation=arg.type_comment)
-            params.append(param)
+    for arg in node.args.posonlyargs:
+        param = Parameter(arg.arg, Parameter.POSITIONAL_ONLY, annotation=arg.type_comment)
+        params.append(param)
 
     for arg in node.args.args:
         param = Parameter(arg.arg, Parameter.POSITIONAL_OR_KEYWORD,
@@ -84,25 +76,25 @@
         return Signature(params)
 
 
-def get_type_comment(obj: Any, bound_method: bool = False) -> Signature:
+def get_type_comment(obj: Any, bound_method: bool = False) -> Signature | None:
     """Get type_comment'ed FunctionDef object from living object.
 
     This tries to parse original code for living object and returns
-    Signature for given *obj*.  It requires py38+ or typed_ast module.
+    Signature for given *obj*.
     """
     try:
         source = getsource(obj)
         if source.startswith((' ', r'\t')):
             # subject is placed inside class or block.  To read its docstring,
             # this adds if-block before the declaration.
-            module = ast_parse('if True:\n' + source)
+            module = ast.parse('if True:\n' + source, type_comments=True)
             subject = cast(ast.FunctionDef, module.body0.body0)  # type: ignore
         else:
-            module = ast_parse(source)
-            subject = cast(ast.FunctionDef, module.body0)  # type: ignore
+            module = ast.parse(source, type_comments=True)
+            subject = cast(ast.FunctionDef, module.body0)
 
         if getattr(subject, "type_comment", None):
-            function = ast_parse(subject.type_comment, mode='func_type')
+            function = ast.parse(subject.type_comment, mode='func_type', type_comments=True)
             return signature_from_ast(subject, bound_method, function)  # type: ignore
         else:
             return None
@@ -133,7 +125,7 @@
         logger.warning(__("Failed to parse type_comment for %r: %s"), obj, exc)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('autodoc-before-process-signature', update_annotations_using_type_comments)
 
     return {'version': sphinx.__display_version__, 'parallel_read_safe': True}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autodoc/typehints.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autodoc/typehints.py Changed

@@ -1,27 +1,22 @@
-"""
-    sphinx.ext.autodoc.typehints
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Generating content for autodoc using typehints"""
 
-    Generating content for autodoc using typehints
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from collections import OrderedDict
-from typing import Any, Dict, Iterable, Set, cast
+from typing import Any, Iterable, cast
 
 from docutils import nodes
 from docutils.nodes import Element
 
+import sphinx
 from sphinx import addnodes
 from sphinx.application import Sphinx
-from sphinx.util import inspect, typing
+from sphinx.util import inspect
+from sphinx.util.typing import stringify_annotation
 
 
 def record_typehints(app: Sphinx, objtype: str, name: str, obj: Any,
-                     options: Dict, args: str, retann: str) -> None:
+                     options: dict, args: str, retann: str) -> None:
     """Record type hints to env object."""
     if app.config.autodoc_typehints_format == 'short':
         mode = 'smart'
@@ -31,13 +26,13 @@
     try:
         if callable(obj):
             annotations = app.env.temp_data.setdefault('annotations', {})
-            annotation = annotations.setdefault(name, OrderedDict())
+            annotation = annotations.setdefault(name, {})
             sig = inspect.signature(obj, type_aliases=app.config.autodoc_type_aliases)
             for param in sig.parameters.values():
                 if param.annotation is not param.empty:
-                    annotationparam.name = typing.stringify(param.annotation, mode)
+                    annotationparam.name = stringify_annotation(param.annotation, mode)
             if sig.return_annotation is not sig.empty:
-                annotation'return' = typing.stringify(sig.return_annotation, mode)
+                annotation'return' = stringify_annotation(sig.return_annotation, mode)
     except (TypeError, ValueError):
         pass
 
@@ -67,9 +62,18 @@
 
         for field_list in field_lists:
             if app.config.autodoc_typehints_description_target == "all":
-                modify_field_list(field_list, annotationsfullname)
+                if objtype == 'class':
+                    modify_field_list(field_list, annotationsfullname, suppress_rtype=True)
+                else:
+                    modify_field_list(field_list, annotationsfullname)
+            elif app.config.autodoc_typehints_description_target == "documented_params":
+                augment_descriptions_with_types(
+                    field_list, annotationsfullname, force_rtype=True,
+                )
             else:
-                augment_descriptions_with_types(field_list, annotationsfullname)
+                augment_descriptions_with_types(
+                    field_list, annotationsfullname, force_rtype=False,
+                )
 
 
 def insert_field_list(node: Element) -> nodes.field_list:
@@ -85,8 +89,9 @@
     return field_list
 
 
-def modify_field_list(node: nodes.field_list, annotations: Dictstr, str) -> None:
-    arguments: Dictstr, Dictstr, bool = {}
+def modify_field_list(node: nodes.field_list, annotations: dictstr, str,
+                      suppress_rtype: bool = False) -> None:
+    arguments: dictstr, dictstr, bool = {}
     fields = cast(Iterablenodes.field, node)
     for field in fields:
         field_name = field0.astext()
@@ -113,7 +118,15 @@
         if name == 'return':
             continue
 
-        arg = arguments.get(name, {})
+        if '*' + name in arguments:
+            name = '*' + name
+            arguments.get(name)
+        elif '**' + name in arguments:
+            name = '**' + name
+            arguments.get(name)
+        else:
+            arg = arguments.get(name, {})
+
         if not arg.get('type'):
             field = nodes.field()
             field += nodes.field_name('', 'type ' + name)
@@ -126,6 +139,10 @@
             node += field
 
     if 'return' in annotations and 'return' not in arguments:
+        annotation = annotations'return'
+        if annotation == 'None' and suppress_rtype:
+            return
+
         field = nodes.field()
         field += nodes.field_name('', 'rtype')
         field += nodes.field_body('', nodes.paragraph('', annotation))
@@ -134,11 +151,12 @@
 
 def augment_descriptions_with_types(
     node: nodes.field_list,
-    annotations: Dictstr, str,
+    annotations: dictstr, str,
+    force_rtype: bool,
 ) -> None:
     fields = cast(Iterablenodes.field, node)
-    has_description = set()  # type: Setstr
-    has_type = set()  # type: Setstr
+    has_description: setstr = set()
+    has_type: setstr = set()
     for field in fields:
         field_name = field0.astext()
         parts = re.split(' +', field_name)
@@ -160,30 +178,38 @@
             has_type.add('return')
 
     # Add 'type' for parameters with a description but no declared type.
-    for name in annotations:
+    for name, annotation in annotations.items():
         if name in ('return', 'returns'):
             continue
+
+        if '*' + name in has_description:
+            name = '*' + name
+        elif '**' + name in has_description:
+            name = '**' + name
+
         if name in has_description and name not in has_type:
             field = nodes.field()
             field += nodes.field_name('', 'type ' + name)
-            field += nodes.field_body('', nodes.paragraph('', annotationsname))
+            field += nodes.field_body('', nodes.paragraph('', annotation))
             node += field
 
     # Add 'rtype' if 'return' is present and 'rtype' isn't.
     if 'return' in annotations:
-        if 'return' in has_description and 'return' not in has_type:
+        rtype = annotations'return'
+        if 'return' not in has_type and ('return' in has_description or
+                                         (force_rtype and rtype != "None")):
             field = nodes.field()
             field += nodes.field_name('', 'rtype')
-            field += nodes.field_body('', nodes.paragraph('', annotations'return'))
+            field += nodes.field_body('', nodes.paragraph('', rtype))
             node += field
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('autodoc-process-signature', record_typehints)
     app.connect('object-description-transform', merge_typehints)
 
     return {
-        'version': 'builtin',
+        'version': sphinx.__display_version__,
         'parallel_read_safe': True,
         'parallel_write_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autosectionlabel.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autosectionlabel.py Changed

@@ -1,18 +1,13 @@
-"""
-    sphinx.ext.autosectionlabel
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Allow reference sections by :ref: role using its title."""
 
-    Allow reference sections by :ref: role using its title.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, cast
+from typing import Any, cast
 
 from docutils import nodes
 from docutils.nodes import Node
 
+import sphinx
 from sphinx.application import Sphinx
 from sphinx.domains.std import StandardDomain
 from sphinx.locale import __
@@ -47,6 +42,9 @@
             name = nodes.fully_normalize_name(ref_name)
         sectname = clean_astext(title)
 
+        logger.debug(__('section "%s" gets labeled as "%s"'),
+                     ref_name, name,
+                     location=node, type='autosectionlabel', subtype=docname)
         if name in domain.labels:
             logger.warning(__('duplicate label %s, other instance in %s'),
                            name, app.env.doc2path(domain.labelsname0),
@@ -56,13 +54,13 @@
         domain.labelsname = docname, labelid, sectname
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_config_value('autosectionlabel_prefix_document', False, 'env')
     app.add_config_value('autosectionlabel_maxdepth', None, 'env')
     app.connect('doctree-read', register_sections_as_label)
 
     return {
-        'version': 'builtin',
+        'version': sphinx.__display_version__,
         'parallel_read_safe': True,
         'parallel_write_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autosummary/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autosummary/__init__.py Changed

@@ -1,70 +1,65 @@
-"""
-    sphinx.ext.autosummary
-    ~~~~~~~~~~~~~~~~~~~~~~
-
-    Sphinx extension that adds an autosummary:: directive, which can be
-    used to generate function/method/attribute/etc. summary lists, similar
-    to those output eg. by Epydoc and other API doc generation tools.
+"""Extension that adds an autosummary:: directive.
 
-    An :autolink: role is also provided.
+The directive can be used to generate function/method/attribute/etc. summary
+lists, similar to those output eg. by Epydoc and other API doc generation tools.
 
-    autosummary directive
-    ---------------------
+An :autolink: role is also provided.
 
-    The autosummary directive has the form::
+autosummary directive
+---------------------
 
-        .. autosummary::
-           :nosignatures:
-           :toctree: generated/
+The autosummary directive has the form::
 
-           module.function_1
-           module.function_2
-           ...
+    .. autosummary::
+       :nosignatures:
+       :toctree: generated/
 
-    and it generates an output table (containing signatures, optionally)
+       module.function_1
+       module.function_2
+       ...
 
-        ========================  =============================================
-        module.function_1(args)   Summary line from the docstring of function_1
-        module.function_2(args)   Summary line from the docstring
-        ...
-        ========================  =============================================
+and it generates an output table (containing signatures, optionally)
 
-    If the :toctree: option is specified, files matching the function names
-    are inserted to the toctree with the given prefix:
+    ========================  =============================================
+    module.function_1(args)   Summary line from the docstring of function_1
+    module.function_2(args)   Summary line from the docstring
+    ...
+    ========================  =============================================
 
-        generated/module.function_1
-        generated/module.function_2
-        ...
+If the :toctree: option is specified, files matching the function names
+are inserted to the toctree with the given prefix:
 
-    Note: The file names contain the module:: or currentmodule:: prefixes.
+    generated/module.function_1
+    generated/module.function_2
+    ...
 
-    .. seealso:: autosummary_generate.py
+Note: The file names contain the module:: or currentmodule:: prefixes.
 
+.. seealso:: autosummary_generate.py
 
-    autolink role
-    -------------
 
-    The autolink role functions as ``:obj:`` when the name referred can be
-    resolved to a Python object, and otherwise it becomes simple emphasis.
-    This can be used as the default role to make links 'smart'.
+autolink role
+-------------
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+The autolink role functions as ``:obj:`` when the name referred can be
+resolved to a Python object, and otherwise it becomes simple emphasis.
+This can be used as the default role to make links 'smart'.
 """
 
+from __future__ import annotations
+
 import inspect
 import os
 import posixpath
 import re
 import sys
-import warnings
 from inspect import Parameter
 from os import path
 from types import ModuleType
-from typing import Any, Dict, List, Optional, Sequence, Tuple, Type, cast
+from typing import Any, List, Sequence, cast
 
 from docutils import nodes
-from docutils.nodes import Element, Node, system_message
+from docutils.nodes import Node, system_message
 from docutils.parsers.rst import directives
 from docutils.parsers.rst.states import RSTStateMachine, Struct, state_classes
 from docutils.statemachine import StringList
@@ -73,25 +68,28 @@
 from sphinx import addnodes
 from sphinx.application import Sphinx
 from sphinx.config import Config
-from sphinx.deprecation import (RemovedInSphinx50Warning, RemovedInSphinx60Warning,
-                                deprecated_alias)
 from sphinx.environment import BuildEnvironment
-from sphinx.environment.adapters.toctree import TocTree
 from sphinx.ext.autodoc import INSTANCEATTR, Documenter
 from sphinx.ext.autodoc.directive import DocumenterBridge, Options
 from sphinx.ext.autodoc.importer import import_module
 from sphinx.ext.autodoc.mock import mock
+from sphinx.extension import Extension
 from sphinx.locale import __
 from sphinx.project import Project
 from sphinx.pycode import ModuleAnalyzer, PycodeError
 from sphinx.registry import SphinxComponentRegistry
 from sphinx.util import logging, rst
-from sphinx.util.docutils import (NullReporter, SphinxDirective, SphinxRole, new_document,
-                                  switch_source_input)
-from sphinx.util.inspect import signature_from_str
+from sphinx.util.docutils import (
+    NullReporter,
+    SphinxDirective,
+    SphinxRole,
+    new_document,
+    switch_source_input,
+)
+from sphinx.util.inspect import getmro, signature_from_str
 from sphinx.util.matching import Matcher
 from sphinx.util.typing import OptionSpec
-from sphinx.writers.html import HTMLTranslator
+from sphinx.writers.html import HTML5Translator
 
 logger = logging.getLogger(__name__)
 
@@ -108,32 +106,6 @@
     pass
 
 
-def process_autosummary_toc(app: Sphinx, doctree: nodes.document) -> None:
-    """Insert items described in autosummary:: to the TOC tree, but do
-    not generate the toctree:: list.
-    """
-    warnings.warn('process_autosummary_toc() is deprecated',
-                  RemovedInSphinx50Warning, stacklevel=2)
-    env = app.builder.env
-    crawled = {}
-
-    def crawl_toc(node: Element, depth: int = 1) -> None:
-        crawlednode = True
-        for subnode in node:
-            try:
-                if (isinstance(subnode, autosummary_toc) and
-                        isinstance(subnode0, addnodes.toctree)):
-                    TocTree(env).note(env.docname, subnode0)
-                    continue
-            except IndexError:
-                continue
-            if not isinstance(subnode, nodes.section):
-                continue
-            if subnode not in crawled:
-                crawl_toc(subnode, depth + 1)
-    crawl_toc(doctree)
-
-
 def autosummary_toc_visit_html(self: nodes.NodeVisitor, node: autosummary_toc) -> None:
     """Hide autosummary toctree list in HTML output."""
     raise nodes.SkipNode
@@ -149,7 +121,7 @@
     pass
 
 
-def autosummary_table_visit_html(self: HTMLTranslator, node: autosummary_table) -> None:
+def autosummary_table_visit_html(self: HTML5Translator, node: autosummary_table) -> None:
     """Make the first column of the table non-breaking."""
     try:
         table = cast(nodes.table, node0)
@@ -168,20 +140,12 @@
 
 
 # -- autodoc integration -------------------------------------------------------
-deprecated_alias('sphinx.ext.autosummary',
-                 {
-                     '_app': None,
-                 },
-                 RemovedInSphinx60Warning,
-                 {
-                 })
-
 
 class FakeApplication:
-    def __init__(self):
+    def __init__(self) -> None:
         self.doctreedir = None
         self.events = None
-        self.extensions = {}
+        self.extensions: dictstr, Extension = {}
         self.srcdir = None
         self.config = Config()
         self.project = Project(None, None)
@@ -199,7 +163,7 @@
         super().__init__(env, None, Options(), 0, state)
 
 
-def get_documenter(app: Sphinx, obj: Any, parent: Any) -> TypeDocumenter:
+def get_documenter(app: Sphinx, obj: Any, parent: Any) -> typeDocumenter:
     """Get an autodoc.Documenter class suitable for documenting the given
     object.
 
@@ -255,7 +219,7 @@
         'template': directives.unchanged,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         self.bridge = DocumenterBridge(self.env, self.state.document.reporter,
                                        Options(), self.lineno, self.state)
 
@@ -276,7 +240,7 @@
                 docname = posixpath.join(tree_prefix, real_name)
                 docname = posixpath.normpath(posixpath.join(dirname, docname))
                 if docname not in self.env.found_docs:
-                    if excluded(self.env.doc2path(docname, None)):
+                    if excluded(self.env.doc2path(docname, False)):
                         msg = __('autosummary references excluded document %r. Ignored.')
                     else:
                         msg = __('autosummary: stub file not found %r. '
@@ -303,24 +267,26 @@
 
         return nodes
 
-    def import_by_name(self, name: str, prefixes: Liststr) -> Tuplestr, Any, Any, str:
+    def import_by_name(
+        self, name: str, prefixes: liststr | None,
+    ) -> tuplestr, Any, Any, str:
         with mock(self.config.autosummary_mock_imports):
             try:
-                return import_by_name(name, prefixes, grouped_exception=True)
+                return import_by_name(name, prefixes)
             except ImportExceptionGroup as exc:
                 # check existence of instance attribute
                 try:
                     return import_ivar_by_name(name, prefixes)
                 except ImportError as exc2:
                     if exc2.__cause__:
-                        errors: ListBaseException = exc.exceptions + exc2.__cause__
+                        errors: listBaseException = exc.exceptions + exc2.__cause__
                     else:
                         errors = exc.exceptions + exc2
 
                     raise ImportExceptionGroup(exc.args0, errors)
 
     def create_documenter(self, app: Sphinx, obj: Any,
-                          parent: Any, full_name: str) -> "Documenter":
+                          parent: Any, full_name: str) -> Documenter:
         """Get an autodoc.Documenter class suitable for documenting the given
         object.
 
@@ -329,13 +295,13 @@
         doccls = get_documenter(app, obj, parent)
         return doccls(self.bridge, full_name)
 
-    def get_items(self, names: Liststr) -> ListTuplestr, str, str, str:
+    def get_items(self, names: liststr) -> listtuplestr, str, str, str:
         """Try to import the given names, and return a list of
         ``(name, signature, summary_string, real_name), ...``.
         """
         prefixes = get_import_prefixes_from_env(self.env)
 
-        items: ListTuplestr, str, str, str = 
+        items: listtuplestr, str, str, str = 
 
         max_item_chars = 50
 
@@ -348,7 +314,7 @@
             try:
                 real_name, obj, parent, modname = self.import_by_name(name, prefixes=prefixes)
             except ImportExceptionGroup as exc:
-                errors = list(set("* %s: %s" % (type(e).__name__, e) for e in exc.exceptions))
+                errors = list({f"* {type(e).__name__}: {e}" for e in exc.exceptions})
                 logger.warning(__('autosummary: failed to import %s.\nPossible hints:\n%s'),
                                name, '\n'.join(errors), location=self.get_location())
                 continue
@@ -401,6 +367,9 @@
 
             # -- Grab the summary
 
+            # bodge for ModuleDocumenter
+            documenter._extra_indent = ''  # type: ignoreattr-defined
+
             documenter.add_content(None)
             summary = extract_summary(self.bridge.result.data:, self.state.document)
 
@@ -408,7 +377,7 @@
 
         return items
 
-    def get_table(self, items: ListTuplestr, str, str, str) -> ListNode:
+    def get_table(self, items: listtuplestr, str, str, str) -> listNode:
         """Generate a proper list of table nodes for autosummary:: directive.
 
         *items* is a list produced by :meth:`get_items`.
@@ -417,7 +386,7 @@
         table_spec'spec' = r'\X{1}{2}\X{1}{2}'
 
         table = autosummary_table('')
-        real_table = nodes.table('', classes='longtable')
+        real_table = nodes.table('', classes='autosummary longtable')
         table.append(real_table)
         group = nodes.tgroup('', cols=2)
         real_table.append(group)
@@ -446,9 +415,9 @@
         for name, sig, summary, real_name in items:
             qualifier = 'obj'
             if 'nosignatures' not in self.options:
-                col1 = ':py:%s:`%s <%s>`\\ %s' % (qualifier, name, real_name, rst.escape(sig))
+                col1 = f':py:{qualifier}:`{name} <{real_name}>`\\ {rst.escape(sig)}'
             else:
-                col1 = ':py:%s:`%s <%s>`' % (qualifier, name, real_name)
+                col1 = f':py:{qualifier}:`{name} <{real_name}>`'
             col2 = summary
             append_row(col1, col2)
 
@@ -506,8 +475,8 @@
         s = re.sub(r'{^}*}', '', s)
 
     # Parse the signature to arguments + options
-    args: Liststr = 
-    opts: Liststr = 
+    args: liststr = 
+    opts: liststr = 
 
     opt_re = re.compile(r"^(.*, |)(a-zA-Z0-9_*+)\s*=\s*")
     while s:
@@ -539,9 +508,9 @@
     return "(%s)" % sig
 
 
-def extract_summary(doc: Liststr, document: Any) -> str:
+def extract_summary(doc: liststr, document: Any) -> str:
     """Extract summary from docstring."""
-    def parse(doc: Liststr, settings: Any) -> nodes.document:
+    def parse(doc: liststr, settings: Any) -> nodes.document:
         state_machine = RSTStateMachine(state_classes, 'Body')
         node = new_document('', settings)
         node.reporter = NullReporter()
@@ -595,7 +564,7 @@
     return summary
 
 
-def limited_join(sep: str, items: Liststr, max_chars: int = 30,
+def limited_join(sep: str, items: liststr, max_chars: int = 30,
                  overflow_marker: str = "...") -> str:
     """Join a number of strings into one, limiting the length to *max_chars*.
 
@@ -629,17 +598,17 @@
     It contains an error messages and a list of exceptions as its arguments.
     """
 
-    def __init__(self, message: Optionalstr, exceptions: SequenceBaseException):
+    def __init__(self, message: str | None, exceptions: SequenceBaseException):
         super().__init__(message)
         self.exceptions = list(exceptions)
 
 
-def get_import_prefixes_from_env(env: BuildEnvironment) -> Liststr:
+def get_import_prefixes_from_env(env: BuildEnvironment) -> liststr | None:
     """
     Obtain current Python import prefixes (for `import_by_name`)
     from ``document.env``
     """
-    prefixes: ListOptionalstr = None
+    prefixes: liststr | None = None
 
     currmodule = env.ref_context.get('py:module')
     if currmodule:
@@ -655,20 +624,21 @@
     return prefixes
 
 
-def import_by_name(name: str, prefixes: Liststr = None, grouped_exception: bool = False
-                   ) -> Tuplestr, Any, Any, str:
+def import_by_name(
+    name: str, prefixes: liststr | None = None,
+) -> tuplestr, Any, Any, str:
     """Import a Python object that has the given *name*, under one of the
     *prefixes*.  The first name that succeeds is used.
     """
     tried = 
-    errors: ListImportExceptionGroup = 
+    errors: listImportExceptionGroup = 
     for prefix in prefixes:
         try:
             if prefix:
                 prefixed_name = '.'.join(prefix, name)
             else:
                 prefixed_name = name
-            obj, parent, modname = _import_by_name(prefixed_name, grouped_exception)
+            obj, parent, modname = _import_by_name(prefixed_name, grouped_exception=True)
             return prefixed_name, obj, parent, modname
         except ImportError:
             tried.append(prefixed_name)
@@ -676,16 +646,13 @@
             tried.append(prefixed_name)
             errors.append(exc)
 
-    if grouped_exception:
-        exceptions: ListBaseException = sum((e.exceptions for e in errors), )
-        raise ImportExceptionGroup('no module named %s' % ' or '.join(tried), exceptions)
-    else:
-        raise ImportError('no module named %s' % ' or '.join(tried))
+    exceptions: listBaseException = sum((e.exceptions for e in errors), )
+    raise ImportExceptionGroup('no module named %s' % ' or '.join(tried), exceptions)
 
 
-def _import_by_name(name: str, grouped_exception: bool = False) -> TupleAny, Any, str:
+def _import_by_name(name: str, grouped_exception: bool = True) -> tupleAny, Any, str:
     """Import a Python object given its full name."""
-    errors: ListBaseException = 
+    errors: listBaseException = 
 
     try:
         name_parts = name.split('.')
@@ -730,20 +697,30 @@
             raise ImportError(*exc.args) from exc
 
 
-def import_ivar_by_name(name: str, prefixes: Liststr = None,
-                        grouped_exception: bool = False) -> Tuplestr, Any, Any, str:
+def import_ivar_by_name(name: str, prefixes: liststr | None = None,
+                        grouped_exception: bool = True) -> tuplestr, Any, Any, str:
     """Import an instance variable that has the given *name*, under one of the
     *prefixes*.  The first name that succeeds is used.
     """
     try:
         name, attr = name.rsplit(".", 1)
-        real_name, obj, parent, modname = import_by_name(name, prefixes, grouped_exception)
-        qualname = real_name.replace(modname + ".", "")
-        analyzer = ModuleAnalyzer.for_module(getattr(obj, '__module__', modname))
-        analyzer.analyze()
-        # check for presence in `annotations` to include dataclass attributes
-        if (qualname, attr) in analyzer.attr_docs or (qualname, attr) in analyzer.annotations:
-            return real_name + "." + attr, INSTANCEATTR, obj, modname
+        real_name, obj, parent, modname = import_by_name(name, prefixes)
+
+        # Get ancestors of the object (class.__mro__ includes the class itself as
+        # the first entry)
+        candidate_objects = getmro(obj)
+        if len(candidate_objects) == 0:
+            candidate_objects = (obj,)
+
+        for candidate_obj in candidate_objects:
+            analyzer = ModuleAnalyzer.for_module(getattr(candidate_obj, '__module__', modname))
+            analyzer.analyze()
+            # check for presence in `annotations` to include dataclass attributes
+            found_attrs = set()
+            found_attrs |= {attr for (qualname, attr) in analyzer.attr_docs}
+            found_attrs |= {attr for (qualname, attr) in analyzer.annotations}
+            if attr in found_attrs:
+                return real_name + "." + attr, INSTANCEATTR, obj, modname
     except (ImportError, ValueError, PycodeError) as exc:
         raise ImportError from exc
     except ImportExceptionGroup:
@@ -760,7 +737,7 @@
     Expands to ':obj:`text`' if `text` is an object that can be imported;
     otherwise expands to '*text*'.
     """
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         pyobj_role = self.env.get_domain('py').role('obj')
         objects, errors = pyobj_role('obj', self.rawtext, self.text, self.lineno,
                                      self.inliner, self.options, self.content)
@@ -772,7 +749,7 @@
         try:
             # try to import object by name
             prefixes = get_import_prefixes_from_env(self.env)
-            import_by_name(pending_xref'reftarget', prefixes, grouped_exception=True)
+            import_by_name(pending_xref'reftarget', prefixes)
         except ImportExceptionGroup:
             literal = cast(nodes.literal, pending_xref0)
             objects0 = nodes.emphasis(self.rawtext, literal.astext(),
@@ -781,14 +758,14 @@
         return objects, errors
 
 
-def get_rst_suffix(app: Sphinx) -> str:
-    def get_supported_format(suffix: str) -> Tuplestr, ...:
+def get_rst_suffix(app: Sphinx) -> str | None:
+    def get_supported_format(suffix: str) -> tuplestr, ...:
         parser_class = app.registry.get_source_parsers().get(suffix)
         if parser_class is None:
             return ('restructuredtext',)
         return parser_class.supported
 
-    suffix: str = None
+    suffix = None
     for suffix in app.config.source_suffix:
         if 'restructuredtext' in get_supported_format(suffix):
             return suffix
@@ -801,7 +778,7 @@
 
     if genfiles is True:
         env = app.builder.env
-        genfiles = env.doc2path(x, base=None) for x in env.found_docs
+        genfiles = env.doc2path(x, base=False) for x in env.found_docs
                     if os.path.isfile(env.doc2path(x))
     elif genfiles is False:
         pass
@@ -834,7 +811,7 @@
                                   encoding=app.config.source_encoding)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     # I need autodoc
     app.setup_extension('sphinx.ext.autodoc')
     app.add_node(autosummary_toc,

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/autosummary/generate.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/autosummary/generate.py Changed

@@ -1,22 +1,19 @@
-"""
-    sphinx.ext.autosummary.generate
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Usable as a library or script to generate automatic RST source files for
-    items referred to in autosummary:: directives.
+"""Generates reST source files for autosummary.
 
-    Each generated RST file contains a single auto*:: directive which
-    extracts the docstring of the referred item.
+Usable as a library or script to generate automatic RST source files for
+items referred to in autosummary:: directives.
 
-    Example Makefile rule::
+Each generated RST file contains a single auto*:: directive which
+extracts the docstring of the referred item.
 
-       generate:
-               sphinx-autogen -o source/generated source/*.rst
+Example Makefile rule::
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+   generate:
+           sphinx-autogen -o source/generated source/*.rst
 """
 
+from __future__ import annotations
+
 import argparse
 import inspect
 import locale
@@ -25,10 +22,8 @@
 import pydoc
 import re
 import sys
-import warnings
-from gettext import NullTranslations
 from os import path
-from typing import Any, Dict, List, NamedTuple, Sequence, Set, Tuple, Type, Union
+from typing import TYPE_CHECKING, Any, NamedTuple, Sequence
 
 from jinja2 import TemplateNotFound
 from jinja2.sandbox import SandboxedEnvironment
@@ -38,11 +33,14 @@
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.ext.autodoc import Documenter
 from sphinx.ext.autodoc.importer import import_module
-from sphinx.ext.autosummary import (ImportExceptionGroup, get_documenter, import_by_name,
-                                    import_ivar_by_name)
+from sphinx.ext.autosummary import (
+    ImportExceptionGroup,
+    get_documenter,
+    import_by_name,
+    import_ivar_by_name,
+)
 from sphinx.locale import __
 from sphinx.pycode import ModuleAnalyzer, PycodeError
 from sphinx.registry import SphinxComponentRegistry
@@ -51,6 +49,9 @@
 from sphinx.util.osutil import ensuredir
 from sphinx.util.template import SphinxTemplateLoader
 
+if TYPE_CHECKING:
+    from gettext import NullTranslations
+
 logger = logging.getLogger(__name__)
 
 
@@ -60,7 +61,7 @@
     def __init__(self, translator: NullTranslations) -> None:
         self.config = Config()
         self.registry = SphinxComponentRegistry()
-        self.messagelog: Liststr = 
+        self.messagelog: liststr = 
         self.srcdir = "/"
         self.translator = translator
         self.verbosity = 0
@@ -84,32 +85,26 @@
 
 
 def setup_documenters(app: Any) -> None:
-    from sphinx.ext.autodoc import (AttributeDocumenter, ClassDocumenter, DataDocumenter,
-                                    DecoratorDocumenter, ExceptionDocumenter,
-                                    FunctionDocumenter, MethodDocumenter, ModuleDocumenter,
-                                    NewTypeAttributeDocumenter, NewTypeDataDocumenter,
-                                    PropertyDocumenter)
-    documenters: ListTypeDocumenter = 
+    from sphinx.ext.autodoc import (
+        AttributeDocumenter,
+        ClassDocumenter,
+        DataDocumenter,
+        DecoratorDocumenter,
+        ExceptionDocumenter,
+        FunctionDocumenter,
+        MethodDocumenter,
+        ModuleDocumenter,
+        PropertyDocumenter,
+    )
+    documenters: listtypeDocumenter = 
         ModuleDocumenter, ClassDocumenter, ExceptionDocumenter, DataDocumenter,
-        FunctionDocumenter, MethodDocumenter, NewTypeAttributeDocumenter,
-        NewTypeDataDocumenter, AttributeDocumenter, DecoratorDocumenter, PropertyDocumenter,
+        FunctionDocumenter, MethodDocumenter,
+        AttributeDocumenter, DecoratorDocumenter, PropertyDocumenter,
     
     for documenter in documenters:
         app.registry.add_documenter(documenter.objtype, documenter)
 
 
-def _simple_info(msg: str) -> None:
-    warnings.warn('_simple_info() is deprecated.',
-                  RemovedInSphinx50Warning, stacklevel=2)
-    print(msg)
-
-
-def _simple_warn(msg: str) -> None:
-    warnings.warn('_simple_warn() is deprecated.',
-                  RemovedInSphinx50Warning, stacklevel=2)
-    print('WARNING: ' + msg, file=sys.stderr)
-
-
 def _underline(title: str, line: str = '=') -> str:
     if '\n' in title:
         raise ValueError('Can only underline single lines')
@@ -119,14 +114,9 @@
 class AutosummaryRenderer:
     """A helper class for rendering."""
 
-    def __init__(self, app: UnionBuilder, Sphinx, template_dir: str = None) -> None:
+    def __init__(self, app: Sphinx) -> None:
         if isinstance(app, Builder):
-            warnings.warn('The first argument for AutosummaryRenderer has been '
-                          'changed to Sphinx object',
-                          RemovedInSphinx50Warning, stacklevel=2)
-        if template_dir:
-            warnings.warn('template_dir argument for AutosummaryRenderer is deprecated.',
-                          RemovedInSphinx50Warning, stacklevel=2)
+            raise ValueError('Expected a Sphinx application object!')
 
         system_templates_path = os.path.join(package_dir, 'ext', 'autosummary', 'templates')
         loader = SphinxTemplateLoader(app.srcdir, app.config.templates_path,
@@ -137,26 +127,11 @@
         self.env.filters'e' = rst.escape
         self.env.filters'underline' = _underline
 
-        if isinstance(app, (Sphinx, DummyApplication)):
-            if app.translator:
-                self.env.add_extension("jinja2.ext.i18n")
-                self.env.install_gettext_translations(app.translator)
-        elif isinstance(app, Builder):
-            if app.app.translator:
-                self.env.add_extension("jinja2.ext.i18n")
-                self.env.install_gettext_translations(app.app.translator)
-
-    def exists(self, template_name: str) -> bool:
-        """Check if template file exists."""
-        warnings.warn('AutosummaryRenderer.exists() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        try:
-            self.env.get_template(template_name)
-            return True
-        except TemplateNotFound:
-            return False
+        if app.translator:
+            self.env.add_extension("jinja2.ext.i18n")
+            self.env.install_gettext_translations(app.translator)
 
-    def render(self, template_name: str, context: Dict) -> str:
+    def render(self, template_name: str, context: dict) -> str:
         """Render a template file."""
         try:
             template = self.env.get_template(template_name)
@@ -192,8 +167,14 @@
                            name, exc, type='autosummary')
             return False
 
-    def scan(self, imported_members: bool) -> Liststr:
+    def scan(self, imported_members: bool) -> liststr:
         members = 
+        try:
+            analyzer = ModuleAnalyzer.for_module(self.object.__name__)
+            attr_docs = analyzer.find_attr_docs()
+        except PycodeError:
+            attr_docs = {}
+
         for name in members_of(self.object, self.app.config):
             try:
                 value = safe_getattr(self.object, name)
@@ -205,7 +186,9 @@
                 continue
 
             try:
-                if inspect.ismodule(value):
+                if ('', name) in attr_docs:
+                    imported = False
+                elif inspect.ismodule(value):  # NoQA: SIM114
                     imported = True
                 elif safe_getattr(value, '__module__') != self.object.__name__:
                     imported = True
@@ -215,14 +198,14 @@
                 imported = False
 
             respect_module_all = not self.app.config.autosummary_ignore_module_all
-            if imported_members:
+            if (
                 # list all members up
-                members.append(name)
-            elif imported is False:
+                imported_members
                 # list not-imported members
-                members.append(name)
-            elif '__all__' in dir(self.object) and respect_module_all:
+                or imported is False
                 # list members that have __all__ set
+                or (respect_module_all and '__all__' in dir(self.object))
+            ):
                 members.append(name)
 
         return members
@@ -242,8 +225,9 @@
 def generate_autosummary_content(name: str, obj: Any, parent: Any,
                                  template: AutosummaryRenderer, template_name: str,
                                  imported_members: bool, app: Any,
-                                 recursive: bool, context: Dict,
-                                 modname: str = None, qualname: str = None) -> str:
+                                 recursive: bool, context: dict,
+                                 modname: str | None = None,
+                                 qualname: str | None = None) -> str:
     doc = get_documenter(app, obj, parent)
 
     def skip_member(obj: Any, name: str, objtype: str) -> bool:
@@ -256,11 +240,11 @@
                            name, exc, type='autosummary')
             return False
 
-    def get_class_members(obj: Any) -> Dictstr, Any:
+    def get_class_members(obj: Any) -> dictstr, Any:
         members = sphinx.ext.autodoc.get_class_members(obj, qualname, safe_getattr)
         return {name: member.object for name, member in members.items()}
 
-    def get_module_members(obj: Any) -> Dictstr, Any:
+    def get_module_members(obj: Any) -> dictstr, Any:
         members = {}
         for name in members_of(obj, app.config):
             try:
@@ -269,17 +253,17 @@
                 continue
         return members
 
-    def get_all_members(obj: Any) -> Dictstr, Any:
+    def get_all_members(obj: Any) -> dictstr, Any:
         if doc.objtype == "module":
             return get_module_members(obj)
         elif doc.objtype == "class":
             return get_class_members(obj)
         return {}
 
-    def get_members(obj: Any, types: Setstr, include_public: Liststr = ,
-                    imported: bool = True) -> TupleListstr, Liststr:
-        items: Liststr = 
-        public: Liststr = 
+    def get_members(obj: Any, types: setstr, include_public: liststr = ,
+                    imported: bool = True) -> tupleliststr, liststr:
+        items: liststr = 
+        public: liststr = 
 
         all_members = get_all_members(obj)
         for name, value in all_members.items():
@@ -301,7 +285,7 @@
                             public.append(name)
         return public, items
 
-    def get_module_attrs(members: Any) -> TupleListstr, Liststr:
+    def get_module_attrs(members: Any) -> tupleliststr, liststr:
         """Find module attributes with docstrings."""
         attrs, public = , 
         try:
@@ -316,9 +300,17 @@
             pass    # give up if ModuleAnalyzer fails to parse code
         return public, attrs
 
-    def get_modules(obj: Any) -> TupleListstr, Liststr:
-        items: Liststr = 
+    def get_modules(
+            obj: Any,
+            skip: Sequencestr,
+            public_members: Sequencestr | None = None) -> tupleliststr, liststr:
+        items: liststr = 
+        public: liststr = 
         for _, modname, _ispkg in pkgutil.iter_modules(obj.__path__):
+
+            if modname in skip:
+                # module was overwritten in __init__.py, so not accessible
+                continue
             fullname = name + '.' + modname
             try:
                 module = import_module(fullname)
@@ -328,15 +320,24 @@
                 pass
 
             items.append(fullname)
-        public = x for x in items if not x.split('.')-1.startswith('_')
+            if public_members is not None:
+                if modname in public_members:
+                    public.append(fullname)
+            else:
+                if not modname.startswith('_'):
+                    public.append(fullname)
         return public, items
 
-    ns: Dictstr, Any = {}
+    ns: dictstr, Any = {}
     ns.update(context)
 
     if doc.objtype == 'module':
         scanner = ModuleScanner(app, obj)
         ns'members' = scanner.scan(imported_members)
+
+        respect_module_all = not app.config.autosummary_ignore_module_all
+        imported_members = imported_members or ('__all__' in dir(obj) and respect_module_all)
+
         ns'functions', ns'all_functions' = \
             get_members(obj, {'function'}, imported=imported_members)
         ns'classes', ns'all_classes' = \
@@ -347,7 +348,36 @@
             get_module_attrs(ns'members')
         ispackage = hasattr(obj, '__path__')
         if ispackage and recursive:
-            ns'modules', ns'all_modules' = get_modules(obj)
+            # Use members that are not modules as skip list, because it would then mean
+            # that module was overwritten in the package namespace
+            skip = (
+                ns"all_functions"
+                + ns"all_classes"
+                + ns"all_exceptions"
+                + ns"all_attributes"
+            )
+
+            # If respect_module_all and module has a __all__ attribute, first get
+            # modules that were explicitly imported. Next, find the rest with the
+            # get_modules method, but only put in "public" modules that are in the
+            # __all__ list
+            #
+            # Otherwise, use get_modules method normally
+            if respect_module_all and '__all__' in dir(obj):
+                imported_modules, all_imported_modules = \
+                    get_members(obj, {'module'}, imported=True)
+                skip += all_imported_modules
+                imported_modules = name + '.' + modname for modname in imported_modules
+                all_imported_modules = \
+                    name + '.' + modname for modname in all_imported_modules
+                public_members = getall(obj)
+            else:
+                imported_modules, all_imported_modules = , 
+                public_members = None
+
+            modules, all_modules = get_modules(obj, skip=skip, public_members=public_members)
+            ns'modules' = imported_modules + modules
+            ns"all_modules" = all_imported_modules + all_modules
     elif doc.objtype == 'class':
         ns'members' = dir(obj)
         ns'inherited_members' = \
@@ -382,20 +412,11 @@
         return template.render(doc.objtype, ns)
 
 
-def generate_autosummary_docs(sources: Liststr, output_dir: str = None,
-                              suffix: str = '.rst', base_path: str = None,
-                              builder: Builder = None, template_dir: str = None,
+def generate_autosummary_docs(sources: liststr, output_dir: str | None = None,
+                              suffix: str = '.rst', base_path: str | None = None,
                               imported_members: bool = False, app: Any = None,
                               overwrite: bool = True, encoding: str = 'utf-8') -> None:
-    if builder:
-        warnings.warn('builder argument for generate_autosummary_docs() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-
-    if template_dir:
-        warnings.warn('template_dir argument for generate_autosummary_docs() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-
-    showed_sources = list(sorted(sources))
+    showed_sources = sorted(sources)
     if len(showed_sources) > 20:
         showed_sources = showed_sources:10 + '...' + showed_sources-10:
     logger.info(__('autosummary generating autosummary for: %s') %
@@ -431,7 +452,7 @@
         ensuredir(path)
 
         try:
-            name, obj, parent, modname = import_by_name(entry.name, grouped_exception=True)
+            name, obj, parent, modname = import_by_name(entry.name)
             qualname = name.replace(modname + ".", "")
         except ImportExceptionGroup as exc:
             try:
@@ -440,16 +461,16 @@
                 qualname = name.replace(modname + ".", "")
             except ImportError as exc2:
                 if exc2.__cause__:
-                    exceptions: ListBaseException = exc.exceptions + exc2.__cause__
+                    exceptions: listBaseException = exc.exceptions + exc2.__cause__
                 else:
                     exceptions = exc.exceptions + exc2
 
-                errors = list(set("* %s: %s" % (type(e).__name__, e) for e in exceptions))
+                errors = list({f"* {type(e).__name__}: {e}" for e in exceptions})
                 logger.warning(__('autosummary failed to import %s.\nPossible hints:\n%s'),
                                entry.name, '\n'.join(errors))
                 continue
 
-        context: Dictstr, Any = {}
+        context: dictstr, Any = {}
         if app:
             context.update(app.config.autosummary_context)
 
@@ -464,7 +485,7 @@
 
             if content == old_content:
                 continue
-            elif overwrite:  # content has changed
+            if overwrite:  # content has changed
                 with open(filename, 'w', encoding=encoding) as f:
                     f.write(content)
                 new_files.append(filename)
@@ -477,19 +498,18 @@
     if new_files:
         generate_autosummary_docs(new_files, output_dir=output_dir,
                                   suffix=suffix, base_path=base_path,
-                                  builder=builder, template_dir=template_dir,
                                   imported_members=imported_members, app=app,
                                   overwrite=overwrite)
 
 
 # -- Finding documented entries in files ---------------------------------------
 
-def find_autosummary_in_files(filenames: Liststr) -> ListAutosummaryEntry:
+def find_autosummary_in_files(filenames: liststr) -> listAutosummaryEntry:
     """Find out what items are documented in source/*.rst.
 
     See `find_autosummary_in_lines`.
     """
-    documented: ListAutosummaryEntry = 
+    documented: listAutosummaryEntry = 
     for filename in filenames:
         with open(filename, encoding='utf-8', errors='ignore') as f:
             lines = f.read().splitlines()
@@ -497,33 +517,31 @@
     return documented
 
 
-def find_autosummary_in_docstring(name: str, module: str = None, filename: str = None
-                                  ) -> ListAutosummaryEntry:
+def find_autosummary_in_docstring(
+    name: str, filename: str | None = None,
+) -> listAutosummaryEntry:
     """Find out what items are documented in the given object's docstring.
 
     See `find_autosummary_in_lines`.
     """
-    if module:
-        warnings.warn('module argument for find_autosummary_in_docstring() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-
     try:
-        real_name, obj, parent, modname = import_by_name(name, grouped_exception=True)
+        real_name, obj, parent, modname = import_by_name(name)
         lines = pydoc.getdoc(obj).splitlines()
         return find_autosummary_in_lines(lines, module=name, filename=filename)
     except AttributeError:
         pass
     except ImportExceptionGroup as exc:
-        errors = list(set("* %s: %s" % (type(e).__name__, e) for e in exc.exceptions))
-        print('Failed to import %s.\nPossible hints:\n%s' % (name, '\n'.join(errors)))
+        errors = '\n'.join({f"* {type(e).__name__}: {e}" for e in exc.exceptions})
+        print(f'Failed to import {name}.\nPossible hints:\n{errors}')
     except SystemExit:
         print("Failed to import '%s'; the module executes module level "
               "statement and it might call sys.exit()." % name)
     return 
 
 
-def find_autosummary_in_lines(lines: Liststr, module: str = None, filename: str = None
-                              ) -> ListAutosummaryEntry:
+def find_autosummary_in_lines(
+    lines: liststr, module: str | None = None, filename: str | None = None,
+) -> listAutosummaryEntry:
     """Find out what items appear in autosummary:: directives in the
     given lines.
 
@@ -544,10 +562,10 @@
     toctree_arg_re = re.compile(r'^\s+:toctree:\s*(.*?)\s*$')
     template_arg_re = re.compile(r'^\s+:template:\s*(.*?)\s*$')
 
-    documented: ListAutosummaryEntry = 
+    documented: listAutosummaryEntry = 
 
     recursive = False
-    toctree: str = None
+    toctree: str | None = None
     template = None
     current_module = module
     in_autosummary = False
@@ -583,7 +601,7 @@
                     name = name1:
                 if current_module and \
                    not name.startswith(current_module + '.'):
-                    name = "%s.%s" % (current_module, name)
+                    name = f"{current_module}.{name}"
                 documented.append(AutosummaryEntry(name, toctree, template, recursive))
                 continue
 
@@ -663,12 +681,11 @@
     return parser
 
 
-def main(argv: Liststr = sys.argv1:) -> None:
-    sphinx.locale.setlocale(locale.LC_ALL, '')
-    sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx')
-    translator, _ = sphinx.locale.init(, None)
+def main(argv: liststr = sys.argv1:) -> None:
+    locale.setlocale(locale.LC_ALL, '')
+    sphinx.locale.init_console()
 
-    app = DummyApplication(translator)
+    app = DummyApplication(sphinx.locale.get_translator())
     logging.setup(app, sys.stdout, sys.stderr)  # type: ignore
     setup_documenters(app)
     args = get_parser().parse_args(argv)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/coverage.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/coverage.py Changed

@@ -1,21 +1,18 @@
-"""
-    sphinx.ext.coverage
-    ~~~~~~~~~~~~~~~~~~~
-
-    Check Python modules and C API for coverage.  Mostly written by Josip
-    Dzolonga for the Google Highly Open Participation contest.
+"""Check Python modules and C API for coverage.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Mostly written by Josip Dzolonga for the Google Highly Open Participation
+contest.
 """
 
+from __future__ import annotations
+
 import glob
 import inspect
 import pickle
 import re
 from importlib import import_module
 from os import path
-from typing import IO, Any, Dict, List, Pattern, Set, Tuple
+from typing import IO, Any
 
 import sphinx
 from sphinx.application import Sphinx
@@ -29,12 +26,12 @@
 
 
 # utility
-def write_header(f: IO, text: str, char: str = '-') -> None:
+def write_header(f: IOstr, text: str, char: str = '-') -> None:
     f.write(text + '\n')
     f.write(char * len(text) + '\n')
 
 
-def compile_regex_list(name: str, exps: str) -> ListPattern:
+def compile_regex_list(name: str, exps: str) -> listre.Patternstr:
     lst = 
     for exp in exps:
         try:
@@ -53,19 +50,19 @@
                 'results in %(outdir)s' + path.sep + 'python.txt.')
 
     def init(self) -> None:
-        self.c_sourcefiles: Liststr = 
+        self.c_sourcefiles: liststr = 
         for pattern in self.config.coverage_c_path:
             pattern = path.join(self.srcdir, pattern)
             self.c_sourcefiles.extend(glob.glob(pattern))
 
-        self.c_regexes: ListTuplestr, Pattern = 
+        self.c_regexes: listtuplestr, re.Patternstr = 
         for (name, exp) in self.config.coverage_c_regexes.items():
             try:
                 self.c_regexes.append((name, re.compile(exp)))
             except Exception:
                 logger.warning(__('invalid regex %r in coverage_c_regexes'), exp)
 
-        self.c_ignorexps: Dictstr, ListPattern = {}
+        self.c_ignorexps: dictstr, listre.Patternstr = {}
         for (name, exps) in self.config.coverage_ignore_c_items.items():
             self.c_ignorexpsname = compile_regex_list('coverage_ignore_c_items',
                                                         exps)
@@ -82,11 +79,11 @@
         return 'coverage overview'
 
     def write(self, *ignored: Any) -> None:
-        self.py_undoc: Dictstr, Dictstr, Any = {}
+        self.py_undoc: dictstr, dictstr, Any = {}
         self.build_py_coverage()
         self.write_py_coverage()
 
-        self.c_undoc: Dictstr, SetTuplestr, str = {}
+        self.c_undoc: dictstr, settuplestr, str = {}
         self.build_c_coverage()
         self.write_c_coverage()
 
@@ -94,8 +91,8 @@
         # Fetch all the info from the header files
         c_objects = self.env.domaindata'c''objects'
         for filename in self.c_sourcefiles:
-            undoc: SetTuplestr, str = set()
-            with open(filename) as f:
+            undoc: settuplestr, str = set()
+            with open(filename, encoding="utf-8") as f:
                 for line in f:
                     for key, regex in self.c_regexes:
                         match = regex.match(line)
@@ -113,7 +110,7 @@
 
     def write_c_coverage(self) -> None:
         output_file = path.join(self.outdir, 'c.txt')
-        with open(output_file, 'w') as op:
+        with open(output_file, 'w', encoding="utf-8") as op:
             if self.config.coverage_write_headline:
                 write_header(op, 'Undocumented C API elements', '=')
             op.write('\n')
@@ -133,10 +130,10 @@
                 op.write('\n')
 
     def ignore_pyobj(self, full_name: str) -> bool:
-        for exp in self.py_ignorexps:
-            if exp.search(full_name):
-                return True
-        return False
+        return any(
+            exp.search(full_name)
+            for exp in self.py_ignorexps
+        )
 
     def build_py_coverage(self) -> None:
         objects = self.env.domaindata'py''objects'
@@ -161,7 +158,7 @@
                 continue
 
             funcs = 
-            classes: Dictstr, Liststr = {}
+            classes: dictstr, liststr = {}
 
             for name, obj in inspect.getmembers(mod):
                 # diverse module attributes are ignored:
@@ -175,7 +172,7 @@
                     # is not defined in this module
                     continue
 
-                full_name = '%s.%s' % (mod_name, name)
+                full_name = f'{mod_name}.{name}'
                 if self.ignore_pyobj(full_name):
                     continue
 
@@ -200,7 +197,7 @@
                             classesname = 
                             continue
 
-                        attrs: Liststr = 
+                        attrs: liststr = 
 
                         for attr_name in dir(obj):
                             if attr_name not in obj.__dict__:
@@ -218,7 +215,7 @@
                             if skip_undoc and not attr.__doc__:
                                 # skip methods without docstring if wished
                                 continue
-                            full_attr_name = '%s.%s' % (full_name, attr_name)
+                            full_attr_name = f'{full_name}.{attr_name}'
                             if self.ignore_pyobj(full_attr_name):
                                 continue
                             if full_attr_name not in objects:
@@ -232,7 +229,7 @@
     def write_py_coverage(self) -> None:
         output_file = path.join(self.outdir, 'python.txt')
         failed = 
-        with open(output_file, 'w') as op:
+        with open(output_file, 'w', encoding="utf-8") as op:
             if self.config.coverage_write_headline:
                 write_header(op, 'Undocumented Python objects', '=')
             keys = sorted(self.py_undoc.keys())
@@ -303,7 +300,7 @@
             pickle.dump((self.py_undoc, self.c_undoc), dumpfile)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_builder(CoverageBuilder)
     app.add_config_value('coverage_ignore_modules', , False)
     app.add_config_value('coverage_ignore_functions', , False)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/doctest.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/doctest.py Changed

@@ -1,22 +1,17 @@
-"""
-    sphinx.ext.doctest
-    ~~~~~~~~~~~~~~~~~~
-
-    Mimic doctest by automatically executing code snippets and checking
-    their results.
+"""Mimic doctest in Sphinx.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+The extension automatically execute code snippets and checks their results.
 """
 
+from __future__ import annotations
+
 import doctest
 import re
 import sys
 import time
 from io import StringIO
 from os import path
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple,
-                    Type)
+from typing import TYPE_CHECKING, Any, Callable, Iterable, Sequence
 
 from docutils import nodes
 from docutils.nodes import Element, Node, TextElement
@@ -47,15 +42,15 @@
     """Check `spec` satisfies `version` or not.
 
     This obeys PEP-440 specifiers:
-    https://www.python.org/dev/peps/pep-0440/#version-specifiers
+    https://peps.python.org/pep-0440/#version-specifiers
 
     Some examples:
 
-        >>> is_allowed_version('3.3', '<=3.5')
+        >>> is_allowed_version('<=3.5', '3.3')
         True
-        >>> is_allowed_version('3.3', '<=3.2')
+        >>> is_allowed_version('<=3.2', '3.3')
         False
-        >>> is_allowed_version('3.3', '>3.2, <4.0')
+        >>> is_allowed_version('>3.2, <4.0', '3.3')
         True
     """
     return Version(version) in SpecifierSet(spec)
@@ -73,7 +68,7 @@
     optional_arguments = 1
     final_argument_whitespace = True
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         # use ordinary docutils nodes for test code: they get special attributes
         # so that our builder recognizes them, and the other builders are happy.
         code = '\n'.join(self.content)
@@ -87,7 +82,7 @@
                 if not test:
                     test = code
                 code = doctestopt_re.sub('', code)
-        nodetype: TypeTextElement = nodes.literal_block
+        nodetype: typeTextElement = nodes.literal_block
         if self.name in ('testsetup', 'testcleanup') or 'hide' in self.options:
             nodetype = nodes.comment
         if self.arguments:
@@ -100,15 +95,9 @@
             # only save if it differs from code
             node'test' = test
         if self.name == 'doctest':
-            if self.config.highlight_language in ('py', 'python'):
-                node'language' = 'pycon'
-            else:
-                node'language' = 'pycon3'  # default
+            node'language' = 'pycon'
         elif self.name == 'testcode':
-            if self.config.highlight_language in ('py', 'python'):
-                node'language' = 'python'
-            else:
-                node'language' = 'python3'  # default
+            node'language' = 'python'
         elif self.name == 'testoutput':
             # don't try to highlight output
             node'language' = 'none'
@@ -152,13 +141,13 @@
 
 class TestsetupDirective(TestDirective):
     option_spec: OptionSpec = {
-        'skipif': directives.unchanged_required
+        'skipif': directives.unchanged_required,
     }
 
 
 class TestcleanupDirective(TestDirective):
     option_spec: OptionSpec = {
-        'skipif': directives.unchanged_required
+        'skipif': directives.unchanged_required,
     }
 
 
@@ -202,11 +191,11 @@
 class TestGroup:
     def __init__(self, name: str) -> None:
         self.name = name
-        self.setup: ListTestCode = 
-        self.tests: ListListTestCode = 
-        self.cleanup: ListTestCode = 
+        self.setup: listTestCode = 
+        self.tests: listlistTestCode = 
+        self.cleanup: listTestCode = 
 
-    def add_code(self, code: "TestCode", prepend: bool = False) -> None:
+    def add_code(self, code: TestCode, prepend: bool = False) -> None:
         if code.type == 'testsetup':
             if prepend:
                 self.setup.insert(0, code)
@@ -225,13 +214,13 @@
             raise RuntimeError(__('invalid TestCode type'))
 
     def __repr__(self) -> str:
-        return 'TestGroup(name=%r, setup=%r, cleanup=%r, tests=%r)' % (
-            self.name, self.setup, self.cleanup, self.tests)
+        return (f'TestGroup(name={self.name!r}, setup={self.setup!r}, '
+                f'cleanup={self.cleanup!r}, tests={self.tests!r})')
 
 
 class TestCode:
     def __init__(self, code: str, type: str, filename: str,
-                 lineno: int, options: Dict = None) -> None:
+                 lineno: int, options: dict | None = None) -> None:
         self.code = code
         self.type = type
         self.filename = filename
@@ -239,13 +228,13 @@
         self.options = options or {}
 
     def __repr__(self) -> str:
-        return 'TestCode(%r, %r, filename=%r, lineno=%r, options=%r)' % (
-            self.code, self.type, self.filename, self.lineno, self.options)
+        return (f'TestCode({self.code!r}, {self.type!r}, filename={self.filename!r}, '
+                f'lineno={self.lineno!r}, options={self.options!r})')
 
 
 class SphinxDocTestRunner(doctest.DocTestRunner):
-    def summarize(self, out: Callable, verbose: bool = None  # type: ignore
-                  ) -> Tupleint, int:
+    def summarize(self, out: Callable, verbose: bool = None,  # type: ignore
+                  ) -> tupleint, int:
         string_io = StringIO()
         old_stdout = sys.stdout
         sys.stdout = string_io
@@ -323,10 +312,10 @@
             logger.info(text, nonl=True)
         self.outfile.write(text)
 
-    def get_target_uri(self, docname: str, typ: str = None) -> str:
+    def get_target_uri(self, docname: str, typ: str | None = None) -> str:
         return ''
 
-    def get_outdated_docs(self) -> Setstr:
+    def get_outdated_docs(self) -> setstr:
         return self.env.found_docs
 
     def finish(self) -> None:
@@ -368,11 +357,11 @@
             filename = relpath(node.source, self.env.srcdir)\
                 .rsplit(':docstring of ', maxsplit=1)0
         except Exception:
-            filename = self.env.doc2path(docname, base=None)
+            filename = self.env.doc2path(docname, False)
         return filename
 
     @staticmethod
-    def get_line_number(node: Node) -> int:
+    def get_line_number(node: Node) -> int | None:
         """Get the real line number or admit we don't know."""
         # TODO:  Work out how to store or calculate real (file-relative)
         #       line numbers for doctest blocks in docstrings.
@@ -392,16 +381,16 @@
             return False
         else:
             condition = node'skipif'
-            context: Dictstr, Any = {}
+            context: dictstr, Any = {}
             if self.config.doctest_global_setup:
-                exec(self.config.doctest_global_setup, context)
-            should_skip = eval(condition, context)
+                exec(self.config.doctest_global_setup, context)  # NoQA: S102
+            should_skip = eval(condition, context)  # NoQA: PGH001
             if self.config.doctest_global_cleanup:
-                exec(self.config.doctest_global_cleanup, context)
+                exec(self.config.doctest_global_cleanup, context)  # NoQA: S102
             return should_skip
 
     def test_doc(self, docname: str, doctree: Node) -> None:
-        groups: Dictstr, TestGroup = {}
+        groups: dictstr, TestGroup = {}
         add_to_all_groups = 
         self.setup_runner = SphinxDocTestRunner(verbose=False,
                                                 optionflags=self.opt)
@@ -482,9 +471,9 @@
         return compile(code, name, self.type, flags, dont_inherit)
 
     def test_group(self, group: TestGroup) -> None:
-        ns: Dict = {}
+        ns: dict = {}
 
-        def run_setup_cleanup(runner: Any, testcodes: ListTestCode, what: Any) -> bool:
+        def run_setup_cleanup(runner: Any, testcodes: listTestCode, what: Any) -> bool:
             examples = 
             for testcode in testcodes:
                 example = doctest.Example(testcode.code, '', lineno=testcode.lineno)
@@ -493,7 +482,7 @@
                 return True
             # simulate a doctest with the code
             sim_doctest = doctest.DocTest(examples, {},
-                                          '%s (%s code)' % (group.name, what),
+                                          f'{group.name} ({what} code)',
                                           testcodes0.filename, 0, None)
             sim_doctest.globs = ns
             old_f = runner.failures
@@ -553,7 +542,7 @@
         run_setup_cleanup(self.cleanup_runner, group.cleanup, 'cleanup')
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_directive('testsetup', TestsetupDirective)
     app.add_directive('testcleanup', TestcleanupDirective)
     app.add_directive('doctest', DoctestDirective)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/duration.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/duration.py Changed

@@ -1,20 +1,15 @@
-"""
-    sphinx.ext.duration
-    ~~~~~~~~~~~~~~~~~~~
+"""Measure durations of Sphinx processing."""
 
-    Measure durations of Sphinx processing.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from datetime import datetime, timedelta
 from itertools import islice
 from operator import itemgetter
-from typing import Any, Dict, List, cast
+from typing import Any, cast
 
 from docutils import nodes
 
+import sphinx
 from sphinx.application import Sphinx
 from sphinx.domains import Domain
 from sphinx.locale import __
@@ -28,7 +23,7 @@
     name = 'duration'
 
     @property
-    def reading_durations(self) -> Dictstr, timedelta:
+    def reading_durations(self) -> dictstr, timedelta:
         return self.data.setdefault('reading_durations', {})
 
     def note_reading_duration(self, duration: timedelta) -> None:
@@ -40,7 +35,7 @@
     def clear_doc(self, docname: str) -> None:
         self.reading_durations.pop(docname, None)
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dictstr, timedelta) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dictstr, timedelta) -> None:
         for docname, duration in otherdata.items():
             if docname in docnames:
                 self.reading_durationsdocname = duration
@@ -55,7 +50,7 @@
     domain.clear()
 
 
-def on_source_read(app: Sphinx, docname: str, content: Liststr) -> None:
+def on_source_read(app: Sphinx, docname: str, content: liststr) -> None:
     """Start to measure reading duration."""
     app.env.temp_data'started_at' = datetime.now()
 
@@ -81,7 +76,7 @@
         logger.info('%d.%03d %s', d.seconds, d.microseconds / 1000, docname)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_domain(DurationDomain)
     app.connect('builder-inited', on_builder_inited)
     app.connect('source-read', on_source_read)
@@ -89,7 +84,7 @@
     app.connect('build-finished', on_build_finished)
 
     return {
-        'version': 'builtin',
+        'version': sphinx.__display_version__,
         'parallel_read_safe': True,
         'parallel_write_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/extlinks.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/extlinks.py Changed

@@ -1,33 +1,26 @@
-"""
-    sphinx.ext.extlinks
-    ~~~~~~~~~~~~~~~~~~~
-
-    Extension to save typing and prevent hard-coding of base URLs in the reST
-    files.
-
-    This adds a new config value called ``extlinks`` that is created like this::
+"""Extension to save typing and prevent hard-coding of base URLs in reST files.
 
-       extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}
+This adds a new config value called ``extlinks`` that is created like this::
 
-    Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
-    link to ``https://example.invalid/foo.html``.  The link caption depends on
-    the *caption* value given:
+   extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}
 
-    - If it is ``None``, the caption will be the full URL.
-    - If it is a string, it must contain ``%s`` exactly once.  In this case the
-      caption will be *caption* with the role content substituted for ``%s``.
+Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
+link to ``https://example.invalid/foo.html``.  The link caption depends on
+the *caption* value given:
 
-    You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
+- If it is ``None``, the caption will be the full URL.
+- If it is a string, it must contain ``%s`` exactly once.  In this case the
+  caption will be *caption* with the role content substituted for ``%s``.
 
-    Both, the url string and the caption string must escape ``%`` as ``%%``.
+You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Both, the url string and the caption string must escape ``%`` as ``%%``.
 """
 
+from __future__ import annotations
+
 import re
-import warnings
-from typing import Any, Dict, List, Tuple
+from typing import Any
 
 from docutils import nodes, utils
 from docutils.nodes import Node, system_message
@@ -35,10 +28,9 @@
 
 import sphinx
 from sphinx.application import Sphinx
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.locale import __
 from sphinx.transforms.post_transforms import SphinxPostTransform
-from sphinx.util import logging
+from sphinx.util import logging, rst
 from sphinx.util.nodes import split_explicit_title
 from sphinx.util.typing import RoleFunction
 
@@ -55,6 +47,9 @@
     default_priority = 500
 
     def run(self, **kwargs: Any) -> None:
+        if not self.config.extlinks_detect_hardcoded_links:
+            return
+
         for refnode in self.document.findall(nodes.reference):
             self.check_uri(refnode)
 
@@ -67,15 +62,25 @@
             return
 
         uri = refnode'refuri'
+        title = refnode.astext()
 
         for alias, (base_uri, _caption) in self.app.config.extlinks.items():
-            uri_pattern = re.compile(base_uri.replace('%s', '(?P<value>.+)'))
+            uri_pattern = re.compile(re.escape(base_uri).replace('%s', '(?P<value>.+)'))
+
             match = uri_pattern.match(uri)
-            if match and match.groupdict().get('value'):
+            if (
+                match and
+                match.groupdict().get('value') and
+                '/' not in match.groupdict()'value'
+            ):
                 # build a replacement suggestion
                 msg = __('hardcoded link %r could be replaced by an extlink '
                          '(try using %r instead)')
-                replacement = f":{alias}:`{match.groupdict().get('value')}`"
+                value = match.groupdict().get('value')
+                if uri != title:
+                    replacement = f":{alias}:`{rst.escape(title)} <{value}>`"
+                else:
+                    replacement = f":{alias}:`{value}`"
                 logger.warning(msg, uri, replacement, location=refnode)
 
 
@@ -85,25 +90,9 @@
     # a prefix.
     # Remark: It is an implementation detail that we use Pythons %-formatting.
     # So far we only expose ``%s`` and require quoting of ``%`` using ``%%``.
-    try:
-        base_url % 'dummy'
-    except (TypeError, ValueError):
-        warnings.warn('extlinks: Sphinx-6.0 will require base URL to '
-                      'contain exactly one \'%s\' and all other \'%\' need '
-                      'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
-        base_url = base_url.replace('%', '%%') + '%s'
-    if caption is not None:
-        try:
-            caption % 'dummy'
-        except (TypeError, ValueError):
-            warnings.warn('extlinks: Sphinx-6.0 will require a caption string to '
-                          'contain exactly one \'%s\' and all other \'%\' need '
-                          'to be escaped as \'%%\'.', RemovedInSphinx60Warning)
-            caption = caption.replace('%', '%%') + '%s'
-
     def role(typ: str, rawtext: str, text: str, lineno: int,
-             inliner: Inliner, options: Dict = {}, content: Liststr = 
-             ) -> TupleListNode, Listsystem_message:
+             inliner: Inliner, options: dict = {}, content: liststr = ,
+             ) -> tuplelistNode, listsystem_message:
         text = utils.unescape(text)
         has_explicit_title, title, part = split_explicit_title(text)
         full_url = base_url % part
@@ -122,8 +111,10 @@
         app.add_role(name, make_link_role(name, base_url, caption))
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_config_value('extlinks', {}, 'env')
+    app.add_config_value('extlinks_detect_hardcoded_links', False, 'env')
+
     app.connect('builder-inited', setup_link_roles)
     app.add_post_transform(ExternalLinksChecker)
     return {'version': sphinx.__display_version__, 'parallel_read_safe': True}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/githubpages.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/githubpages.py Changed

@@ -1,36 +1,56 @@
-"""
-    sphinx.ext.githubpages
-    ~~~~~~~~~~~~~~~~~~~~~~
+"""To publish HTML docs at GitHub Pages, create .nojekyll file."""
 
-    To publish HTML docs at GitHub Pages, create .nojekyll file.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
-import urllib
-from typing import Any, Dict
+import urllib.parse
+from typing import Any
 
 import sphinx
 from sphinx.application import Sphinx
 from sphinx.environment import BuildEnvironment
 
 
-def create_nojekyll_and_cname(app: Sphinx, env: BuildEnvironment) -> None:
-    if app.builder.format == 'html':
-        open(os.path.join(app.builder.outdir, '.nojekyll'), 'wt').close()
-
-        html_baseurl = app.config.html_baseurl
-        if html_baseurl:
-            domain = urllib.parse.urlparse(html_baseurl).hostname
-            if domain and not domain.endswith(".github.io"):
-                with open(os.path.join(app.builder.outdir, 'CNAME'), 'wt') as f:
-                    # NOTE: don't write a trailing newline. The `CNAME` file that's
-                    # auto-generated by the Github UI doesn't have one.
-                    f.write(domain)
+def _get_domain_from_url(url: str) -> str:
+    """Get the domain from a URL."""
+    return url and urllib.parse.urlparse(url).hostname or ''
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def create_nojekyll_and_cname(app: Sphinx, env: BuildEnvironment) -> None:
+    """Manage the ``.nojekyll`` and ``CNAME`` files for GitHub Pages.
+
+    For HTML-format builders (e.g. 'html', 'dirhtml') we unconditionally create
+    the ``.nojekyll`` file to signal that GitHub Pages should not run Jekyll
+    processing.
+
+    If the :confval:`html_baseurl` option is set, we also create a CNAME file
+    with the domain from ``html_baseurl``, so long as it is not a ``github.io``
+    domain.
+
+    If this extension is loaded and the domain in ``html_baseurl`` no longer
+    requires a CNAME file, we remove any existing ``CNAME`` files from the
+    output directory.
+    """
+    if app.builder.format != 'html':
+        return
+
+    open(os.path.join(app.builder.outdir, '.nojekyll'), 'wb').close()
+    cname_path = os.path.join(app.builder.outdir, 'CNAME')
+
+    domain = _get_domain_from_url(app.config.html_baseurl)
+    # Filter out GitHub Pages domains, as they do not require CNAME files.
+    if domain and not domain.endswith(".github.io"):
+        with open(cname_path, 'w', encoding="utf-8") as f:
+            # NOTE: don't write a trailing newline. The `CNAME` file that's
+            # auto-generated by the GitHub UI doesn't have one.
+            f.write(domain)
+    else:
+        try:
+            os.unlink(cname_path)
+        except FileNotFoundError:
+            pass
+
+
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('env-updated', create_nojekyll_and_cname)
     return {'version': sphinx.__display_version__, 'parallel_read_safe': True}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/graphviz.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/graphviz.py Changed

@@ -1,20 +1,14 @@
+"""Allow graphviz-formatted graphs to be included inline in generated documents.
 """
-    sphinx.ext.graphviz
-    ~~~~~~~~~~~~~~~~~~~
 
-    Allow graphviz-formatted graphs to be included in Sphinx-generated
-    documents inline.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import posixpath
 import re
 import subprocess
 from os import path
-from subprocess import PIPE, CalledProcessError
-from typing import Any, Dict, List, Tuple
+from subprocess import CalledProcessError
+from typing import Any
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -31,7 +25,7 @@
 from sphinx.util.nodes import set_source_info
 from sphinx.util.osutil import ensuredir
 from sphinx.util.typing import OptionSpec
-from sphinx.writers.html import HTMLTranslator
+from sphinx.writers.html import HTML5Translator
 from sphinx.writers.latex import LaTeXTranslator
 from sphinx.writers.manpage import ManualPageTranslator
 from sphinx.writers.texinfo import TexinfoTranslator
@@ -50,14 +44,14 @@
     href_re = re.compile('href=".*?"')
 
     def __init__(self, filename: str, content: str, dot: str = '') -> None:
-        self.id: str = None
+        self.id: str | None = None
         self.filename = filename
         self.content = content.splitlines()
-        self.clickable: Liststr = 
+        self.clickable: liststr = 
 
         self.parse(dot=dot)
 
-    def parse(self, dot: str = None) -> None:
+    def parse(self, dot: str) -> None:
         matched = self.maptag_re.match(self.content0)
         if not matched:
             raise GraphvizError('Invalid clickable map file found: %s' % self.filename)
@@ -124,7 +118,7 @@
         'class': directives.class_option,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if self.arguments:
             document = self.state.document
             if self.content:
@@ -192,7 +186,7 @@
         'class': directives.class_option,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = graphviz()
         node'code' = '%s %s {\n%s\n}\n' % \
                        (self.name, self.arguments0, '\n'.join(self.content))
@@ -217,14 +211,15 @@
             return figure
 
 
-def render_dot(self: SphinxTranslator, code: str, options: Dict, format: str,
-               prefix: str = 'graphviz', filename: str = None) -> Tuplestr, str:
+def render_dot(self: SphinxTranslator, code: str, options: dict, format: str,
+               prefix: str = 'graphviz', filename: str | None = None,
+               ) -> tuplestr | None, str | None:
     """Render graphviz code into a PNG or PDF output file."""
     graphviz_dot = options.get('graphviz_dot', self.builder.config.graphviz_dot)
     hashkey = (code + str(options) + str(graphviz_dot) +
                str(self.builder.config.graphviz_dot_args)).encode()
 
-    fname = '%s-%s.%s' % (prefix, sha1(hashkey).hexdigest(), format)
+    fname = f'{prefix}-{sha1(hashkey).hexdigest()}.{format}'
     relfn = posixpath.join(self.builder.imgpath, fname)
     outfn = path.join(self.builder.outdir, self.builder.imagedir, fname)
 
@@ -232,7 +227,7 @@
         return relfn, outfn
 
     if (hasattr(self.builder, '_graphviz_warned_dot') and
-       self.builder._graphviz_warned_dot.get(graphviz_dot)):  # type: ignore  # NOQA
+       self.builder._graphviz_warned_dot.get(graphviz_dot)):
         return None, None
 
     ensuredir(path.dirname(outfn))
@@ -251,7 +246,7 @@
         dot_args.extend('-Tcmapx', '-o%s.map' % outfn)
 
     try:
-        ret = subprocess.run(dot_args, input=code.encode(), stdout=PIPE, stderr=PIPE,
+        ret = subprocess.run(dot_args, input=code.encode(), capture_output=True,
                              cwd=cwd, check=True)
         if not path.isfile(outfn):
             raise GraphvizError(__('dot did not produce an output file:\nstderr\n%r\n'
@@ -269,9 +264,10 @@
                                'stdout\n%r') % (exc.stderr, exc.stdout)) from exc
 
 
-def render_dot_html(self: HTMLTranslator, node: graphviz, code: str, options: Dict,
-                    prefix: str = 'graphviz', imgcls: str = None, alt: str = None,
-                    filename: str = None) -> Tuplestr, str:
+def render_dot_html(self: HTML5Translator, node: graphviz, code: str, options: dict,
+                    prefix: str = 'graphviz', imgcls: str | None = None,
+                    alt: str | None = None, filename: str | None = None,
+                    ) -> tuplestr, str:
     format = self.builder.config.graphviz_output_format
     try:
         if format not in ('png', 'svg'):
@@ -321,12 +317,12 @@
     raise nodes.SkipNode
 
 
-def html_visit_graphviz(self: HTMLTranslator, node: graphviz) -> None:
+def html_visit_graphviz(self: HTML5Translator, node: graphviz) -> None:
     render_dot_html(self, node, node'code', node'options', filename=node.get('filename'))
 
 
 def render_dot_latex(self: LaTeXTranslator, node: graphviz, code: str,
-                     options: Dict, prefix: str = 'graphviz', filename: str = None
+                     options: dict, prefix: str = 'graphviz', filename: str | None = None,
                      ) -> None:
     try:
         fname, outfn = render_dot(self, code, options, 'pdf', prefix, filename)
@@ -364,7 +360,7 @@
 
 
 def render_dot_texinfo(self: TexinfoTranslator, node: graphviz, code: str,
-                       options: Dict, prefix: str = 'graphviz') -> None:
+                       options: dict, prefix: str = 'graphviz') -> None:
     try:
         fname, outfn = render_dot(self, code, options, 'png', prefix)
     except GraphvizError as exc:
@@ -402,7 +398,7 @@
         copy_asset(src, dst)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_node(graphviz,
                  html=(html_visit_graphviz, None),
                  latex=(latex_visit_graphviz, None),

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/ifconfig.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/ifconfig.py Changed

@@ -1,25 +1,22 @@
-"""
-    sphinx.ext.ifconfig
-    ~~~~~~~~~~~~~~~~~~~
-
-    Provides the ``ifconfig`` directive that allows to write documentation
-    that is included depending on configuration variables.
+"""Provides the ``ifconfig`` directive.
 
-    Usage::
+The ``ifconfig`` directive enables writing documentation
+that is included depending on configuration variables.
 
-        .. ifconfig:: releaselevel in ('alpha', 'beta', 'rc')
+Usage::
 
-           This stuff is only included in the built docs for unstable versions.
+    .. ifconfig:: releaselevel in ('alpha', 'beta', 'rc')
 
-    The argument for ``ifconfig`` is a plain Python expression, evaluated in the
-    namespace of the project configuration (that is, all variables from
-    ``conf.py`` are available.)
+       This stuff is only included in the built docs for unstable versions.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+The argument for ``ifconfig`` is a plain Python expression, evaluated in the
+namespace of the project configuration (that is, all variables from
+``conf.py`` are available.)
 """
 
-from typing import Any, Dict, List
+from __future__ import annotations
+
+from typing import Any
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -43,12 +40,12 @@
     final_argument_whitespace = True
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = ifconfig()
         node.document = self.state.document
         self.set_source_info(node)
         node'expr' = self.arguments0
-        nested_parse_with_titles(self.state, self.content, node)
+        nested_parse_with_titles(self.state, self.content, node, self.content_offset)
         return node
 
 
@@ -56,9 +53,9 @@
     ns = {confval.name: confval.value for confval in app.config}
     ns.update(app.config.__dict__.copy())
     ns'builder' = app.builder.name
-    for node in doctree.findall(ifconfig):
+    for node in list(doctree.findall(ifconfig)):
         try:
-            res = eval(node'expr', ns)
+            res = eval(node'expr', ns)  # NoQA: PGH001
         except Exception as err:
             # handle exceptions in a clean fashion
             from traceback import format_exception_only
@@ -74,7 +71,7 @@
                 node.replace_self(node.children)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_node(ifconfig)
     app.add_directive('ifconfig', IfConfig)
     app.connect('doctree-resolved', process_ifconfig_nodes)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/imgconverter.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/imgconverter.py Changed

@@ -1,18 +1,13 @@
-"""
-    sphinx.ext.imgconverter
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""Image converter extension for Sphinx"""
 
-    Image converter extension for Sphinx
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import subprocess
 import sys
-from subprocess import PIPE, CalledProcessError
-from typing import Any, Dict
+from subprocess import CalledProcessError
+from typing import Any
 
+import sphinx
 from sphinx.application import Sphinx
 from sphinx.errors import ExtensionError
 from sphinx.locale import __
@@ -35,12 +30,16 @@
         try:
             args = self.config.image_converter, '-version'
             logger.debug('Invoking %r ...', args)
-            subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True)
+            subprocess.run(args, capture_output=True, check=True)
             return True
         except OSError as exc:
-            logger.warning(__('convert command %r cannot be run, '
-                              'check the image_converter setting: %s'),
-                           self.config.image_converter, exc)
+            logger.warning(__(
+                "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\n"
+                "Traceback: %s",
+            ), self.config.image_converter, exc)
             return False
         except CalledProcessError as exc:
             logger.warning(__('convert exited with error:\n'
@@ -59,7 +58,7 @@
                     self.config.image_converter_args +
                     _from, _to)
             logger.debug('Invoking %r ...', args)
-            subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True)
+            subprocess.run(args, capture_output=True, check=True)
             return True
         except OSError:
             logger.warning(__('convert command %r cannot be run, '
@@ -72,7 +71,7 @@
                                  (exc.stderr, exc.stdout)) from exc
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_post_transform(ImagemagickConverter)
     if sys.platform == 'win32':
         # On Windows, we use Imagemagik v7 by default to avoid the trouble for
@@ -87,7 +86,7 @@
         app.add_config_value('image_converter_args', , 'env')
 
     return {
-        'version': 'builtin',
+        'version': sphinx.__display_version__,
         'parallel_read_safe': True,
         'parallel_write_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/imgmath.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/imgmath.py Changed

@@ -1,21 +1,15 @@
-"""
-    sphinx.ext.imgmath
-    ~~~~~~~~~~~~~~~~~~
+"""Render math in HTML via dvipng or dvisvgm."""
 
-    Render math in HTML via dvipng or dvisvgm.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import posixpath
+import base64
 import re
 import shutil
 import subprocess
 import tempfile
 from os import path
-from subprocess import PIPE, CalledProcessError
-from typing import Any, Dict, List, Tuple
+from subprocess import CalledProcessError
+from typing import Any
 
 from docutils import nodes
 from docutils.nodes import Element
@@ -32,17 +26,21 @@
 from sphinx.util.osutil import ensuredir
 from sphinx.util.png import read_png_depth, write_png_depth
 from sphinx.util.template import LaTeXRenderer
-from sphinx.writers.html import HTMLTranslator
+from sphinx.writers.html import HTML5Translator
 
 logger = logging.getLogger(__name__)
 
 templates_path = path.join(package_dir, 'templates', 'imgmath')
 
+__all__ = ()
+
 
 class MathExtError(SphinxError):
     category = 'Math extension error'
 
-    def __init__(self, msg: str, stderr: str = None, stdout: str = None) -> None:
+    def __init__(
+        self, msg: str, stderr: str | None = None, stdout: str | None = None,
+    ) -> None:
         if stderr:
             msg += '\nstderr\n' + stderr
         if stdout:
@@ -61,10 +59,10 @@
 depthsvgcomment_re = re.compile(r'')
 
 
-def read_svg_depth(filename: str) -> int:
+def read_svg_depth(filename: str) -> int | None:
     """Read the depth from comment at last line of SVG file
     """
-    with open(filename) as f:
+    with open(filename, encoding="utf-8") as f:
         for line in f:  # noqa: B007
             pass
         # Only last line is checked
@@ -77,19 +75,23 @@
 def write_svg_depth(filename: str, depth: int) -> None:
     """Write the depth to SVG file as a comment at end of file
     """
-    with open(filename, 'a') as f:
+    with open(filename, 'a', encoding="utf-8") as f:
         f.write('\n' % depth)
 
 
 def generate_latex_macro(image_format: str,
-                         math: str, config: Config, confdir: str = '') -> str:
+                         math: str,
+                         config: Config,
+                         confdir: str = '') -> str:
     """Generate LaTeX macro."""
     variables = {
         'fontsize': config.imgmath_font_size,
         'baselineskip': int(round(config.imgmath_font_size * 1.2)),
         'preamble': config.imgmath_latex_preamble,
-        'tightpage': '' if image_format == 'png' else ',tightpage',
-        'math': math
+        # the dvips option is important when imgmath_latex in "xelatex", "tectonic",
+        # it has no impact when imgmath_latex="latex"
+        'tightpage': '' if image_format == 'png' else ',dvips,tightpage',
+        'math': math,
     }
 
     if config.imgmath_use_preview:
@@ -125,18 +127,25 @@
     with open(filename, 'w', encoding='utf-8') as f:
         f.write(latex)
 
+    imgmath_latex_name = path.basename(builder.config.imgmath_latex)
+
     # build latex command; old versions of latex don't have the
     # --output-directory option, so we have to manually chdir to the
     # temp dir to run it.
-    command = builder.config.imgmath_latex, '--interaction=nonstopmode'
+    command = builder.config.imgmath_latex
+    if imgmath_latex_name not in 'tectonic':
+        command.append('--interaction=nonstopmode')
     # add custom args from the config file
     command.extend(builder.config.imgmath_latex_args)
     command.append('math.tex')
 
     try:
-        subprocess.run(command, stdout=PIPE, stderr=PIPE, cwd=tempdir, check=True,
+        subprocess.run(command, capture_output=True, cwd=tempdir, check=True,
                        encoding='ascii')
-        return path.join(tempdir, 'math.dvi')
+        if imgmath_latex_name in 'xelatex', 'tectonic':
+            return path.join(tempdir, 'math.xdv')
+        else:
+            return path.join(tempdir, 'math.dvi')
     except OSError as exc:
         logger.warning(__('LaTeX command %r cannot be run (needed for math '
                           'display), check the imgmath_latex setting'),
@@ -146,10 +155,10 @@
         raise MathExtError('latex exited with error', exc.stderr, exc.stdout) from exc
 
 
-def convert_dvi_to_image(command: Liststr, name: str) -> Tuplestr, str:
+def convert_dvi_to_image(command: liststr, name: str) -> tuplestr, str:
     """Convert DVI file to specific image format."""
     try:
-        ret = subprocess.run(command, stdout=PIPE, stderr=PIPE, check=True, encoding='ascii')
+        ret = subprocess.run(command, capture_output=True, check=True, encoding='ascii')
         return ret.stdout, ret.stderr
     except OSError as exc:
         logger.warning(__('%s command %r cannot be run (needed for math '
@@ -160,13 +169,10 @@
         raise MathExtError('%s exited with error' % name, exc.stderr, exc.stdout) from exc
 
 
-def convert_dvi_to_png(dvipath: str, builder: Builder) -> Tuplestr, int:
+def convert_dvi_to_png(dvipath: str, builder: Builder, out_path: str) -> int | None:
     """Convert DVI file to PNG image."""
-    tempdir = ensure_tempdir(builder)
-    filename = path.join(tempdir, 'math.png')
-
     name = 'dvipng'
-    command = builder.config.imgmath_dvipng, '-o', filename, '-T', 'tight', '-z9'
+    command = builder.config.imgmath_dvipng, '-o', out_path, '-T', 'tight', '-z9'
     command.extend(builder.config.imgmath_dvipng_args)
     if builder.config.imgmath_use_preview:
         command.append('--depth')
@@ -180,19 +186,16 @@
             matched = depth_re.match(line)
             if matched:
                 depth = int(matched.group(1))
-                write_png_depth(filename, depth)
+                write_png_depth(out_path, depth)
                 break
 
-    return filename, depth
+    return depth
 
 
-def convert_dvi_to_svg(dvipath: str, builder: Builder) -> Tuplestr, int:
+def convert_dvi_to_svg(dvipath: str, builder: Builder, out_path: str) -> int | None:
     """Convert DVI file to SVG image."""
-    tempdir = ensure_tempdir(builder)
-    filename = path.join(tempdir, 'math.svg')
-
     name = 'dvisvgm'
-    command = builder.config.imgmath_dvisvgm, '-o', filename
+    command = builder.config.imgmath_dvisvgm, '-o', out_path
     command.extend(builder.config.imgmath_dvisvgm_args)
     command.append(dvipath)
 
@@ -204,17 +207,20 @@
             matched = depthsvg_re.match(line)
             if matched:
                 depth = round(float(matched.group(1)) * 100 / 72.27)  # assume 100ppi
-                write_svg_depth(filename, depth)
+                write_svg_depth(out_path, depth)
                 break
 
-    return filename, depth
+    return depth
 
 
-def render_math(self: HTMLTranslator, math: str) -> Tuplestr, int:
+def render_math(
+    self: HTML5Translator,
+    math: str,
+) -> tuplestr | None, int | None:
     """Render the LaTeX math expression *math* using latex and dvipng or
     dvisvgm.
 
-    Return the filename relative to the built document and the "depth",
+    Return the image absolute filename and the "depth",
     that is, the distance of image bottom and baseline in pixels, if the
     option to use preview_latex is switched on.
 
@@ -233,15 +239,15 @@
                                  self.builder.config,
                                  self.builder.confdir)
 
-    filename = "%s.%s" % (sha1(latex.encode()).hexdigest(), image_format)
-    relfn = posixpath.join(self.builder.imgpath, 'math', filename)
-    outfn = path.join(self.builder.outdir, self.builder.imagedir, 'math', filename)
-    if path.isfile(outfn):
+    filename = f"{sha1(latex.encode()).hexdigest()}.{image_format}"
+    generated_path = path.join(self.builder.outdir, self.builder.imagedir, 'math', filename)
+    ensuredir(path.dirname(generated_path))
+    if path.isfile(generated_path):
         if image_format == 'png':
-            depth = read_png_depth(outfn)
+            depth = read_png_depth(generated_path)
         elif image_format == 'svg':
-            depth = read_svg_depth(outfn)
-        return relfn, depth
+            depth = read_svg_depth(generated_path)
+        return generated_path, depth
 
     # if latex or dvipng (dvisvgm) has failed once, don't bother to try again
     if hasattr(self.builder, '_imgmath_warned_latex') or \
@@ -258,40 +264,54 @@
     # .dvi -> .png/.svg
     try:
         if image_format == 'png':
-            imgpath, depth = convert_dvi_to_png(dvipath, self.builder)
+            depth = convert_dvi_to_png(dvipath, self.builder, generated_path)
         elif image_format == 'svg':
-            imgpath, depth = convert_dvi_to_svg(dvipath, self.builder)
+            depth = convert_dvi_to_svg(dvipath, self.builder, generated_path)
     except InvokeError:
         self.builder._imgmath_warned_image_translator = True  # type: ignore
         return None, None
 
-    # Move generated image on tempdir to build dir
-    ensuredir(path.dirname(outfn))
-    shutil.move(imgpath, outfn)
+    return generated_path, depth
+
 
-    return relfn, depth
+def render_maths_to_base64(image_format: str, generated_path: str) -> str:
+    with open(generated_path, "rb") as f:
+        encoded = base64.b64encode(f.read()).decode(encoding='utf-8')
+    if image_format == 'png':
+        return f'data:image/png;base64,{encoded}'
+    if image_format == 'svg':
+        return f'data:image/svg+xml;base64,{encoded}'
+    raise MathExtError('imgmath_image_format must be either "png" or "svg"')
 
 
-def cleanup_tempdir(app: Sphinx, exc: Exception) -> None:
+def clean_up_files(app: Sphinx, exc: Exception) -> None:
     if exc:
         return
-    if not hasattr(app.builder, '_imgmath_tempdir'):
-        return
-    try:
-        shutil.rmtree(app.builder._mathpng_tempdir)  # type: ignore
-    except Exception:
-        pass
+
+    if hasattr(app.builder, '_imgmath_tempdir'):
+        try:
+            shutil.rmtree(app.builder._imgmath_tempdir)
+        except Exception:
+            pass
+
+    if app.builder.config.imgmath_embed:
+        # in embed mode, the images are still generated in the math output dir
+        # to be shared across workers, but are not useful to the final document
+        try:
+            shutil.rmtree(path.join(app.builder.outdir, app.builder.imagedir, 'math'))
+        except Exception:
+            pass
 
 
-def get_tooltip(self: HTMLTranslator, node: Element) -> str:
+def get_tooltip(self: HTML5Translator, node: Element) -> str:
     if self.builder.config.imgmath_add_tooltips:
         return ' alt="%s"' % self.encode(node.astext()).strip()
     return ''
 
 
-def html_visit_math(self: HTMLTranslator, node: nodes.math) -> None:
+def html_visit_math(self: HTML5Translator, node: nodes.math) -> None:
     try:
-        fname, depth = render_math(self, '$' + node.astext() + '$')
+        rendered_path, depth = render_math(self, '$' + node.astext() + '$')
     except MathExtError as exc:
         msg = str(exc)
         sm = nodes.system_message(msg, type='WARNING', level=2,
@@ -299,25 +319,33 @@
         sm.walkabout(self)
         logger.warning(__('display latex %r: %s'), node.astext(), msg)
         raise nodes.SkipNode from exc
-    if fname is None:
+
+    if rendered_path is None:
         # something failed -- use text-only as a bad substitute
         self.body.append('<span class="math">%s</span>' %
                          self.encode(node.astext()).strip())
     else:
-        c = ('<img class="math" src="%s"' % fname) + get_tooltip(self, node)
+        if self.builder.config.imgmath_embed:
+            image_format = self.builder.config.imgmath_image_format.lower()
+            img_src = render_maths_to_base64(image_format, rendered_path)
+        else:
+            bname = path.basename(rendered_path)
+            relative_path = path.join(self.builder.imgpath, 'math', bname)
+            img_src = relative_path.replace(path.sep, '/')
+        c = f'<img class="math" src="{img_src}"' + get_tooltip(self, node)
         if depth is not None:
-            c += ' style="vertical-align: %dpx"' % (-depth)
+            c += f' style="vertical-align: {-depth:d}px"'
         self.body.append(c + '/>')
     raise nodes.SkipNode
 
 
-def html_visit_displaymath(self: HTMLTranslator, node: nodes.math_block) -> None:
+def html_visit_displaymath(self: HTML5Translator, node: nodes.math_block) -> None:
     if node'nowrap':
         latex = node.astext()
     else:
         latex = wrap_displaymath(node.astext(), None, False)
     try:
-        fname, depth = render_math(self, latex)
+        rendered_path, depth = render_math(self, latex)
     except MathExtError as exc:
         msg = str(exc)
         sm = nodes.system_message(msg, type='WARNING', level=2,
@@ -332,17 +360,25 @@
         self.body.append('<span class="eqno">(%s)' % number)
         self.add_permalink_ref(node, _('Permalink to this equation'))
         self.body.append('</span>')
-    if fname is None:
+
+    if rendered_path is None:
         # something failed -- use text-only as a bad substitute
         self.body.append('<span class="math">%s</span></p>\n</div>' %
                          self.encode(node.astext()).strip())
     else:
-        self.body.append(('<img src="%s"' % fname) + get_tooltip(self, node) +
+        if self.builder.config.imgmath_embed:
+            image_format = self.builder.config.imgmath_image_format.lower()
+            img_src = render_maths_to_base64(image_format, rendered_path)
+        else:
+            bname = path.basename(rendered_path)
+            relative_path = path.join(self.builder.imgpath, 'math', bname)
+            img_src = relative_path.replace(path.sep, '/')
+        self.body.append(f'<img src="{img_src}"' + get_tooltip(self, node) +
                          '/></p>\n</div>')
     raise nodes.SkipNode
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_html_math_renderer('imgmath',
                                (html_visit_math, None),
                                (html_visit_displaymath, None))
@@ -360,5 +396,6 @@
     app.add_config_value('imgmath_latex_preamble', '', 'html')
     app.add_config_value('imgmath_add_tooltips', True, 'html')
     app.add_config_value('imgmath_font_size', 12, 'html')
-    app.connect('build-finished', cleanup_tempdir)
+    app.add_config_value('imgmath_embed', False, 'html', bool)
+    app.connect('build-finished', clean_up_files)
     return {'version': sphinx.__display_version__, 'parallel_read_safe': True}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/inheritance_diagram.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/inheritance_diagram.py Changed

@@ -1,45 +1,40 @@
-r"""
-    sphinx.ext.inheritance_diagram
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+r"""Defines a docutils directive for inserting inheritance diagrams.
 
-    Defines a docutils directive for inserting inheritance diagrams.
+Provide the directive with one or more classes or modules (separated
+by whitespace).  For modules, all of the classes in that module will
+be used.
 
-    Provide the directive with one or more classes or modules (separated
-    by whitespace).  For modules, all of the classes in that module will
-    be used.
+Example::
 
-    Example::
+   Given the following classes:
 
-       Given the following classes:
+   class A: pass
+   class B(A): pass
+   class C(A): pass
+   class D(B, C): pass
+   class E(B): pass
 
-       class A: pass
-       class B(A): pass
-       class C(A): pass
-       class D(B, C): pass
-       class E(B): pass
+   .. inheritance-diagram: D E
 
-       .. inheritance-diagram: D E
+   Produces a graph like the following:
 
-       Produces a graph like the following:
+               A
+              / \
+             B   C
+            / \ /
+           E   D
 
-                   A
-                  / \
-                 B   C
-                / \ /
-               E   D
-
-    The graph is inserted as a PNG+image map into HTML and a PDF in
-    LaTeX.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+The graph is inserted as a PNG+image map into HTML and a PDF in
+LaTeX.
 """
 
+from __future__ import annotations
+
 import builtins
 import inspect
 import re
 from importlib import import_module
-from typing import Any, Dict, Iterable, List, Tuple, cast
+from typing import Any, Iterable, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -49,12 +44,17 @@
 from sphinx import addnodes
 from sphinx.application import Sphinx
 from sphinx.environment import BuildEnvironment
-from sphinx.ext.graphviz import (figure_wrapper, graphviz, render_dot_html, render_dot_latex,
-                                 render_dot_texinfo)
+from sphinx.ext.graphviz import (
+    figure_wrapper,
+    graphviz,
+    render_dot_html,
+    render_dot_latex,
+    render_dot_texinfo,
+)
 from sphinx.util import md5
 from sphinx.util.docutils import SphinxDirective
 from sphinx.util.typing import OptionSpec
-from sphinx.writers.html import HTMLTranslator
+from sphinx.writers.html import HTML5Translator
 from sphinx.writers.latex import LaTeXTranslator
 from sphinx.writers.texinfo import TexinfoTranslator
 
@@ -137,9 +137,10 @@
     from all the way to the root "object", and then is able to generate a
     graphviz dot graph from them.
     """
-    def __init__(self, class_names: Liststr, currmodule: str, show_builtins: bool = False,
-                 private_bases: bool = False, parts: int = 0, aliases: Dictstr, str = None,
-                 top_classes: ListAny = ) -> None:
+    def __init__(self, class_names: liststr, currmodule: str, show_builtins: bool = False,
+                 private_bases: bool = False, parts: int = 0,
+                 aliases: dictstr, str | None = None, top_classes: listAny = ,
+                 ) -> None:
         """*class_names* is a list of child classes to show bases from.
 
         If *show_builtins* is True, then Python builtins will be shown
@@ -153,16 +154,16 @@
             raise InheritanceException('No classes found for '
                                        'inheritance diagram')
 
-    def _import_classes(self, class_names: Liststr, currmodule: str) -> ListAny:
+    def _import_classes(self, class_names: liststr, currmodule: str) -> listAny:
         """Import a list of classes."""
-        classes: ListAny = 
+        classes: listAny = 
         for name in class_names:
             classes.extend(import_classes(name, currmodule))
         return classes
 
-    def _class_info(self, classes: ListAny, show_builtins: bool, private_bases: bool,
-                    parts: int, aliases: Dictstr, str, top_classes: ListAny
-                    ) -> ListTuplestr, str, Liststr, str:
+    def _class_info(self, classes: listAny, show_builtins: bool, private_bases: bool,
+                    parts: int, aliases: dictstr, str, top_classes: listAny,
+                    ) -> listtuplestr, str, liststr, str:
         """Return name and bases for all classes that are ancestors of
         *classes*.
 
@@ -199,7 +200,7 @@
             except Exception:  # might raise AttributeError for strange classes
                 pass
 
-            baselist: Liststr = 
+            baselist: liststr = 
             all_classescls = (nodename, fullname, baselist, tooltip)
 
             if fullname in top_classes:
@@ -219,7 +220,9 @@
 
         return list(all_classes.values())
 
-    def class_name(self, cls: Any, parts: int = 0, aliases: Dictstr, str = None) -> str:
+    def class_name(
+        self, cls: Any, parts: int = 0, aliases: dictstr, str | None = None,
+    ) -> str:
         """Given a class object, return a fully-qualified name.
 
         This works for things I've tested in matplotlib so far, but may not be
@@ -229,7 +232,7 @@
         if module in ('__builtin__', 'builtins'):
             fullname = cls.__name__
         else:
-            fullname = '%s.%s' % (module, cls.__qualname__)
+            fullname = f'{module}.{cls.__qualname__}'
         if parts == 0:
             result = fullname
         else:
@@ -239,7 +242,7 @@
             return aliasesresult
         return result
 
-    def get_all_class_names(self) -> Liststr:
+    def get_all_class_names(self) -> liststr:
         """Get all of the class names involved in the graph."""
         return fullname for (_, fullname, _, _) in self.class_info
 
@@ -263,14 +266,15 @@
         'style': '"setlinewidth(0.5)"',
     }
 
-    def _format_node_attrs(self, attrs: Dict) -> str:
+    def _format_node_attrs(self, attrs: dictstr, Any) -> str:
         return ','.join('%s=%s' % x for x in sorted(attrs.items()))
 
-    def _format_graph_attrs(self, attrs: Dict) -> str:
+    def _format_graph_attrs(self, attrs: dictstr, Any) -> str:
         return ''.join('%s=%s;\n' % x for x in sorted(attrs.items()))
 
-    def generate_dot(self, name: str, urls: Dict = {}, env: BuildEnvironment = None,
-                     graph_attrs: Dict = {}, node_attrs: Dict = {}, edge_attrs: Dict = {}
+    def generate_dot(self, name: str, urls: dictstr, str = {},
+                     env: BuildEnvironment | None = None,
+                     graph_attrs: dict = {}, node_attrs: dict = {}, edge_attrs: dict = {},
                      ) -> str:
         """Generate a graphviz dot graph from the classes that were passed in
         to __init__.
@@ -293,7 +297,7 @@
             n_attrs.update(env.config.inheritance_node_attrs)
             e_attrs.update(env.config.inheritance_edge_attrs)
 
-        res: Liststr = 
+        res: liststr = 
         res.append('digraph %s {\n' % name)
         res.append(self._format_graph_attrs(g_attrs))
 
@@ -339,7 +343,7 @@
         'top-classes': directives.unchanged_required,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         node = inheritance_diagram()
         node.document = self.state.document
         class_names = self.arguments0.split()
@@ -390,7 +394,7 @@
     return md5(encoded).hexdigest()-10:
 
 
-def html_visit_inheritance_diagram(self: HTMLTranslator, node: inheritance_diagram) -> None:
+def html_visit_inheritance_diagram(self: HTML5Translator, node: inheritance_diagram) -> None:
     """
     Output the graph for HTML.  This will insert a PNG with clickable
     image map.
@@ -438,7 +442,7 @@
     raise nodes.SkipNode
 
 
-def texinfo_visit_inheritance_diagram(self: TexinfoTranslator, node: inheritance_diagram
+def texinfo_visit_inheritance_diagram(self: TexinfoTranslator, node: inheritance_diagram,
                                       ) -> None:
     """
     Output the graph for Texinfo.  This will insert a PNG.
@@ -458,7 +462,7 @@
     raise nodes.SkipNode
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.setup_extension('sphinx.ext.graphviz')
     app.add_node(
         inheritance_diagram,

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/intersphinx.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/intersphinx.py Changed

@@ -1,28 +1,23 @@
-"""
-    sphinx.ext.intersphinx
-    ~~~~~~~~~~~~~~~~~~~~~~
-
-    Insert links to objects documented in remote Sphinx documentation.
-
-    This works as follows:
+"""Insert links to objects documented in remote Sphinx documentation.
 
-    * Each Sphinx HTML build creates a file named "objects.inv" that contains a
-      mapping from object names to URIs relative to the HTML set's root.
+This works as follows:
 
-    * Projects using the Intersphinx extension can specify links to such mapping
-      files in the `intersphinx_mapping` config value.  The mapping will then be
-      used to resolve otherwise missing references to objects into links to the
-      other documentation.
+* Each Sphinx HTML build creates a file named "objects.inv" that contains a
+  mapping from object names to URIs relative to the HTML set's root.
 
-    * By default, the mapping file is assumed to be at the same location as the
-      rest of the documentation; however, the location of the mapping file can
-      also be specified individually, e.g. if the docs should be buildable
-      without Internet access.
+* Projects using the Intersphinx extension can specify links to such mapping
+  files in the `intersphinx_mapping` config value.  The mapping will then be
+  used to resolve otherwise missing references to objects into links to the
+  other documentation.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+* By default, the mapping file is assumed to be at the same location as the
+  rest of the documentation; however, the location of the mapping file can
+  also be specified individually, e.g. if the docs should be buildable
+  without Internet access.
 """
 
+from __future__ import annotations
+
 import concurrent.futures
 import functools
 import posixpath
@@ -30,28 +25,36 @@
 import sys
 import time
 from os import path
-from types import ModuleType
-from typing import IO, Any, Dict, List, Optional, Tuple, cast
+from typing import IO, TYPE_CHECKING, Any, cast
 from urllib.parse import urlsplit, urlunsplit
 
 from docutils import nodes
-from docutils.nodes import Element, Node, TextElement, system_message
-from docutils.utils import Reporter, relative_path
+from docutils.utils import relative_path
 
 import sphinx
 from sphinx.addnodes import pending_xref
-from sphinx.application import Sphinx
 from sphinx.builders.html import INVENTORY_FILENAME
-from sphinx.config import Config
-from sphinx.domains import Domain
-from sphinx.environment import BuildEnvironment
 from sphinx.errors import ExtensionError
 from sphinx.locale import _, __
 from sphinx.transforms.post_transforms import ReferencesResolver
 from sphinx.util import logging, requests
 from sphinx.util.docutils import CustomReSTDispatcher, SphinxRole
 from sphinx.util.inventory import InventoryFile
-from sphinx.util.typing import Inventory, InventoryItem, RoleFunction
+
+if TYPE_CHECKING:
+    from types import ModuleType
+    from typing import Tuple, Union
+
+    from docutils.nodes import Node, TextElement, system_message
+    from docutils.utils import Reporter
+
+    from sphinx.application import Sphinx
+    from sphinx.config import Config
+    from sphinx.domains import Domain
+    from sphinx.environment import BuildEnvironment
+    from sphinx.util.typing import Inventory, InventoryItem, RoleFunction
+
+    InventoryCacheEntry = TupleUnionstr, None, int, Inventory
 
 logger = logging.getLogger(__name__)
 
@@ -63,12 +66,22 @@
         self.env = env
 
         if not hasattr(env, 'intersphinx_cache'):
+            # initial storage when fetching inventories before processing
             self.env.intersphinx_cache = {}  # type: ignore
+
             self.env.intersphinx_inventory = {}  # type: ignore
             self.env.intersphinx_named_inventory = {}  # type: ignore
 
     @property
-    def cache(self) -> Dictstr, Tuplestr, int, Inventory:
+    def cache(self) -> dictstr, InventoryCacheEntry:
+        """Intersphinx cache.
+
+        - Key is the URI of the remote inventory
+        - Element one is the key given in the Sphinx intersphinx_mapping
+          configuration value
+        - Element two is a time value for cache invalidation, a float
+        - Element three is the loaded remote inventory, type Inventory
+        """
         return self.env.intersphinx_cache  # type: ignore
 
     @property
@@ -76,7 +89,7 @@
         return self.env.intersphinx_inventory  # type: ignore
 
     @property
-    def named_inventory(self) -> Dictstr, Inventory:
+    def named_inventory(self) -> dictstr, Inventory:
         return self.env.intersphinx_named_inventory  # type: ignore
 
     def clear(self) -> None:
@@ -105,7 +118,7 @@
     return urlunsplit(frags)
 
 
-def _read_from_url(url: str, config: Config = None) -> IO:
+def _read_from_url(url: str, config: Config | None = None) -> IO:
     """Reads data from *url* with an HTTP *GET*.
 
     This function supports fetching from resources which use basic HTTP auth as
@@ -148,14 +161,14 @@
     else:
         frags = list(parts)
         if parts.port:
-            frags1 = '{}@{}:{}'.format(parts.username, parts.hostname, parts.port)
+            frags1 = f'{parts.username}@{parts.hostname}:{parts.port}'
         else:
-            frags1 = '{}@{}'.format(parts.username, parts.hostname)
+            frags1 = f'{parts.username}@{parts.hostname}'
 
         return urlunsplit(frags)
 
 
-def fetch_inventory(app: Sphinx, uri: str, inv: Any) -> Any:
+def fetch_inventory(app: Sphinx, uri: str, inv: str) -> Inventory:
     """Fetch, parse and return an intersphinx inventory file."""
     # both *uri* (base URI of the links to generate) and *inv* (actual
     # location of the inventory file) can be local or remote URIs
@@ -174,7 +187,7 @@
         raise
     try:
         if hasattr(f, 'url'):
-            newinv = f.url  # type: ignore
+            newinv = f.url
             if inv != newinv:
                 logger.info(__('intersphinx inventory has moved: %s -> %s'), inv, newinv)
 
@@ -195,7 +208,12 @@
 
 
 def fetch_inventory_group(
-    name: str, uri: str, invs: Any, cache: Any, app: Any, now: float
+    name: str | None,
+    uri: str,
+    invs: tuplestr | None, ...,
+    cache: dictstr, InventoryCacheEntry,
+    app: Sphinx,
+    now: int,
 ) -> bool:
     cache_time = now - app.config.intersphinx_cache_limit * 86400
     failures = 
@@ -214,7 +232,7 @@
                     failures.append(err.args)
                     continue
                 if invdata:
-                    cacheuri = (name, now, invdata)
+                    cacheuri = name, now, invdata
                     return True
         return False
     finally:
@@ -235,12 +253,16 @@
     """Load all intersphinx mappings into the environment."""
     now = int(time.time())
     inventories = InventoryAdapter(app.builder.env)
+    intersphinx_cache: dictstr, InventoryCacheEntry = inventories.cache
 
     with concurrent.futures.ThreadPoolExecutor() as pool:
         futures = 
+        name: str | None
+        uri: str
+        invs: tuplestr | None, ...
         for name, (uri, invs) in app.config.intersphinx_mapping.values():
             futures.append(pool.submit(
-                fetch_inventory_group, name, uri, invs, inventories.cache, app, now
+                fetch_inventory_group, name, uri, invs, intersphinx_cache, app, now,
             ))
         updated = f.result() for f in concurrent.futures.as_completed(futures)
 
@@ -254,19 +276,23 @@
         # add the unnamed inventories last.  This means that the
         # unnamed inventories will shadow the named ones but the named
         # ones can still be accessed when the name is specified.
-        cached_vals = list(inventories.cache.values())
-        named_vals = sorted(v for v in cached_vals if v0)
-        unnamed_vals = v for v in cached_vals if not v0
-        for name, _x, invdata in named_vals + unnamed_vals:
+        named_vals = 
+        unnamed_vals = 
+        for name, _expiry, invdata in intersphinx_cache.values():
+            if name:
+                named_vals.append((name, invdata))
+            else:
+                unnamed_vals.append((name, invdata))
+        for name, invdata in sorted(named_vals) + unnamed_vals:
             if name:
                 inventories.named_inventoryname = invdata
             for type, objects in invdata.items():
                 inventories.main_inventory.setdefault(type, {}).update(objects)
 
 
-def _create_element_from_result(domain: Domain, inv_name: Optionalstr,
+def _create_element_from_result(domain: Domain, inv_name: str | None,
                                 data: InventoryItem,
-                                node: pending_xref, contnode: TextElement) -> Element:
+                                node: pending_xref, contnode: TextElement) -> nodes.reference:
     proj, version, uri, dispname = data
     if '://' not in uri and node.get('refdoc'):
         # get correct path in case of subdirectories
@@ -295,10 +321,10 @@
 
 
 def _resolve_reference_in_domain_by_target(
-        inv_name: Optionalstr, inventory: Inventory,
-        domain: Domain, objtypes: Liststr,
+        inv_name: str | None, inventory: Inventory,
+        domain: Domain, objtypes: liststr,
         target: str,
-        node: pending_xref, contnode: TextElement) -> OptionalElement:
+        node: pending_xref, contnode: TextElement) -> nodes.reference | None:
     for objtype in objtypes:
         if objtype not in inventory:
             # Continue if there's nothing of this kind in the inventory
@@ -327,21 +353,21 @@
 
 
 def _resolve_reference_in_domain(env: BuildEnvironment,
-                                 inv_name: Optionalstr, inventory: Inventory,
+                                 inv_name: str | None, inventory: Inventory,
                                  honor_disabled_refs: bool,
-                                 domain: Domain, objtypes: Liststr,
-                                 node: pending_xref, contnode: TextElement
-                                 ) -> OptionalElement:
+                                 domain: Domain, objtypes: liststr,
+                                 node: pending_xref, contnode: TextElement,
+                                 ) -> nodes.reference | None:
     # we adjust the object types for backwards compatibility
     if domain.name == 'std' and 'cmdoption' in objtypes:
-        # until Sphinx-1.6, cmdoptions are stored as std:option
+        # cmdoptions were stored as std:option until Sphinx 1.6
         objtypes.append('option')
     if domain.name == 'py' and 'attribute' in objtypes:
-        # Since Sphinx-2.1, properties are stored as py:method
+        # properties are stored as py:method since Sphinx 2.1
         objtypes.append('method')
 
     # the inventory contains domain:type as objtype
-    objtypes = "{}:{}".format(domain.name, t) for t in objtypes
+    objtypes = f"{domain.name}:{t}" for t in objtypes
 
     # now that the objtypes list is complete we can remove the disabled ones
     if honor_disabled_refs:
@@ -362,9 +388,9 @@
                                                   full_qualified_name, node, contnode)
 
 
-def _resolve_reference(env: BuildEnvironment, inv_name: Optionalstr, inventory: Inventory,
+def _resolve_reference(env: BuildEnvironment, inv_name: str | None, inventory: Inventory,
                        honor_disabled_refs: bool,
-                       node: pending_xref, contnode: TextElement) -> OptionalElement:
+                       node: pending_xref, contnode: TextElement) -> nodes.reference | None:
     # disabling should only be done if no inventory is given
     honor_disabled_refs = honor_disabled_refs and inv_name is None
 
@@ -374,8 +400,8 @@
     typ = node'reftype'
     if typ == 'any':
         for domain_name, domain in env.domains.items():
-            if honor_disabled_refs \
-                    and (domain_name + ":*") in env.config.intersphinx_disabled_reftypes:
+            if (honor_disabled_refs
+                    and (domain_name + ":*") in env.config.intersphinx_disabled_reftypes):
                 continue
             objtypes = list(domain.object_types)
             res = _resolve_reference_in_domain(env, inv_name, inventory,
@@ -409,8 +435,8 @@
 
 def resolve_reference_in_inventory(env: BuildEnvironment,
                                    inv_name: str,
-                                   node: pending_xref, contnode: TextElement
-                                   ) -> OptionalElement:
+                                   node: pending_xref, contnode: TextElement,
+                                   ) -> nodes.reference | None:
     """Attempt to resolve a missing reference via intersphinx references.
 
     Resolution is tried in the given inventory with the target as is.
@@ -424,8 +450,8 @@
 
 def resolve_reference_any_inventory(env: BuildEnvironment,
                                     honor_disabled_refs: bool,
-                                    node: pending_xref, contnode: TextElement
-                                    ) -> OptionalElement:
+                                    node: pending_xref, contnode: TextElement,
+                                    ) -> nodes.reference | None:
     """Attempt to resolve a missing reference via intersphinx references.
 
     Resolution is tried with the target as is in any inventory.
@@ -436,8 +462,8 @@
 
 
 def resolve_reference_detect_inventory(env: BuildEnvironment,
-                                       node: pending_xref, contnode: TextElement
-                                       ) -> OptionalElement:
+                                       node: pending_xref, contnode: TextElement,
+                                       ) -> nodes.reference | None:
     """Attempt to resolve a missing reference via intersphinx references.
 
     Resolution is tried first with the target as is in any inventory.
@@ -465,7 +491,7 @@
 
 
 def missing_reference(app: Sphinx, env: BuildEnvironment, node: pending_xref,
-                      contnode: TextElement) -> OptionalElement:
+                      contnode: TextElement) -> nodes.reference | None:
     """Attempt to resolve a missing reference via intersphinx references."""
 
     return resolve_reference_detect_inventory(env, node, contnode)
@@ -477,8 +503,9 @@
     This enables :external:***:/:external+***: roles on parsing reST document.
     """
 
-    def role(self, role_name: str, language_module: ModuleType, lineno: int, reporter: Reporter
-             ) -> TupleRoleFunction, Listsystem_message:
+    def role(
+        self, role_name: str, language_module: ModuleType, lineno: int, reporter: Reporter,
+    ) -> tupleRoleFunction, listsystem_message:
         if len(role_name) > 9 and role_name.startswith(('external:', 'external+')):
             return IntersphinxRole(role_name), 
         else:
@@ -494,7 +521,7 @@
     def __init__(self, orig_name: str) -> None:
         self.orig_name = orig_name
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         assert self.name == self.orig_name.lower()
         inventory, name_suffix = self.get_inventory_and_name_suffix(self.orig_name)
         if inventory and not inventory_exists(self.env, inventory):
@@ -516,7 +543,7 @@
 
         return result, messages
 
-    def get_inventory_and_name_suffix(self, name: str) -> TupleOptionalstr, str:
+    def get_inventory_and_name_suffix(self, name: str) -> tuplestr | None, str:
         assert name.startswith('external'), name
         assert name8 in ':+', name
         # either we have an explicit inventory name, i.e,
@@ -528,7 +555,7 @@
         inv, suffix = IntersphinxRole._re_inv_ref.fullmatch(name, 8).group(2, 3)
         return inv, suffix
 
-    def get_role_name(self, name: str) -> OptionalTuplestr, str:
+    def get_role_name(self, name: str) -> tuplestr, str | None:
         names = name.split(':')
         if len(names) == 1:
             # role
@@ -552,14 +579,11 @@
     def is_existent_role(self, domain_name: str, role_name: str) -> bool:
         try:
             domain = self.env.get_domain(domain_name)
-            if role_name in domain.roles:
-                return True
-            else:
-                return False
+            return role_name in domain.roles
         except ExtensionError:
             return False
 
-    def invoke_role(self, role: Tuplestr, str) -> TupleListNode, Listsystem_message:
+    def invoke_role(self, role: tuplestr, str) -> tuplelistNode, listsystem_message:
         domain = self.env.get_domain(role0)
         if domain:
             role_func = domain.role(role1)
@@ -579,7 +603,7 @@
     default_priority = ReferencesResolver.default_priority - 1
 
     def run(self, **kwargs: Any) -> None:
-        for node in self.document.traverse(pending_xref):
+        for node in self.document.findall(pending_xref):
             if 'intersphinx' not in node:
                 continue
             contnode = cast(nodes.TextElement, node0.deepcopy())
@@ -599,10 +623,10 @@
                 node.replace_self(newnode)
 
 
-def install_dispatcher(app: Sphinx, docname: str, source: Liststr) -> None:
+def install_dispatcher(app: Sphinx, docname: str, source: liststr) -> None:
     """Enable IntersphinxDispatcher.
 
-    .. note:: The installed dispatcher will uninstalled on disabling sphinx_domain
+    .. note:: The installed dispatcher will be uninstalled on disabling sphinx_domain
               automatically.
     """
     dispatcher = IntersphinxDispatcher()
@@ -622,7 +646,16 @@
                     continue
             else:
                 # old format, no name
+                # xref RemovedInSphinx80Warning
                 name, uri, inv = None, key, value
+                msg = (
+                    "The pre-Sphinx 1.0 'intersphinx_mapping' format is "
+                    "deprecated and will be removed in Sphinx 8. Update to the "
+                    "current format as described in the documentation. "
+                    f"Hint: \"intersphinx_mapping = {{'<name>': {(uri, inv)!r}}}\"."
+                    "https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_mapping"  # NoQA: E501
+                )
+                logger.warning(msg)
 
             if not isinstance(inv, tuple):
                 config.intersphinx_mappingkey = (name, (uri, (inv,)))
@@ -633,11 +666,11 @@
             config.intersphinx_mapping.pop(key)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_config_value('intersphinx_mapping', {}, True)
     app.add_config_value('intersphinx_cache_limit', 5, False)
     app.add_config_value('intersphinx_timeout', None, False)
-    app.add_config_value('intersphinx_disabled_reftypes', , True)
+    app.add_config_value('intersphinx_disabled_reftypes', 'std:doc', True)
     app.connect('config-inited', normalize_intersphinx_mapping, priority=800)
     app.connect('builder-inited', load_mappings)
     app.connect('source-read', install_dispatcher)
@@ -646,20 +679,20 @@
     return {
         'version': sphinx.__display_version__,
         'env_version': 1,
-        'parallel_read_safe': True
+        'parallel_read_safe': True,
     }
 
 
-def inspect_main(argv: Liststr) -> None:
+def inspect_main(argv: liststr) -> None:
     """Debug functionality to print out an inventory"""
     if len(argv) < 1:
         print("Print out an inventory file.\n"
               "Error: must specify local path or URL to an inventory file.",
               file=sys.stderr)
-        sys.exit(1)
+        raise SystemExit(1)
 
     class MockConfig:
-        intersphinx_timeout: int = None
+        intersphinx_timeout: int | None = None
         tls_verify = False
         user_agent = None

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/linkcode.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/linkcode.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.ext.linkcode
-    ~~~~~~~~~~~~~~~~~~~
+"""Add external links to module code in Python object descriptions."""
 
-    Add external links to module code in Python object descriptions.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, Set
+from typing import Any
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -41,7 +35,7 @@
 
     for objnode in list(doctree.findall(addnodes.desc)):
         domain = objnode.get('domain')
-        uris: Setstr = set()
+        uris: setstr = set()
         for signode in objnode:
             if not isinstance(signode, addnodes.desc_signature):
                 continue
@@ -73,7 +67,7 @@
             signode += onlynode
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('doctree-read', doctree_read)
     app.add_config_value('linkcode_resolve', None, '')
     return {'version': sphinx.__display_version__, 'parallel_read_safe': True}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/mathjax.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/mathjax.py Changed

@@ -1,17 +1,14 @@
-"""
-    sphinx.ext.mathjax
-    ~~~~~~~~~~~~~~~~~~
+"""Allow `MathJax`_ to be used to display math in Sphinx's HTML writer.
 
-    Allow `MathJax <https://www.mathjax.org/>`_ to be used to display math in
-    Sphinx's HTML writer -- requires the MathJax JavaScript library on your
-    webserver/computer.
+This requires the MathJax JavaScript library on your webserver/computer.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+.. _MathJax: https://www.mathjax.org/
 """
 
+from __future__ import annotations
+
 import json
-from typing import Any, Dict, cast
+from typing import Any, cast
 
 from docutils import nodes
 
@@ -21,7 +18,7 @@
 from sphinx.errors import ExtensionError
 from sphinx.locale import _
 from sphinx.util.math import get_node_equation_number
-from sphinx.writers.html import HTMLTranslator
+from sphinx.writers.html import HTML5Translator
 
 # more information for mathjax secure url is here:
 # https://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn
@@ -30,7 +27,7 @@
 logger = sphinx.util.logging.getLogger(__name__)
 
 
-def html_visit_math(self: HTMLTranslator, node: nodes.math) -> None:
+def html_visit_math(self: HTML5Translator, node: nodes.math) -> None:
     self.body.append(self.starttag(node, 'span', '', CLASS='math notranslate nohighlight'))
     self.body.append(self.builder.config.mathjax_inline0 +
                      self.encode(node.astext()) +
@@ -38,7 +35,7 @@
     raise nodes.SkipNode
 
 
-def html_visit_displaymath(self: HTMLTranslator, node: nodes.math_block) -> None:
+def html_visit_displaymath(self: HTML5Translator, node: nodes.math_block) -> None:
     self.body.append(self.starttag(node, 'div', CLASS='math notranslate nohighlight'))
     if node'nowrap':
         self.body.append(self.encode(node.astext()))
@@ -70,9 +67,12 @@
     raise nodes.SkipNode
 
 
-def install_mathjax(app: Sphinx, pagename: str, templatename: str, context: Dict,
+def install_mathjax(app: Sphinx, pagename: str, templatename: str, context: dictstr, Any,
                     event_arg: Any) -> None:
-    if app.builder.format != 'html' or app.builder.math_renderer_name != 'mathjax':  # type: ignore  # NOQA
+    if (
+        app.builder.format != 'html' or
+        app.builder.math_renderer_name != 'mathjax'  # type: ignoreattr-defined
+    ):
         return
     if not app.config.mathjax_path:
         raise ExtensionError('mathjax_path config value must be set for the '
@@ -105,7 +105,7 @@
         app.add_js_file(app.config.mathjax_path, **options)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_html_math_renderer('mathjax',
                                (html_visit_math, None),
                                (html_visit_displaymath, None))

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/napoleon/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/napoleon/__init__.py Changed

@@ -1,16 +1,10 @@
-"""
-    sphinx.ext.napoleon
-    ~~~~~~~~~~~~~~~~~~~
+"""Support for NumPy and Google style docstrings."""
 
-    Support for NumPy and Google style docstrings.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from typing import Any
 
-from typing import Any, Dict, List
-
-from sphinx import __display_version__ as __version__
+import sphinx
 from sphinx.application import Sphinx
 from sphinx.ext.napoleon.docstring import GoogleDocstring, NumpyDocstring
 from sphinx.util import inspect
@@ -49,7 +43,7 @@
     .. _Google style:
        https://google.github.io/styleguide/pyguide.html
     .. _NumPy style:
-       https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt
+       https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard
 
     Attributes
     ----------
@@ -143,7 +137,7 @@
 
         See Also
         --------
-        :attr:`napoleon_use_admonition_for_examples`
+        :confval:`napoleon_use_admonition_for_examples`
 
     napoleon_use_admonition_for_references : :obj:`bool` (Defaults to False)
         True to use the ``.. admonition::`` directive for **References**
@@ -151,7 +145,7 @@
 
         See Also
         --------
-        :attr:`napoleon_use_admonition_for_examples`
+        :confval:`napoleon_use_admonition_for_examples`
 
     napoleon_use_ivar : :obj:`bool` (Defaults to False)
         True to use the ``:ivar:`` role for instance variables. False to use
@@ -209,7 +203,7 @@
         False to use a single ``:keyword arguments:`` role for all the
         keywords.
 
-        This behaves similarly to  :attr:`napoleon_use_param`. Note unlike
+        This behaves similarly to :confval:`napoleon_use_param`. Note unlike
         docutils, ``:keyword:`` and ``:param:`` will not be treated the same
         way - there will be a separate "Keyword Arguments" section, rendered
         in the same fashion as "Parameters" section (type links created if
@@ -217,7 +211,7 @@
 
         See Also
         --------
-        :attr:`napoleon_use_param`
+        :confval:`napoleon_use_param`
 
     napoleon_use_rtype : :obj:`bool` (Defaults to True)
         True to use the ``:rtype:`` role for the return type. False to output
@@ -294,7 +288,7 @@
             setattr(self, name, value)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     """Sphinx extension setup function.
 
     When the extension is loaded, Sphinx imports this module and executes
@@ -318,7 +312,7 @@
     """
     if not isinstance(app, Sphinx):
         # probably called by tests
-        return {'version': __version__, 'parallel_read_safe': True}
+        return {'version': sphinx.__display_version__, 'parallel_read_safe': True}
 
     _patch_python_domain()
 
@@ -328,30 +322,25 @@
 
     for name, (default, rebuild) in Config._config_values.items():
         app.add_config_value(name, default, rebuild)
-    return {'version': __version__, 'parallel_read_safe': True}
+    return {'version': sphinx.__display_version__, 'parallel_read_safe': True}
 
 
 def _patch_python_domain() -> None:
-    try:
-        from sphinx.domains.python import PyTypedField
-    except ImportError:
-        pass
-    else:
-        import sphinx.domains.python
-        from sphinx.locale import _
-        for doc_field in sphinx.domains.python.PyObject.doc_field_types:
-            if doc_field.name == 'parameter':
-                doc_field.names = ('param', 'parameter', 'arg', 'argument')
-                break
-        sphinx.domains.python.PyObject.doc_field_types.append(
-            PyTypedField('keyword', label=_('Keyword Arguments'),
-                         names=('keyword', 'kwarg', 'kwparam'),
-                         typerolename='obj', typenames=('paramtype', 'kwtype'),
-                         can_collapse=True))
+    from sphinx.domains.python import PyObject, PyTypedField
+    from sphinx.locale import _
+    for doc_field in PyObject.doc_field_types:
+        if doc_field.name == 'parameter':
+            doc_field.names = ('param', 'parameter', 'arg', 'argument')
+            break
+    PyObject.doc_field_types.append(
+        PyTypedField('keyword', label=_('Keyword Arguments'),
+                     names=('keyword', 'kwarg', 'kwparam'),
+                     typerolename='obj', typenames=('paramtype', 'kwtype'),
+                     can_collapse=True))
 
 
 def _process_docstring(app: Sphinx, what: str, name: str, obj: Any,
-                       options: Any, lines: Liststr) -> None:
+                       options: Any, lines: liststr) -> None:
     """Process the docstring for a given python object.
 
     Called when autodoc has read and processed a docstring. `lines` is a list

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/napoleon/docstring.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/napoleon/docstring.py Changed

@@ -1,28 +1,18 @@
-"""
-    sphinx.ext.napoleon.docstring
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Classes for docstring parsing and formatting."""
 
-
-    Classes for docstring parsing and formatting.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import collections
 import inspect
 import re
 from functools import partial
-from typing import Any, Callable, Dict, List, Tuple, Type, Union
+from typing import Any, Callable
 
 from sphinx.application import Sphinx
 from sphinx.config import Config as SphinxConfig
-from sphinx.ext.napoleon.iterators import modify_iter
 from sphinx.locale import _, __
 from sphinx.util import logging
-from sphinx.util.inspect import stringify_annotation
-from sphinx.util.typing import get_type_hints
+from sphinx.util.typing import get_type_hints, stringify_annotation
 
 logger = logging.getLogger(__name__)
 
@@ -35,7 +25,7 @@
     r'((?::(?:a-zA-Z0-9+\-_+:.)*a-zA-Z0-9+:`.+?`)|'
     r'(?:``.+?``))')
 _xref_regex = re.compile(
-    r'(?:(?::(?:a-zA-Z0-9+\-_+:.)*a-zA-Z0-9+:)?`.+?`)'
+    r'(?:(?::(?:a-zA-Z0-9+\-_+:.)*a-zA-Z0-9+:)?`.+?`)',
 )
 _bullet_list_regex = re.compile(r'^(\*|\+|\-)(\s+\S|\s*$)')
 _enumerated_list_regex = re.compile(
@@ -46,7 +36,7 @@
     r"(,\sor\s|\sor\s|\sof\s|:\s|\sto\s|,\sand\s|\sand\s|,\s"
     r"|{|}"
     r'|"(?:\\"|^")*"'
-    r"|'(?:\\'|^')*')"
+    r"|'(?:\\'|^')*')",
 )
 _default_regex = re.compile(
     r"^default^_0-9A-Za-z.*$",
@@ -54,7 +44,30 @@
 _SINGLETONS = ("None", "True", "False", "Ellipsis")
 
 
-def _convert_type_spec(_type: str, translations: Dictstr, str = {}) -> str:
+class Deque(collections.deque):
+    """
+    A subclass of deque that mimics ``pockets.iterators.modify_iter``.
+
+    The `.Deque.get` and `.Deque.next` methods are added.
+    """
+
+    sentinel = object()
+
+    def get(self, n: int) -> Any:
+        """
+        Return the nth element of the stack, or ``self.sentinel`` if n is
+        greater than the stack size.
+        """
+        return selfn if n < len(self) else self.sentinel
+
+    def next(self) -> Any:
+        if self:
+            return super().popleft()
+        else:
+            raise StopIteration
+
+
+def _convert_type_spec(_type: str, translations: dictstr, str = {}) -> str:
     """Convert type specification to reference in reST."""
     if _type in translations:
         return translations_type
@@ -133,9 +146,16 @@
     _name_rgx = re.compile(r"^\s*((?::(?P<role>\S+):)?`(?P<name>~?a-zA-Z0-9_.-+)`|"
                            r" (?P<name2>~?a-zA-Z0-9_.-+))\s*", re.X)
 
-    def __init__(self, docstring: Unionstr, Liststr, config: SphinxConfig = None,
-                 app: Sphinx = None, what: str = '', name: str = '',
-                 obj: Any = None, options: Any = None) -> None:
+    def __init__(
+        self,
+        docstring: str | liststr,
+        config: SphinxConfig | None = None,
+        app: Sphinx | None = None,
+        what: str = '',
+        name: str = '',
+        obj: Any = None,
+        options: Any = None,
+    ) -> None:
         self._config = config
         self._app = app
 
@@ -161,14 +181,14 @@
             lines = docstring.splitlines()
         else:
             lines = docstring
-        self._line_iter = modify_iter(lines, modifier=lambda s: s.rstrip())
-        self._parsed_lines: Liststr = 
+        self._lines = Deque(map(str.rstrip, lines))
+        self._parsed_lines: liststr = 
         self._is_in_section = False
         self._section_indent = 0
         if not hasattr(self, '_directive_sections'):
-            self._directive_sections: Liststr = 
+            self._directive_sections: liststr = 
         if not hasattr(self, '_sections'):
-            self._sections: Dictstr, Callable = {
+            self._sections: dictstr, Callable = {
                 'args': self._parse_parameters_section,
                 'arguments': self._parse_parameters_section,
                 'attention': partial(self._parse_admonition, 'attention'),
@@ -220,7 +240,7 @@
         """
         return '\n'.join(self.lines())
 
-    def lines(self) -> Liststr:
+    def lines(self) -> liststr:
         """Return the parsed lines of the docstring in reStructuredText format.
 
         Returns
@@ -231,34 +251,36 @@
         """
         return self._parsed_lines
 
-    def _consume_indented_block(self, indent: int = 1) -> Liststr:
+    def _consume_indented_block(self, indent: int = 1) -> liststr:
         lines = 
-        line = self._line_iter.peek()
-        while(not self._is_section_break() and
-              (not line or self._is_indented(line, indent))):
-            lines.append(next(self._line_iter))
-            line = self._line_iter.peek()
+        line = self._lines.get(0)
+        while (
+            not self._is_section_break() and
+            (not line or self._is_indented(line, indent))
+        ):
+            lines.append(self._lines.next())
+            line = self._lines.get(0)
         return lines
 
-    def _consume_contiguous(self) -> Liststr:
+    def _consume_contiguous(self) -> liststr:
         lines = 
-        while (self._line_iter.has_next() and
-               self._line_iter.peek() and
+        while (self._lines and
+               self._lines.get(0) and
                not self._is_section_header()):
-            lines.append(next(self._line_iter))
+            lines.append(self._lines.next())
         return lines
 
-    def _consume_empty(self) -> Liststr:
+    def _consume_empty(self) -> liststr:
         lines = 
-        line = self._line_iter.peek()
-        while self._line_iter.has_next() and not line:
-            lines.append(next(self._line_iter))
-            line = self._line_iter.peek()
+        line = self._lines.get(0)
+        while self._lines and not line:
+            lines.append(self._lines.next())
+            line = self._lines.get(0)
         return lines
 
-    def _consume_field(self, parse_type: bool = True, prefer_type: bool = False
-                       ) -> Tuplestr, str, Liststr:
-        line = next(self._line_iter)
+    def _consume_field(self, parse_type: bool = True, prefer_type: bool = False,
+                       ) -> tuplestr, str, liststr:
+        line = self._lines.next()
 
         before, colon, after = self._partition_field_on_colon(line)
         _name, _type, _desc = before, '', after
@@ -283,7 +305,7 @@
         return _name, _type, _descs
 
     def _consume_fields(self, parse_type: bool = True, prefer_type: bool = False,
-                        multiple: bool = False) -> ListTuplestr, str, Liststr:
+                        multiple: bool = False) -> listtuplestr, str, liststr:
         self._consume_empty()
         fields = 
         while not self._is_section_break():
@@ -295,8 +317,8 @@
                 fields.append((_name, _type, _desc,))
         return fields
 
-    def _consume_inline_attribute(self) -> Tuplestr, Liststr:
-        line = next(self._line_iter)
+    def _consume_inline_attribute(self) -> tuplestr, liststr:
+        line = self._lines.next()
         _type, colon, _desc = self._partition_field_on_colon(line)
         if not colon or not _desc:
             _type, _desc = _desc, _type
@@ -305,8 +327,8 @@
         _descs = self.__class__(_descs, self._config).lines()
         return _type, _descs
 
-    def _consume_returns_section(self, preprocess_types: bool = False
-                                 ) -> ListTuplestr, str, Liststr:
+    def _consume_returns_section(self, preprocess_types: bool = False,
+                                 ) -> listtuplestr, str, liststr:
         lines = self._dedent(self._consume_to_next_section())
         if lines:
             before, colon, after = self._partition_field_on_colon(lines0)
@@ -329,31 +351,31 @@
         else:
             return 
 
-    def _consume_usage_section(self) -> Liststr:
+    def _consume_usage_section(self) -> liststr:
         lines = self._dedent(self._consume_to_next_section())
         return lines
 
     def _consume_section_header(self) -> str:
-        section = next(self._line_iter)
+        section = self._lines.next()
         stripped_section = section.strip(':')
         if stripped_section.lower() in self._sections:
             section = stripped_section
         return section
 
-    def _consume_to_end(self) -> Liststr:
+    def _consume_to_end(self) -> liststr:
         lines = 
-        while self._line_iter.has_next():
-            lines.append(next(self._line_iter))
+        while self._lines:
+            lines.append(self._lines.next())
         return lines
 
-    def _consume_to_next_section(self) -> Liststr:
+    def _consume_to_next_section(self) -> liststr:
         self._consume_empty()
         lines = 
         while not self._is_section_break():
-            lines.append(next(self._line_iter))
+            lines.append(self._lines.next())
         return lines + self._consume_empty()
 
-    def _dedent(self, lines: Liststr, full: bool = False) -> Liststr:
+    def _dedent(self, lines: liststr, full: bool = False) -> liststr:
         if full:
             return line.lstrip() for line in lines
         else:
@@ -371,7 +393,7 @@
         else:
             return name
 
-    def _fix_field_desc(self, desc: Liststr) -> Liststr:
+    def _fix_field_desc(self, desc: liststr) -> liststr:
         if self._is_list(desc):
             desc = '' + desc
         elif desc0.endswith('::'):
@@ -384,17 +406,19 @@
                 desc = '', desc0 + self._indent(desc_block, 4)
         return desc
 
-    def _format_admonition(self, admonition: str, lines: Liststr) -> Liststr:
+    def _format_admonition(self, admonition: str, lines: liststr) -> liststr:
         lines = self._strip_empty(lines)
         if len(lines) == 1:
-            return '.. %s:: %s' % (admonition, lines0.strip()), ''
+            return f'.. {admonition}:: {lines0.strip()}', ''
         elif lines:
             lines = self._indent(self._dedent(lines), 3)
             return '.. %s::' % admonition, '' + lines + ''
         else:
             return '.. %s::' % admonition, ''
 
-    def _format_block(self, prefix: str, lines: Liststr, padding: str = None) -> Liststr:
+    def _format_block(
+        self, prefix: str, lines: liststr, padding: str | None = None,
+    ) -> liststr:
         if lines:
             if padding is None:
                 padding = ' ' * len(prefix)
@@ -410,40 +434,40 @@
         else:
             return prefix
 
-    def _format_docutils_params(self, fields: ListTuplestr, str, Liststr,
-                                field_role: str = 'param', type_role: str = 'type'
-                                ) -> Liststr:
+    def _format_docutils_params(self, fields: listtuplestr, str, liststr,
+                                field_role: str = 'param', type_role: str = 'type',
+                                ) -> liststr:
         lines = 
         for _name, _type, _desc in fields:
             _desc = self._strip_empty(_desc)
             if any(_desc):
                 _desc = self._fix_field_desc(_desc)
-                field = ':%s %s: ' % (field_role, _name)
+                field = f':{field_role} {_name}: '
                 lines.extend(self._format_block(field, _desc))
             else:
-                lines.append(':%s %s:' % (field_role, _name))
+                lines.append(f':{field_role} {_name}:')
 
             if _type:
-                lines.append(':%s %s: %s' % (type_role, _name, _type))
+                lines.append(f':{type_role} {_name}: {_type}')
         return lines + ''
 
-    def _format_field(self, _name: str, _type: str, _desc: Liststr) -> Liststr:
+    def _format_field(self, _name: str, _type: str, _desc: liststr) -> liststr:
         _desc = self._strip_empty(_desc)
         has_desc = any(_desc)
         separator = ' -- ' if has_desc else ''
         if _name:
             if _type:
                 if '`' in _type:
-                    field = '**%s** (%s)%s' % (_name, _type, separator)
+                    field = f'**{_name}** ({_type}){separator}'
                 else:
-                    field = '**%s** (*%s*)%s' % (_name, _type, separator)
+                    field = f'**{_name}** (*{_type}*){separator}'
             else:
-                field = '**%s**%s' % (_name, separator)
+                field = f'**{_name}**{separator}'
         elif _type:
             if '`' in _type:
-                field = '%s%s' % (_type, separator)
+                field = f'{_type}{separator}'
             else:
-                field = '*%s*%s' % (_type, separator)
+                field = f'*{_type}*{separator}'
         else:
             field = ''
 
@@ -456,12 +480,12 @@
         else:
             return field
 
-    def _format_fields(self, field_type: str, fields: ListTuplestr, str, Liststr
-                       ) -> Liststr:
+    def _format_fields(self, field_type: str, fields: listtuplestr, str, liststr,
+                       ) -> liststr:
         field_type = ':%s:' % field_type.strip()
         padding = ' ' * len(field_type)
         multi = len(fields) > 1
-        lines: Liststr = 
+        lines: liststr = 
         for _name, _type, _desc in fields:
             field = self._format_field(_name, _type, _desc)
             if multi:
@@ -476,12 +500,12 @@
         return lines
 
     def _get_current_indent(self, peek_ahead: int = 0) -> int:
-        line = self._line_iter.peek(peek_ahead + 1)peek_ahead
-        while line != self._line_iter.sentinel:
+        line = self._lines.get(peek_ahead)
+        while line is not self._lines.sentinel:
             if line:
                 return self._get_indent(line)
             peek_ahead += 1
-            line = self._line_iter.peek(peek_ahead + 1)peek_ahead
+            line = self._lines.get(peek_ahead)
         return 0
 
     def _get_indent(self, line: str) -> int:
@@ -490,35 +514,33 @@
                 return i
         return len(line)
 
-    def _get_initial_indent(self, lines: Liststr) -> int:
+    def _get_initial_indent(self, lines: liststr) -> int:
         for line in lines:
             if line:
                 return self._get_indent(line)
         return 0
 
-    def _get_min_indent(self, lines: Liststr) -> int:
+    def _get_min_indent(self, lines: liststr) -> int:
         min_indent = None
         for line in lines:
             if line:
                 indent = self._get_indent(line)
-                if min_indent is None:
-                    min_indent = indent
-                elif indent < min_indent:
+                if min_indent is None or indent < min_indent:
                     min_indent = indent
         return min_indent or 0
 
-    def _indent(self, lines: Liststr, n: int = 4) -> Liststr:
+    def _indent(self, lines: liststr, n: int = 4) -> liststr:
         return (' ' * n) + line for line in lines
 
     def _is_indented(self, line: str, indent: int = 1) -> bool:
-        for i, s in enumerate(line):
+        for i, s in enumerate(line):  # noqa: SIM110
             if i >= indent:
                 return True
             elif not s.isspace():
                 return False
         return False
 
-    def _is_list(self, lines: Liststr) -> bool:
+    def _is_list(self, lines: liststr) -> bool:
         if not lines:
             return False
         if _bullet_list_regex.match(lines0):
@@ -536,7 +558,7 @@
         return next_indent > indent
 
     def _is_section_header(self) -> bool:
-        section = self._line_iter.peek().lower()
+        section = self._lines.get(0).lower()
         match = _google_section_regex.match(section)
         if match and section.strip(':') in self._sections:
             header_indent = self._get_indent(section)
@@ -550,8 +572,8 @@
         return False
 
     def _is_section_break(self) -> bool:
-        line = self._line_iter.peek()
-        return (not self._line_iter.has_next() or
+        line = self._lines.get(0)
+        return (not self._lines or
                 self._is_section_header() or
                 (self._is_in_section and
                     line and
@@ -583,9 +605,7 @@
         self._parsed_lines = self._consume_empty()
 
         if self._name and self._what in ('attribute', 'data', 'property'):
-            # Implicit stop using StopIteration no longer allowed in
-            # Python 3.7; see PEP 479
-            res: Liststr = 
+            res: liststr = 
             try:
                 res = self._parse_attribute_docstring()
             except StopIteration:
@@ -593,7 +613,7 @@
             self._parsed_lines.extend(res)
             return
 
-        while self._line_iter.has_next():
+        while self._lines:
             if self._is_section_header():
                 try:
                     section = self._consume_section_header()
@@ -613,29 +633,28 @@
                     lines = self._consume_to_next_section()
             self._parsed_lines.extend(lines)
 
-    def _parse_admonition(self, admonition: str, section: str) -> Liststr:
+    def _parse_admonition(self, admonition: str, section: str) -> liststr:
         # type (str, str) -> Liststr
         lines = self._consume_to_next_section()
         return self._format_admonition(admonition, lines)
 
-    def _parse_attribute_docstring(self) -> Liststr:
+    def _parse_attribute_docstring(self) -> liststr:
         _type, _desc = self._consume_inline_attribute()
         lines = self._format_field('', '', _desc)
         if _type:
             lines.extend('', ':type: %s' % _type)
         return lines
 
-    def _parse_attributes_section(self, section: str) -> Liststr:
+    def _parse_attributes_section(self, section: str) -> liststr:
         lines = 
         for _name, _type, _desc in self._consume_fields():
             if not _type:
                 _type = self._lookup_annotation(_name)
             if self._config.napoleon_use_ivar:
-                _name = self._qualify_name(_name, self._obj)
                 field = ':ivar %s: ' % _name
                 lines.extend(self._format_block(field, _desc))
                 if _type:
-                    lines.append(':vartype %s: %s' % (_name, _type))
+                    lines.append(f':vartype {_name}: {_type}')
             else:
                 lines.append('.. attribute:: ' + _name)
                 if self._opt and 'noindex' in self._opt:
@@ -652,7 +671,7 @@
             lines.append('')
         return lines
 
-    def _parse_examples_section(self, section: str) -> Liststr:
+    def _parse_examples_section(self, section: str) -> liststr:
         labels = {
             'example': _('Example'),
             'examples': _('Examples'),
@@ -661,25 +680,25 @@
         label = labels.get(section.lower(), section)
         return self._parse_generic_section(label, use_admonition)
 
-    def _parse_custom_generic_section(self, section: str) -> Liststr:
+    def _parse_custom_generic_section(self, section: str) -> liststr:
         # for now, no admonition for simple custom sections
         return self._parse_generic_section(section, False)
 
-    def _parse_custom_params_style_section(self, section: str) -> Liststr:
+    def _parse_custom_params_style_section(self, section: str) -> liststr:
         return self._format_fields(section, self._consume_fields())
 
-    def _parse_custom_returns_style_section(self, section: str) -> Liststr:
+    def _parse_custom_returns_style_section(self, section: str) -> liststr:
         fields = self._consume_returns_section(preprocess_types=True)
         return self._format_fields(section, fields)
 
-    def _parse_usage_section(self, section: str) -> Liststr:
+    def _parse_usage_section(self, section: str) -> liststr:
         header = '.. rubric:: Usage:', ''
         block = '.. code-block:: python', ''
         lines = self._consume_usage_section()
         lines = self._indent(lines, 3)
         return header + block + lines + ''
 
-    def _parse_generic_section(self, section: str, use_admonition: bool) -> Liststr:
+    def _parse_generic_section(self, section: str, use_admonition: bool) -> liststr:
         lines = self._strip_empty(self._consume_to_next_section())
         lines = self._dedent(lines)
         if use_admonition:
@@ -692,7 +711,7 @@
         else:
             return header, ''
 
-    def _parse_keyword_arguments_section(self, section: str) -> Liststr:
+    def _parse_keyword_arguments_section(self, section: str) -> liststr:
         fields = self._consume_fields()
         if self._config.napoleon_use_keyword:
             return self._format_docutils_params(
@@ -702,8 +721,8 @@
         else:
             return self._format_fields(_('Keyword Arguments'), fields)
 
-    def _parse_methods_section(self, section: str) -> Liststr:
-        lines: Liststr = 
+    def _parse_methods_section(self, section: str) -> liststr:
+        lines: liststr = 
         for _name, _type, _desc in self._consume_fields(parse_type=False):
             lines.append('.. method:: %s' % _name)
             if self._opt and 'noindex' in self._opt:
@@ -713,11 +732,11 @@
             lines.append('')
         return lines
 
-    def _parse_notes_section(self, section: str) -> Liststr:
+    def _parse_notes_section(self, section: str) -> liststr:
         use_admonition = self._config.napoleon_use_admonition_for_notes
         return self._parse_generic_section(_('Notes'), use_admonition)
 
-    def _parse_other_parameters_section(self, section: str) -> Liststr:
+    def _parse_other_parameters_section(self, section: str) -> liststr:
         if self._config.napoleon_use_param:
             # Allow to declare multiple parameters at once (ex: x, y: int)
             fields = self._consume_fields(multiple=True)
@@ -726,7 +745,7 @@
             fields = self._consume_fields()
             return self._format_fields(_('Other Parameters'), fields)
 
-    def _parse_parameters_section(self, section: str) -> Liststr:
+    def _parse_parameters_section(self, section: str) -> liststr:
         if self._config.napoleon_use_param:
             # Allow to declare multiple parameters at once (ex: x, y: int)
             fields = self._consume_fields(multiple=True)
@@ -735,9 +754,9 @@
             fields = self._consume_fields()
             return self._format_fields(_('Parameters'), fields)
 
-    def _parse_raises_section(self, section: str) -> Liststr:
+    def _parse_raises_section(self, section: str) -> liststr:
         fields = self._consume_fields(parse_type=False, prefer_type=True)
-        lines: Liststr = 
+        lines: liststr = 
         for _name, _type, _desc in fields:
             m = self._name_rgx.match(_type)
             if m and m.group('name'):
@@ -748,12 +767,12 @@
             _type = ' ' + _type if _type else ''
             _desc = self._strip_empty(_desc)
             _descs = ' ' + '\n    '.join(_desc) if any(_desc) else ''
-            lines.append(':raises%s:%s' % (_type, _descs))
+            lines.append(f':raises{_type}:{_descs}')
         if lines:
             lines.append('')
         return lines
 
-    def _parse_receives_section(self, section: str) -> Liststr:
+    def _parse_receives_section(self, section: str) -> liststr:
         if self._config.napoleon_use_param:
             # Allow to declare multiple parameters at once (ex: x, y: int)
             fields = self._consume_fields(multiple=True)
@@ -762,15 +781,15 @@
             fields = self._consume_fields()
             return self._format_fields(_('Receives'), fields)
 
-    def _parse_references_section(self, section: str) -> Liststr:
+    def _parse_references_section(self, section: str) -> liststr:
         use_admonition = self._config.napoleon_use_admonition_for_references
         return self._parse_generic_section(_('References'), use_admonition)
 
-    def _parse_returns_section(self, section: str) -> Liststr:
+    def _parse_returns_section(self, section: str) -> liststr:
         fields = self._consume_returns_section()
         multi = len(fields) > 1
         use_rtype = False if multi else self._config.napoleon_use_rtype
-        lines: Liststr = 
+        lines: liststr = 
 
         for _name, _type, _desc in fields:
             if use_rtype:
@@ -792,17 +811,17 @@
             lines.append('')
         return lines
 
-    def _parse_see_also_section(self, section: str) -> Liststr:
+    def _parse_see_also_section(self, section: str) -> liststr:
         return self._parse_admonition('seealso', section)
 
-    def _parse_warns_section(self, section: str) -> Liststr:
+    def _parse_warns_section(self, section: str) -> liststr:
         return self._format_fields(_('Warns'), self._consume_fields())
 
-    def _parse_yields_section(self, section: str) -> Liststr:
+    def _parse_yields_section(self, section: str) -> liststr:
         fields = self._consume_returns_section(preprocess_types=True)
         return self._format_fields(_('Yields'), fields)
 
-    def _partition_field_on_colon(self, line: str) -> Tuplestr, str, str:
+    def _partition_field_on_colon(self, line: str) -> tuplestr, str, str:
         before_colon = 
         after_colon = 
         colon = ''
@@ -824,18 +843,7 @@
                 colon,
                 "".join(after_colon).strip())
 
-    def _qualify_name(self, attr_name: str, klass: Type) -> str:
-        if klass and '.' not in attr_name:
-            if attr_name.startswith('~'):
-                attr_name = attr_name1:
-            try:
-                q = klass.__qualname__
-            except AttributeError:
-                q = klass.__name__
-            return '~%s.%s' % (q, attr_name)
-        return attr_name
-
-    def _strip_empty(self, lines: Liststr) -> Liststr:
+    def _strip_empty(self, lines: liststr) -> liststr:
         if lines:
             start = -1
             for i, line in enumerate(lines):
@@ -861,16 +869,17 @@
                 if not hasattr(self, "_annotations"):
                     localns = getattr(self._config, "autodoc_type_aliases", {})
                     localns.update(getattr(
-                                   self._config, "napoleon_type_aliases", {}
+                                   self._config, "napoleon_type_aliases", {},
                                    ) or {})
                     self._annotations = get_type_hints(self._obj, None, localns)
                 if _name in self._annotations:
-                    return stringify_annotation(self._annotations_name)
+                    return stringify_annotation(self._annotations_name,
+                                                'fully-qualified-except-typing')
         # No annotation found
         return ""
 
 
-def _recombine_set_tokens(tokens: Liststr) -> Liststr:
+def _recombine_set_tokens(tokens: liststr) -> liststr:
     token_queue = collections.deque(tokens)
     keywords = ("optional", "default")
 
@@ -926,7 +935,7 @@
     return list(combine_set(token_queue))
 
 
-def _tokenize_type_spec(spec: str) -> Liststr:
+def _tokenize_type_spec(spec: str) -> liststr:
     def postprocess(item):
         if _default_regex.match(item):
             default = item:7
@@ -938,16 +947,16 @@
         else:
             return item
 
-    tokens = list(
+    tokens = 
         item
         for raw_token in _token_regex.split(spec)
         for item in postprocess(raw_token)
         if item
-    )
+    
     return tokens
 
 
-def _token_type(token: str, location: str = None) -> str:
+def _token_type(token: str, location: str | None = None) -> str:
     def is_numeric(token):
         try:
             # use complex to make sure every numeric value is detected as literal
@@ -980,14 +989,14 @@
             location=location,
         )
         type_ = "literal"
-    elif token.startswith("'") or token.startswith('"'):
+    elif token.startswith(("'", '"')):
         logger.warning(
             __("malformed string literal (missing closing quote): %s"),
             token,
             location=location,
         )
         type_ = "literal"
-    elif token.endswith("'") or token.endswith('"'):
+    elif token.endswith(("'", '"')):
         logger.warning(
             __("malformed string literal (missing opening quote): %s"),
             token,
@@ -1006,7 +1015,9 @@
     return type_
 
 
-def _convert_numpy_type_spec(_type: str, location: str = None, translations: dict = {}) -> str:
+def _convert_numpy_type_spec(
+    _type: str, location: str | None = None, translations: dict = {},
+) -> str:
     def convert_obj(obj, translations, default_translation):
         translation = translations.get(obj, obj)
 
@@ -1135,13 +1146,20 @@
             The lines of the docstring in a list.
 
     """
-    def __init__(self, docstring: Unionstr, Liststr, config: SphinxConfig = None,
-                 app: Sphinx = None, what: str = '', name: str = '',
-                 obj: Any = None, options: Any = None) -> None:
+    def __init__(
+        self,
+        docstring: str | liststr,
+        config: SphinxConfig | None = None,
+        app: Sphinx | None = None,
+        what: str = '',
+        name: str = '',
+        obj: Any = None,
+        options: Any = None,
+    ) -> None:
         self._directive_sections = '.. index::'
         super().__init__(docstring, config, app, what, name, obj, options)
 
-    def _get_location(self) -> str:
+    def _get_location(self) -> str | None:
         try:
             filepath = inspect.getfile(self._obj) if self._obj is not None else None
         except TypeError:
@@ -1163,9 +1181,9 @@
         else:
             return func(name)
 
-    def _consume_field(self, parse_type: bool = True, prefer_type: bool = False
-                       ) -> Tuplestr, str, Liststr:
-        line = next(self._line_iter)
+    def _consume_field(self, parse_type: bool = True, prefer_type: bool = False,
+                       ) -> tuplestr, str, liststr:
+        line = self._lines.next()
         if parse_type:
             _name, _, _type = self._partition_field_on_colon(line)
         else:
@@ -1191,20 +1209,20 @@
         _desc = self.__class__(_desc, self._config).lines()
         return _name, _type, _desc
 
-    def _consume_returns_section(self, preprocess_types: bool = False
-                                 ) -> ListTuplestr, str, Liststr:
+    def _consume_returns_section(self, preprocess_types: bool = False,
+                                 ) -> listtuplestr, str, liststr:
         return self._consume_fields(prefer_type=True)
 
     def _consume_section_header(self) -> str:
-        section = next(self._line_iter)
+        section = self._lines.next()
         if not _directive_regex.match(section):
             # Consume the header underline
-            next(self._line_iter)
+            self._lines.next()
         return section
 
     def _is_section_break(self) -> bool:
-        line1, line2 = self._line_iter.peek(2)
-        return (not self._line_iter.has_next() or
+        line1, line2 = self._lines.get(0), self._lines.get(1)
+        return (not self._lines or
                 self._is_section_header() or
                 '', '' == line1, line2 or
                 (self._is_in_section and
@@ -1212,7 +1230,7 @@
                     not self._is_indented(line1, self._section_indent)))
 
     def _is_section_header(self) -> bool:
-        section, underline = self._line_iter.peek(2)
+        section, underline = self._lines.get(0), self._lines.get(1)
         section = section.lower()
         if section in self._sections and isinstance(underline, str):
             return bool(_numpy_section_regex.match(underline))
@@ -1223,14 +1241,14 @@
                         return True
         return False
 
-    def _parse_see_also_section(self, section: str) -> Liststr:
+    def _parse_see_also_section(self, section: str) -> liststr:
         lines = self._consume_to_next_section()
         try:
             return self._parse_numpydoc_see_also_section(lines)
         except ValueError:
             return self._format_admonition('seealso', lines)
 
-    def _parse_numpydoc_see_also_section(self, content: Liststr) -> Liststr:
+    def _parse_numpydoc_see_also_section(self, content: liststr) -> liststr:
         """
         Derived from the NumpyDoc implementation of _parse_see_also.
 
@@ -1244,7 +1262,7 @@
         """
         items = 
 
-        def parse_item_name(text: str) -> Tuplestr, str:
+        def parse_item_name(text: str) -> tuplestr, str | None:
             """Match ':role:`name`' or 'name'"""
             m = self._name_rgx.match(text)
             if m:
@@ -1255,7 +1273,7 @@
                     return g2, g1
             raise ValueError("%s is not a item name" % text)
 
-        def push_item(name: str, rest: Liststr) -> None:
+        def push_item(name: str, rest: liststr) -> None:
             if not name:
                 return
             name, role = parse_item_name(name)
@@ -1279,7 +1297,7 @@
             return new_func, description, role
 
         current_func = None
-        rest: Liststr = 
+        rest: liststr = 
 
         for line in content:
             if not line.strip():
@@ -1314,11 +1332,11 @@
             for func, description, role in items
         
 
-        lines: Liststr = 
+        lines: liststr = 
         last_had_desc = True
         for name, desc, role in items:
             if role:
-                link = ':%s:`%s`' % (role, name)
+                link = f':{role}:`{name}`'
             else:
                 link = ':obj:`%s`' % name
             if desc or last_had_desc:

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/todo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/todo.py Changed

@@ -1,17 +1,13 @@
-"""
-    sphinx.ext.todo
-    ~~~~~~~~~~~~~~~
-
-    Allow todos to be inserted into your documentation.  Inclusion of todos can
-    be switched of by a configuration variable.  The todolist directive collects
-    all todos of your project and lists them along with a backlink to the
-    original location.
+"""Allow todos to be inserted into your documentation.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Inclusion of todos can be switched of by a configuration variable.
+The todolist directive collects all todos of your project and lists them along
+with a backlink to the original location.
 """
 
-from typing import Any, Dict, List, Tuple, cast
+from __future__ import annotations
+
+from typing import Any, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -28,7 +24,7 @@
 from sphinx.util import logging, texescape
 from sphinx.util.docutils import SphinxDirective, new_document
 from sphinx.util.typing import OptionSpec
-from sphinx.writers.html import HTMLTranslator
+from sphinx.writers.html import HTML5Translator
 from sphinx.writers.latex import LaTeXTranslator
 
 logger = logging.getLogger(__name__)
@@ -57,11 +53,11 @@
         'name': directives.unchanged,
     }
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         if not self.options.get('class'):
             self.options'class' = 'admonition-todo'
 
-        (todo,) = super().run()  # type: TupleNode
+        (todo,) = super().run()
         if isinstance(todo, nodes.system_message):
             return todo
         elif isinstance(todo, todo_node):
@@ -80,13 +76,13 @@
     label = 'todo'
 
     @property
-    def todos(self) -> Dictstr, Listtodo_node:
+    def todos(self) -> dictstr, listtodo_node:
         return self.data.setdefault('todos', {})
 
     def clear_doc(self, docname: str) -> None:
         self.todos.pop(docname, None)
 
-    def merge_domaindata(self, docnames: Liststr, otherdata: Dict) -> None:
+    def merge_domaindata(self, docnames: liststr, otherdata: dict) -> None:
         for docname in docnames:
             self.todosdocname = otherdata'todos'docname
 
@@ -113,7 +109,7 @@
     final_argument_whitespace = False
     option_spec: OptionSpec = {}
 
-    def run(self) -> ListNode:
+    def run(self) -> listNode:
         # Simply insert an empty todolist node which will be replaced later
         # when process_todo_nodes is called
         return todolist('')
@@ -130,14 +126,14 @@
         self.process(doctree, docname)
 
     def process(self, doctree: nodes.document, docname: str) -> None:
-        todos: Listtodo_node = sum(self.domain.todos.values(), )
+        todos: listtodo_node = sum(self.domain.todos.values(), )
         for node in list(doctree.findall(todolist)):
             if not self.config.todo_include_todos:
                 node.parent.remove(node)
                 continue
 
             if node.get('ids'):
-                content: ListElement = nodes.target()
+                content: listElement = nodes.target()
             else:
                 content = 
 
@@ -165,7 +161,7 @@
         suffix = descriptiondescription.find('>>') + 2:
 
         para = nodes.paragraph(classes='todo-source')
-        para += nodes.Text(prefix, prefix)
+        para += nodes.Text(prefix)
 
         # Create a reference
         linktext = nodes.emphasis(_('original entry'), _('original entry'))
@@ -178,7 +174,7 @@
             pass
 
         para += reference
-        para += nodes.Text(suffix, suffix)
+        para += nodes.Text(suffix)
 
         return para
 
@@ -194,14 +190,14 @@
         self.document.remove(todo)
 
 
-def visit_todo_node(self: HTMLTranslator, node: todo_node) -> None:
+def visit_todo_node(self: HTML5Translator, node: todo_node) -> None:
     if self.config.todo_include_todos:
         self.visit_admonition(node)
     else:
         raise nodes.SkipNode
 
 
-def depart_todo_node(self: HTMLTranslator, node: todo_node) -> None:
+def depart_todo_node(self: HTML5Translator, node: todo_node) -> None:
     self.depart_admonition(node)
 
 
@@ -222,7 +218,7 @@
     self.body.append('\\end{sphinxadmonition}\n')
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_event('todo-defined')
     app.add_config_value('todo_include_todos', False, 'html')
     app.add_config_value('todo_link_only', False, 'html')
@@ -243,5 +239,5 @@
     return {
         'version': sphinx.__display_version__,
         'env_version': 2,
-        'parallel_read_safe': True
+        'parallel_read_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/ext/viewcode.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/ext/viewcode.py Changed

@@ -1,18 +1,11 @@
-"""
-    sphinx.ext.viewcode
-    ~~~~~~~~~~~~~~~~~~~
+"""Add links to module code in Python object descriptions."""
 
-    Add links to module code in Python object descriptions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import posixpath
 import traceback
-import warnings
 from os import path
-from typing import Any, Dict, Generator, Iterable, Optional, Set, Tuple, cast
+from typing import Any, Generator, Iterable, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -22,12 +15,12 @@
 from sphinx.application import Sphinx
 from sphinx.builders import Builder
 from sphinx.builders.html import StandaloneHTMLBuilder
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.environment import BuildEnvironment
 from sphinx.locale import _, __
 from sphinx.pycode import ModuleAnalyzer
 from sphinx.transforms.post_transforms import SphinxPostTransform
-from sphinx.util import get_full_modname, logging, status_iterator
+from sphinx.util import get_full_modname, logging
+from sphinx.util.display import status_iterator
 from sphinx.util.nodes import make_refnode
 
 logger = logging.getLogger(__name__)
@@ -45,13 +38,13 @@
     """
 
 
-def _get_full_modname(app: Sphinx, modname: str, attribute: str) -> Optionalstr:
+def _get_full_modname(app: Sphinx, modname: str, attribute: str) -> str | None:
     try:
         return get_full_modname(modname, attribute)
     except AttributeError:
         # sphinx.ext.viewcode can't follow class instance attribute
         # then AttributeError logging output only verbose mode.
-        logger.verbose('Didn\'t find %s in %s', attribute, modname)
+        logger.verbose("Didn't find %s in %s", attribute, modname)
         return None
     except Exception as e:
         # sphinx.ext.viewcode follow python domain directives.
@@ -66,12 +59,11 @@
 def is_supported_builder(builder: Builder) -> bool:
     if builder.format != 'html':
         return False
-    elif builder.name == 'singlehtml':
+    if builder.name == 'singlehtml':
         return False
-    elif builder.name.startswith('epub') and not builder.config.viewcode_enable_epub:
+    if builder.name.startswith('epub') and not builder.config.viewcode_enable_epub:
         return False
-    else:
-        return True
+    return True
 
 
 def doctree_read(app: Sphinx, doctree: Node) -> None:
@@ -111,7 +103,7 @@
     for objnode in list(doctree.findall(addnodes.desc)):
         if objnode.get('domain') != 'py':
             continue
-        names: Setstr = set()
+        names: setstr = set()
         for signode in objnode:
             if not isinstance(signode, addnodes.desc_signature):
                 continue
@@ -146,7 +138,7 @@
     if not hasattr(env, '_viewcode_modules'):
         env._viewcode_modules = {}  # type: ignore
     # now merge in the information from the subprocess
-    for modname, entry in other._viewcode_modules.items():  # type: ignore
+    for modname, entry in other._viewcode_modules.items():
         if modname not in env._viewcode_modules:  # type: ignore
             env._viewcode_modulesmodname = entry  # type: ignore
         else:
@@ -195,19 +187,7 @@
             node.parent.remove(node)
 
 
-def missing_reference(app: Sphinx, env: BuildEnvironment, node: Element, contnode: Node
-                      ) -> OptionalNode:
-    # resolve our "viewcode" reference nodes -- they need special treatment
-    if node'reftype' == 'viewcode':
-        warnings.warn('viewcode extension is no longer use pending_xref node. '
-                      'Please update your extension.', RemovedInSphinx50Warning)
-        return make_refnode(app.builder, node'refdoc', node'reftarget',
-                            node'refid', contnode)
-
-    return None
-
-
-def get_module_filename(app: Sphinx, modname: str) -> Optionalstr:
+def get_module_filename(app: Sphinx, modname: str) -> str | None:
     """Get module filename for *modname*."""
     source_info = app.emit_firstresult('viewcode-find-source', modname)
     if source_info:
@@ -235,13 +215,13 @@
         if path.getmtime(module_filename) <= path.getmtime(page_filename):
             # generation is not needed if the HTML page is newer than module file.
             return False
-    except IOError:
+    except OSError:
         pass
 
     return True
 
 
-def collect_pages(app: Sphinx) -> GeneratorTuplestr, Dictstr, Any, str, None, None:
+def collect_pages(app: Sphinx) -> Generatortuplestr, dictstr, Any, str, None, None:
     env = app.builder.env
     if not hasattr(env, '_viewcode_modules'):
         return
@@ -250,12 +230,12 @@
     highlighter = app.builder.highlighter  # type: ignore
     urito = app.builder.get_relative_uri
 
-    modnames = set(env._viewcode_modules)  # type: ignore
+    modnames = set(env._viewcode_modules)
 
     for modname, entry in status_iterator(
-            sorted(env._viewcode_modules.items()),  # type: ignore
+            sorted(env._viewcode_modules.items()),
             __('highlighting module code... '), "blue",
-            len(env._viewcode_modules),  # type: ignore
+            len(env._viewcode_modules),
             app.verbosity, lambda x: x0):
         if not entry:
             continue
@@ -266,7 +246,7 @@
         # construct a page name for the highlighted source
         pagename = posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/'))
         # highlight the source using the builder's highlighter
-        if env.config.highlight_language in ('python3', 'default', 'none'):
+        if env.config.highlight_language in {'default', 'none'}:
             lexer = env.config.highlight_language
         else:
             lexer = 'python'
@@ -327,10 +307,9 @@
                 stack.pop()
                 html.append('</ul>')
             stack.append(modname + '.')
-        html.append('<li><a href="%s">%s</a></li>\n' % (
-            urito(posixpath.join(OUTPUT_DIRNAME, 'index'),
-                  posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/'))),
-            modname))
+        relative_uri = urito(posixpath.join(OUTPUT_DIRNAME, 'index'),
+                             posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/')))
+        html.append(f'<li><a href="{relative_uri}">{modname}</a></li>\n')
     html.append('</ul>' * (len(stack) - 1))
     context = {
         'title': _('Overview: module code'),
@@ -341,7 +320,7 @@
     yield (posixpath.join(OUTPUT_DIRNAME, 'index'), context, 'page.html')
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_config_value('viewcode_import', None, False)
     app.add_config_value('viewcode_enable_epub', False, False)
     app.add_config_value('viewcode_follow_imported_members', True, False)
@@ -349,7 +328,6 @@
     app.connect('env-merge-info', env_merge_info)
     app.connect('env-purge-doc', env_purge_doc)
     app.connect('html-collect-pages', collect_pages)
-    app.connect('missing-reference', missing_reference)
     # app.add_config_value('viewcode_include_modules', , 'env')
     # app.add_config_value('viewcode_exclude_modules', , 'env')
     app.add_event('viewcode-find-source')
@@ -358,5 +336,5 @@
     return {
         'version': sphinx.__display_version__,
         'env_version': 1,
-        'parallel_read_safe': True
+        'parallel_read_safe': True,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/extension.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/extension.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.extension
-    ~~~~~~~~~~~~~~~~
+"""Utilities for Sphinx extensions."""
 
-    Utilities for Sphinx extensions.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import TYPE_CHECKING, Any, Dict
+from typing import TYPE_CHECKING, Any
 
 from packaging.version import InvalidVersion, Version
 
@@ -41,8 +35,15 @@
         self.parallel_write_safe = kwargs.pop('parallel_write_safe', True)
 
 
-def verify_needs_extensions(app: "Sphinx", config: Config) -> None:
-    """Verify the required Sphinx extensions are loaded."""
+def verify_needs_extensions(app: Sphinx, config: Config) -> None:
+    """Check that extensions mentioned in :confval:`needs_extensions` satisfy the version
+    requirement, and warn if an extension is not loaded.
+
+    Warns if an extension in :confval:`needs_extension` is not loaded.
+
+    :raises VersionRequirementError: if the version of an extension in
+    :confval:`needs_extension` is unknown or older than the required version.
+    """
     if config.needs_extensions is None:
         return
 
@@ -71,7 +72,7 @@
                                           (extname, reqversion, extension.version))
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('config-inited', verify_needs_extensions, priority=800)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/highlighting.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/highlighting.py Changed

@@ -1,26 +1,25 @@
-"""
-    sphinx.highlighting
-    ~~~~~~~~~~~~~~~~~~~
+"""Highlight code blocks using Pygments."""
 
-    Highlight code blocks using Pygments.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from functools import partial
 from importlib import import_module
-from typing import Any, Dict
+from typing import Any
 
-from packaging import version
-from pygments import __version__ as pygmentsversion
 from pygments import highlight
 from pygments.filters import ErrorToken
 from pygments.formatter import Formatter
 from pygments.formatters import HtmlFormatter, LatexFormatter
 from pygments.lexer import Lexer
-from pygments.lexers import (CLexer, Python3Lexer, PythonConsoleLexer, PythonLexer, RstLexer,
-                             TextLexer, get_lexer_by_name, guess_lexer)
+from pygments.lexers import (
+    CLexer,
+    PythonConsoleLexer,
+    PythonLexer,
+    RstLexer,
+    TextLexer,
+    get_lexer_by_name,
+    guess_lexer,
+)
 from pygments.style import Style
 from pygments.styles import get_style_by_name
 from pygments.util import ClassNotFound
@@ -31,13 +30,11 @@
 
 logger = logging.getLogger(__name__)
 
-lexers: Dictstr, Lexer = {}
-lexer_classes: Dictstr, Lexer = {
+lexers: dictstr, Lexer = {}
+lexer_classes: dictstr, typeLexer | partialLexer = {
     'none': partial(TextLexer, stripnl=False),
     'python': partial(PythonLexer, stripnl=False),
-    'python3': partial(Python3Lexer, stripnl=False),
     'pycon': partial(PythonConsoleLexer, stripnl=False),
-    'pycon3': partial(PythonConsoleLexer, python3=True, stripnl=False),
     'rest': partial(RstLexer, stripnl=False),
     'c': partial(CLexer, stripnl=False),
 }
@@ -48,24 +45,42 @@
                    ord('}'): '\\PYGZcb{}'}
 
 # used if Pygments is available
-# use textcomp quote to get a true single quote
+# MEMO: no use of \protected here to avoid having to do hyperref extras,
+# (if in future code highlighting in sectioning titles is activated):
+# the definitions here use only robust, protected or chardef tokens,
+# which are all known to the hyperref re-encoding for bookmarks.
+# The " is troublesome because we would like to use \text\textquotedbl
+# but \textquotedbl is *defined to raise an error* (!) if the font
+# encoding is OT1.  This however could happen from 'fontenc' key.
+# MEMO: the Pygments escapes with \char`\<char> syntax, if the document
+# uses old OT1 font encoding, work correctly only in monospace font.
+# MEMO: the Pygmentize output mark-up is always with a {} after.
 _LATEX_ADD_STYLES = r'''
-\renewcommand\PYGZsq{\textquotesingle}
-'''
-# fix extra space between lines when Pygments highlighting uses \fcolorbox
-# add a {..} to limit \fboxsep scope, and force \fcolorbox use correct value
-# cf pygments #1708 which makes this unneeded for Pygments > 2.7.4
-_LATEX_ADD_STYLES_FIXPYG = r'''
+% Sphinx redefinitions
+% Originally to obtain a straight single quote via package textcomp, then
+% to fix problems for the 5.0.0 inline code highlighting (captions!).
+% The \text is from amstext, a dependency of sphinx.sty.  It is here only
+% to avoid build errors if for some reason expansion is in math mode.
+\def\PYGZbs{\text\textbackslash}
+\def\PYGZus{\_}
+\def\PYGZob{\{}
+\def\PYGZcb{\}}
+\def\PYGZca{\text\textasciicircum}
+\def\PYGZam{\&}
+\def\PYGZlt{\text\textless}
+\def\PYGZgt{\text\textgreater}
+\def\PYGZsh{\#}
+\def\PYGZpc{\%}
+\def\PYGZdl{\$}
+\def\PYGZhy{\sphinxhyphen}% defined in sphinxlatexstyletext.sty
+\def\PYGZsq{\text\textquotesingle}
+\def\PYGZdq{"}
+\def\PYGZti{\text\textasciitilde}
 \makeatletter
-% fix for Pygments <= 2.7.4
-\let\spx@original@fcolorbox\fcolorbox
-\def\spx@fixpyg@fcolorbox{\fboxsep-\fboxrule\spx@original@fcolorbox}
-\def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+%
-             {\let\fcolorbox\spx@fixpyg@fcolorbox\PYG@do{#2}}}
+% use \protected to allow syntax highlighting in captions
+\protected\def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+{\PYG@do{#2}}}
 \makeatother
 '''
-if version.parse(pygmentsversion).release <= (2, 7, 4):
-    _LATEX_ADD_STYLES += _LATEX_ADD_STYLES_FIXPYG
 
 
 class PygmentsBridge:
@@ -75,12 +90,12 @@
     latex_formatter = LatexFormatter
 
     def __init__(self, dest: str = 'html', stylename: str = 'sphinx',
-                 latex_engine: str = None) -> None:
+                 latex_engine: str | None = None) -> None:
         self.dest = dest
         self.latex_engine = latex_engine
 
         style = self.get_style(stylename)
-        self.formatter_args: Dictstr, Any = {'style': style}
+        self.formatter_args: dictstr, Any = {'style': style}
         if dest == 'html':
             self.formatter = self.html_formatter
         else:
@@ -102,23 +117,20 @@
         kwargs.update(self.formatter_args)
         return self.formatter(**kwargs)
 
-    def get_lexer(self, source: str, lang: str, opts: Dict = None,
+    def get_lexer(self, source: str, lang: str, opts: dict | None = None,
                   force: bool = False, location: Any = None) -> Lexer:
         if not opts:
             opts = {}
 
         # find out which lexer to use
-        if lang in ('py', 'python'):
+        if lang in {'py', 'python', 'py3', 'python3', 'default'}:
             if source.startswith('>>>'):
                 # interactive session
                 lang = 'pycon'
             else:
                 lang = 'python'
-        elif lang in ('py3', 'python3', 'default'):
-            if source.startswith('>>>'):
-                lang = 'pycon3'
-            else:
-                lang = 'python3'
+        if lang == 'pycon3':
+            lang = 'pycon'
 
         if lang in lexers:
             # just return custom lexers here (without installing raiseonerror filter)
@@ -141,7 +153,7 @@
 
         return lexer
 
-    def highlight_block(self, source: str, lang: str, opts: Dict = None,
+    def highlight_block(self, source: str, lang: str, opts: dict | None = None,
                         force: bool = False, location: Any = None, **kwargs: Any) -> str:
         if not isinstance(source, str):
             source = source.decode()
@@ -158,8 +170,8 @@
             if lang == 'default':
                 pass  # automatic highlighting failed.
             else:
-                logger.warning(__('Could not lex literal_block as "%s". '
-                                  'Highlighting skipped.'), lang,
+                logger.warning(__('Could not lex literal_block %r as "%s". '
+                                  'Highlighting skipped.'), source, lang,
                                type='misc', subtype='highlighting_failure',
                                location=location)
             lexer = self.get_lexer(source, 'none', opts, force, location)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/io.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/io.py Changed

@@ -1,21 +1,14 @@
-"""
-    sphinx.io
-    ~~~~~~~~~
+"""Input/Output files"""
+from __future__ import annotations
 
-    Input/Output files
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-import codecs
-from typing import TYPE_CHECKING, Any, List, Type
+from typing import TYPE_CHECKING, Any
 
+import docutils
 from docutils import nodes
 from docutils.core import Publisher
 from docutils.frontend import Values
 from docutils.io import FileInput, Input, NullOutput
 from docutils.parsers import Parser
-from docutils.parsers.rst import Parser as RSTParser
 from docutils.readers import standalone
 from docutils.transforms import Transform
 from docutils.transforms.references import DanglingReferences
@@ -23,12 +16,14 @@
 
 from sphinx import addnodes
 from sphinx.environment import BuildEnvironment
-from sphinx.transforms import (AutoIndexUpgrader, DoctreeReadEvent, FigureAligner,
-                               SphinxTransformer)
-from sphinx.transforms.i18n import (Locale, PreserveTranslatableMessages,
-                                    RemoveTranslatableInline)
+from sphinx.transforms import AutoIndexUpgrader, DoctreeReadEvent, SphinxTransformer
+from sphinx.transforms.i18n import (
+    Locale,
+    PreserveTranslatableMessages,
+    RemoveTranslatableInline,
+)
 from sphinx.transforms.references import SphinxDomains
-from sphinx.util import UnicodeDecodeErrorHandler, get_filetype, logging
+from sphinx.util import logging
 from sphinx.util.docutils import LoggingReporter
 from sphinx.versioning import UIDTransform
 
@@ -46,7 +41,7 @@
     This replaces reporter by Sphinx's on generating document.
     """
 
-    transforms: ListTypeTransform = 
+    transforms: listtypeTransform = 
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         from sphinx.application import Sphinx
@@ -57,11 +52,11 @@
 
         super().__init__(*args, **kwargs)
 
-    def setup(self, app: "Sphinx") -> None:
+    def setup(self, app: Sphinx) -> None:
         self._app = app      # hold application object only for compatibility
         self._env = app.env
 
-    def get_transforms(self) -> ListTypeTransform:
+    def get_transforms(self) -> listtypeTransform:
         transforms = super().get_transforms() + self.transforms
 
         # remove transforms which is not needed for Sphinx
@@ -96,7 +91,7 @@
     A basic document reader for Sphinx.
     """
 
-    def setup(self, app: "Sphinx") -> None:
+    def setup(self, app: Sphinx) -> None:
         self.transforms = self.transforms + app.registry.get_transforms()
         super().setup(app)
 
@@ -128,12 +123,12 @@
     Because the translated texts are partial and they don't have correct line numbers.
     """
 
-    def setup(self, app: "Sphinx") -> None:
+    def setup(self, app: Sphinx) -> None:
         super().setup(app)
 
         self.transforms = self.transforms + app.registry.get_transforms()
         unused = PreserveTranslatableMessages, Locale, RemoveTranslatableInline,
-                  AutoIndexUpgrader, FigureAligner, SphinxDomains, DoctreeReadEvent,
+                  AutoIndexUpgrader, SphinxDomains, DoctreeReadEvent,
                   UIDTransform
         for transform in unused:
             if transform in self.transforms:
@@ -161,15 +156,10 @@
         super().__init__(*args, **kwargs)
 
 
-def read_doc(app: "Sphinx", env: BuildEnvironment, filename: str) -> nodes.document:
-    """Parse a document and convert to doctree."""
-    # set up error_handler for the target document
-    error_handler = UnicodeDecodeErrorHandler(env.docname)
-    codecs.register_error('sphinx', error_handler)  # type: ignore
-
+def create_publisher(app: Sphinx, filetype: str) -> Publisher:
     reader = SphinxStandaloneReader()
     reader.setup(app)
-    filetype = get_filetype(app.config.source_suffix, filename)
+
     parser = app.registry.create_source_parser(app, filetype)
     if parser.__class__.__name__ == 'CommonMarkParser' and parser.settings_spec == ():
         # a workaround for recommonmark
@@ -177,14 +167,22 @@
         #   internally.  But recommonmark-0.4.0 does not provide settings_spec for reST
         #   parser.  As a workaround, this copies settings_spec for RSTParser to the
         #   CommonMarkParser.
+        from docutils.parsers.rst import Parser as RSTParser
+
         parser.settings_spec = RSTParser.settings_spec
 
-    pub = Publisher(reader=reader,
-                    parser=parser,
-                    writer=SphinxDummyWriter(),
-                    source_class=SphinxFileInput,
-                    destination=NullOutput())
-    pub.process_programmatic_settings(None, env.settings, None)
-    pub.set_source(source_path=filename)
-    pub.publish()
-    return pub.document
+    pub = Publisher(
+        reader=reader,
+        parser=parser,
+        writer=SphinxDummyWriter(),
+        source_class=SphinxFileInput,
+        destination=NullOutput(),
+    )
+    # Propagate exceptions by default when used programmatically:
+    defaults = {"traceback": True, **app.env.settings}
+    # Set default settings
+    if docutils.__version_info__:2 >= (0, 19):
+        pub.get_settings(**defaults)  # type: ignorearg-type
+    else:
+        pub.settings = pub.setup_option_parser(**defaults).get_default_values()  # type: ignore
+    return pub

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/jinja2glue.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/jinja2glue.py Changed

@@ -1,16 +1,11 @@
-"""
-    sphinx.jinja2glue
-    ~~~~~~~~~~~~~~~~~
+"""Glue code for the jinja2 templating engine."""
 
-    Glue code for the jinja2 templating engine.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import pathlib
 from os import path
 from pprint import pformat
-from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Tuple, Union
+from typing import TYPE_CHECKING, Any, Callable, Iterator
 
 from jinja2 import BaseLoader, FileSystemLoader, TemplateNotFound
 from jinja2.environment import Environment
@@ -44,7 +39,7 @@
         return 0
 
 
-def _todim(val: Unionint, str) -> str:
+def _todim(val: int | str) -> str:
     """
     Make val a css dimension. In particular the following transformations
     are performed:
@@ -62,7 +57,7 @@
     return val  # type: ignore
 
 
-def _slice_index(values: List, slices: int) -> IteratorList:
+def _slice_index(values: list, slices: int) -> Iteratorlist:
     seq = list(values)
     length = 0
     for value in values:
@@ -73,7 +68,7 @@
         count = 0
         start = offset
         if slices == slice_number + 1:  # last column
-            offset = len(seq)
+            offset = len(seq)  # noqa: SIM113
         else:
             for value in valuesoffset::
                 count += 1 + len(value11)
@@ -107,10 +102,10 @@
 
 
 @pass_context
-def warning(context: Dict, message: str, *args: Any, **kwargs: Any) -> str:
+def warning(context: dict, message: str, *args: Any, **kwargs: Any) -> str:
     if 'pagename' in context:
         filename = context.get('pagename') + context.get('file_suffix', '')
-        message = 'in rendering %s: %s' % (filename, message)
+        message = f'in rendering {filename}: {message}'
     logger = logging.getLogger('sphinx.themes')
     logger.warning(message, *args, **kwargs)
     return ''  # return empty string not to output any values
@@ -122,9 +117,9 @@
     template names.
     """
 
-    def get_source(self, environment: Environment, template: str) -> Tuplestr, str, Callable:
+    def get_source(self, environment: Environment, template: str) -> tuplestr, str, Callable:
         for searchpath in self.searchpath:
-            filename = path.join(searchpath, template)
+            filename = str(pathlib.Path(searchpath, template))
             f = open_if_exists(filename)
             if f is None:
                 continue
@@ -149,7 +144,12 @@
 
     # TemplateBridge interface
 
-    def init(self, builder: "Builder", theme: Theme = None, dirs: Liststr = None) -> None:
+    def init(
+        self,
+        builder: Builder,
+        theme: Theme | None = None,
+        dirs: liststr | None = None,
+    ) -> None:
         # create a chain of paths to search
         if theme:
             # the theme's own dir and its bases' dirs
@@ -192,10 +192,10 @@
         if use_i18n:
             self.environment.install_gettext_translations(builder.app.translator)
 
-    def render(self, template: str, context: Dict) -> str:  # type: ignore
+    def render(self, template: str, context: dict) -> str:  # type: ignore
         return self.environment.get_template(template).render(context)
 
-    def render_string(self, source: str, context: Dict) -> str:
+    def render_string(self, source: str, context: dict) -> str:
         return self.environment.from_string(source).render(context)
 
     def newest_template_mtime(self) -> float:
@@ -203,7 +203,7 @@
 
     # Loader interface
 
-    def get_source(self, environment: Environment, template: str) -> Tuplestr, str, Callable:
+    def get_source(self, environment: Environment, template: str) -> tuplestr, str, Callable:
         loaders = self.loaders
         # exclamation mark starts search from theme
         if template.startswith('!'):

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/.tx/config Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/__init__.py Changed

@@ -1,138 +1,124 @@
-"""
-    sphinx.locale
-    ~~~~~~~~~~~~~
+"""Locale utilities."""
 
-    Locale utilities.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import gettext
 import locale
-from collections import UserString, defaultdict
-from gettext import NullTranslations
-from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple, Union
+from gettext import NullTranslations, translation
+from os import path
+from typing import Any, Callable
 
 
-class _TranslationProxy(UserString):
+class _TranslationProxy:
     """
-    Class for proxy strings from gettext translations. This is a helper for the
-    lazy_* functions from this module.
-
     The proxy implementation attempts to be as complete as possible, so that
     the lazy objects should mostly work as expected, for example for sorting.
-
-    This inherits from UserString because some docutils versions use UserString
-    for their Text nodes, which then checks its argument for being either a
-    basestring or UserString, otherwise calls str() -- not unicode() -- on it.
     """
-    __slots__ = ('_func', '_args')
+    __slots__ = '_catalogue', '_namespace', '_message'
 
-    def __new__(cls, func: Callable, *args: str) -> object:  # type: ignore
-        if not args:
-            # not called with "function" and "arguments", but a plain string
-            return str(func)
-        return object.__new__(cls)
+    def __init__(self, catalogue: str, namespace: str, message: str) -> None:
+        self._catalogue = catalogue
+        self._namespace = namespace
+        self._message = message
 
-    def __getnewargs__(self) -> Tuplestr:
-        return (self._func,) + self._args  # type: ignore
+    def __str__(self) -> str:
+        try:
+            return translatorsself._namespace, self._catalogue.gettext(self._message)
+        except KeyError:
+            # NullTranslations().gettext(self._message) == self._message
+            return self._message
 
-    def __init__(self, func: Callable, *args: str) -> None:
-        self._func = func
-        self._args = args
+    def __dir__(self) -> liststr:
+        return dir(str)
 
-    @property
-    def data(self) -> str:  # type: ignore
-        return self._func(*self._args)
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__str__(), name)
 
-    # replace function from UserString; it instantiates a self.__class__
-    # for the encoding result
+    def __getstate__(self) -> tuplestr, str, str:
+        return self._catalogue, self._namespace, self._message
 
-    def encode(self, encoding: str = None, errors: str = None) -> bytes:  # type: ignore
-        if encoding:
-            if errors:
-                return self.data.encode(encoding, errors)
-            else:
-                return self.data.encode(encoding)
-        else:
-            return self.data.encode()
+    def __setstate__(self, tup: tuplestr, str, str) -> None:
+        self._catalogue, self._namespace, self._message = tup
 
-    def __dir__(self) -> Liststr:
-        return dir(str)
+    def __copy__(self) -> _TranslationProxy:
+        return _TranslationProxy(self._catalogue, self._namespace, self._message)
 
-    def __str__(self) -> str:
-        return str(self.data)
+    def __repr__(self) -> str:
+        try:
+            return f'i{self.__str__()!r}'
+        except Exception:
+            return (self.__class__.__name__
+                    + f'({self._catalogue}, {self._namespace}, {self._message})')
 
-    def __add__(self, other: str) -> str:  # type: ignore
-        return self.data + other
+    def __add__(self, other: str) -> str:
+        return self.__str__() + other
 
     def __radd__(self, other: str) -> str:
-        return other + self.data
+        return other + self.__str__()
 
-    def __mod__(self, other: str) -> str:  # type: ignore
-        return self.data % other
+    def __mod__(self, other: str) -> str:
+        return self.__str__() % other
 
     def __rmod__(self, other: str) -> str:
-        return other % self.data
+        return other % self.__str__()
 
-    def __mul__(self, other: Any) -> str:  # type: ignore
-        return self.data * other
+    def __mul__(self, other: Any) -> str:
+        return self.__str__() * other
 
     def __rmul__(self, other: Any) -> str:
-        return other * self.data
+        return other * self.__str__()
 
-    def __getattr__(self, name: str) -> Any:
-        if name == '__members__':
-            return self.__dir__()
-        return getattr(self.data, name)
+    def __hash__(self):
+        return hash(self.__str__())
 
-    def __getstate__(self) -> TupleCallable, Tuplestr, ...:
-        return self._func, self._args
+    def __eq__(self, other):
+        return self.__str__() == other
 
-    def __setstate__(self, tup: TupleCallable, Tuplestr) -> None:
-        self._func, self._args = tup
+    def __lt__(self, string):
+        return self.__str__() < string
 
-    def __copy__(self) -> "_TranslationProxy":
-        return self
+    def __contains__(self, char):
+        return char in self.__str__()
 
-    def __repr__(self) -> str:
-        try:
-            return 'i' + repr(str(self.data))
-        except Exception:
-            return '<%s broken>' % self.__class__.__name__
+    def __len__(self):
+        return len(self.__str__())
+
+    def __getitem__(self, index):
+        return self.__str__()index
 
 
-translators: DictTuplestr, str, NullTranslations = defaultdict(NullTranslations)
+translators: dicttuplestr, str, NullTranslations = {}
 
 
-def init(locale_dirs: ListOptionalstr, language: Optionalstr,
-         catalog: str = 'sphinx', namespace: str = 'general') -> TupleNullTranslations, bool:
+def init(
+    locale_dirs: liststr | None,
+    language: str | None,
+    catalog: str = 'sphinx',
+    namespace: str = 'general',
+) -> tupleNullTranslations, bool:
     """Look for message catalogs in `locale_dirs` and *ensure* that there is at
     least a NullTranslations catalog set in `translators`. If called multiple
     times or if several ``.mo`` files are found, their contents are merged
     together (thus making ``init`` reentrant).
     """
-    global translators
     translator = translators.get((namespace, catalog))
     # ignore previously failed attempts to find message catalogs
     if translator.__class__ is NullTranslations:
         translator = None
-    # the None entry is the system's default locale path
-    has_translation = True
 
-    if language and '_' in language:
-        # for language having country code (like "de_AT")
-        languages: OptionalListstr = language, language.split('_')0
-    elif language:
-        languages = language
+    if language:
+        if '_' in language:
+            # for language having country code (like "de_AT")
+            languages: liststr | None = language, language.split('_')0
+        else:
+            languages = language
     else:
         languages = None
 
     # loading
+    # the None entry is the system's default locale path
     for dir_ in locale_dirs:
         try:
-            trans = gettext.translation(catalog, localedir=dir_, languages=languages)
+            trans = translation(catalog, localedir=dir_, languages=languages)
             if translator is None:
                 translator = trans
             else:
@@ -140,42 +126,30 @@
         except Exception:
             # Language couldn't be found in the specified path
             pass
-    # guarantee translators(namespace, catalog) exists
-    if translator is None:
+    if translator is not None:
+        has_translation = True
+    else:
         translator = NullTranslations()
         has_translation = False
-    translators(namespace, catalog) = translator
+    # guarantee translators(namespace, catalog) exists
+    translatorsnamespace, catalog = translator
     return translator, has_translation
 
 
-def setlocale(category: int, value: Unionstr, Iterablestr = None) -> None:
-    """Update locale settings.
-
-    This does not throw any exception even if update fails.
-    This is workaround for Python's bug.
+_LOCALE_DIR = path.abspath(path.dirname(__file__))
 
-    For more details:
 
-    * https://github.com/sphinx-doc/sphinx/issues/5724
-    * https://bugs.python.org/issue18378#msg215215
-
-    .. note:: Only for internal use.  Please don't call this method from extensions.
-              This will be removed in future.
-    """
-    try:
-        locale.setlocale(category, value)
-    except locale.Error:
-        pass
-
-
-def init_console(locale_dir: str, catalog: str) -> TupleNullTranslations, bool:
+def init_console(
+    locale_dir: str = _LOCALE_DIR,
+    catalog: str = 'sphinx',
+) -> tupleNullTranslations, bool:
     """Initialize locale for console.
 
     .. versionadded:: 1.8
     """
     try:
         # encoding is ignored
-        language, _ = locale.getlocale(locale.LC_MESSAGES)  # type: TupleOptionalstr, Any
+        language, _ = locale.getlocale(locale.LC_MESSAGES)
     except AttributeError:
         # LC_MESSAGES is not always defined. Fallback to the default language
         # in case it is not.
@@ -184,22 +158,14 @@
 
 
 def get_translator(catalog: str = 'sphinx', namespace: str = 'general') -> NullTranslations:
-    return translators(namespace, catalog)
+    return translators.get((namespace, catalog), NullTranslations())
 
 
 def is_translator_registered(catalog: str = 'sphinx', namespace: str = 'general') -> bool:
     return (namespace, catalog) in translators
 
 
-def _lazy_translate(catalog: str, namespace: str, message: str) -> str:
-    """Used instead of _ when creating TranslationProxy, because _ is
-    not bound yet at that time.
-    """
-    translator = get_translator(catalog, namespace)
-    return translator.gettext(message)
-
-
-def get_translation(catalog: str, namespace: str = 'general') -> Callable:
+def get_translation(catalog: str, namespace: str = 'general') -> Callablestr, str:
     """Get a translation function based on the *catalog* and *namespace*.
 
     The extension can use this API to translate the messages on the
@@ -224,16 +190,13 @@
 
     .. versionadded:: 1.8
     """
-    def gettext(message: str, *args: Any) -> str:
+    def gettext(message: str) -> str:
         if not is_translator_registered(catalog, namespace):
             # not initialized yet
-            return _TranslationProxy(_lazy_translate, catalog, namespace, message)  # type: ignore  # NOQA
+            return _TranslationProxy(catalog, namespace, message)  # type: ignorereturn-value  # noqa: E501
         else:
             translator = get_translator(catalog, namespace)
-            if len(args) <= 1:
-                return translator.gettext(message)
-            else:  # support pluralization
-                return translator.ngettext(message, args0, args1)
+            return translator.gettext(message)
 
     return gettext
 
@@ -262,7 +225,7 @@
 }
 
 # Moved to sphinx.directives.other (will be overridden later)
-versionlabels: Dictstr, str = {}
+versionlabels: dictstr, str = {}
 
 # Moved to sphinx.domains.python (will be overridden later)
-pairindextypes: Dictstr, str = {}
+pairindextypes: dictstr, str = {}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ar/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ar/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0627\u0644\u0645\u0648\u0636\u0648\u0639 \u0627\u0644\u062a\u0627\u0644\u064a",
         "Other changes": "",
         "Overview": "",
-        "Permalink to this definition": "",
-        "Permalink to this headline": "",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "",
         "Previous topic": "\u0627\u0644\u0645\u0648\u0636\u0648\u0639 \u0627\u0644\u0633\u0627\u0628\u0642",
@@ -39,7 +37,7 @@
         "Search": "\u0628\u062d\u062b",
         "Search Page": "\u0635\u0641\u062d\u0629 \u0627\u0644\u0628\u062d\u062b",
         "Search Results": "\u0646\u062a\u0627\u0626\u062c \u0627\u0644\u0628\u062d\u062b",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "\u0627\u0644\u0628\u062d\u062b \u0636\u0645\u0646 %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ar/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ar/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ar/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ar/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Abdullah ahmed <Alhadab@hotmail.co.uk>, 2020\n"
 "Language-Team: Arabic (http://www.transifex.com/sphinx-doc/sphinx-1/language/ar/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ar\n"
 "Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "لا يمكن العثور على المجلد المصدر (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "لا يمكن ان يكون المجلد المصدر والمجلد الهدف متطابقين"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "تشغيل Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "يحتاج هذا المشروع على الاقل الى الاصدار %s من Sphinx وبالتالي لا يمكن بناءه باستخدام الاصدار الحالي"
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "تحميل الترجمات  %s "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "تم"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "غير متوفرة للرسائل الافتراضية المدمجة"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "فشل: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "لم يتم اختيار نوع البناء، تم استخدام نوع البناء الافتراضي: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "نجح"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "انتهى مع وجود مشاكل"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "بناء %s، %sتحذير."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "بناء %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "مجلد الاعدادات لا يحتوي على ملف conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "قسم %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "جدول %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r لتم يتم العثور عليه، لهذا تم تجاهلة"
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "حدث غير معروف: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "المستند غير قابل للقراءة. تجاهل."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "التصميم %r "
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "بناء mo:"
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "جميع ملفات المصدر"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "بناء %s"
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "التحقق من التوافق"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "تحديث البيئة:"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "تجهيز المستندات"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "نسخ الصور..."
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "قراءة القوالب"
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "صفحة الHTML موجودة في  %(outdir)s"
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "كتابة ملفات إضافية"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "معالجة %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "ملفات الXML موجودة في %(outdir)s"
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "صفحة الHTML موجودة في  %(outdir)s"
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "الفهرس العام"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "الفهرس"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "التالي"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "السابق"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "إنشاء الفهرس"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "كتابة صفحات إضافية "
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "نسخ الملفات القابلة للتحميل للنسخ..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "غير قادر على نسخ الملفات القابلة للتحميل %r : %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "غير قادر على نسخ الملف الثابت %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "نسخ ملفات إضافية"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "غير قادر على نسخ المف الإضافي %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "ملف الشعار %r غير موجود"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "ملف الايقونة %r غير موجود"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,35 +1230,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1302,7 +1304,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1338,161 +1340,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "الرجاء ادخال بعض النصوص"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "أدخل إما 'نعم' أو'لا'"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "أدخل امتداد الملف, مثلا '.rst' أو '.txt'"
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "اسم المشروع"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "اسم المؤلف(ون)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "نسخة المشروع"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "إصدار المشروع"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "لغة المشروع"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "امتداد ملف المصدر"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "إنشاء Makefile ؟ (نعم / لا)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "إنشاء ملف أوامر للويندوز؟ (نعم/لا)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "اسم المشروع"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "أسماء المؤلفين"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "إنشاء Makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "إنشاء Batchfile ؟"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "عرف متغير للقالب"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "مؤلف القسم:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "كاتب الكود:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "المؤلف"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,559 +1866,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "متغير"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "نوع"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "كائن"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "كائن"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "متغيرات"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "متغير بيئة العمل"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "صفحة البحث"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s ليس مجلد."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "رابط دائم لهذه المعادلة"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "المصدر"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "المستندات"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "مثال"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "أمثلة"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "ملاحظات"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "مراجع"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "تنبيه"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "احتياط"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "خطر"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "خطأ"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "تلميح"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "مهم"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "ملاحظة"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "شاهد أيضا"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "نصيحة"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "تحذير"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "استمرار في الصفحة التالية"
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr "قائمة المحتويات"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "بحث"
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "البحث ضمن %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "الحقوق"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\"> حقوق النشر </a> %(copyright)s"
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169;  حقوق النشر %(copyright)s"
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "بحث"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "نتائج البحث"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "المحتوى"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "فشل"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bg/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/bg/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bg/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/bg/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bg/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/bg/LC_MESSAGES/sphinx.po Changed

@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Bulgarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/bg/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: bg\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,565 +226,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:248
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -786,428 +793,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1239,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:157
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:160
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:163
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:180
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1499,15 +1507,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1517,21 +1525,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1547,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,172 +1641,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1812,614 +1820,625 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:555
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:556
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:557
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:560
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:561
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:597
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2450,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2681,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2698,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2736,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2915,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +3023,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3070,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3085,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3238,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3319,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3392,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3439,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:285
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bn/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/bn/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u09aa\u09b0\u09ac\u09b0\u09cd\u09a4\u09c0 \u099f\u09aa\u09bf\u0995",
         "Other changes": "\u0985\u09a8\u09cd\u09af\u09be\u09a8\u09cd\u09af \u09aa\u09b0\u09bf\u09ac\u09b0\u09cd\u09a4\u09a8",
         "Overview": "\u09ad\u09c1\u09ae\u09bf\u0995\u09be",
-        "Permalink to this definition": "\u098f\u0987 \u09b8\u0982\u099c\u09cd\u099e\u09be\u09b0 \u09aa\u09be\u09b0\u09cd\u09ae\u09be\u09b2\u09bf\u0999\u09cd\u0995",
-        "Permalink to this headline": "\u098f\u0987 \u09b6\u09bf\u09b0\u09c7\u09be\u09a8\u09be\u09ae\u09c7\u09b0 \u09aa\u09be\u09b0\u09cd\u09ae\u09be\u09b2\u09bf\u0999\u09cd\u0995",
         "Please activate JavaScript to enable the search\n    functionality.": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8 \u0995\u09b0\u09be\u09b0 \u099c\u09a8\u09cd\u09af \u0985\u09a8\u09c1\u0997\u09cd\u09b0\u09b9\u09aa\u09c2\u09b0\u09cd\u09ac\u0995 \u099c\u09be\u09ad\u09be\u09b8\u09cd\u0995\u09cd\u09b0\u09bf\u09aa\u09cd\u099f \n   \u09b8\u0995\u09cd\u09b0\u09bf\u09df \u0995\u09b0\u09c1\u09a8\u0964",
         "Preparing search...": "",
         "Previous topic": "\u09aa\u09c2\u09b0\u09cd\u09ac\u09ac\u09b0\u09cd\u09a4\u09c0 \u099f\u09aa\u09bf\u0995",
@@ -39,7 +37,7 @@
         "Search": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8",
         "Search Page": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8 \u09aa\u09be\u09a4\u09be",
         "Search Results": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8\u09c7\u09b0 \u09ab\u09b2\u09be\u09ab\u09b2",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "%(docstitle)s \u098f\u09b0 \u09ae\u09a7\u09cd\u09af\u09c7 \u0996\u09c1\u0981\u099c\u09c1\u09a8",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bn/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/bn/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/bn/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/bn/LC_MESSAGES/sphinx.po Changed

@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2009\n"
 "Language-Team: Bengali (http://www.transifex.com/sphinx-doc/sphinx-1/language/bn/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: bn\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,565 +227,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "পাইথন উন্নয়ন পরামর্শ; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:248
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr "বিল্টইন সমূহ"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "মডিউল লেভেল"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -787,428 +794,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr "(-"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "সাধারণ ইনডেক্স"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "ইনডেক্স"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "পরবর্তী"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "পূর্ববর্তী"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "ইনডেক্স"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "রিলিজ"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1240,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:157
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:160
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:163
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:180
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1500,15 +1508,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1518,21 +1526,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1548,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,172 +1642,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1813,614 +1821,625 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "অনুচ্ছেদ লেখক:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "মডিউল লেখক:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "লেখক:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "প্যারামিটার"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr "রিটার্নস"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr "রিটার্ন টাইপ"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "ফাংশন"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "%s ভার্সনে নতুন"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s ভার্সনে পরিবর্তিত"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s ভার্সন থেকে ডেপ্রিকেটেড"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "ক্লাস"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (বিল্ট-ইন ফাংশন)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s মেথড)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (ক্লাসে)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s এ্যট্রিবিউট)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr "%s (মডিউল)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr "মেথড"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr "ডাটা"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr "এ্যট্রিবিউট"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "মডিউল"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "কিওয়ার্ড"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "অপারেটর"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "অবজেক্ট"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr "এক্সেপশন"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "স্ট্যাটমেন্ট"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "বিল্ট-ইন ফাংশন"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr "রেইজেস"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s মডিউলে)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s মডিউলে)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (বিল্ট-ইন ভ্যারিয়েবল)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (বিল্ট-ইন ক্লাস)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s ক্লাসে)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s ক্লাস মেথড)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s স্ট্যাটিক মেথড)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr "মডিউল সমূহ"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr "ডেপ্রিকেটেড"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr "ক্লাস মেথড"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr "স্ট্যাটিক মেথড"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:555
 msgid "glossary term"
 msgstr "শব্দকোষ"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:556
 msgid "grammar token"
 msgstr "ব্যকরণ টোকেন"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:557
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559
 msgid "environment variable"
 msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:560
 msgid "program option"
 msgstr "প্রোগ্রাম অপশন"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:561
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:597
 msgid "Module Index"
 msgstr "মডিউল ইনডেক্স"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "অনুসন্ধান পাতা"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2451,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2682,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2699,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2737,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "অসমাপ্ত কাজ"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2916,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +3024,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3071,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3086,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "দৃষ্টি আকর্ষণ"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "সতর্কীকরণ"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "বিপজ্জনক"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "ভুল (এরর)"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "আভাস"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "গুরুত্বপূর্ণ"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "নোট"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "আরও দেখুন"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "পরামর্শ"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "সতর্কতা"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "পূর্ববর্তী পাতা হতে চলমান"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3239,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "অনুসন্ধান"
@@ -3271,35 +3320,35 @@
 msgid "Navigation"
 msgstr "নেভিগেশন"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s এর মধ্যে খুঁজুন"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "এই ডকুমেন্ট সম্পর্কে"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "কপিরাইট"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "%(last_updated)s সর্বশেষ পরিবর্তন করা হয়েছে।"
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3393,12 @@
 msgstr "খুঁজুন"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "অনুসন্ধানের ফলাফল"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3440,278 @@
 msgid "Other changes"
 msgstr "অন্যান্য পরিবর্তন"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "এই শিরোনামের পার্মালিঙ্ক"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "এই সংজ্ঞার পার্মালিঙ্ক"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "অনুসন্ধানের ম্যাচগুলো লুকান"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr ""
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "অনুসন্ধানের ম্যাচগুলো লুকান"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:285
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "এই সংজ্ঞার পার্মালিঙ্ক"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr "পাদটীকা"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "ছবি"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ca/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ca/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Tema seg\u00fcent",
         "Other changes": "Altres canvis",
         "Overview": "Resum",
-        "Permalink to this definition": "Link permanent a aquesta definici\u00f3",
-        "Permalink to this headline": "Link permanent a aquest t\u00edtol",
         "Please activate JavaScript to enable the search\n    functionality.": "Activa JavaScript per utilitzar la funcionalitat\nde cerca.",
         "Preparing search...": "",
         "Previous topic": "Tema anterior",
@@ -39,7 +37,7 @@
         "Search": "Cerca",
         "Search Page": "P\u00e0gina de Cerca",
         "Search Results": "Resultats de la Cerca",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Cerca dins de %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ca/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ca/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ca/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ca/LC_MESSAGES/sphinx.po Changed

@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2009\n"
 "Language-Team: Catalan (http://www.transifex.com/sphinx-doc/sphinx-1/language/ca/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: ca\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,565 +227,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:248
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr "Mòduls Interns"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "Nivell de mòdul"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -787,428 +794,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr " (a "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índex General"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "índex"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "següent"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentació"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Índex"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Versió"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1240,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:157
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:160
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:163
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:180
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1500,15 +1508,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1518,21 +1526,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1548,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,172 +1642,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1813,614 +1821,625 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "Autor de la secció:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "Autor del mòdul: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Paràmetres"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr "Retorna"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr "Tipus de retorn"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr "membre"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr "variable"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "funció"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr "tipus"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "Novetat de la versió %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "Canviat a la versió %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsolet desde la versió %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "class"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funció interna)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (mètode %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (class)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr "%s (mòdul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "mòdul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "paraula clau"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "objecte"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr "excepció"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "sentència"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "funció interna"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr "Llença"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (al mòdul %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (al mòdul %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variable interna)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe interna)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (class a %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (mètode estàtic %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr "mòduls"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr "Obsolet"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr "mètode estàtic"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr " (obsolet)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr "variable d'entorn; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:555
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:556
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:557
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559
 msgid "environment variable"
 msgstr "variable d'entorn"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:560
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:561
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:597
 msgid "Module Index"
 msgstr "Índex de Mòduls"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Pàgina de Cerca"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "vegeu %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "vegeu també %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2451,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2682,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2699,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2737,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Pendent"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2916,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +3024,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3071,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3086,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "Atenció"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "Compte"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "Perill"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Error"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "Suggerència"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Vegeu també"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "Truc"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "Avís"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "ve de la pàgina anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3239,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Cerca"
@@ -3271,35 +3320,35 @@
 msgid "Navigation"
 msgstr "Navegació"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Cerca dins de %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Quant a aquests documents"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última actualització el %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3393,12 @@
 msgstr "cerca"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Resultats de la Cerca"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3440,278 @@
 msgid "Other changes"
 msgstr "Altres canvis"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link permanent a aquest títol"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link permanent a aquesta definició"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Oculta Resultats de Cerca"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr ""
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Oculta Resultats de Cerca"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:285
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "Link permanent a aquesta definició"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "imatge"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cak/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cak/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cak/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cak/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cak/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cak/LC_MESSAGES/sphinx.po Changed

@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Julien Malard <julien.malard@mail.mcgill.ca>, 2019\n"
 "Language-Team: Kaqchikel (http://www.transifex.com/sphinx-doc/sphinx-1/language/cak/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: cak\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr "xk'isïk"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "sachoj: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,565 +227,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr "Ruwachib'äl %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr "Kik'ajtz'ïk %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:248
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -787,428 +794,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr "tajin nutz'ib'aj"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr "(chupam"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Konojel cholwuj"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "cholwuj"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "jun chïk"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "chi rij kan"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Cholwuj"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr "Rusachoj nuk'unem:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr "Rusachoj kamulunem:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1240,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:157
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:160
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:163
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:180
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Ütz apetïk pa rokisanem runuk'ik Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr "Rub'i' samäj"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr "Kib'i' ajtz'ib'anel(a')"
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1500,15 +1508,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr "Rujalwäch samäj"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1518,21 +1526,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Ruch'ab'äl samaj"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1548,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,172 +1642,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1813,614 +1821,625 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Jalajöj"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr "retal jalöj"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "Ruwäch"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "wachinäq"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr "Retal jalöj"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:555
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:556
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:557
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:560
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:561
 msgid "document"
 msgstr "wuj"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:597
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "tatz'u %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "tatz'u chuqa' %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2451,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2682,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2699,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2737,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr "(chupam %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Chi tiqib'ana'"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Ri <<original entry>> k'o chupam %s, pa juch' %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2916,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +3024,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3071,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3086,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr "Tz'etb'äl"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr "Tz'etb'äl"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr "Jalajöj chïk"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Sachoj"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Tatz'u chuqa'"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3239,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3271,35 +3320,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3393,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3440,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", pa"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:285
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "rusachoj rusik'inïk: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "rusachoj rutz'ib'axïk: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr "wachib'äl: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "wachib'äl"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cs/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cs/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Dal\u0161\u00ed t\u00e9ma",
         "Other changes": "Ostatn\u00ed zm\u011bny",
         "Overview": "P\u0159ehled",
-        "Permalink to this definition": "Trval\u00fd odkaz na tuto definici",
-        "Permalink to this headline": "Trval\u00fd odkaz na tento nadpis",
         "Please activate JavaScript to enable the search\n    functionality.": "Pro podporu vyhled\u00e1v\u00e1n\u00ed aktivujte JavaScript.",
         "Preparing search...": "Vyhled\u00e1v\u00e1n\u00ed se p\u0159ipravuje...",
         "Previous topic": "P\u0159echoz\u00ed t\u00e9ma",
@@ -39,7 +37,7 @@
         "Search": "Vyhled\u00e1v\u00e1n\u00ed",
         "Search Page": "Vyhled\u00e1vac\u00ed str\u00e1nka",
         "Search Results": "V\u00fdsledky vyhled\u00e1v\u00e1n\u00ed",
-        "Search finished, found %s page(s) matching the search query.": "Vyhled\u00e1v\u00e1n\u00ed dokon\u010deno, str\u00e1nky odpov\u00eddaj\u00edc\u00ed hledan\u00e9mu v\u00fdrazu: %s.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Prohledat %(docstitle)s",
         "Searching": "Prob\u00edh\u00e1 vyhled\u00e1n\u00ed",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cs/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cs/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cs/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cs/LC_MESSAGES/sphinx.po Changed

@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Vilibald W. <vilibald.wanca@gmail.com>, 2014-2015\n"
 "Language-Team: Czech (http://www.transifex.com/sphinx-doc/sphinx-1/language/cs/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: cs\n"
 "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,565 +228,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr "Obr. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr "Tabulka %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr "Výpis %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:249
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr "Vestavěné funkce"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "Úroveň modulu"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -788,428 +795,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr " (v "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Obecný rejstřík"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "rejstřík"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "další"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "předchozí"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentace pro %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Rejstřík"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Vydání"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,271 +1241,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1501,15 +1509,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1519,21 +1527,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1549,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,172 +1643,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1814,432 +1822,438 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "Autor sekce: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "Autor modulu: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr "Autor kódu:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Parametry"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr "Vrací"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr "Typ návratové hodnoty"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr "člen"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr "proměnná"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "funkce"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "Nové ve verzi %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "Změněno ve verzi %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastaralé od verze %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr "Vyvolá"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "třída"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (vestavěná funkce)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metoda %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (třída)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globální proměnná nebo konstanta)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr "Argumenty"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr "metoda"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "klíčové slovo"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "operátor"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr "výjimka"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "příkaz"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "vestavěná funkce"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr "Proměnné"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr "Vyvolá"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (v modulu %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (v modulu %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (vestavěná proměnná)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (vestavěná třída)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (třída v %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (třídní metoda %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statická metoda %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr "Rejstřík modulů Pythonu"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr "moduly"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr "Zastaralé"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr "třídní metoda"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr "statická metoda"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr " (zastaralé)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr "direktiva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr "proměnná prostředí; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
@@ -2275,8 +2289,8 @@
 msgid "Search Page"
 msgstr "Vyhledávací stránka"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2286,142 +2300,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "viz %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "viz také %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboly"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2452,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2683,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2700,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr "graf: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr "graf"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2738,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(v %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr "zdroj"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr "původní záznam"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr "dokumentace"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr "Kód modulu"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Zdrojový kód pro %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr "Přehled: kód modulu"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Všechny moduly s dostupným kódem</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2917,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +3025,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3072,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3087,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "Výstraha"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "Upozornění"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "Nebezpečí"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Chyba"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "Rada"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "Důležité"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "Poznámka"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Viz také"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "Varování"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "pokračujte na předchozí stránce"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3240,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Vyhledávání"
@@ -3272,35 +3321,35 @@
 msgid "Navigation"
 msgstr "Navigace"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Prohledat %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "O těchto dokumentech"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Veškerá práva vyhrazena"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Aktualizováno dne %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3394,12 @@
 msgstr "hledat"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Výsledky vyhledávání"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,123 +3441,111 @@
 msgid "Other changes"
 msgstr "Ostatní změny"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Trvalý odkaz na tento nadpis"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Trvalý odkaz na tuto definici"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Skrýt výsledky vyhledávání"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Probíhá vyhledání"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Vyhledávání se připravuje..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Vyhledávání dokončeno, stránky odpovídající hledanému výrazu: %s."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", v "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Rozbalit boční lištu"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Skrýt výsledky vyhledávání"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Sbalit boční lištu"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Rozbalit boční lištu"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Obsah"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
@@ -3518,154 +3555,164 @@
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "Trvalý odkaz na tuto definici"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr "Permalink k této tabulce"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr "Permalink k tomuto kódu"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr "Permalink k tomuto obrázku"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr "Poznámky pod čarou"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr "obrázek: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "obrázek"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cy/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cy/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Pwnc nesaf",
         "Other changes": "Newidiadau arall",
         "Overview": "Trosolwg",
-        "Permalink to this definition": "Permalink i'r diffiniad hwn",
-        "Permalink to this headline": "Permalink i'r pennawd hwn",
         "Please activate JavaScript to enable the search\n    functionality.": "Trwoch JavaScript ymlaen i alluogi'r chwilio.",
         "Preparing search...": "Paratoi chwilio...",
         "Previous topic": "Pwnc blaenorol",
@@ -39,7 +37,7 @@
         "Search": "Chwilio",
         "Search Page": "Tudalen Chwilio",
         "Search Results": "Canlyniadau chwilio",
-        "Search finished, found %s page(s) matching the search query.": "Chwiliad wedi gorffen, wedi ffeindio %s tudalen(nau) yn cyfateb a'r ymholiad chwilio.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Chwilio o fewn %(docstitle)s",
         "Searching": "Yn chwilio",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cy/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cy/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/cy/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/cy/LC_MESSAGES/sphinx.po Changed

@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Geraint Palmer <palmer.geraint@googlemail.com>, 2016\n"
 "Language-Team: Welsh (http://www.transifex.com/sphinx-doc/sphinx-1/language/cy/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: cy\n"
 "Plural-Forms: nplurals=4; plural=(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,565 +228,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr "Ffig. %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr "Tabl %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr "Listing %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:248
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "Lefel modiwl"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -788,428 +795,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr " (yn "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indecs cyffredinol"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indecs"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "nesaf"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "blaenorol"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dogfennaeth %s %s "
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Indecs"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Rhyddhad"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,271 +1241,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:157
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:160
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:163
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:180
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1501,15 +1509,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1519,21 +1527,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1549,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,172 +1643,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1814,614 +1822,625 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "Awdur yr adran:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "Awdur y fodiwl:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr "Awdur y cod:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "Awdur:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Paramedrau"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr "aelod"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "ffwythiant"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "Newydd yn fersiwn %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "Wedi newid yn fersiwn %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Dibrisiwyd ers fersiwn %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (newidyn byd-eang neu cysonyn)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "modiwl"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "allweddair"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "gweithredydd"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "gwrthrych"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "datganiad"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "ffwythiant built-in"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:555
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:556
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:557
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:560
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:561
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:597
 msgid "Module Index"
 msgstr "Indecs Modiwlau"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Tudalen Chwilio"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "gweler %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "gweler hefyd %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symbolau"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2452,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2683,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2700,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr "graff: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr "graff"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2738,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(yn %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr "ffynhonnell"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr "eitem wreiddiol"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr "Cod y modiwl"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Cod ffynhonnell ar gyfer %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr "Trosolwg: cod y modiwl"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Holl fodiwlau lle mae'r cod ar gael</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2917,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +3025,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3072,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3087,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "Sylw"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "Gofal"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "Perygl"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Gwall"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "Awgrym"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "Pwysig"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "Nodyn"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Gweler hefyd"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "Awgrym"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "Rhybudd"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "wedi'i barhau o'r tudalen blaenorol"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3240,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Chwilio"
@@ -3272,35 +3321,35 @@
 msgid "Navigation"
 msgstr "Llywio"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Chwilio o fewn %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Ynglŷn â'r dogfennau hyn"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Hawlfraint"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Diweddarwyd yn ddiwethaf ar %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3394,12 @@
 msgstr "chwilio"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Canlyniadau chwilio"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3441,278 @@
 msgid "Other changes"
 msgstr "Newidiadau arall"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Permalink i'r pennawd hwn"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Permalink i'r diffiniad hwn"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Cuddio Canlyniadau Chwilio"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Yn chwilio"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Paratoi chwilio..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Chwiliad wedi gorffen, wedi ffeindio %s tudalen(nau) yn cyfateb a'r ymholiad chwilio."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", yn "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Ehangu'r bar ochr"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Cuddio Canlyniadau Chwilio"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Cyfangu'r bar ochr"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Ehangu'r bar ochr"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Cynnwys"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:285
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "Permalink i'r diffiniad hwn"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr "Permalink i'r tabl hwn"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr "Permalink i'r cod hwn"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr "Permalink i'r ddelwedd hon"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr "Permalink i'r toctree hwn"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr "Troednodiadau"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr "delwedd: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "delwedd"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/da/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/da/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "N\u00e6ste emne",
         "Other changes": "Andre \u00e6ndringer",
         "Overview": "Oversigt",
-        "Permalink to this definition": "Permalink til denne definition",
-        "Permalink to this headline": "Permalink til denne overskrift",
         "Please activate JavaScript to enable the search\n    functionality.": "Aktiv\u00e9r venligst JavaScript for at aktivere\n    s\u00f8gefunktionalitet.",
         "Preparing search...": "Forbereder s\u00f8gning...",
         "Previous topic": "Forrige emne",
@@ -39,7 +37,7 @@
         "Search": "S\u00f8g",
         "Search Page": "S\u00f8geside",
         "Search Results": "S\u00f8geresultater",
-        "Search finished, found %s page(s) matching the search query.": "S\u00f8gning f\u00e6rdig, fandt %s sider der matcher s\u00f8geforesp\u00f8rgslen.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "S\u00f8g i %(docstitle)s",
         "Searching": "S\u00f8ger",
         "Searching for multiple words only shows matches that contain\n    all words.": "Bem\u00e6rk: Hvis du s\u00f8ger efter flere ord, vises kun resultater der indeholder alle ordene.",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/da/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/da/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/da/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/da/LC_MESSAGES/sphinx.po Changed

@@ -11,134 +11,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2021\n"
 "Language-Team: Danish (http://www.transifex.com/sphinx-doc/sphinx-1/language/da/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: da\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kan ikke finde kildemappen (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Kildemappe og destinationsmappe kan ikke være identiske"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Kører Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Dette projekt kræver mindst Sphinx v%s og kan derfor ikke bygges med denne version."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "indlæser oversættelser %s ..."
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr "færdig"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "ikke tilgængelig for indbyggede beskeder"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "fejlede: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "lykkedes"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "færdig med problemer"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "kompilering %s, %s advarsel."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "kompilering %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +146,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +159,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "konfigurationsmappe indeholder ikke en conf.py-fil (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr "Ingen sådan konfigurationsværdi: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfigurationsværdien %r er allerede til stede"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,565 +230,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr "figur %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr "tabel %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr "Kildekode %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r blev ikke fundet, ignorerer."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Ukendt hændelsesnavn: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr "domænet %s er allerede registreret"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Rollen %r er allerede registreret til domæne %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser for %r er allerede registreret"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Kunne ikke importere udvidelse %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Udvidelsen %s brugt af dette projekt kræver mindst Sphinx v%s; den kan derfor ikke bygges med denne version."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:248
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr "læser kilder ..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr "forbereder dokumenter"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr "Indbyggede"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "Modulniveau"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "konfigurationsværdien »epub_contributor« bør ikke være tom for EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "ugyldig css_file: %r, ignoreret"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Beskedkatalogerne er i %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr "læser skabeloner ..."
 
@@ -790,428 +797,434 @@
 msgid "writing message catalogs... "
 msgstr "skriver beskedkataloger ..."
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML-siden er i %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr " (i "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML-siderne er i %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d. %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Generelt indeks"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indeks"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "næste"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "forrige"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "kan ikke kopiere statisk fil %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "udgyldig js_file: %r, ignoreret"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon-filen %r findes ikke"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentation"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Udgave"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr "Kodningsfejl:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,271 +1243,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:147
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:151
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:154
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:157
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:160
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:163
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:174
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:177
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:180
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:183
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "kan ikke finde filer %r"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr "Indtast venligst noget tekst."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr "Indtast venligst enten »y« eller »n«."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Indtast venligt et filsuffiks, f.eks. ».rst« eller ».txt«"
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1503,15 +1511,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1521,21 +1529,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1551,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Filen %s findes allerede, udelader."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,172 +1645,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "opret ikke makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr "skabelonmappe for skabelonfiler"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1816,614 +1824,625 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "Afsnitsforfatter: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "Modulforfatter: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr "Kodeforfatter: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "Forfatter: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Parametre"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr "Returnerer"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr "Returtype"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr "medlem"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr "variabel"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "funktion"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr "optæl"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr "optælling"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "Ny i version %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "Ændret i version %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Forældet siden version %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr "Template-parametre"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr "Kaster"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "klasse"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (indbygget funktion)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metode i %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasse)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variabel eller konstant)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (attribut i %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr "Parametre"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr "metode"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr "attribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "nøgleord"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr "undtagelse"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "erklæring"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "indbygget funktion"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr "Variable"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr "Rejser"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (i modulet %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (i modulet %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (indbygget variabel)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (indbygget klasse)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasse i %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (klassemetode i %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statisk metode i %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr "Python-modulindeks"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr "moduler"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr "Forældet"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr "klassemetode"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr "statisk metode"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr " (forældet)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiv)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rolle)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr "direktiv"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr "rolle"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr "miljøvariabel; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:555
 msgid "glossary term"
 msgstr "begreb i ordliste"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:556
 msgid "grammar token"
 msgstr "grammatisk element"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:557
 msgid "reference label"
 msgstr "referenceetiket"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559
 msgid "environment variable"
 msgstr "miljøvariabel"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:560
 msgid "program option"
 msgstr "programtilvalg"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:561
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:597
 msgid "Module Index"
 msgstr "Modulindeks"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Søgeside"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "ny konfiguration"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "udvidelser ændret"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr "kildemappe er ændret"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "se %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "se også %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboler"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2454,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr "overskriv eksisterende filer"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s er ikke en mappe"
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2685,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2702,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr "graf: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr "graf"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2740,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr "Permalink til denne ligning"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(i %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr "kilde"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr "<<oprindeligt punkt>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Det <<oprindelige punkt>> befinder sig i %s, linje %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr "oprindeligt punkt"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr "dok"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr "Modulkode"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kildekode for %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr "Oversigt: modulkode"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alle moduler, der er kode tilgængelig for</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2919,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +3027,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3074,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3089,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr "Nøgleordsargumenter"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr "Eksempler"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr "Andre parametre"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr "Referencer"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "Vær opmærksom"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "Forsigtig"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "Fare"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Fejl"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "Fif"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "Vigtigt"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "Bemærk"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Se også"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "Advarsel"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "fortsat fra forrige side"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "fortsætter på næste side"
@@ -3193,7 +3242,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Søg"
@@ -3274,35 +3323,35 @@
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Søg i %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Om disse dokumenter"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Ophavsret"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Ophavsret</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Ophavsret %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Sidst opdateret %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3396,12 @@
 msgstr "søg"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Søgeresultater"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,280 +3443,278 @@
 msgid "Other changes"
 msgstr "Andre ændringer"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Permalink til denne overskrift"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Permalink til denne definition"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Skjul søgeresultater"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Søger"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Forbereder søgning..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Søgning færdig, fandt %s sider der matcher søgeforespørgslen."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", i"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Udfold sidebjælke"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Skjul søgeresultater"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Sammenfold sidebjælke"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Udfold sidebjælke"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Indhold"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:285
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "Permalink til denne definition"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr "Permahenvisning til denne tabel"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr "Permahenvisning til denne kode"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr "Permahenvisning til dette billede"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr "Permahenvisning til dette toctree"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr "Fodnoter"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr "billede: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "billede"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/de/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/de/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "N\u00e4chstes Thema",
         "Other changes": "Andere \u00c4nderungen",
         "Overview": "\u00dcbersicht",
-        "Permalink to this definition": "Link zu dieser Definition",
-        "Permalink to this headline": "Link zu dieser \u00dcberschrift",
         "Please activate JavaScript to enable the search\n    functionality.": "Bitte aktivieren Sie JavaScript, wenn Sie die Suchfunktion nutzen wollen.",
         "Preparing search...": "Suche wird vorbereitet...",
         "Previous topic": "Vorheriges Thema",
@@ -39,7 +37,7 @@
         "Search": "Suche",
         "Search Page": "Suche",
         "Search Results": "Suchergebnisse",
-        "Search finished, found %s page(s) matching the search query.": "Die Suche ist fertig, es wurde(n) %s Seite(n) mit Treffern gefunden.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Suche in %(docstitle)s",
         "Searching": "Suchen",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/de/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/de/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/de/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/de/LC_MESSAGES/sphinx.po Changed

@@ -11,134 +11,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Jean-François B. <jfbu@free.fr>, 2018\n"
 "Language-Team: German (http://www.transifex.com/sphinx-doc/sphinx-1/language/de/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: de\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kann Quellverzeichnis nicht finden (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Quellverzeichnis und Zielverzeichnis können nicht identisch sein"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s in Verwendung"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Dieses Projekt benötigt Version %s oder später und kann daher nicht gebaut werden."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "Lade Übersetzungen %s…"
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr "erledigt"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "nicht verfügbar für vordefinierte Nachrichten"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "Fehlgeschlagen: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Kein builder ausgewählt, verwende 'html' per default"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "abgeschlossen"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "mit Problemen beendet"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +146,12 @@
 "explicit"
 msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenlesen fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +159,70 @@
 "explicit"
 msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenschreiben fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "Konfigurationsverzeichnis enthält keine conf.py Datei (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "Ungültige Nummer %r for Konfiguration %r, wird ignoriert"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr "Keine solche Konfigurationseinstellung: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfigurationswert %r bereits gesetzt"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,565 +230,566 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr "Abschnitt %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr "Abb. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr "Tab. %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr "Quellcode %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r nicht gefunden, daher ignoriert."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr "Event %r bereits verfügbar"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Unbekannter Event name: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments Lexer Name %r ist unbekannt"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr "Ursprüngliche Ausnahme:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:249
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "Modulebene"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr ""
 
@@ -790,428 +797,434 @@
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Stichwortverzeichnis"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "Index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "weiter"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "zurück"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s Dokumentation"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Stichwortverzeichnis"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,271 +1243,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1503,15 +1511,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1521,21 +1529,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1551,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,172 +1645,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
@@ -1816,432 +1824,438 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "Autor des Abschnitts: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "Autor des Moduls: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr "Autor des Quellcode: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr "%s-%s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Parameter"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr "Rückgabe"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr "Rückgabetyp"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr "Member"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr "Variable"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "Funktion"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr "Makro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr "Aufzählung"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr "Enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr "Typ"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "Neu in Version %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "Geändert in Version %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Veraltet ab Version %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr "Template Parameter"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr "Wirft"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "Klasse"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (Standard-Funktion)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (Methode von %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (Klasse)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globale Variable oder Konstante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (Attribut von %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr "Parameter"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr "%s (Modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr "Methode"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr "Wert"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr "Attribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "Modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "Schlüsselwort"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "Operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "Objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr "Exception"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "Anweisung"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "Builtin-Funktion"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr "Variablen"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr "Verursacht"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (im Modul %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in Modul %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (Standard-Variable)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (Builtin-Klasse)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (Klasse in %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (Klassenmethode von %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statische Methode von %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr "Python-Modulindex"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr "Module"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr "Veraltet"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr "Klassenmethode"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr "statische Methode"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr " (veraltet)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (Direktive)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr "%s (Rolle)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr "Direktive"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr "Rolle"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr "Umgebungsvariable; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
@@ -2277,8 +2291,8 @@
 msgid "Search Page"
 msgstr "Suche"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2288,142 +2302,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "siehe %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "siehe auch %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Sonderzeichen"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2454,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2685,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2702,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr "Diagramm: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr "Diagramm"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2740,178 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr "Quellcode"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Zu tun"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr "<<ursprüngliche Eintrag>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Der <<ursprüngliche Eintrag>> steht in %s, Zeile %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr "ursprüngliche Eintrag"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr "Doku"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr "Modul-Quellcode"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Quellcode für %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr "Überblick: Modul-Quellcode"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alle Module, für die Quellcode verfügbar ist</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2919,107 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +3027,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3074,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3089,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "Achtung"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "Vorsicht"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "Gefahr"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Fehler"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "Hinweis"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "Wichtig"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "Bemerkung"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Siehe auch"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "Tipp"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "Warnung"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "Fortsetzung der vorherigen Seite"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "Fortsetzung auf der nächsten Seite"
@@ -3193,7 +3242,7 @@
 msgid "Table of Contents"
 msgstr "Inhaltsverzeichnis"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Suche"
@@ -3274,35 +3323,35 @@
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Suche in %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Über dieses Dokument"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Zuletzt aktualisiert am %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3396,12 @@
 msgstr "suchen"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Suchergebnisse"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,123 +3443,111 @@
 msgid "Other changes"
 msgstr "Andere Änderungen"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link zu dieser Überschrift"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link zu dieser Definition"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Suchergebnisse ausblenden"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Suchen"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Suche wird vorbereitet..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Die Suche ist fertig, es wurde(n) %s Seite(n) mit Treffern gefunden."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", in "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Seitenleiste ausklappen"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Suchergebnisse ausblenden"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Seitenleiste einklappen"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Seitenleiste ausklappen"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Inhalt"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
@@ -3520,154 +3557,164 @@
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "Link zu dieser Definition"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr "Link zu dieser Tabelle"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr "Link zu diesem Quellcode"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr "Link zu diesem Bild"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr "Permanenter Link zu diesem Inhaltsverzeichnis"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr "Fußnoten"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr "Bild: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "Bild"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/el/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/el/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0395\u03c0\u03cc\u03bc\u03b5\u03bd\u03bf \u03b8\u03ad\u03bc\u03b1",
         "Other changes": "\u0386\u03bb\u03bb\u03b5\u03c2 \u03b1\u03bb\u03bb\u03b1\u03b3\u03ad\u03c2",
         "Overview": "\u0395\u03c0\u03b9\u03c3\u03ba\u03cc\u03c0\u03b7\u03c3\u03b7",
-        "Permalink to this definition": "\u039c\u03cc\u03bd\u03b9\u03bc\u03bf\u03c2 \u03c3\u03cd\u03bd\u03b4\u03b5\u03c3\u03bc\u03bf\u03c2 \u03c3\u03b5 \u03b1\u03c5\u03c4\u03cc\u03bd \u03c4\u03bf\u03bd \u03bf\u03c1\u03b9\u03c3\u03bc\u03cc",
-        "Permalink to this headline": "\u039c\u03cc\u03bd\u03b9\u03bc\u03bf\u03c2 \u03c3\u03cd\u03bd\u03b4\u03b5\u03c3\u03bc\u03bf\u03c2 \u03c3\u03b5 \u03b1\u03c5\u03c4\u03ae\u03bd \u03c4\u03b7\u03bd \u03ba\u03b5\u03c6\u03b1\u03bb\u03af\u03b4\u03b1",
         "Please activate JavaScript to enable the search\n    functionality.": "\u03a0\u03b1\u03c1\u03b1\u03ba\u03b1\u03bb\u03ce, \u03b5\u03bd\u03b5\u03c1\u03b3\u03bf\u03c0\u03bf\u03b9\u03ae\u03c3\u03c4\u03b5 \u03c4\u03b7 JavaScript \u03b3\u03b9\u03b1 \u03bd\u03b1 \u03b5\u03af\u03bd\u03b1\u03b9 \u03b4\u03c5\u03bd\u03b1\u03c4\u03ae \u03b7 \u03bb\u03b5\u03b9\u03c4\u03bf\u03c5\u03c1\u03b3\u03af\u03b1\n    \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2.",
         "Preparing search...": "\u03a0\u03c1\u03bf\u03b5\u03c4\u03bf\u03b9\u03bc\u03b1\u03c3\u03af\u03b1 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2...",
         "Previous topic": "\u03a0\u03c1\u03bf\u03b7\u03b3\u03bf\u03cd\u03bc\u03b5\u03bd\u03bf \u03b8\u03ad\u03bc\u03b1",
@@ -39,7 +37,7 @@
         "Search": "\u0391\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7",
         "Search Page": "\u03a3\u03b5\u03bb\u03af\u03b4\u03b1 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2",
         "Search Results": "\u0391\u03c0\u03bf\u03c4\u03b5\u03bb\u03ad\u03c3\u03bc\u03b1\u03c4\u03b1 \u0391\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2",
-        "Search finished, found %s page(s) matching the search query.": "\u0397 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7 \u03bf\u03bb\u03bf\u03ba\u03bb\u03b7\u03c1\u03ce\u03b8\u03b7\u03ba\u03b5, \u03b2\u03c1\u03ad\u03b8\u03b7\u03ba\u03b5/\u03b1\u03bd %s \u03c3\u03b5\u03bb\u03af\u03b4\u03b1/\u03b5\u03c2 \u03bc\u03b5 \u03b2\u03ac\u03c3\u03b7 \u03c4\u03bf\u03c5\u03c2 \u03cc\u03c1\u03bf\u03c5\u03c2 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "\u0391\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7 \u03c3\u03c4\u03bf %(docstitle)s",
         "Searching": "\u0395\u03ba\u03c4\u03b5\u03bb\u03b5\u03af\u03c4\u03b1\u03b9 \u03b7 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/el/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/el/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/el/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/el/LC_MESSAGES/sphinx.po Changed

@@ -10,134 +10,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2022-10-16 00:30+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2021\n"
 "Language-Team: Greek (http://www.transifex.com/sphinx-doc/sphinx-1/language/el/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.10.3\n"
 "Language: el\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Δεν είναι δυνατή η εύρεση του καταλόγου πηγής (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Ο κατάλογος πηγής και ο κατάλογος προορισμού δεν είναι δυνατό να είναι ίδιοι"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Εκτέλεση Sphinx έκδοση %s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s και επομένως δεν είναι δυνατή η μεταγλωτισση με αυτή την έκδοση."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "δημιουργία καταλόγου εξόδου"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:456
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "κατά τον καθορισμό της επέκτασης %s"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "η 'παραμετροποίηση' σύμφωνα με τον τρέχοντα ορισμό στο conf.py δεν αποτελεί καλέσιμο. Παρακαλείσθε να τροποποιήσετε τον ορισμό ώστε να το κάνετε μία καλέσιμη συνάρτηση. Αυτό απαιτείται προκειμένου το conf.py να συμπεριφέρεται ως μία επέκταση Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "φόρτωση μεταφράσεων %s..."
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/__init__.py:519
 msgid "done"
 msgstr "ολοκλήρωση"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "δεν είναι διαθέσιμο για εσωτερικά μηνύματα"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "φόρτωση πακτωμένου περιβάλλοντος"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "αποτυχία: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Δεν επιλέχθηκε μεταγλωττιστής, θα χρησιμοποιηθεί ο προεπιλεγμένος: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "επιτυχία"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "ολοκλήρωση με προβλήματα"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "μεταγλώττιση %s, %s προειδοποίηση"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "μεταγλώττιση %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "η κλάση κόμβου %r έχει ήδη καταχωρηθεί, οι επισκέπτες της θα υπερσκελιστούν"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "η οδηγία %r έει ήδη καταχωρηθεί, θα υπερσκελιστεί"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "ο ρόλος %r έχει ήδη καταχωρηθεί, θα υπερσκελιστεί"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1285
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -145,12 +145,12 @@
 "explicit"
 msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε από  το δημιουργό της επέκτασης να το ελέγχει και να το κάνει σαφές"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1289
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1292
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -158,64 +158,70 @@
 "explicit"
 msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε το δημιουργό της επέκτασης να το ελέγξει και να το κάνει σαφές"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1296
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1304 sphinx/application.py:1308
 #, python-format
 msgid "doing serial %s"
 msgstr "εκτέλεση σειριακής %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:170
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "ο κατάλογος παραμετροποίησης δεν περιλαμβάνει κανένα αρχείο conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:179
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:208
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης καταλόγου %r, θα αγνοηθεί (χρησιμοποιήστε το %r για να καθορίσετε τα επιμέρους στοιχεία)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:217
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "ανέγκυρος αριθμός %r για τιμή παραμετροποίησης %r, θα αγνοηθεί"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:222
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης %r με τύπο ο οποίος δεν υποστηρίζεται, θα αγνοηθεί"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:251
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "άγνωστη τιμή παραμετροποίσης %r στην υπερσκέλιση, θα αγνοηθεί"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:279
 #, python-format
 msgid "No such config value: %s"
 msgstr "Δεν υπάρχει τέτοια τιμή παραμετροποίησης: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:303
 #, python-format
 msgid "Config value %r already present"
 msgstr "Η τιμή παραμετροποίησης %r υφίσταται ήδη."
 
-#: sphinx/config.py:342
+#: sphinx/config.py:352
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Υπάρχει ένα συντακτικό λάθος στο αρχείο παραμετροποίησής σας: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:355
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Το αρχείο παραμετροποίησης (ή ένα από τα στοιχεία που εισάγει) κάλεσε την sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:362
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,565 +229,566 @@
 "%s"
 msgstr "Υπάρχει ένα προγραμματιστικό λάθος στο αρχείο παραμετροποίησής σας:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:388
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Η τιμή παραμτετροποίησης 'source_suffix' αναμένει στοιχειοσειρά, στοιχειοσειρά καταλόγου, ή λεξικό. Αλλά παραδόθηκε %r."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:407
 #, python-format
 msgid "Section %s"
 msgstr "Τομέας %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:408
 #, python-format
 msgid "Fig. %s"
 msgstr "Εικ. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:409
 #, python-format
 msgid "Table %s"
 msgstr "Πίνακας %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:410
 #, python-format
 msgid "Listing %s"
 msgstr "Λίστα %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:447
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Η τιμή παραμετροποίησης '{name}' πρέπει να λαμβάνει μία από τις {candidates} αλλά εκχωρήθηκε η '{current}'."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:465
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Η τιμή παραμετροποίησης '{name' έχει τύπο 'current__name__}'; αναμενόμενη {permitted}."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Η τιμή παραμετροποίησης '{name}' έχει τύπο '{current__name__}', αρχικοποίηση σε '{default__name__}'."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "το primary_domain %r δεν βρέθηκε, θα αγνοηθεί."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:60
 #, python-format
 msgid "Event %r already present"
 msgstr "Το συμβάν %r υπάρχει ήδη"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:66
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Άγνωστο όνομα συμβάντος: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:105
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:51
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Η επέκταση %s απαιτείται από τις ρυθμίσεις needs_extensions, αλλά δεν είναι φορτωμένη."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:67
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Το έργο χρειάζεται την επέκταση %s τουλάχιστον στην έκδοση %s και επομένως δεν είναι δυνατή η μεταγλώττιση με τη φορτωμένη έκδοση (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:138
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Το όνομα %r δεν είναι γνωστό"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:164
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Δεν είναι δυνατό το lex του literal_block ως %s. Η επισήμανση παραβλέφθηκε."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:49
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:55
 msgid "document not readable. Ignored."
 msgstr "το έγγραφο δεν είναι αναγνωσιμό. Θα αγνοηθεί."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Η κλάση μεταγλώττισης %s δεν έχει χαρακτηριστικό \"name\" "
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Ο μεταγλωττιστής %r υφίσταται ήδη (στο δομοστοιχείο %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Το όνομα μεταγλωττιστή %s δεν είναι καταχωρημένο ή διαθέσιμο δια μέσου του σημείου εισαγωγής"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:159
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Το όνομα μεταγλωττιστή %sδεν είναι καταχορημένο"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:177
 #, python-format
 msgid "domain %s already registered"
 msgstr "ο τομέας %s είναι ήδη καταχωρημένος"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:200 sphinx/registry.py:213 sphinx/registry.py:224
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "ο τομέας %s δεν έχει καταχωρηθεί ακόμη"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Η οδηγία %r είναι ήδη καταχωρημένη στον τομέα %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:216
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Ο ρόλος %r είναι ήδη καταχωρημένος στον τομέα %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:227
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Ο δείκτης %r είναι ήδη καταχωρημένος στον τομέα %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:258
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "Το object_type %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:284
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "Το crossref_type %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:291
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "το source_suffix %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:301
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "το source_parser για το %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:310
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Ο αναλυτής πηγής για το %s δεν είναι καταχωρημένος"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:339
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Ο μεταφραστής για το %r υφίσταται ήδη"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:352
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "το kwargs για το add_node() πρέπει να είναι μία (visit, depart) συνάρτηση πλειάδας: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:428
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "το enumerable_node %r είναι ήδη καταχωρημένο"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:437
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:450
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "η επέκταση %r συγχωνεύθηκε ήδη με το Sphinx από την έκδοση %s; η επέκταση αυτή θα αγνοηθεί."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:461
 msgid "Original exception:\n"
 msgstr "Αρχική εξαίρεση:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:462
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Δεν ήταν δυνατή η εισαγωγή της επέκτασης %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:467
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "η επέκταση %r δεν έχει συνάρτηση setup(); αποτελεί δομοστοιχείο επέκτασης του Sphinx;"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:476
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Η επέκταση %s η οποία χρησιμοποιείται από αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s: επομένως δεν είναι δυνατή η μεταγλώττιση με αυτή την έκδοση."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:484
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "η επέκταση %r επιστρέφει ένα μη υποστηριζόμενο αντικείμενο από τη συνάρτησή της setup(): θα έπρεπε να επιστρέφει None ή έναν κατάλογο μεταδεδομένων"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:173
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:189
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:223
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:72
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "το θέμα %r δεν έχει ρύθμιση \"theme\""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "το θέμα %r δεν έχει ρύθμιση \"inherit\""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:80
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "δεν βρέθηκε θέμα με το όνομα %r, το οποίο κληρονομήθηκε από το %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:103
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "η ρύθμιση %s.%s δεν εμφανίζεται από τις παραμετροποιήσεις θέματος που αναζητήθηκαν"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:122
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "δόθηκε μη υποστηριζόμενη επιλογή θέματος %r"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:221
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "το αρχείο %r στο μονοπάτι θέματος δεν αποτελεί ένα έγκυρο zipfile ή δεν περιλαμβάνει ένα θέμα"
 
-#: sphinx/theming.py:244
+#: sphinx/theming.py:236
 msgid ""
 "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
 msgstr ""
 
-#: sphinx/theming.py:249
+#: sphinx/theming.py:241
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "δεν βρέθηκε θέμα με όνομα %r (απουσιάζει το theme.conf;)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:200
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:204
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:224
 msgid "building mo: "
 msgstr "μεταγλώττιση mo:"
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:225 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr "εγγραφή εξόδου..."
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:234
 #, python-format
 msgid "all of %d po files"
 msgstr "όλα τα αρχεία po του %d"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:252
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "στόχοι για τα αρχεία po του %d οι οποίοι έχουν καθοριστεί"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:260
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "στόχοι για τα αρχεία po του %d τα οποία είναι ξεπερασμένα"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:269
 msgid "all source files"
 msgstr "όλα τα αρχεία πηγής"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:279
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:284
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν βρίσκεται κάτω από τον κατάλογο πηγής, θα αγνοηθεί"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:290
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν υπάρχει, θα αγνοηθεί"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:299
 #, python-format
 msgid "%d source files given on command line"
 msgstr "τα αρχεία πηγής %d που δόθηκαν στη γραμμή εντολής"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:311
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "στόχοι για τα αρχεία πηγής %d τα οποία είναι ξεπερασμένα"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:322 sphinx/builders/gettext.py:238
 #, python-format
 msgid "building %s: "
 msgstr "μεταγλώττιση %s:"
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:329
 msgid "looking for now-outdated files... "
 msgstr "αναζήτηση για νεοξεπερασμένα αρχεία..."
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:334
 #, python-format
 msgid "%d found"
 msgstr "βρέθηκε %d"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:336
 msgid "none found"
 msgstr "δεν βρέθηκε κανένα"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:341
 msgid "pickling environment"
 msgstr "Περιβάλλον μετατροπής αντικειμένων Python σε ροή bytes"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:347
 msgid "checking consistency"
 msgstr "έλεγχος συνοχής"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:351
 msgid "no targets are out of date."
 msgstr "κανένας στόχος δεν είναι ξεπερασμένος."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:390
 msgid "updating environment: "
 msgstr "αναβάθμιση περιβάλλοντος:"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:411
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s προστέθηκε, %s άλλαξε, %s απομακρύνθηκε"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:449 sphinx/builders/__init__.py:461
 msgid "reading sources... "
 msgstr "ανάγνωση πηγών..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "σε αναμονή για εργάτες..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:553
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docname προς εγγραφή: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:562 sphinx/builders/singlehtml.py:145
 msgid "preparing documents"
 msgstr "προετοιμασία κειμένων"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:210
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "βρέθηκε διπλότυπη εγγραφή ToC: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:399 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:413 sphinx/builders/texinfo.py:173
 msgid "copying images... "
 msgstr "αντιγραφή εικόνων..."
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:406
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "δεν είναι δυνατή η ανάγωνση αρχείου εικόνας %r: αντί αυτού θα αντιγραφεί"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:412 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:183
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "δεν είναι δυνατή η αντιγραφή αρχείου εικόνας %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:429
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "δεν είναι δυνατή η εγγραφή αρχείου %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:439
 msgid "Pillow not found - copying image files"
 msgstr "Το pillow δεν βρέθηκε - αντιγραφή αρχείων εικόνας"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:465
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:470
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:498
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:524
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "άγνωστο mimetype για %s, θα ανγοηθεί"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:671
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:696
 #, python-format
 msgid "writing %s file..."
 msgstr "εγγραφή %s αρχείου..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:26
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Το αρχείο επισκόπησης είναι σε %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:52
 #, python-format
 msgid "no changes in version %s."
 msgstr "καμία αλλαγή στην έκδοση %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:54
 msgid "writing summary file..."
 msgstr "εγγραφή αρχείου σύνοψης"
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:70
 msgid "Builtins"
 msgstr "Ενσωματωμένες λειτουργίες"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:72
 msgid "Module level"
 msgstr "Επίπεδο μονάδας λειτουργίας"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "αντιγραφή αρχείων πηγής..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "δεν ήταν δυνατή η ανάγνωση %r για τη δημιουργία changelog"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:14
 msgid "The dummy builder generates no files."
 msgstr "Ο προσωρινός μεταγλωττιστής δεν δημιουργεί αρχεία."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:61
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Το αρχείο ePub βρίσκεται σε %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:159
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:185
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_language\" (ή \"language\") δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:189
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_uid\" πρέπει να είναι XML NAME για EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:192
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_title\" (ή \"html_title\") δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:196
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_author\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:199
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_contributor\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:202
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_description\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_publisher\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_copyright\" (ή \"copyright\") δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"epub_identifier\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "η τιμή παραμετροποίησης \"version\" δεν πρέπει να είναι κενή για EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:229 sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "ανέγκυρο css_file: %r, θα αγνοηθεί"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:217
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Οι κατάλογοι των μηνυμάτων είναι στο %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:239
 #, python-format
 msgid "targets for %d template files"
 msgstr "στόχοι για %d πρότυπα αρχεία"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:243
 msgid "reading templates... "
 msgstr "ανάγνωση προτύπων..."
 
@@ -789,428 +796,434 @@
 msgid "writing message catalogs... "
 msgstr "εγγραφή καταλόγων μηνύματος..."
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:111
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Αναζητήστε οποιαδήποτε λάθη στο παραπάνω αποτέλεσμα ή σε %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:146
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "λανθασμένος σύνδεσμος: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:323
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Δεν βρέθηκε το anchor '%s'"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:556
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:30
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Οι σελίδες manual βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:37
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"man_pages\"; δεν θα καταγραφούν manual pages"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:295 sphinx/builders/manpage.py:46
+#: sphinx/builders/singlehtml.py:153 sphinx/builders/texinfo.py:102
 msgid "writing"
 msgstr "εγγραφή"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:61
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "η τιμή παραμετροποίησης \"man_pages\" κάνει αναφορά το άγνωστο κείμενο %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:26
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Η σελίδα HTML είναι στο %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:148
 msgid "assembling single document"
 msgstr "συναρμολόγηση απλού κειμένου"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:166
 msgid "writing additional files"
 msgstr "εγγραφή επιπρόσθετων αρχείων"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:38
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Τα αρχεία Texinfo βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:40
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του makeinfo\n(χρησιμοποιήστε το 'make info' εδώ για να το κάνετε αυτόματα)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:68
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "δεν βρέθηκε τιμή \"texinfo_documents\": δεν θα γίνει εγγραφή κανενός κειμένου"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:76
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "η τιμή παραμετροποίησης \"texninfo_documents\" αναφέρεται σε άγνωστο κείμενο %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:277 sphinx/builders/texinfo.py:98
 #, python-format
 msgid "processing %s"
 msgstr "επεξεργασία %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:348 sphinx/builders/texinfo.py:149
 msgid "resolving references..."
 msgstr "επίλυση αναφορών..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:358 sphinx/builders/texinfo.py:158
 msgid " (in "
 msgstr " (σε "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:188
 msgid "copying Texinfo support files"
 msgstr "αντιγραφή αρχείων υποστήριξης Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:192
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "σφάλμα κατά την εγγραφή του αρχείου Makefile: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:22
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Τα αρχεία κειένου βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1115 sphinx/builders/text.py:69
+#: sphinx/builders/xml.py:86
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "σφάλμα καταγραφής αρχείου %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:27
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:98
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:157
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "το αρχείο πληροφοριών μεταγλώττισης είναι κατεστραμμένο: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:189
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Οι σελίδες HTML βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Αδυναμία ανάγνωσης αρχείου πληροφοριών μεταγλώττισης: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:180
+#: sphinx/transforms/__init__.py:110 sphinx/writers/manpage.py:94
+#: sphinx/writers/texinfo.py:222
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %B %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Κεντρικό Ευρετήριοο"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "ευρετήριο"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "επόμενο"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "προηγούμενο"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "αντιγραφή αρχείων μεταφόρτωσης..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "δεν είναι δυνατή η αντιγραφή του μεταφορτωμένου αρχείου %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "δεν είναι δυνατή η αντιγραφή στατικού αρχείου %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "δεν είναι δυνατή η αντιγραφή του επιπλέον αρχείου %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Αδυναμία εγγραφής του αρχείου πληροφοριών μεταγλώττισης: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "ο κατάλογος εύρεσης δεν ήταν δυνατό να φορτωθεί, αλλά δε θα μεταγλωττιστούν όλα τα έγγραφα: ο κατάλογος δε θα είναι πλήρης."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "η σελιδα %s ταιριάζει δύο σχέδια στo html_sidebars: %r and %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1098
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ένα σφάλμα Unicode παρουσιάστηκε κατά τη δημιουργία της σελίδας %s. Παρακαλείστε να επιβεβαιώσετε ότι όλες οι τιμές παραμετροποίησης οι οποίες περιλαμβάνουν μη-ASCII περιεχόμενο είναι στοιχειοσειρές Unicode."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1103
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ένα σφάλμα συνέβη κατά τη σύνθεση της σελίδας %s.\n\nΑιτία %r "
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1132
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1137
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1179
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "ανέγκυρο js_file: %r, θα αγνοηθεί"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1266
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Πολλά math_renderers έχουν καταγραφεί. Αλλά δεν έχει επιλεγεί κανένα math_renderer."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1269
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Δόθηκε άγνωστο math_renderer %r."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1277
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "Η εγγραφή html_extra_path %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1281
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1290
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "η εγγραφή html_static_path %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1294
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1303 sphinx/builders/latex/__init__.py:425
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "το αρχείο logo %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1312
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "το αρχείο favicon %r δεν υπάρχει"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1332
 msgid ""
 "html_add_permalinks has been deprecated since v3.5.0. Please use "
 "html_permalinks and html_permalinks_icon instead."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1347
+msgid ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
+
+#: sphinx/builders/html/__init__.py:1374
 #, python-format
 msgid "%s %s documentation"
 msgstr "Τεκμηρίωση του %s - %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:105
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Τα αρχεία LaTeX βρίσκονται σε %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:107
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του (pdf)latex\n(χρησιμοποιήστε το 'make latexpdf' εδώ για να το κάνετε αυτόματα)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:143
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"latex_documents\": δεν θα πραγματοποιηθεί εγγραφή για κανένα κείμενο"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:151
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "η τιμή παραμετροποίησης \"latex_documents\" κάνει αναφορά το άγνωστο κείμενο %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:187 sphinx/domains/std.py:596
+#: 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:487
 msgid "Index"
 msgstr "Ευρετήριο"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:190 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Δημοσίευση"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:204 sphinx/writers/latex.py:366
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "καμία γνωστή επιλογή Babel για τη γλώσσα %r"
 
-#: sphinx/builders/latex/__init__.py:379
+#: sphinx/builders/latex/__init__.py:375
 msgid "copying TeX support files"
 msgstr "αντιγραφή αρχείων υποστήριξης TeX"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:391
 msgid "copying TeX support files..."
 msgstr "αντιγραφή αρχείων υποστήριξης TeX..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:404
 msgid "copying additional files"
 msgstr "αντιγραφή επιπρόσθετων αρχείων"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:448
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:456
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:83
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:86
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:34
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Παρουσιάστηκε εξαίρεση κατά τη μεταγλώττιση, εκκίνηση αποσφαλματιστή: "
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:44
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:46
 msgid "reST markup error:"
 msgstr "σφάλμα reST markup:"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:52
 msgid "Encoding error:"
 msgstr "Σφάλμα κωδικοποίησης:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:55 sphinx/cmd/build.py:70
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Το πλήρες ιστορικό έχει αποθηκευτεί σε %s, σε περίπτωση που  επιθυμείτε να αναφέρετε το ζήτημα στους προγραμματιστές."
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:59
 msgid "Recursion error:"
 msgstr "Σφάλμα αναδρομής:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:62
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:67
 msgid "Exception occurred:"
 msgstr "Εμφανίστηκε εξαίρεση:"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:73
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Παρακαλείστε να το αναφέρετε αν ήταν ένα σφάλμα χρήσης, ώστε ένα καλύτερο μήνυμα σφάλματος να δοθεί την επόμενη φορά."
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:76
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Μία αναφορά σφάλματος μπορεί να υποβληθεί στον ινχηλάτη στο https://github.com/sphinx-doc/sphinx/issues>. Ευχαριστούμε!"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:92
 msgid "job number should be a positive number"
 msgstr "ο αριθμός εργασίας θα πρέπει να είναι θετικός αριθμός"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:100 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:304 sphinx/ext/autosummary/generate.py:581
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:101
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1229,271 +1242,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:122
 msgid "path to documentation source files"
 msgstr "μονοπάτι για τα αρχεία πηγής τεκμηρίωσης"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:124
 msgid "path to output directory"
 msgstr "μονοπάτι στον κατάλογο εξόδου"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:126
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "μία λίστα με συγκεκριμένα αρχεία να επαναμεταγλωττιστούν. Θα αγνοηθεί αν δοθεί το -a"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:129
 msgid "general options"
 msgstr "γενικές επιλογές"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:132
 msgid "builder to use (default: html)"
 msgstr "μεταγλωττιστής για χρήση (προεπιλογή: html)"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:134
 msgid "write all files (default: only write new and changed files)"
 msgstr "εγγραφή όλων των αρχείων (προεπιλογή: εγγραφή μόνο νέων και αλλαγμένων αρχείων)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:137
 msgid "don't use a saved environment, always read all files"
 msgstr "μην χρησιμοποιείτε ένα αποθηκευμένο περιβάλλον, πάντα να διαβάζετε όλα τα αρχεία"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:140
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "μονοπάτι για το αποθηκευμένο περιβάλλον και τα αρχεία doctree (προεπιλογή: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:143
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "παράλληλος μεταγλωττισμός με Ν διεργασίες όπου είναι δυνατό (ιδιαίτερη τιμή \"auto\" θα ορίσει Ν στο cpu-count)"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:147
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "το μονοπάτι όπου βρίσκεται το αρχείο παραμετροποίησης (conf.py) (προεπιλογή: το ίδιο όπως το SOURCEDIR)"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:150
 msgid "use no config file at all, only -D options"
 msgstr "να μη χρησιμοποιηθεί κανένα αρχείο παραμετροποίησης, μόνο επιλογές -D"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:153
 msgid "override a setting in configuration file"
 msgstr "παράκαμψη ρύθμισης στο αρχείο παραμετροποίησης"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:156
 msgid "pass a value into HTML templates"
 msgstr "μεταφορά τιμής στα πρότυπα HTML"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:159
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "ορίστε ετικέτα: συμπεριλάβατε \"only\" τμήματα με TAG"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:161
 msgid "nit-picky mode, warn about all missing references"
 msgstr "Ο τρόπος nit-picky, προειδοποιεί για όλες τις αναφορές που απουσιάζουν"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:164
 msgid "console output options"
 msgstr "επιλογές εξόδου κονσόλας"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:166
 msgid "increase verbosity (can be repeated)"
 msgstr "αυξήστε τον βερμπαλισμό (μπορεί να επαναληφθεί)"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:168 sphinx/ext/apidoc.py:327
 msgid "no output on stdout, just warnings on stderr"
 msgstr "καμία έξοδος στο stdout, μόνο προειδοποιήσεις στο stderr"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:170
 msgid "no output at all, not even warnings"
 msgstr "κανένα αποτέλεσμα ούτε προειδοποιήσεις"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:173
 msgid "do emit colored output (default: auto-detect)"
 msgstr "να γίνεται εκπομπή χρωματιστής εξόδου (προεπιλογή: auto-detect)"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:176
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "να μην παρουσιάζεται έγχρωμο αποτέλεσμα (προεπιλογή: αυτόματη αναγνώριση)"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:179
 msgid "write warnings (and errors) to given file"
 msgstr "προειδοποιήσεις εγγραφής (και σφάλματα) στο δοθέν αρχείο"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:181
 msgid "turn warnings into errors"
 msgstr "μετατροπή προειδοποιήσεων σε σφάλματα"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:183
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:185
 msgid "show full traceback on exception"
 msgstr "απεικόνιση πλήρους ιστορικού σε περίπτωση εξαίρεσης"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:187
 msgid "run Pdb on exception"
 msgstr "εκτέλεση Pdb σε περίπτωση εξαίρεσης"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "δεν είναι δυνατή η εύρεση αρχείων %r"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:211
 msgid "cannot combine -a option and filenames"
 msgstr "δεν γίνεται συνδιασμός της επιλογής -a και των ονομάτων αρχείων"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:232
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "δεν είναι δυνατό το άνοιγμα του αρχείου προειδοποίησης %r: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:246
 msgid "-D option argument must be in the form name=value"
 msgstr "Το όρισμα -D πρέπει να είναι της μορφής όνομα=τιμέ"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:253
 msgid "-A option argument must be in the form name=value"
 msgstr "Το όρισμα -Α πρέπει να είναι της μορφής όνομα=τιμή"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:38
 msgid "automatically insert docstrings from modules"
 msgstr "αυτόματη εισαγωγή docstrings από τα δομοστοιχεία"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically test code snippets in doctest blocks"
 msgstr "αυτόματα κομμάτια δοκιμαστικού κώδικα σε τμήματα doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:40
 msgid "link between Sphinx documentation of different projects"
 msgstr "σύνδεσμος μεταξύ τεκμηρίωσης Sphinx διαφόρων έργων"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:41
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "γράψτε εγγραφές \"todo\" οι οποίες μπορούν αν εμφανίζονται ή να αποκρύπτονται κατά τη μεταγλώττιση"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:42
 msgid "checks for documentation coverage"
 msgstr "αναζήτηση για κάλυψη βιβλιογραφίας"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:43
 msgid "include math, rendered as PNG or SVG images"
 msgstr "να συμπεριληφθεί το math, απεικονισμένο ως εικόνες PNG η SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered in the browser by MathJax"
 msgstr "να συμπεριληφθεί το math, απεικονισμένο στο φυλλομετρηρή απο το MathJax"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:45
 msgid "conditional inclusion of content based on config values"
 msgstr "υποθετική εισαγωγή περιεχομένου βασισμένη στις τιμές παραμετροποίησης"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:46
 msgid "include links to the source code of documented Python objects"
 msgstr "να συμπεριληφθούν σύνδεσμοι στον πηγαίο κώδικα των τεκμηριωμένων αντικειμένων Python"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:47
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "δημιουργία αρχείου .nojekyll για έκδοση του εγγράφου στις σελίδες GitHub "
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:89
 msgid "Please enter a valid path name."
 msgstr "Παρακαλείστε να εισάγετε ένα έγκυρο όνομα μονοπατιού."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:105
 msgid "Please enter some text."
 msgstr "Παρακαλείστε να εισάγετε κάποιο κείμενο."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:112
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Παρακαλείστε να εισάγετε ένα από τα %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:119
 msgid "Please enter either 'y' or 'n'."
 msgstr "Παρακαλείστε να εισάγετε είτε 'y' είτε 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:125
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Παρακαλείστε να εισάγετε μία επέκταση αρχείου, π.χ. '.rst' ή '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:208
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Καλώς ήρθατε στο εργαλείο γρήγορης εκκίνησης Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:218
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:219
 msgid "Root path for the documentation"
 msgstr "Ριζικό μονοπάτι για την τεκμηρίωση"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:224
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Σφάλμα: ένα υπάρχον conf.py έχει βρεθεί στοn επιλεγμένο ριζικό κατάλογο."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:226
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα έργα Sphinx."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:228
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Παρακαλείστε να εισάγετε ένα νέο ριζικό μονοπάτι (ή απλά πιέστε το Enter για έξοδο)"
 
-#: sphinx/cmd/quickstart.py:238
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:238
 msgid "Separate source and build directories (y/n)"
 msgstr "Ξεχωριστοί κατάλογοι για πηγή και μεταγλώττιση (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: 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 ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:245
 msgid "Name prefix for templates and static dir"
 msgstr "Πρόθεμα ονόματος για πρότυπα και στατικούς καταλόγους"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:250
 msgid "Project name"
 msgstr "Όνομα έργου"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:252
 msgid "Author name(s)"
 msgstr "Όνομα(τα) συγγραφέα"
 
-#: sphinx/cmd/quickstart.py:259
+#: 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"
@@ -1502,15 +1510,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:261
 msgid "Project version"
 msgstr "Έκδοση έργου"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:263
 msgid "Project release"
 msgstr "Κυκλοφορία έργου"
 
-#: sphinx/cmd/quickstart.py:270
+#: 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"
@@ -1520,21 +1528,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Γλώσσα έργου"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Επέκταση αρχείου πηγής"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1542,91 +1550,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Όνομα του κυρίους σας εγγράφου (χωρίς επέκταση)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Σφάλμα: το κύριο αρχείο %s έχει ήδη βρεθεί στο επιλεγμένο ριζικό κατάλογο."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα αρχεία."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Παρακαλείσθε να εισάγετε ένα νέο όνομα αρχείου, ή να μεταονομάσετε το υπάρχον αρχείο και να πιέσετε το Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Υποδείξτε ποιά απο τις ακόλουθες επεκτάσεις Sphinx πρέπει να ενεργοποιηθούν:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Σημείωση: τα imgmath και mathjax δεν είναι δυνατό να ενεργοποιηθούν ταυτόχρονα. Το imgmath έχει αποεπιλεγθεί. "
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Δημιουργία Makefile; (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Δημιουργία αρχείου εντολών Windows; (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:85
 #, python-format
 msgid "Creating file %s."
 msgstr "Δημιουργία αρχείου %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:82
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Το αρχείο %s υπάρχει ήδη, παραλείπεται."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Ολοκλήρωση: μία αρχική δομή καταλόγου δημιουργήθηκε."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1636,172 +1644,172 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nΔημιουργία απαιτούμενων αρχείων για ένα έργο Sphinx.\n\nΤο sphinx-quickstart είναι ένα διαδραστικό εργαλείο το οποίο κάνει κάποιες ερωτήσεις για το δικό σας \nέργο και μετά δημιουργεί έναν πλήρη κατάλογο τεκμηρίωσης και δείγμα \nMakefile για να χρησιμοποιηθεί με το sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "ήσυχος τρόπος"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Επιλογές δομής"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "αν ορίζεται, θα ξεχωρίσουν οι κατάλογοι πηγής και μεταγλώττισης"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "αντικατάσταση για τελεία σε _templates κλπ."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Βασικές επιλογές έργου"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "όνομα έργου"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "ονόματα συγγραφέων"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "έκδοση του έργου"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "δημοσίευση του έργου"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "γλώσσα εγγράφου"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "επέκταση αρχείου πηγής"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "κύριο όνομα εγγράφου"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "χρηση epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Επιλογές επέκτασης"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:387
 #, python-format
 msgid "enable %s extension"
 msgstr "ενεργοποίηση της επέκτασης %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:383
 msgid "enable arbitrary extensions"
 msgstr "ενεργοποίηση αυθαίρετων επεκτάσεων"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Δημιουργία Makefile και Batchfile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "δημιουργία makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "να μη δημιουργηθεί makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "δημιουργία batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "να μη δημιουργηθεί batchfile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "χρησιμοποιήστε το make-mode για το Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "μην χρησιμοποιείτε make-mode για Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:389
 msgid "Project templating"
 msgstr "Προτυποποίηση έργου"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:392
 msgid "template directory for template files"
 msgstr "πρότυπος κατάλογος για πρότυπα αρχεία"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "ορίστε μία τιμή προτύπου"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "καθορίστηκε το \"quiet\", αλλά δεν καθορίστηκε είτε το \"project\" είτε το \"author\"."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Σφάλμα: το καθορισθέν μονοπάτι δεν είναι κατάλογος, ή τα αρχεία sphinx υπάρχουν ήδη."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "Το sphinx-quickstart δημιουργεί μόνο εντός ενός κενού καταλόγου. Παρακαλείσθε να καθορίσετε ένα νέο ριζικό μονοπάτι."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Ανέγκυρη μεταβλητή προτύπου: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:58
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:77
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Ανέγκυρη λεζάντα: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:123 sphinx/directives/code.py:274
+#: sphinx/directives/code.py:450
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "η προδιαγραφή αριθμού σειράς είναι εκτός e;yroyw (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:202
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Δεν είναι δυνατή η ταυτόχρονη χρήση των επιλογών \"%s\" και \"%s\""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:216
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Το συμπεριληφθέν αρχείο %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:219
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Η κωδικοποίηση %r που χρησιμοποιήθηκε για την ανάγνωση του συμπεριληφθέντος αρχείου %r φαίνεται να είναι λανθασμένη, προσπαθήστε να δώσετε μία επιλογή :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:256
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Το αντικείμενο  με όνομα %r δεν βρέθηκε στο συμπεριληφθέν αρχείο %r"
@@ -1815,432 +1823,438 @@
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Προσδιορισμός γραμμής %r: δεν ελήφθησαν γραμμές από το συμπεριληφθέν αρχείο %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:106
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:127 sphinx/environment/adapters/toctree.py:180
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "Το toctree περιλαμβάνει αναφορά στο αποκλεισμένο κείμενο %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:130 sphinx/environment/adapters/toctree.py:184
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "το toctree περιλαμβάνει αναφορά στο μη υπαρκτό έγγραφο %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:140
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:172
 msgid "Section author: "
 msgstr "Συντάκτης τμήματος: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:174
 msgid "Module author: "
 msgstr "Συντάκτης μονάδας: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:176
 msgid "Code author: "
 msgstr "Συντάκτης κώδικα: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:178
 msgid "Author: "
 msgstr "Συντάκτης: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:250
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:275
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:109
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:389
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3302
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3227
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3348 sphinx/domains/cpp.py:7423
+#: sphinx/domains/python.py:437 sphinx/ext/napoleon/docstring.py:751
 msgid "Parameters"
 msgstr "Παράμετροι"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3351 sphinx/domains/cpp.py:7429
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3354 sphinx/domains/cpp.py:7432
+#: sphinx/domains/javascript.py:247 sphinx/domains/python.py:449
 msgid "Returns"
 msgstr "Επιστρέφει"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3356 sphinx/domains/javascript.py:249
+#: sphinx/domains/python.py:451
 msgid "Return type"
 msgstr "Επιστρεφόμενος τύπος"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3751 sphinx/domains/cpp.py:7836
 msgid "member"
 msgstr "μέλος"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3752
 msgid "variable"
 msgstr "μεταβλητή"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3753 sphinx/domains/cpp.py:7835
+#: sphinx/domains/javascript.py:358 sphinx/domains/python.py:1200
 msgid "function"
 msgstr "συνάρτηση"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3754
 msgid "macro"
 msgstr "μακροεντολή"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3755
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7834
 msgid "union"
 msgstr "ένωση"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7839
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7840
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3759 sphinx/domains/cpp.py:7837
 msgid "type"
 msgstr "τύπος"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7842
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:20
 #, python-format
 msgid "New in version %s"
 msgstr "Νέο στην έκδοση %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:21
 #, python-format
 msgid "Changed in version %s"
 msgstr "Άλλαξε στην έκδοση %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Αποσύρθηκε στην έκδοση %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:67
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:78
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Η παραπομπή %s δεν αναφέρεται."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4887 sphinx/domains/cpp.py:7378
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7183
 msgid "Template Parameters"
 msgstr "Παράμετροι Προτύπου"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7301
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7426 sphinx/domains/javascript.py:244
 msgid "Throws"
 msgstr "Προκαλεί"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7833 sphinx/domains/javascript.py:360
+#: sphinx/domains/python.py:1202
 msgid "class"
 msgstr "κλάση"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7838
 msgid "concept"
 msgstr "έννοια"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7843
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:143
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (ενσωματωμένη συνάρτηση)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:144 sphinx/domains/python.py:860
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (μέθοδος της %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:146
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (κλάση)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (καθολική μεταβλητή ή σταθερά)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:150 sphinx/domains/python.py:945
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (ιδιότητα της %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:241
 msgid "Arguments"
 msgstr "Παράμετροι"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:317
 #, python-format
 msgid "%s (module)"
 msgstr "%s (μονάδα)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1204
 msgid "method"
 msgstr "μέθοδος"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:361 sphinx/domains/python.py:1201
 msgid "data"
 msgstr "δεδομένα"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1207
 msgid "attribute"
 msgstr "ιδιότητα"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:51
+#: sphinx/domains/python.py:1209
 msgid "module"
 msgstr "μονάδα"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:394
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:57
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "διπλότυπη ετικέτα της εξίσωσης %s, άλλη εμφάνιση στο %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:111 sphinx/writers/latex.py:2092
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Ανέγκυρο math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:52
 msgid "keyword"
 msgstr "λέξη κλειδί"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:53
 msgid "operator"
 msgstr "τελεστής"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:54
 msgid "object"
 msgstr "αντικείμενο"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:55 sphinx/domains/python.py:1203
 msgid "exception"
 msgstr "εξαίρεση"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:56
 msgid "statement"
 msgstr "δήλωση"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:57
 msgid "built-in function"
 msgstr "ενσωματωμένη συνάρτηση"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:442
 msgid "Variables"
 msgstr "Μεταβλητές"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:446
 msgid "Raises"
 msgstr "Προκαλεί"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:703 sphinx/domains/python.py:849
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (στη μονάδα %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:763 sphinx/domains/python.py:941
+#: sphinx/domains/python.py:992
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (στη μονάδα %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:765
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (ενσωματωμένη μεταβλητή)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:790
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (ενσωματωμένη κλάση)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:791
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (κλάση σε %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:832
+msgid ""
+"Using the :property: flag with the py:method directiveis deprecated, use "
+"\".. py:property::\" instead."
+msgstr ""
+
+#: sphinx/domains/python.py:854
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (μέθοδος κλάσης της %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:856 sphinx/domains/python.py:996
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:858
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (στατική μέθοδος της %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1129
 msgid "Python Module Index"
 msgstr "Ευρετήριο Μονάδων της Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1130
 msgid "modules"
 msgstr "μονάδες"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1179
 msgid "Deprecated"
 msgstr "Αποσύρθηκε"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1205
 msgid "class method"
 msgstr "μέθοδος της κλάσης"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1206
 msgid "static method"
 msgstr "&#x7f;στατική μέθοδος"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1208
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1266
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1386
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "περισσότεροι από έναν στόχοι βρέθηκα για την παραπομπή %r: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1447
 msgid " (deprecated)"
 msgstr " (αποσύρθηκε)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:122 sphinx/domains/rst.py:178
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (οδηγία)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:179 sphinx/domains/rst.py:183
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:214
 #, python-format
 msgid "%s (role)"
 msgstr "%s (ρόλος)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:223
 msgid "directive"
 msgstr "οδηγία"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:224
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:225
 msgid "role"
 msgstr "ρόλος"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:247
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:90 sphinx/domains/std.py:107
 #, python-format
 msgid "environment variable; %s"
 msgstr "μεταβλητή περιβάλλοντος; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:174
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Λανθασμένη περιγραφή επιλογής %r, θα πρέπει να μοιάζει με \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" ή \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:250
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:252
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:379
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:387
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:393 sphinx/domains/std.py:406
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
@@ -2276,8 +2290,8 @@
 msgid "Search Page"
 msgstr "Σελίδα αναζήτησης"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:751
+#: sphinx/ext/autosectionlabel.py:47
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s"
@@ -2287,142 +2301,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:868
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "το numfig έχει απενεργοποιηθεί. Το :numref: θα ανγοηθεί."
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:888
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "ο σύνδεσμος δεν έχει λεζάντα: %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:902
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "ανέγκυρο numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:905
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "ανέγκυρο numfig_format: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1129
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1131
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr "νέα παραμετροποίηση"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr "η παραμετροποίηση άλλαξε"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr "αλλαγμένες επεκτάσεις"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:254
 msgid "build environment version not current"
 msgstr "η έκδοση του περιβάλλοντος μεταλώττισης δεν είναι η τρέχουσα"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:256
 msgid "source directory has changed"
 msgstr "ο πηγαίος κατάλογος έχει αλλάξει"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:335
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Το περιβάλλον δεν είναι συμβατό με τον επιλεγμένο μεταγλωττιστή, παρακαλείστε να επιλέξετε ένα διαφορετικό κατάλογο toctree."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:434
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Αδυναμία σάρωσης εγγράφων σε %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:563
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Ο τομέας %r δεν είναι καταχωρημένος"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:651
 msgid "self referenced toctree found. Ignored."
 msgstr "Βρέθηκε αυτοαναφερόμενο toctree. Θα αγνοηθεί."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:693
 msgid "document isn't included in any toctree"
 msgstr "το έγγραφο δεν συμπεριλαμβάνεται σε κανένα toctree"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:70
 #, python-format
 msgid "see %s"
 msgstr "δείτε %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:74
 #, python-format
 msgid "see also %s"
 msgstr "δείτε επίσης %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:77
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "άγνωστος τύπος εγγραφής ευρετηρίου %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:166
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Σύμβολα"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:155
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "αναγνωρίστηκαν κυκλικές αναφορές toctree, θα αγνοηθούν: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:174
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "το toctree περιλαμβάνει αναφορά στο έγγραφο %r η οποία δεν έχει τίτλο: δεν θα δημιουργηθεί σύνδεσμος"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:182
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:80
 #, python-format
 msgid "image file not readable: %s"
 msgstr "το αρχείο εικόνας δεν είναι αναγνώσιμο: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:99
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "το αρχείο εικόνας %s δεν είναι αναγνώσιμο: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:125
 #, python-format
 msgid "download file not readable: %s"
 msgstr "το μεταφορτωμένο αρχείο δεν είναι αναγνώσιμο: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:217
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "στο %s έχουν ήδη ανατεθεί αριθμοί τομέα (εμφωλιασμένο αριθμημένο toctree;)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:78
 #, python-format
 msgid "Would create file %s."
 msgstr "Θα δημιουργούσε το αρχείο %s."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:305
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2434,209 +2453,228 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nΑναζητήστε αναδρομικα σε <MODULE_PATH>για δομοστοιχεία Python και πακέτα και δημιουργήστε \nένα αρχείο reST με οδηγίες automodule για κάθε πακέτο στο <OUTPUT_PATH>.\n\nΤα <EXCLUDE_PATTERN>μπορεί να αποτελούν αρχεία ή/και σχέδια καταλόγων τα οποία θα \nεκτελεστούν κατά τη δημιουργία.\n\nΣημείωση: από προεπιλογή αυτό το σενάριο δεν θα αντικαταστήσει τα ήδη δημιουργημένα αρχεία."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:318
 msgid "path to module to document"
 msgstr "μονοπάτι για το δομοστοιχείο για το έγγραφο"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "αρχεία fnmatch-style και/ή υποδείγματα καταλόγου που θα εξαιρεθούν από τη δημιουργία"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:325
 msgid "directory to place all output"
 msgstr "κατάλογο για τοποθέτηση όλων των προϊόντων"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:330
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "μέγιστο βάθος από υποδομοστοιχεία για απεικόνιση στο TOC (προεπιλογή: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:333
 msgid "overwrite existing files"
 msgstr "αντικατάσταση υπάρχοντων αρχείων"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:336
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ακολουθία συμβολικών συνδέσμων. Ισχυρό όταν συνδυάζεται με το collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:339
 msgid "run the script without creating files"
 msgstr "εκτελέστε το σενάριο χωρίς τη δημιουργία αρχείων"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:342
 msgid "put documentation for each module on its own page"
 msgstr "τοποθετήστε βιβλιογραφία για κάθε δομοστοιχείο στη δικής της σελίδα"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:345
 msgid "include \"_private\" modules"
 msgstr "να συμπεριληφθούν τα δομοστοιχεία \"_private\""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:347
 msgid "filename of table of contents (default: modules)"
 msgstr "όνομα αρχείου του πίνακα περιεχομένων (προεπιλογή: δομοστοιχεία)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:349
 msgid "don't create a table of contents file"
 msgstr "να μη δημιουργηθεί αρχείο με πίνακα περιεχομένων"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:352
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "μη δημιουργείτε κεφαλίδες για πακέτα δομοστοιχείων/πακέτων (π.χ. όταν τα docstrings τα περιλαμβάνουν ήδη)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:357
 msgid "put module documentation before submodule documentation"
 msgstr "τοποθέτηση βιβλιογραφίας δομοστοιχείου πριν από την βιβλιογραφία υπόδομοστοιχείου"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:361
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή  POP-0420 αυτονόητων namespaces"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:365
 msgid "file suffix (default: rst)"
 msgstr "επέκταση αρχείου (προεπιλογή: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:367
 msgid "generate a full project with sphinx-quickstart"
 msgstr "δημιουργία ενός πλήρους έργου με το sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:370
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "η προσθήκη του module_path στο sys.path, χρησιμοποιείται όταν δίδεται το --full"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:372
 msgid "project name (default: root module name)"
 msgstr "όνομα έργου (προεπιλογή: όνομα ριζικού δομοστοιχείου)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:374
 msgid "project author(s), used when --full is given"
 msgstr "συγγραφέας(εις) έργου, χρησιμοποιείται όταν δίδεται το --full"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:376
 msgid "project version, used when --full is given"
 msgstr "έκδοση έργου, χρησιμοποιείται όταν δίνεται το --full"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:378
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "έκδοση έργου, χρησιμοποιείται όταν δίδεται το --full, προεπιλογή σε --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:381
 msgid "extension options"
 msgstr "επιλογές επέκτασης"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:414
 #, python-format
 msgid "%s is not a directory."
 msgstr "το %s δεν είναι κατάλογος."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:43
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:38
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "ανέγκυρο regex %r σε %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:47
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Η δοκιμή της κάλυψης στις πηγές ολοκληρώθηκε, δείτε τα αποτελέσματα στο %(outdir)s python.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:61
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "ανέγκυρο regex %r στο coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:122
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:154
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "το δομοστοιχείο %s δεν ήταν δυνατό να εισαχθεί: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:250
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:266
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:279
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:111
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "λείπει '+' ή '-' στην επιλογή '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:116
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "Η '%s δεν είναι μία έγκυρη επιλογή."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:130
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' δεν αποτελεί μία έγκυρη επιλογή για pyversion"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:213
 msgid "invalid TestCode type"
 msgstr "ανέγκυρος τύπος TestCode"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:271
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Ολοκληρώθηκε η δοκιμή των doctests στις πηγές, δείτε τα αποτελέσματα σε %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:421
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "δεν υπάρχει κώδικας/αποτέλεσμα στο τμήμα %s στο %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:507
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "Ο ανέγκυρος κώδικας doctest θα αγνοηθεί: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:72
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:81
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/extlinks.py:100
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and "
+"all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/extlinks.py:108
+#, python-format
+msgid ""
+"extlinks: Sphinx-6.0 will require a caption string to contain exactly one "
+"'%s' and all other '%' need to be escaped as '%%'."
+msgstr ""
+
+#: sphinx/ext/graphviz.py:124
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Η οδηγία Graphviz δεν είναι δυνατό να περιλαμβάνει και περιεχόμενο και ένα όρισμα ονόματος αρχείου"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:134
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Το εξωτερικό αρχείο Graphviz %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:141
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Η οδηγία χωρίς περιεχόμενο \"graphviz\" θα αγνοηθεί."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:250
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2646,14 +2684,14 @@
 "%r"
 msgstr "το dot δεν παρήγαγε κανένα αρχείο εξόδου:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:254
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "η εντολή dot %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για αποτέλεσμα graphviz), ελέγξτε τη ρύθμιση graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:261
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2663,33 +2701,35 @@
 "%r"
 msgstr "το dot ολοκλήρωσε με σφάλμα:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:272
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "Το graphviz_output_format πρέπει να είναι ένα από τα 'png', 'svg', αλλά είναι %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:276 sphinx/ext/graphviz.py:328
+#: sphinx/ext/graphviz.py:365
 #, python-format
 msgid "dot code %r: %s"
 msgstr "κωδικός dot %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:378 sphinx/ext/graphviz.py:386
 #, python-format
 msgid "graph: %s"
 msgstr "γράφημα: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 msgid "graph"
 msgstr "γράφημα"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:34
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:43 sphinx/ext/imgconverter.py:67
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2699,163 +2739,178 @@
 "%r"
 msgstr "η μετατροπή ολοκλήρωσε με σφάλμα:stderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:62
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:137
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Η εντολή LaTex %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για απεικόνιση μαθηματικών), ελέγξτε τη ρύθμιση imgmath_latex"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:151
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s η εντολή %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για μαθηματική απεικόνιση), ελέγξτε τη ρύθμιση imgmath_%s"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:308
 #, python-format
 msgid "display latex %r: %s"
 msgstr "απεικόνιση latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:341
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "σε σειρά latex %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:348 sphinx/ext/mathjax.py:47
 msgid "Permalink to this equation"
 msgstr "Μόνιμος σύνδεσμος σε αυτή την εξίσωση"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:172
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "το απόθεμα intersphinx έχει μεταφερθεί: %s->%s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:203
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "φότωση του αποθέματος intersphinx από %s..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:217
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "παρουσιάστηκαν κάποια ζητήματα με μερικά απο τα αποθέματα, αλλά υπήρξαν λειτουργικές εναλλακτικές:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:223
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "αδυναμία προσέγγισης οποιασδήποτε αποθήκης με τα ακόλουθα ζητήματα:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:268
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(στη %s έκδοση %s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:270
 #, python-format
 msgid "(in %s)"
 msgstr "(στο %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:494
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:500
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:587
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:612
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "το αναγνωριστικό intersphinx %r δεν είναι στοιχειοσειρά. Θα αγνοηθεί"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:625
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:62 sphinx/ext/viewcode.py:178
 msgid "source"
 msgstr "πηγή"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:62
 msgid "Todo"
 msgstr "Εκκρεμότητα"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:95
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "βρέθηκε εγγραφή TODO:%s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:153
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:155
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Το <<original entry>> βρίσκεται στο %s, γραμή %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:165
 msgid "original entry"
 msgstr "αρχική εγγραφή"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:235
 msgid "highlighting module code... "
 msgstr "επισήμανση κώδικα δομοστοιχείου..."
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:267
 msgid "docs"
 msgstr "τεκμηρίωση"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:281
 msgid "Module code"
 msgstr "Κώδικας μονάδας"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:287
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Πηγαίος κώδικας για το %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:314
 msgid "Overview: module code"
 msgstr "Επισκόπηση: κώδικας της μονάδας"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:315
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Όλες οι μονάδες για τις οποίες υπάρχει διαθέσιμος κώδικας</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:119
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:375
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "ανέγκυρη υπογραφή για αυτόματο %s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:492
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "σφάλμα κατά τη μορφοποίηση των ορισμάτων για %s:%s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
+#: sphinx/ext/autodoc/__init__.py:629 sphinx/ext/autodoc/__init__.py:1693
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr "απουσιάζει το χαρακτηριστικό %s στο αντικείμενο %s"
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:783
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:876
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2863,113 +2918,107 @@
 "explicit module name)"
 msgstr "δεν γνωρίζω ποιο δομοστοιχείο να εισάγω για αυτόματη τεκμηρίωση %r (προσπαθήστε να τοποθετήσετε μία οδηγία \"module\" ή  \"currentmodule\" στο έγγραφο, ή να δώσετε ένα σαφές όνομα δομοστοιχείου)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:920
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:939
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:1000
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" στο όνομα automodule δεν βγάζει νόημα"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1007
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "ορίσματα υπογραφής ή επιστροφή σημείωσης η οποία δόθηκε για το automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1020
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ πρέπει να είναι λίστα στοιχειοσειράς, όχι %r (στο δομοστοιχείο %s) -- θα αγνοηθεί το __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1086
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1287 sphinx/ext/autodoc/__init__.py:1364
+#: sphinx/ext/autodoc/__init__.py:2773
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1557
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1679
 #, python-format
 msgid "Bases: %s"
 msgstr "Βάσεις: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1780 sphinx/ext/autodoc/__init__.py:1858
+#: sphinx/ext/autodoc/__init__.py:1881
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1925
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2164 sphinx/ext/autodoc/__init__.py:2261
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2392
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:117
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:250
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:269
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:322
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2977,46 +3026,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:336
 #, python-format
 msgid "failed to parse name %s"
 msgstr "αδυναμία ανάλυσης ονόματος %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:341
 #, python-format
 msgid "failed to import object %s"
 msgstr "αδυναμία εισαγωγής αντικειμένου %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:795
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:803
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "Το autosummary δημιουργεί αρχεία .rst εσωτερικά. Αλλά το δικό σας source_suffix δεν περιλαμβάνει .rst. Θα παραλειφθεί."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:151
+#: sphinx/ext/autosummary/generate.py:224
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:362
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary δημιουργία autosummary για: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:366
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "αυτόματη περίληψη εγγραφή στο %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:409
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3024,7 +3073,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:582
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3039,138 +3088,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nΔημιουργία ReStrucuredText χρησιμοποιώντας τις οδηγίες autosummary.\n\nΤο sphinx-autogen αποτελεί ένα πρόσθιο εργαλείο για το sphinx.ext.autosummary.generate. Δημιουργεί \nτα αρχεία reStructuredText από τις οδηγίες autosummary οι οποίες περιλαμβάνονται στα \nπαραδοθέντα αρχεία εισόδου.\n\nΗ μορφή της οδηγίας autosummary τεκμηρειώνεται στο \nδομοστοιχείο ``sphinx.ext.autosummary``  της Python και μπορεί να αναγνωστεί χρησιμοποιώντας το :: \n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:599
 msgid "source files to generate rST files for"
 msgstr "αρχεία πηγής για να δημιουργηθούν τα αρχεία reST"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:603
 msgid "directory to place all output in"
 msgstr "ο κατάλογος που θα τοποθετεί όλο το αποτέλεσμα εξόδου"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:606
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "προεπιλεγμένη επέκταση για αρχεία (προεπιλογή: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:610
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "προσαρμοσμένος κατάλογος προτύπου (προεπιλογή: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:614
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "μέλη εισαγμένα στο έγγραφο (προεπιλογή: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:618
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:339 sphinx/ext/napoleon/docstring.py:718
 msgid "Keyword Arguments"
 msgstr "Ορίσματα λέξης-κλειδί"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:672
 msgid "Example"
 msgstr "Παράδειγμα"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:673
 msgid "Examples"
 msgstr "Παραδείγματα"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:733
 msgid "Notes"
 msgstr "Σημειώσεις"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Other Parameters"
 msgstr "Άλλες παράμετροι"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:778
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "References"
 msgstr "Αναφορές"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:814
 msgid "Warns"
 msgstr "Προειδοποιήσεις"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Yields"
 msgstr "Αποδόσεις"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:988
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:995
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:1002
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1009
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:249
 msgid "Attention"
 msgstr "Προσοχή"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:250
 msgid "Caution"
 msgstr "Προσοχή"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:251
 msgid "Danger"
 msgstr "Κίνδυνος"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:252
 msgid "Error"
 msgstr "Σφάλμα"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:253
 msgid "Hint"
 msgstr "Συμβουλή"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:254
 msgid "Important"
 msgstr "Σημαντικό"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:255
 msgid "Note"
 msgstr "Σημείωση"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:256
 msgid "See also"
 msgstr "Δείτε επίσης"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:257
 msgid "Tip"
 msgstr "Πρακτική συμβουλή"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:258
 msgid "Warning"
 msgstr "Προειδοποίηση"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "συνεχίζεται από την προηγούμενη σελίδα"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "συνέχεια στην επόμενη σελίδα"
@@ -3192,7 +3241,7 @@
 msgid "Table of Contents"
 msgstr "Πίνακας περιεχομένων"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Αναζήτηση"
@@ -3273,35 +3322,35 @@
 msgid "Navigation"
 msgstr "Πλοήγηση"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Αναζήτηση στο %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Σχετικά με αυτά τα κείμενα"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a>%(copyright)s"
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Τελευταία ενημέρωση στις %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3346,12 +3395,12 @@
 msgstr "αναζήτηση"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Αποτελέσματα Αναζήτησης"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3393,123 +3442,111 @@
 msgid "Other changes"
 msgstr "Άλλες αλλαγές"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Μόνιμος σύνδεσμος σε αυτήν την κεφαλίδα"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Μόνιμος σύνδεσμος σε αυτόν τον ορισμό"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Απόκρυψη Ευρεθέντων Αναζητήσεων"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Εκτελείται η αναζήτηση"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Προετοιμασία αναζήτησης..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Η αναζήτηση ολοκληρώθηκε, βρέθηκε/αν %s σελίδα/ες με βάση τους όρους αναζήτησης."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", στο "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Άνοιγμα πλαϊνής μπάρας"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Απόκρυψη Ευρεθέντων Αναζητήσεων"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Κλείσιμο πλαϊνής μπάρας"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Άνοιγμα πλαϊνής μπάρας"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Περιεχόμενα"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:218
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "βρέθηκε ευρετήριο βασιζόμενο σε 4 στήλες. Μπορεί να αποτελεί σφάλμα της επέκτασης που χρησιμοποιείτε: %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:257
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Δεν υπάρχει αναφορά για την υποσημείωση %s."
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:263
 msgid "Footnote # is not referenced."
 msgstr "Η υποσημείωση # δεν αναφέρεται."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:324 sphinx/transforms/i18n.py:395
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ασυνεπείς αναφορές υποσημείωσης στα μεταφρασμένα μηνύματα. original: {0}, translated: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:367
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "ασυνεπείς αναφορές στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:414
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ασυνεπείς αναφορές παραπομπής στο μεταφρασμένο μήνυμα. αρχικό: {0}, μεταφρασμένο: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:434
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ασυνεπείς αναφορές όρων στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:110
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:152
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "περισσότεροι από ένας στόχοι βρέθηκαν για 'οποιαδήποτε' παραπομπή %r: θα μπορούσε να είναι %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:200
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:203
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:75
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:103
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:121
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Άγνωστος τύπος αρχείου: %s..."
@@ -3519,154 +3556,164 @@
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "μη κωδικοποιήσιμοι χαρακτήρες πηγής, θα αντικατασταθούν με \"?\": %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/__init__.py:512
 msgid "skipped"
 msgstr "παράβλεψη"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/__init__.py:517
 msgid "failed"
 msgstr "αποτυχία"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:76
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:295
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:588
 #, python-format
 msgid "unknown node type: %r"
 msgstr "άγνωστος τύπος κόμβου: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:61
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "σφάλμα ανάγνωσης: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:68
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "καταγραφή λάθους: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:92
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:188
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Ανέγκυρος τύπος ημερομηνίας. Τοποθετείστε στη στοιχειοσειρά μονά εισαγωγικά εάν θέλετε να το εξάγετε απευθείας: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:429
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "το toctree περιλαμβάνει αναφορά σε άγνωστο αρχείο %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:616
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "εξαίρεση κατά την αξιολόγηση μόνο της έκφρασης οδηγίας: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:69
 #, python-format
 msgid "default role %s not found"
 msgstr "ο προεπιλεγμένος ρόλος %s δεν βρέθηκε"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/html.py:121 sphinx/writers/html.py:130
+#: sphinx/writers/html5.py:99 sphinx/writers/html5.py:108
+msgid "Permalink to this definition"
+msgstr "Μόνιμος σύνδεσμος σε αυτόν τον ορισμό"
+
+#: sphinx/writers/html.py:322 sphinx/writers/html5.py:300
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "δεν έχει καθοριστεί numfig_format για το %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/html.py:332 sphinx/writers/html5.py:310
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Κανένα ID δεν έχει ανατεθεί στο κόμβο %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/html.py:406 sphinx/writers/html5.py:364
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/html.py:429 sphinx/writers/html.py:434
+#: sphinx/writers/html5.py:387 sphinx/writers/html5.py:392
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/html.py:438 sphinx/writers/html5.py:396
 msgid "Permalink to this table"
 msgstr "Απευθείας σύνδεσμος σε αυτόν τον πίνακα"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/html.py:481 sphinx/writers/html5.py:439
 msgid "Permalink to this code"
 msgstr "Απευθείας σύνδεσμος σε αυτόν τον κώδικα"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/html.py:483 sphinx/writers/html5.py:441
 msgid "Permalink to this image"
 msgstr "Απευθείας σύνδεσμος σε αυτήν την εικόνα"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/html.py:485 sphinx/writers/html5.py:443
 msgid "Permalink to this toctree"
 msgstr "Απευθείας σύνδεσμος σε αυτόν τον πίνακα περιεχομένων"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/html.py:632 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Δεν ήταν δυνατή η λήψη του μεγέθους της εικόνας. Η επιλογή :scale: θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:331
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "άγνωστο toplevel_sectioning %r για την κλάσση %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:382
 msgid "too large :maxdepth:, ignored."
 msgstr "πολύ μεγάλο :maxdepth:, θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:621
 msgid "document title is not a single Text node"
 msgstr "ο τίτλος του εγγράφου δεν είναι μονός κόμβος κειμένου"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:653 sphinx/writers/texinfo.py:614
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "ο ανακαλυφθέν τίτλος κόμβος δεν βρίσκεται σε τομέα, θέμα, πίνακα, προειδοποίηση ή πλαϊνή μπάρα"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:829 sphinx/writers/manpage.py:239
+#: sphinx/writers/texinfo.py:629
 msgid "Footnotes"
 msgstr "Σημειώσεις υποσέλιδου"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:897
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "τόσο η επιλογή για tabularcolumns όσο και για :widths: δίνονται. Η επιλογή :widths: θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1246
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "η μονάδα διάστασης %s δεν είναι έγκυρη. Θα αγνοηθεί."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1562
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "βρέθηκε άγνωστος τύπος εγγραφής ευρετηρίου %s"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:288 sphinx/writers/text.py:795
 #, python-format
 msgid "image: %s"
 msgstr "εικόνα: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:796
 msgid "image"
 msgstr "εικόνα"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1185
 msgid "caption not inside a figure."
 msgstr "η λεζάντα δεν βρίσκεται εντός μίας εικόνας."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1273
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "μη υλοποιημένος τύπος κόμβου: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_FR/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_FR/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: English (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_FR/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: en_FR\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_GB/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_GB/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po Changed

@@ -1,1117 +1,1120 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
+# Adam Turner, 2022
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Adam Turner, 2022\n"
 "Language-Team: English (United Kingdom) (http://www.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.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: en_GB\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
-msgstr ""
+msgstr "Cannot find source directory (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
-msgstr ""
+msgstr "Output directory (%s) is not a directory"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
-msgstr ""
+msgstr "Source directory and destination directory cannot be identical"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
-msgstr ""
+msgstr "Running Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
-msgstr ""
+msgstr "This project needs at least Sphinx v%s and therefore cannot be built with this version."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
-msgstr ""
+msgstr "making output directory"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
-msgstr ""
+msgstr "while setting up extension %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
-msgstr ""
+msgstr "'setup' 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:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
-msgstr ""
+msgstr "loading translations %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
-msgstr ""
+msgstr "done"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
-msgstr ""
+msgstr "not available for built-in messages"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
-msgstr ""
+msgstr "loading pickled environment"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
-msgstr ""
+msgstr "failed: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
-msgstr ""
+msgstr "No builder selected, using default: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
-msgstr ""
+msgstr "succeeded"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
-msgstr ""
+msgstr "finished with problems"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "build %s, %s warning (with warnings treated as errors)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr ""
+msgstr "build %s, %s warnings (with warnings treated as errors)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
-msgstr ""
+msgstr "build %s, %s warning."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
-msgstr ""
+msgstr "build %s, %s warnings."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
-msgstr ""
+msgstr "build %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
-msgstr ""
+msgstr "node class %r is already registered, its visitors will be overridden"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
-msgstr ""
+msgstr "directive %r is already registered, it will be overridden"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
-msgstr ""
+msgstr "role %r is already registered, it will be overridden"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr ""
+msgstr "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:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
-msgstr ""
+msgstr "the %s extension is not safe for parallel reading"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr ""
+msgstr "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:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
-msgstr ""
+msgstr "the %s extension is not safe for parallel writing"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
-msgstr ""
+msgstr "doing serial %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, 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:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
-msgstr ""
+msgstr "cannot override dictionary config setting %r, ignoring (use %r to set individual elements)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
-msgstr ""
+msgstr "invalid number %r for config value %r, ignoring"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
-msgstr ""
+msgstr "cannot override config setting %r with unsupported type, ignoring"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
-msgstr ""
+msgstr "unknown config value %r in override, ignoring"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
-msgstr ""
+msgstr "No such config value: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
-msgstr ""
+msgstr "Config value %r already present"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
-msgstr ""
+msgstr "There is a syntax error in your configuration file: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
-msgstr ""
+msgstr "The configuration file (or one of the modules it imports) called sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
 "\n"
 "%s"
-msgstr ""
+msgstr "There is a programmable error in your configuration file:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
-msgstr ""
+msgstr "The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
-msgstr ""
+msgstr "Section %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
-msgstr ""
+msgstr "Fig. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
-msgstr ""
+msgstr "Table %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
-msgstr ""
+msgstr "Listing %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
-msgstr ""
+msgstr "The config value `{name}` has to be a one of {candidates}, but `{current}` is given."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
-msgstr ""
+msgstr "The config value `{name}' has type `{current.__name__}'; expected {permitted}."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
-msgstr ""
+msgstr "The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
-msgstr ""
+msgstr "primary_domain %r not found, ignored."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
-msgstr ""
+msgstr "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add \"root_doc = 'contents'\" to your conf.py."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
-msgstr ""
+msgstr "Event %r already present"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
-msgstr ""
+msgstr "Unknown event name: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
-msgstr ""
+msgstr "Handler %r for event %r threw an exception"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr ""
+msgstr "The %s extension is required by needs_extensions settings, but it is not loaded."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
-msgstr ""
+msgstr "This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
-msgstr ""
+msgstr "Pygments lexer name %r is not known"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
-msgstr ""
+msgstr "Could not lex literal_block as \"%s\". Highlighting skipped."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
-msgstr ""
+msgstr "multiple files found for the document \"%s\": %r\nUse %r for the build."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
-msgstr ""
+msgstr "document not readable. Ignored."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
-msgstr ""
+msgstr "Builder class %s has no \"name\" attribute"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
-msgstr ""
+msgstr "Builder %r already exists (in module %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
-msgstr ""
+msgstr "Builder name %s not registered or available through entry point"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
-msgstr ""
+msgstr "Builder name %s not registered"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
-msgstr ""
+msgstr "domain %s already registered"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
-msgstr ""
+msgstr "domain %s not yet registered"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
-msgstr ""
+msgstr "The %r directive is already registered to domain %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
-msgstr ""
+msgstr "The %r role is already registered to domain %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
-msgstr ""
+msgstr "The %r index is already registered to domain %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
-msgstr ""
+msgstr "The %r object_type is already registered"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
-msgstr ""
+msgstr "The %r crossref_type is already registered"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
-msgstr ""
+msgstr "source_suffix %r is already registered"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
-msgstr ""
+msgstr "source_parser for %r is already registered"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
-msgstr ""
+msgstr "Source parser for %s not registered"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
-msgstr ""
+msgstr "Translator for %r already exists"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
-msgstr ""
+msgstr "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
-msgstr ""
+msgstr "enumerable_node %r already registered"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
-msgstr ""
+msgstr "math renderer %s is already registered"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
-msgstr ""
+msgstr "the extension %r was already merged with Sphinx since version %s; this extension is ignored."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
-msgstr ""
+msgstr "Original exception:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
-msgstr ""
+msgstr "Could not import extension %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
-msgstr ""
+msgstr "extension %r has no setup() function; is it really a Sphinx extension module?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
-msgstr ""
+msgstr "The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
-msgstr ""
+msgstr "extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
-msgstr ""
+msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
-msgstr ""
+msgstr "invalid PEP number %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
-msgstr ""
+msgstr "invalid RFC number %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "theme %r doesn't have \"theme\" setting"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
-msgstr ""
+msgstr "theme %r doesn't have \"inherit\" setting"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
-msgstr ""
+msgstr "no theme named %r found, inherited by %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
-msgstr ""
+msgstr "setting %s.%s occurs in none of the searched theme configs"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
-msgstr ""
+msgstr "unsupported theme option %r given"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
-msgstr ""
+msgstr "file %r on theme path is not a valid zipfile or contains no theme"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
-msgstr ""
+msgstr "no theme named %r found (missing theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
-msgstr ""
+msgstr "a suitable image for %s builder not found: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
-msgstr ""
+msgstr "a suitable image for %s builder not found: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
-msgstr ""
+msgstr "building mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
-msgstr ""
+msgstr "writing output... "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
-msgstr ""
+msgstr "all of %d po files"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
-msgstr ""
+msgstr "targets for %d po files that are specified"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
-msgstr ""
+msgstr "targets for %d po files that are out of date"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
+msgstr "all source files"
+
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
-msgstr ""
+msgstr "file %r given on command line is not under the source directory, ignoring"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
-msgstr ""
+msgstr "%d source files given on command line"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
-msgstr ""
+msgstr "targets for %d source files that are out of date"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
-msgstr ""
+msgstr "building %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
-msgstr ""
+msgstr "looking for now-outdated files... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
-msgstr ""
+msgstr "%d found"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
-msgstr ""
+msgstr "none found"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
-msgstr ""
+msgstr "pickling environment"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
-msgstr ""
+msgstr "checking consistency"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,648 +1631,649 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
-msgstr ""
+msgstr "\":file:\" option for csv-table directive now recognises an absolute path as a relative path from source directory. Please update your document."
 
 #: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
-msgstr ""
+msgstr "Graphviz directive cannot have both content and a filename argument"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
-msgstr ""
+msgstr "External Graphviz file %r not found or reading it failed"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
-msgstr ""
+msgstr "Ignoring \"graphviz\" directive without content."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
-msgstr ""
+msgstr "dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr ""
+msgstr "graphviz_output_format must be one of 'png', 'svg', but is %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
-msgstr ""
+msgstr "Permalink to this equation"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3290,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3363,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3410,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
-msgstr ""
+msgstr "Could not obtain image size. :scale: option is ignored."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_HK/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_HK/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: English (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_HK/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: en_HK\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eo/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/eo/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eo/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/eo/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eo/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/eo/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Tatsuro YOKOTA <hidaruma@outlook.jp>, 2021\n"
 "Language-Team: Esperanto (http://www.transifex.com/sphinx-doc/sphinx-1/language/eo/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: eo\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Ne povas trovi fontan dosierujon (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indico universala"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indico"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "sekva"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "antaŭa"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentaro"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,35 +1230,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1302,7 +1304,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1338,161 +1340,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Aŭtoro:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,559 +1866,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametroj"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "membro"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcio"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "nomaĵo"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klaso"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klaso)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "datenoj"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "escepto"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "vidu %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "vidu ankaŭ %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboloj"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Avertoj"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Eraro"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Averto"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Aŭtora rajto"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "serĉu"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/es/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/es/LC_MESSAGES/sphinx.js Changed

@@ -13,7 +13,7 @@
         "Complete Table of Contents": "\u00cdndice de contenidos completo",
         "Contents": "Contenidos",
         "Copyright": "Copyright",
-        "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "",
+        "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "Creado usando <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.",
         "Expand sidebar": "Expandir barra lateral",
         "Full index on one page": "\u00cdndice completo en una p\u00e1gina",
         "General Index": "\u00cdndice General",
@@ -30,8 +30,6 @@
         "Next topic": "Pr\u00f3ximo tema",
         "Other changes": "Otros cambios",
         "Overview": "Resumen",
-        "Permalink to this definition": "Enlazar permanentemente con esta definici\u00f3n",
-        "Permalink to this headline": "Enlazar permanentemente con este t\u00edtulo",
         "Please activate JavaScript to enable the search\n    functionality.": "Por favor, active JavaScript para habilitar la funcionalidad\n    de b\u00fasqueda.",
         "Preparing search...": "Preparando b\u00fasqueda...",
         "Previous topic": "Tema anterior",
@@ -39,7 +37,7 @@
         "Search": "B\u00fasqueda",
         "Search Page": "P\u00e1gina de B\u00fasqueda",
         "Search Results": "Resultados de la b\u00fasqueda",
-        "Search finished, found %s page(s) matching the search query.": "B\u00fasqueda finalizada, encontr\u00f3 %s p\u00e1gina(s) acorde con la consulta de b\u00fasqueda.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "B\u00fasqueda finalizada, se encontraron ${resultCount} p\u00e1ginas que coinciden con la consulta de b\u00fasqueda.",
         "Search within %(docstitle)s": "Buscar en %(docstitle)s",
         "Searching": "Buscando",
         "Searching for multiple words only shows matches that contain\n    all words.": "La b\u00fasqueda de varias palabras solo muestra coincidencias que contienen\n    todas las palabras.",
@@ -59,5 +57,5 @@
         "search this documentation": "buscar en esta documentaci\u00f3n",
         "the documentation for": "la documentaci\u00f3n para"
     },
-    "plural_expr": "(n != 1)"
+    "plural_expr": "n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/es/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/es/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/es/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/es/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,153 +8,154 @@
 # Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018
 # Guillem Borrell <guillem@torroja.dmt.upm.es>, 2011
 # Ivan García <ivan.garcia@studio-point.com>, 2019
-# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013-2018,2020
+# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013-2018,2020,2022
+# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2022
 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2021
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013-2018,2020,2022\n"
 "Language-Team: Spanish (http://www.transifex.com/sphinx-doc/sphinx-1/language/es/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: es\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "No se encuentra directorio fuente (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
-msgstr ""
+msgstr "Directorio de salida (%s) no es un directorio"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Directorio fuente y directorio destino no pueden ser idénticos"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Ejecutando Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Este proyecto necesita al menos Sphinx v%s y por lo tanto no se puede construir con esta versión."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "creando directorio de salida"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "mientras configura la extensión %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' como se define actualmente en el archivo conf.py no es un Python invocable. Por favor, modifique su definición para que sea una función invocable. Esto es necesario para que el archivo conf.py se comporte como una extensión de Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "cargando traducciones %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "hecho"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "no disponible para mensajes incorporados"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "cargando el ambiente pickled"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "fallo: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Ningún constructor seleccionado, utilizando el valor predeterminado: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "éxitoso"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "finalizo con problemas"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "compilación %s, %sadvertencia (con advertencias tratadas como errores)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "compilación %s, %s advertencias (con advertencias tratadas como errores)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "construir %s, %s advertencia."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "compilación %s, %s advertencias."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "construir %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "la clase de nodo %r ya está registrada, sus visitantes serán reemplazados"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "la directiva %r ya está registrada, esa se reemplazará"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "el rol %r ya está registrado, ese se reemplazará"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr "la extensión de %s no declara si es seguro para la lectura  en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito"
+msgstr "la extensión de %s no declara si es seguro para la lectura en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "la extensión %s no es segura para lectura paralela"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,64 +163,70 @@
 "explicit"
 msgstr "la extensión %s no declara si es seguro para la escritura paralela, suponiendo que no lo sea - solicite al autor de la extensión que lo verifique y haga explicito"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "la extensión %s no es segura para escritura paralela"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "realizando serialmente %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "directorio de configuración no contiene un archivo conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "Se encontró un valor de configuración no válido: 'language = None'. Actualice su configuración a un código de idioma válido. Volviendo a definir 'en' (Inglés)."
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "no se puede reemplazar el ajuste de la configuración del diccionario %r, haciendo caso omiso (utilice %r para definir elementos individuales)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "número no válido %r de valor de configuración %r, haciendo caso omiso"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "no se puede reemplazar los ajustes de configuración %r con tipo no compatible, haciendo caso omiso"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "valor de configuración desconocido %r en anulación, ignorando"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "No hay tal valor de configuración: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Valor de configuración %r ya presente"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Hay un error de sintaxis en su archivo de configuración: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "El archivo de configuración (o uno de los módulos que importa) invocó sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -227,898 +234,894 @@
 "%s"
 msgstr "Hay un error programable en su archivo de configuración:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "El valor de configuración `source_suffix' espera una cadena de caracteres, una lista de cadena de caracteres o un diccionario. Pero `%r' es dado."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Sección %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Figura %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabla %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Lista %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "El valor de configuración `{name}` tiene que ser uno de {candidates}, pero fue dado `{current}`."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "El valor de configuración `{name}' tiene tipo `{current.__name__}'; esperado {permitted}."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "El valor de configuración `{name}' tiene el tipo `{current.__name__}', el valor predeterminado es `{default.__name__}'."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r no fue encontrado, se ignora."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
-msgstr ""
+msgstr "Desde v2.0, Sphinx usa \"index\" como root_doc por defecto. Agregue \"root_doc = 'contents'\" a su archivo conf.py."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Evento %r ya presente"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nombre de evento desconocido: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
-msgstr ""
+msgstr "Manipulador %r para el evento %r lanzó una excepción"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "La extensión %s es requerida por la configuración de needs_extensions, pero esta no es cargada."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Este proyecto necesita la extensión %s por lo menos en la versión %s y por lo tanto no puede ser construido con la versión cargada (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "El nombre del lexer de pigmentos %r se desconoce"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "No pudo el léxico literal_block como \"%s\". Destacado omitido."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
-msgstr ""
+msgstr "varios archivos encontrados para el documento \"%s\": %r\nUse %r para la compilación."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "documento no legible. Ignorado."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Constructor clase %s no tiene ningún atributo \"name\""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Constructor %r ya existe (en el módulo %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Nombre de constructor %s no registrados o disponibles a través del punto de entrada"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Nombre de constructor %s no registrado"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "dominio %s ya esta registrado"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "dominio %s no esta registrado"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "La directiva %r ya fue registrada en el dominio %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "El rol %r ya fue registrado en el dominio %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "El índice %r ya fue registrado en el dominio %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "El %r object_type ya está registrado"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "El %r crossref_type ya está registrado"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r ya está registrado"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser para %r ya está registrado"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Analizador de fuentes para %s no registrado"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Traductor para %r ya existe"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs para la función add_node() debe ser una tupla de función (visitar, salir): %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r ya esta registrado"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
-msgstr ""
+msgstr "el renderizador matemático %s ya está registrado"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "la extensión %r ya se fusionó con Sphinx desde la versión %s; esta extensión se omite."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Excepción original:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "No puede importar la extensión %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "extensión %r no tiene ninguna función setup(); ¿es realmente un módulo de extensión de Sphinx?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "La extensión %s utilizada por este proyecto necesita al menos la versión de Sphinx v%s; por lo tanto no puede ser construido con esta versión."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "extensión %r devuelve un objeto no soportado de su función setup(); debe devolver un diccionario de metadatos o ninguno"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
-msgstr ""
+msgstr "número de PEP inválido %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
-msgstr ""
+msgstr "número RFC inválido %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r no tiene configuraciones de \"tema\""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r no tiene configuraciones de \"heredar\""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "no encontrado ningún tema llamado %r, heredado por %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "configuración de %s.%s se produce en ninguna de las configuraciones de tema buscado"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "opción de tema no soportada %r fue dada"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "archivo %r o ruta del tema no es un archivo zip válido o no contiene ningún tema"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "sin tema llamado %r encontrado (¿falta el archivo theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "una imagen adecuada para %s constructor no encontrado: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "una imagen adecuada para %s constructor no encontrado: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
-msgstr "compilando mo:"
+msgstr "compilando mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "escribiendo salida... "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
-msgstr "Todos los %d archivos po"
+msgstr "todos los %d archivos po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "los objetivos para %d los archivos po que se especifican"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "los objetivos para %d los archivos po que estan desactualizados"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "todos los archivos fuente"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "archivo %r dado en la línea de comandos no está en el directorio fuente, ignorado"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "archivo %r dado en la línea de comandos no existe, ignorado"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d archivos fuente dados en la línea de comandos"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "los objetivos para %d los archivos fuentes que estan desactualizados"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
-msgstr "compilando %s:"
+msgstr "compilando %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
-msgstr "buscando por archivos no actualizados..."
+msgstr "buscando por archivos no actualizados... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
-msgstr "encontrado %d"
+msgstr "%d encontrado"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "no encontrado"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "preparando ambiente"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "verificando consistencia"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "no hay archivos objetivo desactualizados."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
-msgstr "actualizando ambiente"
+msgstr "actualizando ambiente: "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%sañadido, %s cambiado, %s removido"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
-msgstr "leyendo fuentes..."
+msgstr "leyendo fuentes... "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "Esperando a los workers..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames para escribir: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "preparando documentos"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "entrada de tabla de contenido duplicada encontrada: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
-msgstr "copiando imágenes..."
+msgstr "copiando imágenes... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "no puede leer el archivo de imagen %r: en su lugar, lo copia"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "no se puede copiar archivo de imagen %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "no se puede escribir archivo de imagen %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
-msgstr "no se encuentra Pillow - copiando archivos de imágenes"
+msgstr "Pillow no encontrada - copiando archivos de imágenes"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
-msgstr ""
+msgstr "escribiendo el archivo mimetype..."
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
-msgstr ""
+msgstr "escribiendo el archivo META-INF/container.xml..."
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
-msgstr ""
+msgstr "escribiendo el archivo content.opf..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "mimetype desconocido para %s, ignorando"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
-msgstr ""
+msgstr "escribiendo el archivo toc.ncx..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "escribiendo archivo %s..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "El archivo de resumen está en %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "no hay cambios en versión %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "escribiendo archivo de resumen..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Funciones incorporadas"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Nivel de módulo"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
-msgstr "copiando archivos fuente"
+msgstr "copiando archivos fuente..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "no se pudo leer %r for para la creación del registro de cambios"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "El constructor ficticio no genera archivos."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "El archivo ePub está en %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
-msgstr ""
+msgstr "escribiendo el archivo nav.xhtml..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_language\" (o \"language\") no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "el valor de configuración \"epub_uid\" debe ser XML NAME para EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_title\" (or \"html_title\") no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_author\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_contributor\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_description\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_publisher\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_copyright\" (or \"copyright\") no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"epub_identifier\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "el valor de configuración \"version\" no debe estar vacío para EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file inválido: %r, ignorado"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Los catálogos de mensajes están en %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "objetivos para los archivos de plantillas %d"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
-msgstr "leyendo plantillas..."
+msgstr "leyendo plantillas... "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
-msgstr "escribiendo catálogos de mensajes..."
+msgstr "escribiendo catálogos de mensajes... "
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Busque cualquier error en la salida anterior o en el archivo %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "enlace roto: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Ancla '%s' no encontrado"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
-msgstr ""
+msgstr "Error al compilar expresiones regulares en linkcheck_allowed_redirects: %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Las páginas del manual están en %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "no se encontró el valor de configuración \"man_pages\"; no se escribirán las páginas del manual"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "escribiendo"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "El valor de configuración \"man_pages\" hace referencia a un documento desconocido %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Página HTML está en %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "ensamblando documento sencillo"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "escribiendo archivos adicionales"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Los archivos Texinfo están en %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nEjecute el comando 'make' en ese directorio para ejecutarlos a través de makeinfo\n(usa el comando 'make info' aquí para hacer esto automáticamente)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "no se encontró el valor de configuración \"texinfo_documents\"; no se escribirán documentos"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "El valor de configuración \"texinfo_documents\" hace referencia a un documento desconocido %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "procesando %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "resolviendo referencias..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (en "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "copiando archivos de soporte Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "error escribiendo archivo Makefile: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Los archivos de texto están en %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "error escribiendo archivo %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Los archivos XML están en %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Los archivos pseudo-XML están en %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "el archivo de información de compilación está roto: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Las páginas HTML están en %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Error al leer la información de compilación del fichero: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d de %B de %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índice General"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "índice"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "siguiente"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "generando índices"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "escribiendo páginas adicionales"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
-msgstr "copiando archivos descargables..."
+msgstr "copiando archivos descargables... "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "no se puede copiar archivo descargable %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
-msgstr ""
+msgstr "Error al copiar un archivo en html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
-msgstr ""
+msgstr "copiar archivos estáticos"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "no se puede copiar archivo estático %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "copiando archivos extras"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "no se puede copiar archivo extra %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Error al escribir el archivo de información de compilación: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "no se pudo cargar el índice de búsqueda, pero no se crearán todos los documentos: el índice estará incompleto."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr "La página %s coincide con dos patrones en html_sidebars: %r y %r"
+msgstr "página %s coincide con dos patrones en html_sidebars: %r y %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "Se produjo un error Unicode al representar la página %s. Asegúrese de que todos los valores de configuración que contengan contenido que no sea ASCII sean cadenas Unicode."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
-msgstr "Ha ocurrido un error al renderizar la pagina %s. Motivo: %r"
+msgstr "Ha ocurrido un error al renderizar la pagina %s.\nRazón: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "volcar inventario de objetos"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "volcar el índice de búsqueda en %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file inválido: %r, ignorado"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Muchos math_renderers están registrados. Pero no se ha seleccionado math_renderer."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Desconocido math_renderer %r es dado."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "entrada html_extra_path %r no existe"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "entrada html_extra_path %r se coloca dentro de outdir"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "entrada html_static_path %r no existe"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "entrada html_static_path %r se coloca dentro de outdir"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "archivo de logo %r no existe"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "el archivo %r usado para el favicon no existe"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "documentación de %s - %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Los archivos LaTeX están en %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nEjecuta el comando 'make' en este directorio para compilarlos usando (pdf)latex\n(usa el comando 'make latexpdf' aquí para hacer esto automáticamente)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "no se encontró el valor de configuración \"latex_documents\"; no se escribirán documentos"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
-msgstr "El valor de configuración \"latex_documents\" hace referencia a un documento desconocido %s"
+msgstr "valor de configuración \"latex_documents\" hace referencia a un documento desconocido %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Índice"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Versión"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "No se conoce la opción de Babel para el idioma %r"
@@ -1127,94 +1130,94 @@
 msgid "copying TeX support files"
 msgstr "copiando archivos de soporte TeX"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "copiando archivos de soporte TeX..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "copiando archivos adicionales"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "Clave de configuración desconocida: latex_elements%r, ignorada."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
-msgstr ""
+msgstr "Opción de tema desconocida: latex_theme_options%r, ignorado."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r no tiene configuración de \"tema\""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r no tiene configuración de \"%s\""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Ha ocurrido un error al compilar, iniciando depurador:"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "¡Interrumpido!"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
-msgstr "error en marcado de reST"
+msgstr "error en marcado de reST:"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Error de codificación:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "El rastreo completo se ha guardado en %s, si desea informar el problema a los desarrolladores."
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Error de recursión:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr ""
+msgstr "Esto puede ocurrir con archivos de origen muy grandes o profundamente anidados. Puede aumentar cuidadosamente el límite de recurrencia predeterminado de Python de 1000 en el archivo conf.py con, por ej.:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Ha ocurrido una excepción:"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Por favor, informe también esto si fue un error del usuario, de modo que la próxima vez se pueda proporcionar un mejor mensaje de error."
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Se puede presentar un informe de error en el rastreador en <https://github.com/sphinx-doc/sphinx/issues>. ¡Gracias!"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "número de trabajo debe ser un número positivo"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
-msgstr ""
+msgstr "Para más información visite <https://www.sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1231,290 +1234,285 @@
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\nGenerar documentación a partir de archivos fuente.\n\nsphinx-build genera documentación a partir de los archivos en SOURCEDIR y la\ncoloca en OUTPUTDIR. Busca 'conf.py' en SOURCEDIR para los ajustes de configuración.\nLa herramienta 'sphinx-quickstart' se puede usar para generar archivos de plantilla,\nincluido 'conf.py'\n\nsphinx-build puede crear documentación en diferentes formatos. Se selecciona un\nformato especificando el nombre del constructor en la línea de comando; por defecto\nes HTML. Los constructores también pueden realizar otras tareas relacionadas con\nel procesamiento de la documentación.\n\nDe forma predeterminada, se construye todo lo que está desactualizado. La salida solo\npara archivos seleccionados se puede generar especificando nombres de archivo individuales.\n"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "ruta a los archivos fuente de la documentación"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "ruta al directorio de salida"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "una lista de archivos específicos para reconstruir. Ignorado si se especifica -a"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "opciones generales"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "constructor a usar (por defecto: html)"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "escribir todos los archivos (por defecto: solo escribir archivos nuevos y modificados)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "no usar un entorno guardado, siempre leer todos los archivos"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "ruta para el entorno en caché y los archivos doctree (predeterminado: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "construir en paralelo con N procesos donde sea posible (el valor especial \"auto\" establecerá N en recuento de CPU)"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "ruta del archivo de configuración (conf.py) donde se encuentra (predeterminado: igual que el valor SOURCEDIR)"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "no use ningún archivo de configuración, solomente opciones -D"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "sobreescribir un ajuste en el fichero de configuración"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "pasar un valor a la plantilla HTML"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "define la etiqueta: incluye bloques \"only\" con TAG"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "modo quisquilloso, advierte sobre todas las referencias faltantes"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "opciones de salida de consola"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "aumentar la verbosidad (puede repetirse)"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "sin salida en salida estándar, solo advertencias en los mensajes de error estándar"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "sin salida, ni siquiera advertencias"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "emitir salida de color (predeterminado: detección automática)"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "no emite salida de color (predeterminado: detección automática)"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "escribir avisos (y errores) al fichero indicado"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "convertir advertencias en errores"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "con -W, sigue adelante cuando recibas advertencias"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "mostrar rastreo completo en excepción"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "ejecutar Pdb en excepción"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "no se pueden encontrar los archivos %r"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "no se puede combinar la opción -a y nombres de archivo"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "no se puede abrir el archivo de advertencia %r: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
-msgstr "El argumento de la opción -D debe estar en la forma nombre=valor"
+msgstr "argumento de la opción -D debe estar en la forma nombre=valor"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
-msgstr "El argumento de la opción -A debe estar en la forma nombre=valor"
+msgstr "argumento de la opción -A debe estar en la forma nombre=valor"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "insertar automáticamente docstrings de los módulos"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "probar automáticamente fragmentos de código en bloques doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "enlace entre la documentación de Sphinx de diferentes proyectos"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "escribir entradas de \"todo\" que se pueden mostrar u ocultar en la compilación"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "verificación para el cubrimiento de la documentación"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "incluir expresiones matemáticas, mostradas como imágenes PNG o SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "incluir matemática, mostrada en el navegador por MathJax"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "inclusión condicional de contenido basado en valores de configuración"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "incluir enlaces al código fuente de objetos documentados de Python"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "crear archivo .nojekyll para publicar el documento en páginas GitHub"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Por favor, ingrese un nombre de ruta válido."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Por favor, ingrese algún texto."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Por favor, ingrese uno de %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
-msgstr "Por favor, ingrese cualquiera de 'y' o 'n'"
+msgstr "Por favor, ingrese cualquiera de 'y' o 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Por favor, ingrese un archivo de sufijo, por ejemplo, '.rst' o '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Bienvenido a la utilidad de inicio rápido de Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Ingrese los valores para las siguientes configuraciones (solo presione Entrar para\naceptar un valor predeterminado, si se da uno entre paréntesis)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Ruta raíz seleccionada: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Ingrese la ruta raíz para la documentación."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Ruta raíz para la documentación"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Error: un archivo conf.py ya existe en la ruta raíz seleccionada."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart no sobreescribirá proyectos existentes de Sphinx."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Por favor, ingrese una nueva ruta raíz (o ingrese Enter para salir)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Tiene dos opciones para colocar el directorio de compilación para la salida de Sphinx.\nO usas un directorio \"_build\" dentro de la ruta raíz, o separas\ndirectorios \"fuente\" y \"compilación\" dentro de la ruta raíz."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Separar directorios fuente y compilado (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Dentro del directorio raíz, se crearán dos directorios más; \"_templates\"\npara plantillas HTML personalizadas y \"_static\" para hojas de estilo personalizadas y otras archivos\nestáticos. Puede ingresar otro prefijo (como \".\") Para reemplazar el guión bajo."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Prefijo de nombre para directorios de plantillas y estático"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "El nombre del proyecto aparecerá en varios lugares en la documentación construida."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Nombre de proyecto"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Autor(es)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "Sphinx tiene la noción de una \"versión\" y un \"lanzamiento\" para el\nsoftware. Cada versión puede tener varios lanzamientos. Por ejemplo, para\nPython, la versión es algo así como 2.5 o 3.0, mientras que el lanzamiento es\nalgo así como 2.5.1 o 3.0a1. Si no necesita esta estructura dual, simplemente\nconfigure ambas con el mismo valor."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Versión del proyecto"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Liberación del proyecto"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1524,21 +1522,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Si los documentos deben escribirse en un idioma que no sea inglés,\npuede seleccionar un idioma aquí por su código de idioma. Sphinx entonces\ntraducir el texto que genera a ese idioma.\n\nPara obtener una lista de códigos compatibles, vea\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Lenguaje del proyecto"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr ""
+msgstr "El sufijo del nombre de archivo para los archivos de fuente. Comúnmente, esto es \".txt\"\no \".rst\". Solo los archivos con este sufijo se consideran documentos."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Sufijo del archivo fuente"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1546,91 +1544,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "Un documento es especial porque se considera el nodo superior del\n\"contents tree\", es decir, es la raíz de la estructura jerárquica\nde los documentos. Normalmente, esto es \"index\", pero si su documento \"index\"\nes una plantilla personalizada, también puede establecerlo en otro nombre de archivo."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Nombre del documento maestro (sin sufijo)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Error: el archivo maestro %s ya se ha encontrado en la ruta raíz seleccionada."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart no sobreescribirá el archivo existente."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Ingrese un nuevo nombre de archivo o cambie el nombre del archivo existente y presione Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indique cuál de las siguientes extensiones de Sphinx deben habilitarse:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Nota: imgmath y mathjax no se pueden habilitar al mismo tiempo. imgmath ha sido deseleccionado."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Se puede generar un archivo Makefile y un archivo de comandos de Windows para que usted\nsolo tiene que ejecutar, por ejemplo, `make html' en lugar de invocar sphinx-build\ndirectamente."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
-msgstr "Crear Makefile? (y/n)"
+msgstr "¿Crear Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "¿Crear archivo de comandos para Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Creando archivo %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "El archivo %s ya existe, omitiendo."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Terminado: se ha creado una estructura de directorio inicial."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr "Ahora debe completar su archivo maestro %s y crear otros archivos fuente\nde documentación."
+msgstr "Ahora debe completar su archivo maestro %s y crear otros archivos fuente\nde documentación. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr "Use el archivo Makefile para compilar los documentos, así ejecute el comando:\n    make builder"
+msgstr "Use el archivo Makefile para compilar los documentos, así ejecute el comando:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Use el comando sphinx-build para compilar los documentos, así ejecute el comando:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "donde \"builder\" es uno de los constructores compatibles, por ejemplo, html, latex o linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1640,648 +1638,649 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nGenere los archivos necesarios para un proyecto Sphinx.\n\nsphinx-quickstart es una herramienta interactiva que hace algunas preguntas sobre su\nproyecto y luego genera un directorio completo de documentación y un ejemplo del archivo\nMakefilepara ser utilizado con el comando sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "modo silencioso"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "raíz del proyecto"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Opciones de estructura"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "si se especifica, separe los directorios de fuentes y de compilación"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
-msgstr ""
+msgstr "si se especifica, cree un directorio de compilación en el directorio de origen"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "reemplazo para punto en _templates, etc."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Opciones básicas del proyecto"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "nombre del proyecto"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "autores"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "versión del proyecto"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "liberación del proyecto"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "lenguaje del documento"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "sufijo de archivo fuente"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "nombre de documento maestro"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "usar epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Opciones de extensión"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "habilitada extensión %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "habilitar extensiones arbitrarias"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "creación del Makefile y Batchfile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "crear makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "no crear makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "crear batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "no crear batchfile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "use el modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "no use el modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Plantillas de proyecto"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "directorio de plantillas para archivos de plantillas"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "definir una variable de proyceto"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "se especifica \"quiet\", pero no se especifica ninguno de \"project\" o \"author\"."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Error: la ruta especificada no es un directorio, o ya existen archivos sphinx."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart solo se genera en un directorio vacío. Por favor, especifique una nueva ruta raíz."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variable de plantilla inválida: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
-msgstr ""
+msgstr "no espacios en blanco eliminados por identado"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Subtítulo inválido: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "la especificación del número de línea está fuera de range(1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "No puede utilizar ambas opciones \"%s\" y \"%s\""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Archivo incluido %r no encontrado o la lectura del mismo fallo"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Codificación %r usado para la lectura archivo incluido %r parece estar mala, trate de darle una opción :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objeto nombrado %r no encontrado en el archivo incluido %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "No puede utilizar a \"lineno-match\" con un conjunto desunido de \"líneas\""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Línea especifico %r: sin líneas tiradas desde el archivo incluido %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
-msgstr ""
+msgstr "patrón global toctree %r no coincide con ningún documento"
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree contiene referencia al documento excluido %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree contiene referencias a documentos inexistentes %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
-msgstr ""
+msgstr "entrada duplicada encontrada en toctree: %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor de la sección: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor del módulo: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Código del autor: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
-msgstr ""
+msgstr ".. contenido de los reconocimientos no es una lista"
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
-msgstr ""
+msgstr ".. hlist contenido no es una lista"
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
-msgstr ""
+msgstr "\":file:\" La opción para la directiva csv-table ahora reconoce una ruta absoluta como una ruta relativa desde el directorio de origen. Actualice su documento."
 
 #: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
-msgstr ""
+msgstr "Declaración de C duplicada, también definida en %s:%s.\nLa declaración es '.. c:%s:: %s'."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
-msgstr ""
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parámetros"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
-msgstr ""
+msgstr "Valores devueltos"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Devuelve"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Tipo del valor devuelto"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "miembro"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variable"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "función"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
-msgstr ""
+msgstr "estructura"
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "unión"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumeración"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
-msgstr ""
+msgstr "parámetro de función"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nuevo en la versión %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Distinto en la versión %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsoleto desde la versión %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citación duplicada %s, otra instancia en %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Citación %s no está referenciada."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
-msgstr ""
+msgstr "Declaración de C++ duplicada, también definida en %s:%s.\nLa declaración es '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parametros de Plantilla"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Lanzamientos"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "clase"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "concepto"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
-msgstr ""
+msgstr "parámetro de plantilla"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (función incorporada)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (método de %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (clase)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variable global o constante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atributo de %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumentos"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (módulo)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "método"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dato"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "módulo"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "duplicada %s descripción de %s, otra %s en %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "etiqueta duplicada de la ecuación %s, otra instancia en %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "No válido math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "palabra clave"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objeto"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "excepción"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "sentencia"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "función incorporada"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variables"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Muestra"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (en el módulo %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (en el módulo %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variable incorporada)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (clase incorporada)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (clase en %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (método de clase de %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (método estático de %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (%s propiedad)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Índice de Módulos Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "módulos"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Obsoleto"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "método de la clase"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "método estático"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
-msgstr ""
+msgstr "propiedad"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "descripción duplicada del objeto de %s, otra instancia en %s, utilice :noindex: para uno de ellos"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "se encontró más de un objetivo para la referencia cruzada %r: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (obsoleto)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directiva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (opción directiva)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "directiva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "directive-option"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "descripción duplicada de %s %s, otra instancia en %s"
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "variables de entorno; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Descripción de la opción con formato incorrecto %r, debe verse como \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" o \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
-msgstr "%sopción de línea de comando "
+msgstr "opción de línea de comando %s"
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "opción de línea de comando"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "el término del glosario debe ir precedido de una línea vacía"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "los términos del glosario no deben estar separados por líneas vacías"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "el glosario parece estar mal formateado, verifique la sangría"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "termino de glosario"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "gramática simbólica"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "etiqueta de referencia"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "variables de entorno"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opción de programa"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "documento"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Índice de Módulos"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Página de Búsqueda"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "etiqueta duplicada %s, otra instancia en %s"
@@ -2291,142 +2290,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "duplicada %s descripción de %s, otra instancia en %s"
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig está deshabilitado. :numref: se ignora."
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
-msgstr ""
+msgstr "Error al crear una referencia cruzada. No se asigna ningún número: %s"
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "el enlace no tiene subtítulo: %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "inválido numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "inválido numfig_format: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr ""
+msgid "undefined label: %r"
+msgstr "etiqueta indefinida: %r"
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr ""
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr "No se pudo crear una referencia cruzada. Un título o subtítulo no encontrado: %r"
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "nueva configuración"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "configuración modificada"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "extensiones modificadas"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "la versión del entorno de compilación no es actual"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "directorio fuente ha cambiado"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Este entorno es incompatible con el generador seleccionado, elija otro directorio doctree."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Error al escanear los documentos en %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Dominio %r no está registrado"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "toctree auto referenciado encontrado. Ignorado."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "documento no está incluido en ningún toctree"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "ver %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "ver también %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "tipo de entrada de índice desconocido %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Símbolos"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "referencias circulares de toctree detectadas, ignorando: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree contiene una referencia al documento %r que no tiene título: no se generará ningún enlace"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr "el árbol de la tabla de contenido contiene una referencia a un documento no incluido %r"
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
-msgstr "archivo de imagen no legible:%s"
+msgstr "archivo de imagen no legible: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "archivo de imagen %s no legible: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "el archivo de descarga no es legible: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s ya tiene asignados números de sección (¿número de árbol anidado?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "Debería crear archivo %s."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2438,209 +2442,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nMire recursivamente en <MODULE_PATH> para módulos y paquetes de Python y cree\nun archivo reST con directivas automodule por paquete en el <OUTPUT_PATH>.\n\nLos <EXCLUDE_PATTERN>s pueden ser patrones de archivo y/o directorio que serán\nexcluidos de la generación.\n\nNota: Por defecto, este script no sobrescribirá los archivos ya creados."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "ruta al módulo al documento"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "archivo de estilo fnmatch y/o patrones de directorio para excluir de la generación"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "directorio para colocar toda la salida"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "rofundidad máxima de submódulos para mostrar en la tabla de contenido (predeterminado: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "sobreescribir archivos existentes"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "seguir enlaces simbólicos. Potente cuando se combina con el paquete collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "ejecutar la rutina sin crear archivos"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "poner documentación para cada módulo en su propia página"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "incluir \"_private\" en módulos"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "nombre de archivo de la tabla de contenido (predeterminado: módulos)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "no crear un archivo de tabla de contenido"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
-msgstr "no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación \"docstrings\" ya los contienen)"
+msgstr "no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación docstrings ya los contienen)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "poner la documentación del módulo antes de la documentación del submódulo"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpretar las rutas del módulo de acuerdo con la especificación de espacios de nombres implícitos en la PEP-0420"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "sufijo de archivo (por defecto: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "generar un proyecto completo con sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "agregue module_path al sys.path, que se usa cuando se da el parámetro --full"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "nombre del proyecto (predeterminado: nombre del módulo raíz)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "autor(es) del proyecto, utilizado cuando se da el parámetro --full"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "versión del proyecto, utilizado cuando se da el parámetro --full"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "lanzamiento del proyecto, utilizado cuando se da el parámetro --full, por defecto es --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "opciones de extensión"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s no es un directorio."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "expresiones regulares inválidas %r en %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Pruebas de cobertura en las fuentes terminadas, mira los resultados en %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "expresiones regulares inválidas %r en coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
-msgstr ""
+msgstr "api c indocumentado: %s %s en archivo %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "el módulo %s no podía ser importado: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
-msgstr ""
+msgstr "función python indocumentada: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
-msgstr ""
+msgstr "clase python indocumentada: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
-msgstr ""
+msgstr "método python indocumentado: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "falta '+' o '-' en la opción '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' no es una opción válida."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' no es una opción pyversion válida"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "tipo de TestCode inválido"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Prueba de doctests en las fuentes terminadas, mira los resultados en %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "sin código/salida en el bloque %s en %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "ignorando el código doctest no válido: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== duraciones de lectura más lentas ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
-msgstr ""
+msgstr "enlace codificado %r podría reemplazarse por un enlace externo (intente usar %r en su lugar)"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Directiva Graphviz no puede tener tanto el contenido y un argumento de nombre de archivo"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Archivo externo Graphviz %r no encontrado o la lectura del mismo fallo"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorando la directiva \"graphviz\" sin contenido."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2650,14 +2659,14 @@
 "%r"
 msgstr "dot no produjo un archivo de salida:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "comando dot %r no se puede ejecutar (necesarios para la salida de graphviz), Compruebe la configuración de graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2667,33 +2676,35 @@
 "%r"
 msgstr "dot salió con error:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "el valor del parámetro graphviz_output_format debe ser uno de 'png', 'svg', pero es %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot código %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "gráfica: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "gráfica"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %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"
+"\n"
+"Traceback: %s"
+msgstr "No se puede ejecutar el comando de conversión de imagen %r. 'sphinx.ext.imgconverter' requiere ImageMagick por defecto. Asegúrese de que esté instalado o configure la opción 'image_converter' a un comando de conversión personalizado.\n\nRastrear: %s"
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2703,163 +2714,173 @@
 "%r"
 msgstr "convert salió con error:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr "el comando convert %r no puede ejecutar, compruebe el valor  de configuración image_converter"
+msgstr "el comando convert %r no puede ejecutar, compruebe el valor de configuración image_converter"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "comando LaTeX %r no se puede ejecutar (necesario para la visualización matemática), compruebe la configuración de imgmath_latex"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
-msgstr "El comando%s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s"
+msgstr "comando %s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "visualizar latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "en línea latex %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Enlace permanente a esta ecuación"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "el inventario intersphinx se ha movido: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "cargando inventario intersphinx desde %s..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "encontró algunos problemas con algunos de los inventarios, pero tenían alternativas de trabajo:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "no se pudo llegar a ninguno de los inventarios con los siguientes problemas:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(en %s versión %s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(en %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr "inventario para referencia cruzada externa no encontrado: %s"
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr "rol para referencia cruzada externa no encontrado: %s"
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "%s externo: destino de referencia %s no encontrado: %s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "el identificador de intersphinx %r no es una cadena. Ignorado"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "Error al leer intersphinx_mapping%s, ignorado: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "fuente"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Por hacer"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Marca TODO encontrada: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<entrada original>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
-msgstr "(La  <<entrada original>> se encuentra en %s, línea %d.)"
+msgstr "(La <<entrada original>> se encuentra en %s, línea %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "entrada original"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
-msgstr "resaltando el código del módulo..."
+msgstr "resaltando el código del módulo... "
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "documentos"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Código de módulo"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Código fuente para %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Resumen: código de modulo"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Todos los módulos para los cuales disponen código</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
-msgstr ""
+msgstr "valor no válido para la opción de pedido de miembro: %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
-msgstr ""
+msgstr "valor no válido para la opción class-doc-from: %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "firma inválida para auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "error al formatear argumentos para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "falta el atributo %s en el objeto %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc: no pudo determinar %s.%s (%r) para ser documentado, se planteó la siguiente excepción:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2867,168 +2888,167 @@
 "explicit module name)"
 msgstr "no sabe qué módulo importar para el autodocumento %r (intente colocar una directiva \"module\" o \"currentmodule\" en el documento o dar un nombre explícito al módulo)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
-msgstr ""
+msgstr "Se detecta un objeto simulado: %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
-msgstr ""
+msgstr "error al formatear la firma para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" en el nombre del automodule no tiene sentido"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "argumentos de firma o anotación de retorno dada para automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ debe ser una lista de cadenas, no %r (en el módulo %s) -- ignorando __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
-msgstr ""
+msgstr "atributo faltante mencionado en la :members: módulo %s, atributo %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
-msgstr ""
+msgstr "Error al obtener una firma de función para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
-msgstr ""
+msgstr "Error al obtener una firma de constructor para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Bases: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "falta el atributo %s en el objeto %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
-msgstr ""
+msgstr "alias de %s"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
-msgstr ""
+msgstr "alias de TypeVar(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
-msgstr ""
+msgstr "Error al obtener una firma de método para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
-msgstr ""
+msgstr "Se encontraron __slots__ no válidas en %s. Ignorado."
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
-msgstr ""
+msgstr "Error al analizar un valor de argumento predeterminado para %r: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
-msgstr ""
+msgstr "Error al actualizar la firma para %r: parámetro no encontrado: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "Error al analizar type_comment para %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "referencias autosummary excluidas documento %r. Ignorado."
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: no se encontró el archivo stub %r. Verifique su configuración de autosummary_generate."
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
-msgstr ""
+msgstr "Un resumen automático con subtítulos requiere la opción :toctree: ignorado."
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "autosummary: no se pudo importar %s.\nPosibles pistas:\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "fallo al analizar el nombre %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "fallo al importar el objeto %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: archivo no encontrado: %s"
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary genera archivos .rst internamente. Pero su source_suffix no contiene archivo .rst. Saltado."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary generar autosummary para: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary escribiendo a %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "autosummary no se pudo importar %s.\nPosibles pistas:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3043,138 +3063,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nGenere ReStructuredText usando directivas de resumen automático \"autosummary\".\n\nsphinx-autogen es una interfaz para sphinx.ext.autosummary.generate. Genera\nlos archivos reStructuredText de las directivas autosummary contenidas en el\nlos archivos de entrada dados.\n\nEl formato de la directiva autosummary está documentado en el módulo Python\n``sphinx.ext.autosummary`` y se puede leer usando el siguiente comando::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "archivos fuente para generar archivos rST para"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "directorio para colocar toda la salida en"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "sufijo predeterminado para archivos (predeterminado: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "directorio de plantillas personalizadas (predeterminado: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "documento importados miembros (predeterminado: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
-msgstr ""
+msgstr "documentar exactamente los miembros en module __all__ attribute. (por defecto: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumentos de palabras clave"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Ejemplo"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Ejemplos"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Notas"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Otros parámetros"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
-msgstr ""
+msgstr "Recibe"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Referencias"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Avisos"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "Campos"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
-msgstr ""
+msgstr "conjunto de valores no válidos (falta la llave de cierre): %s"
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
-msgstr ""
+msgstr "conjunto de valor no válido (falta llave de apertura): %s"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
-msgstr ""
+msgstr "literal de cadena con formato incorrecto (falta la comilla de cierre): %s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
-msgstr ""
+msgstr "literal de cadena con formato incorrecto (falta la comilla de apertura): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Atención"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Prudencia"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Peligro"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Error"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Consejo"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Ver también"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Truco"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Advertencia"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "proviene de la página anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "continué en la próxima página"
@@ -3196,7 +3216,7 @@
 msgid "Table of Contents"
 msgstr "Tabla de contenido"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Búsqueda"
@@ -3277,40 +3297,40 @@
 msgid "Navigation"
 msgstr "Navegación"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Buscar en %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Sobre este documento"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Derechos de autor</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Derechos de autor %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Actualizado por última vez en %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr ""
+msgstr "Creado usando <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s."
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
@@ -3350,12 +3370,12 @@
 msgstr "buscar"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Resultados de la búsqueda"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3397,280 +3417,278 @@
 msgid "Other changes"
 msgstr "Otros cambios"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Enlazar permanentemente con este título"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Enlazar permanentemente con esta definición"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Ocultar coincidencias de la búsqueda"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "Búsqueda finalizada, se encontraron ${resultCount} páginas que coinciden con la consulta de búsqueda."
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Buscando"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Preparando búsqueda..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Búsqueda finalizada, encontró %s página(s) acorde con la consulta de búsqueda."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", en "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Expandir barra lateral"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Ocultar coincidencias de la búsqueda"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Contraer barra lateral"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Expandir barra lateral"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Contenidos"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "Índice basado en 4 columnas encontrado. Puede ser un error de extensiones que usted usa: %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Pie de página %s no está referenciado."
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "Pie de página # no está referenciado."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referencias de pie de página inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referencias inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referencias de citas inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referencias de término inconsistentes en el mensaje traducido. original: {0}, traducido: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
-msgstr ""
+msgstr "No se pudo determinar el texto alternativo para la referencia cruzada. Podría ser un error."
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "más de un objetivo destino encontrado para 'cualquier' referencia cruzada %r: podría ser %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
-msgstr ""
+msgstr "%s:%s objetivo de referencia no encontrado: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
-msgstr ""
+msgstr "%r objetivo de referencia no encontrado: %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "No se pudo recuperar la imagen remota: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "No se pudo recuperar la imagen remota: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Formato de imagen desconocido: %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "caracteres fuente no codificables, reemplazando con \"?\": %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "omitido"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "fallado"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
-msgstr ""
+msgstr "Problema en el dominio %s: se supone que el campo debe usar el rol '%s', pero ese rol no está en el dominio."
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
-msgstr ""
+msgstr "directiva desconocida o nombre de rol: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "tipo de nodo desconocido: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "leyendo error: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "escribiendo error: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
-msgstr ""
+msgstr "locale_dir %s no existe"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Formato de fecha inválido. Cite la cadena con comillas simples si desea generarla directamente: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree contiene referencia al archivo inexistente %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "excepción al evaluar solamente la expresión directiva: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "rol por defecto %s no encontrado"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Enlazar permanentemente con esta definición"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format no está definido para %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Cualquier ID no asignado para el nodo %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
-msgstr ""
+msgstr "Enlace permanente a este término"
+
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "Enlace permanente a este encabezado"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Enlace permanente a esta tabla"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Enlace permanente a este código fuente"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Enlace permanente a esta imagen"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Enlace permanente a la tabla de contenidos"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "No se pudo obtener el tamaño de la imagen. La opción :scale: se ignora."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "desconocida %r toplevel_sectioning para la clase %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr "demasiado grande :maxdepth:, ignorado."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
-msgstr "El título del documento no es un nodo de texto único"
+msgstr "título del documento no es un nodo de Texto único"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "no se encontró el nodo de título en la sección, tema, tabla, advertencia o barra lateral"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Notas a pie de página"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "ambas columnas tabulares y la opción :widths: se dan. La opción :widths: se ignora."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "la unidad de dimensión %s no es válida. Ignorado."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "tipo de entrada de índice desconocido %s encontrado"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "imagen: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "imagen"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "subtítulo no dentro de una figura."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "tipo de nodo no implementado: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/et/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/et/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "J\u00e4rgmine teema",
         "Other changes": "\u00dclej\u00e4\u00e4nud muutused",
         "Overview": "\u00dclevaade",
-        "Permalink to this definition": "P\u00fcsiviit sellele definitsioonile",
-        "Permalink to this headline": "P\u00fcsiviit sellele pealkirjale",
         "Please activate JavaScript to enable the search\n    functionality.": "Otsingu v\u00f5imaldamiseks tuleb aktiveerida JavaScript.",
         "Preparing search...": "Otsingu ettevalmistamine...",
         "Previous topic": "Eelmine teema",
@@ -39,7 +37,7 @@
         "Search": "Otsing",
         "Search Page": "Otsinguleht",
         "Search Results": "Otsingu tulemused",
-        "Search finished, found %s page(s) matching the search query.": "Otsingu tulemusena leiti %s leht(e).",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Otsi %(docstitle)s piires",
         "Searching": "Otsimine",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/et/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/et/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/et/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/et/LC_MESSAGES/sphinx.po Changed

@@ -1,144 +1,144 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
 # Aivar Annamaa <aivar.annamaa@gmail.com>, 2011
 # Ivar Smolin <okul at linux ee>, 2012
-# Ivar Smolin <okul@linux.ee>, 2013-2021
+# Ivar Smolin <okul@linux.ee>, 2013-2022
 # Luc Saffre <luc.saffre@gmail.com>, 2015
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Ivar Smolin <okul@linux.ee>, 2013-2022\n"
 "Language-Team: Estonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/et/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: et\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Lähtekataloogi (%s) pole võimalik leida"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "Väljundkataloog (%s) ei ole kataloog"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Lähtekataloog ja sihtkataloog ei tohi olla identsed"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s käitamine"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "See projekt vajab vähemalt Sphinxi v%s ja seetõttu pole projekti võimalik käesoleva versiooniga ehitada."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "väljundkataloogi loomine"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "tõlgete laadimine %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "valmis"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "serialiseeritud keskkonna laadimine"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "tõrge: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Ehitajat pole valitud, kasutatakse vaikimisi ehitajat: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "oli edukas"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "lõppes probleemidega"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "ehitamine %s, %s hoiatus."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "ehitamine %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +146,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "laiendus %s pole rööbiti lugemiseks turvaline"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +159,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "laiendus %s pole rööbiti kirjutamiseks turvaline"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "seadistuste kataloog (%s) ei sisalda faili conf.py"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "vigane arv %r seadistuse väärtusele %r, eiratakse"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Puudub määratud seadistusväärtus: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Seadistuste väärtus %r on juba olemas"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Sinu seadistusfailis on süntaksi viga: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Seadistusfail (või mõni selle poolt imporditud moodulitest) kutsus välja sys.exit()"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,898 +230,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Sektsioon %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Joonis %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabel %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Nimekiri %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r ei leitud, eiratakse."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
-msgstr ""
+msgstr "Sündmus %r on juba olemas"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
-msgstr ""
+msgstr "Tundmatu sündmuse nimi: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "needs_extensions sätted nõuavad laiendust %s, kuid see pole laaditud."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, 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 "See projekt vajab laiendust %s vähemalt versiooniga %s ja seetõttu pole projekti võimalik laaditud versiooniga (%s) ehitada."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "dokument pole loetav ja seda eiratakse."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Ehitaja klassil %s puudub atribuut \"name\""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Ehitaja %r on juba olemas (moodulis %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Ehitajat nimega %s pole registreeritud"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domeen %s on juba registreeritud"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domeen %s pole veel registreeritud"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser on %r jaoks juba registreeritud"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Lähtekoodi analüsaatorit pole %s jaoks registreeritud"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Algne erind:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Laiendust %s pole võimalik importida"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "erindil %r puudub funktsioon setup(); kas see on päriselt Sphinxi laiendusmoodul?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Pythoni täiustusettepanekud; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "teemal %r puudub \"theme\" säte"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "teemal %r puudub \"inherit\" säte"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "fail %r teemarajal pole korrektni zip-fail või ei sisalda see teemat"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "teemat nimega %r ei leitud (kas theme.conf on puudu?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "ehitamine mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "väljundi kirjutamine... "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "%d määratud po-faili sihtfailid"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "%d po-faili sihtfailid on aegunud"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "kõik lähtefailid"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d lähtefaili sihtfailid on aegunud"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "ehitamine %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "praeguseks aegunud failide otsimine... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "leitud %d"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "ei leitud"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "kooskõla kontrollimine"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "aegunud sihtfaile pole"
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "keskkonna uuendamine:"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "lisatud %s, muudetud %s, eemaldatud %s"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "lähtefailide lugemine..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "dokumentide ettevalmistamine"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "kujutiste kopeerimine... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "kujutise faili %r pole võimalik kopeerida: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "kujutise faili %r pole võimalik kirjutada: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "faili %s kirjutamine..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Ülevaatefail asub kataloogis %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "versioonis %s pole muutusi."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "kokkuvõttefaili kirjutamine..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Sisseehitatud"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Mooduli tase"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "lähtefailide kopeerimine..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "vigane css_file: %r, eiratakse"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Sõnumikataloogid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d mallifaili sihtfailid"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "mallide lugemine... "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "sõnumikataloogide kirjutamine... "
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Otsi vigu ülalolevast väljundist või failist %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Juhendi lehed asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "seadistusparameetrit \"man_pages\" ei leitud, juhendi lehti ei kirjutata"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "seadistusparameeter \"man_pages\" viitab tundmatule dokumendile %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML-leht asub kataloogis %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "täiendavate failide kirjutamine"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "seadistusparameetrit \"texinfo_documents\" ei leitud, dokumente ei kirjutata"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "seadistusparameeter \"texinfo_documents\" viitab tundmatule dokumendile %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "viidete lahendamine..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (pealkirjas "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "Texinfo tugifailide kopeerimine"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "viga faili Makefile kirjutamisel: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Tekstifailid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "viga faili %s kirjutamisel: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML-failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "PseudoXML-failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML-lehed asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Viga ehitamise infofaili lugemisel: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d. %b %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Üldindeks"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indeks"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "järgmine"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "eelmine"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "indeksite genereerimine"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "täiendavate lehtede kirjutamine"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "allalaaditavate failide kopeerimine..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "staatilist faili %r pole võimalik kopeerida"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "lisafailide kopeerimine"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "lisafaili %r pole võimalik kopeerida"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Viga ehitamise infofaili kirjutamisel: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, 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 "lehe %s renderdamisel tekkis Unicode viga. Palun veendu, et kõik mitte-ASCII sisuga seadistusparameetrid on kirjeldatud Unicode stringidena."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "otsinguindeksi tõmmise kirjutamine keelele %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "vigane js_file: %r, eiratakse"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path kirjet %r pole olemas"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path kirje %r asub väljaspool väljundkataloogi"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "logofaili %r pole olemas"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon faili %r pole olemas"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentatsioon"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeX-failid asuvad kataloogis %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nNende jooksutamiseks läbi (pdf)latex programmi käivita selles kataloogis\n'make' (selle automaatseks tegemiseks kasuta `make latexpdf')."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "seadistusparameetrit \"latex_documents\" ei leitud, dokumente ei kirjutata"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "seadistusparameeter \"latex_documents\" viitab tundmatule dokumendile %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Redaktsioon"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1124,94 +1126,94 @@
 msgid "copying TeX support files"
 msgstr "TeX-i tugifailide kopeerimine"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "TeX-i tugifailide kopeerimine..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "lisafailide kopeerimine"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "Katkestatud!"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Rekursiooni viga:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Kui see oli kasutaja viga, siis anna palun sellest teada, et tulevikus oleks võimalik parem veateade väljastada."
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Vearaportit on võimalik esitada träkkeris aadressil <https://github.com/sphinx-doc/sphinx/issues>. Aitäh!"
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,35 +1232,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "dokumentatsiooni lähtefailide rada"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "väljundkataloogi rada"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "määratud failide uuestiehitamine. Võtme -a korral eiratakse"
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "üldsuvandid"
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "kasutatav ehitaja (vaikimisi: html)"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "kõikide failide kirjutamine (vaikimisi kirjutatakse ainult uued ja muutunud failid)"
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "salvestatud keskkonda ei kasutata, alati loetakse kõik failid"
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1304,7 +1306,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1340,161 +1342,156 @@
 msgid "run Pdb on exception"
 msgstr "erindi korral Pdb käivitamine"
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "faile %r pole võimalik leida"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "suvandit -a ja failinimesid pole võimalik kombineerida"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "hoiatuste faili %r pole võimalik avada: %s"
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "-D suvandi argument peab olema vormingus nimi=väärtus"
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "-A suvandi argument peab olema vormingus nimi=väärtus"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "moodulite dokumentatsioonistringide automaatne lisamine"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "dokumentatsioonistringides olevate koodijuppide automaattestimine"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "eri projektide Sphinx-dokumentatsiooni omavaheline viitamine"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "\"teha\" sissekannete kirjutamine, mida võib ehitamisega peita või näidata"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "dokumentatsiooni katvuse kontrollid"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "matemaatika kaasamine, mis renderdatakse PNG- või SVG-kujutisteks"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "matemaatika kaasamine, mis renderdatakse veebisirvikus MathJax-i abil"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "sisu tingimuslik kaasamine seadistusparameetrite alusel"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "dokumenteeritud Python-objektide lähtekoodile viitamise kaasamine"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ".nojekyll faili loomine dokumentide avaldamiseks GitHub-i lehtedel"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Palun sisesta mingi tekst."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Palun sisesta kas 'y' või 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Tere tulemast kasutama Sphinx %s lendstardi utiliiti."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Palun sisesta väärtused järgnevate sätete jaoks (kandiliste sulgude vahel\nvõib olla vaikeväärtus, millega nõustumiseks vajuta lihtsalt Enter)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Valitud juurkataloog: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Viga: valitud juurkataloogist leiti olemasolev conf.py."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart ei kirjuta olemasolevaid Sphinx-projekte üle."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Palun sisesta uus juurkataloog (või vajuta Enter lõpetamiseks)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Sphinx'i väljundi ehitamise kataloogi asetamiseks on kaks valikut.\nVõid kasutada kataloogi \"_build\" juurkataloogis või eraldiseisvaid \n\"source\" ja \"build\" katalooge juurkataloogis."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Lähtekoodi ja ehitamise kataloogide eraldamine (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Mallide ja staatilise kataloogi nime eesliide"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Projekti nimi"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Autorite nimed"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1503,15 +1500,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Projekti versioon"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Projekti väljalase"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1521,21 +1518,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Projekti keel"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Lähtefaili järelliide"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1540,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Sinu põhidokumendi nimi (ilma järelliiteta)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Viga: valitud juurkataloogist leiti peafail %s."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart ei kirjuta olemasolevat faili üle."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Palun sisesta uus failinimi või nimeta olemasolev fail ümber ja vajuta Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Märkus: imgmath ja mathjax ei saa korraga lubatud olla. imgmath eemaldati valikust."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Kas luua Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Kas luua Windowsi käsufail? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Faili %s loomine."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Fail %s on juba olemas ja jäetakse vahele."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Lõpetamine: Algne kataloogistruktuur on loodud."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Sa peaks nüüd asustama oma peafaili %s ja looma ülejäänud dokumentatsiooni\nlähtefailid. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Dokumentide ehitamiseks kasuta Makefile, näiteks:\n   make ehitaja"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Dokumentide ehitamiseks kasuta käsku sphinx-build, näiteks:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "kus \"ehitaja\" on üks toetatud ehitajatest, nt. html, latex või linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,230 +1634,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nSphinx-projekti jaoks vajalike failide genereerimine.\n\nsphinx-quickstart on interaktiivne tööriist, mis küsib mõned küsimused Sinu\nprojekti kohta ja seepeale genereerib täieliku dokumentatsioonikataloogi ning\nnäidis-Makefile kasutamiseks koos sphinx-buildiga.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "vaikne režiim"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Struktuuri suvandid"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "kasutamise korral eraldatakse lähtefailide ja ehitamise kataloogid"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Projekti põhisuvandid"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "projekti nimi"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "autorite nimed"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "projekti versioon"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "projekti väljalase"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "dokumendi keel"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "lähtefaili järelliide"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "põhidokumendi nimi"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Laienduste suvandid"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "laienduse %s lubamine"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "suvaliste laienduste määramine"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile ja Batchfile loomine"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "makefile loomine"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "makefile loomata jätmine"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "batchfile loomine"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "batchfile loomata jätmine"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Projekti loomine mallist"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "mallifailide kataloog"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "malli muutuja kirjeldamine"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Vigane mallimuutuja: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Vigane selgitustekst: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Suvandeid \"%s\" ja \"%s\" pole võimalik korraga kasutada"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Sektsiooni autor: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Mooduli autor: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Koodi autor: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1871,559 +1868,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parameetrid"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Tagastab"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Tagastustüüp"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "liige"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "muutuja"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funktsioon"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "loend"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tüüp"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "funktsiooni parameeter"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Uus versioonis %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Muudetud versioonis %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Iganenud alates versioonist %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Malli parameetrid"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klass"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (sisseehitatud funktsioon)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s meetod)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klass)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globaalmuutuja või konstant)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atribuut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumendid"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (moodul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "meetod"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "andmed"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribuut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "moodul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "võrrandil %s on topeltsilt, teine instants on %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Vigane math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "võtmesõna"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operaator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "erind"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "lause"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "sisseehitatud funktsioon"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Muutujad"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (moodulis %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (moodulis %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (sisseehitatud muutuja)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (sisseehitatud klass)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klass moodulis %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (klassi %s meetod)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s staatiline meetod)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Pythoni moodulite indeks"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moodulid"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Iganenud"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klassi meetod"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "staatiline meetod"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (iganenud)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiiv)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (roll)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktiiv"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "roll"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "keskkonnamuutuja; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s käsureasuvand"
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "käsureasuvand"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "sõnastiku termin"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "grammatika märk"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "viite silt"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "keskkonnamuutuja"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programmi suvand"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Mooduli indeks"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Otsinguleht"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "vigane numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "vigane numfig_format: %s"
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "See keskkond pole valitud ehitajaga ühilduv, palun vali mõni teine dokumendipuu kataloog."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "dokument pole ühegi sisukorrapuu osa"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "vaata %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "vaata ka %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Sümbolid"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "kujutise fail pole loetav: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "kujutise fail %s pole loetav: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2438,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "laienduse suvandid"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s pole kataloog."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Lähtefailide katvustestimine on lõppenud, vaata tulemusi failist %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "vigane TestCode tüüp"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Lähtefailide doctest-testimine on lõppenud, vaata tulemusi failist %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "vigase doctest koodi eiramine: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Graphviz direktiivil ei tohi samaaegselt olla argumendid content ja filename"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Välist Graphviz-faili %r ei leitud või esines tõrge selle lugemisel"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ilma sisuta \"graphviz\" direktiivi eiramine."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2655,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot käsku %r pole võimalik käivitada (vajalik graphvizi väljundi jaoks), kontrolli graphviz_dot sätteid"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2672,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format peab olema kas 'png' või 'svg', kuid mitte %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "joonis: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "joonis"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2710,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Püsiviit sellele võrrandile"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(projektis %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "lähtekood"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Teha"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Leitud TEHA kirje: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<algne kirje>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<algne kirje>> asub failis %s, real %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "algne kirje"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumentatsioon"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Mooduli kood"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s lähtekood</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Ülevaade: mooduli kood"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Kõik lähtekoodiga moodulid</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2884,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Põlvnemine: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +2997,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "tõrge objekti %s importimisel"
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary automaatkokkuvõtte genereerimine failile: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary kirjutamine kataloogi %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3044,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3059,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "lähtefailid, mille kohta rST-faile genereerida"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "väljundfailide kataloog"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "failide vaikimisi järelliide (vaikimisi: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "kohandatud mallide kataloog (vaikimisi: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "imporditud liikmete dokumenteerimine (vaikimisi: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Võtmesõnadega argumendid"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Näide"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Näited"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Märkused"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Tähelepanu"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Ettevaatust"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Oht"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Viga"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Vihje"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Tähtis"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Märkus"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Vaata ka"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Nõuanne"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Hoiatus"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "jätk eelmisele leheküljele"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "jätkub järgmisel leheküljel"
@@ -3193,7 +3212,7 @@
 msgid "Table of Contents"
 msgstr "Sisukorratabel"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Otsing"
@@ -3274,35 +3293,35 @@
 msgid "Navigation"
 msgstr "Navigatsioon"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Otsi %(docstitle)s piires"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Info selle dokumentatsiooni kohta"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Autoriõigus"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Autoriõigused</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Autoriõigused %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Viimati uuendatud %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3366,12 @@
 msgstr "otsi"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Otsingu tulemused"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,280 +3413,278 @@
 msgid "Other changes"
 msgstr "Ülejäänud muutused"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Püsiviit sellele pealkirjale"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Püsiviit sellele definitsioonile"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Varja otsingu tulemused"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Otsimine"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Otsingu ettevalmistamine..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Otsingu tulemusena leiti %s leht(e)."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Näita külgriba"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Varja otsingu tulemused"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Varja külgriba"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Näita külgriba"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Sisukord"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Tundmatu pildivorming: %s..."
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "viga lugemisel: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "viga kirjutamisel: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Püsiviit sellele definitsioonile"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Püsiviit sellele tabelile"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Püsiviit sellele programmikoodile"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Püsiviit sellele pildile"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Püsiviit sellele sisukorrapuule"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: on liiga suur ja seda eiratakse."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Joonealused märkused"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "pilt: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "pilt"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eu/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/eu/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Hurrengo gaia",
         "Other changes": "Beste aldaketak",
         "Overview": "Gainbegirada",
-        "Permalink to this definition": "Definizio honetarako esteka iraunkorra",
-        "Permalink to this headline": "Goiburu honetarako esteka iraunkorra",
         "Please activate JavaScript to enable the search\n    functionality.": "Mesedez, gaitu JavaScript-a bilaketa erabili ahal izateko.",
         "Preparing search...": "",
         "Previous topic": "Aurreko gaia",
@@ -39,7 +37,7 @@
         "Search": "Bilatu",
         "Search Page": "Bilaketa orria",
         "Search Results": "Bilaketa emaitzak",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Bilatu %(docstitle)s(e)n",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eu/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/eu/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/eu/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/eu/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Asier Iturralde Sarasola <asier.iturralde@gmail.com>, 2018\n"
 "Language-Team: Basque (http://www.transifex.com/sphinx-doc/sphinx-1/language/eu/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: eu\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Hobekuntza Proposamena; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Modulu maila"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (hemen: "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y %b %d"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indize orokorra"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indizea"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "hurrengoa"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "aurrekoa"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentazioa"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indizea"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Argitalpena"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,35 +1230,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1302,7 +1304,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1338,161 +1340,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Atalaren egilea: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Moduluaren egilea: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Kodearen egilea: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Egilea:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,559 +1866,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametroak"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Itzultzen du"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Itzulketa mota"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "partaidea"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "aldagaia"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funtzioa"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makroa"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "mota"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Berria %s bertsioan"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s bertsioan aldatuta"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s bertsiotik aurrera zaharkituta"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Jaurtitzen du"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klasea"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metodoa)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasea)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (aldagai globala edo konstantea)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atributua)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumentuak"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulua)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metodoa"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "datuak"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atributua"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modulua"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "gako-hitza"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "eragiketa"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objetua"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "salbuespena"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "sententzia"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Aldagaiak"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Goratzen du"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s moduluan)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s moduluan)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasea %s-(e)n)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s klaseko metodoa)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s metodo estatikoa)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python moduluen indizea"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduluak"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Zaharkitua"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klaseko metodoa"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "metodo estatikoa"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (zaharkitua)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rola)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rola"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "inguruneko aldagaia; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "glosarioko terminoa"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "gramatikako token-a"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "erreferentzia etiketa"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "inguruneko aldagaia"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programako aukera"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Moduluen indizea"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Bilaketa orria"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%s ikusi"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "ikusi %s baita ere"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "iturburua"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Egitekoa"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "jatorrizko sarrera"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumentazioa"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Moduluko kodea"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s(r)en iturburu kodea</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Gainbegirada: moduluko kodea"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Kodea eskuragarri duten modulu guztiak</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Adi"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Kontuz"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Arriskua"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Errorea"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Argibidea"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Garrantzitsua"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Oharra"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Ikusi baita ere"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Iradokizuna"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Kontuz"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "aurreko orritik jarraitzen du"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Bilatu"
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr "Nabigazioa"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Bilatu %(docstitle)s(e)n"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Dokumentu hauen inguruan"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Azken aldaketa: %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "bilatu"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Bilaketa emaitzak"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr "Beste aldaketak"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Goiburu honetarako esteka iraunkorra"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Definizio honetarako esteka iraunkorra"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Bilaketa bat-etortzeak ezkutatu"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Alboko barra luzatu"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Bilaketa bat-etortzeak ezkutatu"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Alboko barra tolestu"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Alboko barra luzatu"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Edukiak"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Definizio honetarako esteka iraunkorra"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Oin-oharrak"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "irudia"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fa/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fa/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0645\u0648\u0636\u0648\u0639  \u0628\u0639\u062f\u06cc",
         "Other changes": "\u062f\u06af\u0631 \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a",
         "Overview": "\u0628\u0631\u0631\u0633\u06cc \u0627\u062c\u0645\u0627\u0644\u06cc",
-        "Permalink to this definition": "\u067e\u06cc\u0648\u0646\u062f \u062b\u0627\u0628\u062a \u0628\u0647 \u0627\u06cc\u0646 \u062a\u0639\u0631\u06cc\u0641",
-        "Permalink to this headline": "\u067e\u06cc\u0648\u0646\u062f \u062b\u0627\u0628\u062a \u0628\u0647 \u0627\u06cc\u0646 \u0633\u0631 \u0645\u0642\u0627\u0644\u0647",
         "Please activate JavaScript to enable the search\n    functionality.": "\u0644\u0637\u0641\u0627\u064b \u0628\u0631\u0627\u06cc \u0641\u0639\u0651\u0627\u0644 \u06a9\u0631\u062f\u0646 \u06a9\u0627\u0631\u06a9\u0631\u062f \u062c\u0633\u062a\u062c\u0648\n\u062c\u0627\u0648\u0627 \u0627\u0633\u06a9\u0631\u06cc\u067e\u062a \u0631\u0627 \u0641\u0639\u0651\u0627\u0644 \u06a9\u0646\u06cc\u062f.",
         "Preparing search...": "\u0622\u0645\u0627\u062f\u0647 \u0633\u0627\u0632\u06cc \u062c\u0633\u062a \u0648 \u062c\u0648...",
         "Previous topic": "\u0645\u0648\u0636\u0648\u0639 \u0642\u0628\u0644\u06cc",
@@ -39,7 +37,7 @@
         "Search": "\u062c\u0633\u062a\u062c\u0648",
         "Search Page": "\u0635\u0641\u062d\u0647 \u062c\u0633\u062a\u062c\u0648",
         "Search Results": "\u0646\u062a\u0627\u06cc\u062c \u062c\u0633\u062a\u062c\u0648",
-        "Search finished, found %s page(s) matching the search query.": "\u062c\u0633\u062a\u062c\u0648 \u067e\u0627\u06cc\u0627\u0646 \u06cc\u0627\u0641\u062a \u0648 %s\u0635\u0641\u062d\u0647 \u0646\u062a\u0627\u06cc\u062c \u0645\u0637\u0627\u0628\u0642 \u062c\u0633\u062a\u0627\u0631 \u067e\u06cc\u062f\u0627 \u0634\u062f\u0646.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "\u062c\u0633\u062a\u062c\u0648 \u062f\u0631 %(docstitle)s",
         "Searching": "\u062f\u0631 \u062d\u0627\u0644 \u062c\u0633\u062a \u0648 \u062c\u0648",
         "Searching for multiple words only shows matches that contain\n    all words.": "\u062f\u0631 \u062d\u0627\u0644 \u062c\u0633\u062a\u062c\u0648 \u0628\u0631\u0627\u06cc \u0686\u0646\u062f\u06cc\u0646 \u0648\u0627\u0698\u0647. \u0641\u0642\u0637 \u0648\u0627\u0698\u06af\u0627\u0646\u06cc \u0631\u0627 \u0646\u0634\u0627\u0646 \u0645\u06cc\u200c\u062f\u0647\u062f \u06a9\u0647 \u0634\u0627\u0645\u0644 \u0627\u06cc\u0646 \u0645\u0648\u0627\u0631\u062f \u0628\u0627\u0634\u062f:\n    \u0647\u0645\u0647\u200c\u06cc \u06a9\u0644\u0645\u0647\u200c\u0647\u0627.",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fa/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fa/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fa/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fa/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -11,134 +11,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Hadi F <h_adi_f@yahoo.com>, 2020-2021\n"
 "Language-Team: Persian (http://www.transifex.com/sphinx-doc/sphinx-1/language/fa/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: fa\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "شاخه‌ی منبع(%s) پیدا نشد."
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "نشانی (%s) شاخه نیست"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "شاخه‌های مبدأ و مقصد نمی توانند یکسان باشند"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "اجرای اسفینکس نگارش %s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "این پروژه دست که به افینکس نگارش%s نیاز دارد و برای همین با این نسخه قابل ساخت نیست."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "ایجاد پوشه ی برون داد"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "در حال راه اندازی افزونه‌ی%s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 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' آن طور که در conf.py تعریف شده شیئ قابل فراخوانی پایتون نیست. لطفاً تعریفش را تغییر دهید تا تابع قابل فراخوان پایتون شود. این کار لازمه‌ی conf.py است تا به عنوان افزنه‌ی اسفینکس کار کند."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "بارگذاری ترجمه ها %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "انجام شد"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "برای پیام‌های داخلی در دسترس نیست"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "بارگذاری محیط pckle شده"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "شکست خورد: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "هیچ سازنده‌ای برگزیده نشده، استفاده از قالب خروجی پیش‌فرض: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "موفّقیّت‌آمیز بود"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "انجام شد ولی با مشکل"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "ساخت %s، %s هشدار."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "ساخت %s، %s هشدار."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "ساخت %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "بست کلاس %r در حال حاضر ثبت نام شده است، بازدیدکنندگان این پیوند نادیده گرفته خواهد شد"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "دستور %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "نقش %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +146,12 @@
 "explicit"
 msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای خواندن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "افزونه ی %sبرای خواندن موازی امن نیست"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +159,70 @@
 "explicit"
 msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای نوشتن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "افزونه‌ی %s برای نوشتن موازی امن نیست"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "انجام چندباره‌ی %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "شاخه‌ی پیکربندی(%s)، پرونده‌ی conf.py را ندارد"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته می‌شود (برای تعیین تک تک عناصر %r را به کار ببرید)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته می‌شود"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته می‌شود"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "چنین مقداری برای پیکربندی نبود: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "مقدار پیکربندی %r از قبل موجود است"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "خطای نحوی در پرونده‌ی پیکربندی شما وجود دارد: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "پرونده‌ی پیکربندی (یا یکی از ماژول هایی که وارد می کند)  sys.exit() را فراخواند"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,898 +230,894 @@
 "%s"
 msgstr "یک خطای قابل برنامه ریزی در پرونده‌ی پیکربندی شما وجود دارد:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "مقدار پیکربندی 'source_suffix' انتظار یک رشته، لیست رشته ها، یا فرهنگ لغت را داشت. اما '%r' داده شده است."
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "بخش%s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "شکل %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "جدول %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "فهرست %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "مقدار پیکربندی '{name}' باید یکی از {candidates} باشد، اما '{current}' داده شده."
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، ولی انتظار می‌رفت {permitted} می‌بود."
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، حالت پیش‌فرض {permitted} است."
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "دامنه‌ی اصلی %r یافت نشد، نادیده گرفته می‌شوند."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "از زمان نسخه‌ی ۲ تا به حال، اسفیکنس به صورت پیش فرض از \"index\" به عنوان ریشه‌ی سند(root_doc) استفاده می‌کند. لطفاً \"root_doc = 'contents'\" را به پرونده  conf.py تان اضافه کنید."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "رویداد %r در حال حاضر موجود است"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "نوع اتفاق نامشخّص است: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "مدیر %r برای رویداد %r یک باعث ایراد شد"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "تنظیمات needs_extensions (نیازهای افزونه) افزونه‌ی %s را نیاز دارد، ولی بارگذاری نمی شود."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "این پروژه افزونه‌ی %s (دست کم نسخه‌ی %s) را نیاز دارد، بنابراین نمی تواند با نسخه بارگذاری شده (%s) ساخته شود."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "نام رنگ‌مایه خوان %r شناخته شده نیست"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "امکان خواندن قسمت \"%s\" به عنوان بخش نثل قول ادبی نبود. برجسته کردن آن نادیده گرفته شد."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "برای سند \"%s\": %r پرونده های متعدد یافت شده \nاز %r برای ساخت استفاده کنید."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "سند قابل خواندن نیست. نادیده گرفته شد."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "کلاس سازنده %s هیچ ویژگی‌ای به عنوان \"name\" ندارد"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "سازنده %r در حال حاضر وجود دارد (در پیمانه‌ی %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "نام سازنده %s یا ثبت شده نیست و یا فقط از طریق نقطه ورود در دسترس است"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "نام سازنده %s ثبت نشده است"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "دامنه ی %sپیش تر ثبت شده"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "دامنه %s هنوز ثبت نشده است"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "دستورالعمل %r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "نقش %r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "شاخص %r قبلاً برای دامنه %s ثبت شده"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "نوع شیئ (object_type) %r قبلاً برای دامنه ثبت شده"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "ارجاع متقابل (crossref_type) %r قبلاً ثبت شده"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "پسوند (source_suffix) %r قبلاً ثبت شده است"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "تحلیل‌گر منبع (source_parser) %r قبلاً ثبت شده است"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "تجزیه کننده مبدإ برای %s ثبت نشده است"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "در حال حاضر برای %r مترجم وجود دارد"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "مؤلّفه‌های کلیدی برای تابع add_node() باید تاپل تابعی (بازدید، خروج) باشند: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "بست قابل شمارش (enumerable_node) %r قبلاً ثبت شده است"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "ترسیم‌گر ریاضی %s قبلاً ثبت شده"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "افزونه‌ی %r از نسخه‌ی %s اسفینکس به بعد، در آن ادغام شده؛ بنابراین نادیده گرفته می‌شود."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "ایراد اصلی:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "امکان وارد کردن افزونه‌ی %s نبود"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "افزونه‌ی %r  هیچ تابع setup()ی ندارد؛ آیا این مورد واقعاً یک پیمانه‌ی افزونه‌ی اسفینکس است؟"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "افزونه‌ی %s که در این پروژه استفاده شده دست کم نیازمند اسفینکس نسخه‌ی %s است؛ بنابراین با این نسخه قابل ساخت نیست."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "افزونه‌ی %r شیئ پشتیبانی نشده‌‌ای از تابع setup()ش برگرداند؛ در حالی که می بایست مقدار تهی/هیچ و یا یک دیکشنری فراداده‌ برمی‌گرداند"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "زمینه ی %r فاقد تنظیمات است"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "زمینه‌ی %r تنظیمات به ارث بری ندارد"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "هیچ زمینه‌ای به نام %r پیدا نشد، که با %r جایگزین شود"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "تنظیمات %s. %s در هیچ یک از پیکربندی‌های جستجو شده رخ نمی‌دهد"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "گزینه‌ی پشتیبانی نشده‌ی زمینه %r داده شده"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "پرونده‌ی %r که مسیر زمینه به آن اشاره دارد یا پرونده زیپ معتبری نیست یا هیچ زمینه‌ای درونش ندارد"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "زمینه‌ی خواندن مستندات اسفینکس (< 0.3.0) پیدا شد. از نسخه‌ی ۶/۰ اسفینکس این زمینه‌ دیگر در دسترس نخواهد بود"
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "هیچ زمینه‌ای با نام %r  پیدا نشد(آیا پرونده theme.conf گم شده؟)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "ساخت پرونده‌ی mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "نوشتن برون‌داد... "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "همه‌ی پرونده‌های %d po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "اهداف برای %d پرونده‌های poی که مشخّص شده"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "مقصد‌های %d پرونده‌های poی هستند که منسوخ شده‌اند"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "همه‌ی پرونده‌های منبع"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "پرونده‌ی %r که در خط فرمان داده شده، در شاخه‌ی منبع نیست, نادیده گرفته می‌شود"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "پرونده‌ی %r که در خط فرمان داده شده، وجود ندارد، نادیده گرفته می‌شود"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "پرونده‌های منبع %d داده شده در خط فرمان"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "مقصد‌های %d پرونده‌های منبعی هستند که منسوخ شده‌اند"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "ساخت %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "در پی پرونده‌هایی که الآن منسوخ هستند... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d تا مورد پیدا شد"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "چیزی پیدا نشد"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "بارگذاری محیط pickle شده"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "بررسی ثبات"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "هیچ مقدار تاریخ منسوخ نیست."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "به روز رسانی محیط: "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s اضافه شد، %s تغییر کرد، %s حذف شد"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "خواندن منبع‌ها... "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "در انتظار برای ابزارهای کارگر..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "نام مستندات برای نوشتن: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "آماده سازی اسناد"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "عنوان تکراری در فهرست مطالب پیدا شد:%s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "در حال رونوشت از تصاویر... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "امکان خواندن پرونده‌ی تصویری %r نبود: در عوض کپی می‌شود"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "نمی تواند پرونده‌ی تصویر %r: %s را کپی کند"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "نمی تواند پرونده‌ی تصویری %r: %s را بنویسد"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillow پیدا نشد- رونوشت برداشتن از پرونده‌های تصویری"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "نوشتن پرونده‌های نوع رسانه..."
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "نوشتن پرونده META-INF/container.xml..."
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "نوشتن پرونده‌ی content.opf..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "نوع رسانه‌ی ناشناخته %s، نادیده گرفته شد"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "نوشتن پرونده‌ی خلاصه toc.ncx..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "نوشتن پرونده‌ی %s..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "پرونده‌ی بازبینی در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "بدون تغییرات در نسخه‌ی %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "نوشتن پرونده‌ی خلاصه..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "درونی سازی"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "در سطح ماژول"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "رونوشت از پرونده‌های مبدأ..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "نمی‌توان %r را برای ایجاد گزارش تغییرات خواند"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "سازنده‌ی بدلی هیچ پرونده‌ای تولید نمی کند."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "پرونده‌ی ePub در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "نوشتن پرونده‌ی nav.xhtml..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "مقدار پیکربندی زبان پرونده epub (\"epub_language\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "مقدار پیکربندی شناسه‌ی یکتای انتشار الکترونیکی (\"epub_uid\") باید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) یک XML NAME باشد"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "مقدار پیکربندی عنوان (\"html_title\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "مقدار پیکربندی مؤلّف (\"epub_author\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "مقدار پیکربندی حامی (\"epub_contributor\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "مقدار پیکربندی توضیحات (\"epub_description\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "مقدار پیکربندی ناشر (\"epub_publisher\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "مقدار پیکربندی حق انتشار (\"epub_copyright\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "مقدار پیکربندی شناسه (\"epub_identifier\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "مقدار پیکربندی ویراست (\"version\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "پرونده‌ی css نامعتبر%r: نادیده گرفته می‌شود"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "سیاهه‌های پیام‌ها در %(outdir)s است."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "مقصد‌های قالب پرونده‌های %d"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "خواندن قالب‌ها... "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "نوشتن سیاهه‌های پیام... "
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "به دنبال هر یک از خطاهای بالا در یا در برون‌داد و یا در %(outdir)s/output.txt بگردید"
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "پیوند خراب:  %s (%s)"
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "مهار '%s' پیدا نشد"
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr "شکست در گردآوری عبارات باقاعده در linkcheck_allowed_redirects: %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "صفحات راهنما در %(outdir)s است."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "هیچ مقداری برای تنظیمات «صفحات راهنما» ا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "در حال نوشتن"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "پیکربندی مقدارهای «صفحات راهنما» به سند ناشناخته‌ای ارجاع می‌دهند %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "صفحه HTML در %(outdir)s است."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "سر جمع کرد تک سند"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "نوشتن پرونده‌های اضافی"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "پرونده‌ی اطّلاعات متن در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها رh با makeinfo اجرا کند\n(برای انجام خودکار `make info' را به کار ببرید)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "هیچ تنظیماتی برای «صفحات راهنما» پیدا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "مقدار پیکربندی اطّلاعات متن سندها (texinfo_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "در حال پردازش %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "حل ارجاع‌ها..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (در "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "رونوشت از پرونده‌های با پشتیبانی اطلاعات متن"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "خطای نوشتن پرونده‌ی ساخت (Makefile) : %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "پرونده‌ی متنی در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "خطای نوشتن پرونده: %s, %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "پرونده‌ی XML در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "پرونده‌های شبه XML در پوشه‌ی %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "پرونده‌ی اطّلاعات ساخت خراب است: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "صفحات HTML در %(outdir)s است."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "شکست در خواندن پرونده‌ی اطّلاعات ساخت: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "فهرست کلی"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "فهرست"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "بعدی"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "قبلی"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "تولید نمایه‌ها"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "نوشتن صفحات اضافی"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "رونوشت از پرونده‌های قابل دریافت... "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "نمی تواند از پرونده‌ی قابل دریافت %r: %s رونوشت بگیرد"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "شکست در رونوشت یک پرونده‌ی به html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr "رونوشت از پرونده‌های ثابت"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "نمی تواند از پرونده‌ی ثابت %r رونوشت بگیرد"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "رونوشت برداری از پرونده‌های اضافی"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "نمی تواند از پرونده‌ی اضافه‌ی %r رونوشت بگیرد"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "شکست در نوشتن پرونده‌ی اطّلاعات ساخت: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "نمایه‌ی جستجو نمی‌تواند بارگزاری شود، ولی برای همه‌ی مستندات ساخته‌ نمی‌شود: نمایه‌ ناقص خواهد بود."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "صفحه‌ی %s با دو الگو در نوار کناری صفحه (html_sidebars) هم‌خوانی دارد: %r و%r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "هنگام ارائه‌ی صفحه‌ی %s خطای یونیکد رخ داد. لطفاً اطمینان حاصل کنید که تمام مقدارهای پیکربندی‌ها دارای محتوای غیر اَسکی، رشته‌متن‌های یونکد هستند."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "خطایی در نمایش صفحه‌ی %s رخ داد.\nعلّت: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "خالی کردن فهرست اشیاء"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "خالی کردن نمایه‌ی جستجو در %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "پرونده‌ی js نامعتبر%r: نادیده گرفته می‌شود"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "ارا‌ئه کننده‌های ریاضی زیادی ثبت شده‌اند، ولی هیچ کدام انتخاب نشده."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "نمایش‌دهنده‌ی ریاضی نامشخّص %r داده شده."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "مدخل مسیر اضافی (html_extra_path) %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "مدخل مسیر اضافی (html_extra_path) %r درون شاخه‌ی خارجی قرار دارد"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "مدخل مسیر ثابت (html_static_path) %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "مدخل مسیر ثابت (html_static_path) %r درون شاخه‌ی خارجی قرار دارد"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "پرونده‌ی آرم %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "پرونده‌ی آیکون مورد علاقه %r وجود ندارد"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr "از نسخه‌ی ۳.۵.۰ به بعد افزودن پیوند همیشگی (html_add_permalinks) منسوخ شده. لطفاً از به جایش html_permalinks و html_permalinks_icon را به کار ببرید."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "مستندات %s%s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "پرونده‌ی LaTeX در پوشه‌ی %(outdir)s است."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها را با لتکس(pdf) اجرا کند\n(برای انجام خودکار `make latexpdf' را به کار ببرید)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "هیچ مقدار پیکربندی اسناد لتکسی (latex_documents) پیدا نشد؛ بنابراین هیچ سندی نوشته نخواهد شد"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "مقدار پیکربندی سندهای لتکس (latex_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "فهرست"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "انتشار"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "بدون گزینه‌ی Babel شناخته شده برای زبان %r"
@@ -1124,94 +1126,94 @@
 msgid "copying TeX support files"
 msgstr "رونوشت از پرونده‌های پشتیبانی لتکس"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "رونوشت از پرونده‌های پشتیبانی لتکس..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "رونوشت برداری از پرونده‌های اضافی"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "کلید پیکربندی ناشناخته: latex_elements%r، نادیده گرفته می‌شود."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr "کلید زمینه‌ی ناشناخته: latex_theme_options%r، نادیده گرفته می‌شود."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r فاقد تنظیمات زمینه است"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r فاقد تنظیمات  \"%s\"  است"
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "در حین ساخت ایرادی رخ داد، شروع اشکال زدا:"
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "قطع شد!"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "خطای نشانه‌گذاری متن بازساختمند (reST)"
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "خطای کدگذاری نویسه:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "اگر می‌‌خواهید مشکل را به توسعه‌دهندگان گزارش دهید، ردیابی کامل خطا در %s ذخیره شده است."
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "خطای بازگشتی:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "این اتّفاق ممکن است برای پرونده‌های بسیار تو در توی منبع بیافتد. شما می‌توانید محدودیّت ۱۰۰۰ تایی مقدار پیش‌فرض اجرای بازگشت پایتون را در conf.py زیاد کنید، مثلاً با:"
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "ایراد رخ داد:"
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "لطفاً اگر این مورد خطای کاربر بوده، آن را گزارش دهید تا برای بارهای بعدی پیام خطای بهتری بتواند ارائه شود."
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "گزارش اشکال می تواند در ردیاب در مسیر <https://github.com/sphinx-doc/sphinx/issues> ثبت شود. با سپاس!"
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "شماره‌ی کار باید یک عدد مثبت باشد"
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "برای اطّلاعات بیشتر به <https://www.sphinx-doc.org/> بروید."
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,35 +1232,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr "\nایجاد مستندات از پرونده‌های مبدأ.\n\nسازنده‌ی اسفنکس مستندات را از روی پرونده های مبنع در پوشه‌‌ی منبع تولید کرده در پوشه‌ی برون‌داد قرار می‌دهد.\nاین سازنده در پوشه‌ی مبدأ به دنبال پرونده 'conf.py' تنظیمات پیکربندی می‌گردد.\nاین امکان وجود دارد که از ابزار شروع سریع اسفینکس ('sphinx-quickstart') برای تولید پرونده‌های قالب، که شامل پرونده 'conf.py' هم می‌شود استفاده شود.\n\nسازنده‌ی اسفینکس می توند مستندات را در قالب‌های گوناگونی از پرونده‌های خروجی ایجاد کند. قالب پرونده خروجی با مشخّص کردن نام سازنده در خط فرمان مشخّص می‌شود که به صورت پیش فرض HTML است.  همچنین، سازنده‌ها می‌توانند کارهای دیگر مربوط به فرآیند پردازش مستندسازی را انجام دهند.\n\nبه صورت پیش فرض، هر چیزی که منسوخ شده باشد تولید می‌شود. برون‌داد برای پرونده‌های منتخب می‌تواند فقط با مشخّص کردن نام تک تک پرونده‌ها ساخته شود.\n"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "مسیر پرونده‌های مستندات"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "مسیری برای شاخه‌ی برون داد"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "لیست پرونده‌هایی که قرار است دوباره ساخته شوند. اگر با -a مشخّص شده باشند نادیده گرفته می‌شوند"
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "گزینه‌های کلی"
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "قالب سازنده مورد استفاده (پیش‌فرض:html)"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "نوشتن همه‌ی پرونده‌ها (پیش‌گزیده: فقط پرونده‌های جدید نو تغییر یافته را بنویس)"
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "از محیط ذخیره شده استفاده نکن، همیشه همه پرونده ها را بخوان"
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1304,7 +1306,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr "افزایش ارائه‌ی جزئیّات (می تواند تکرار شود)"
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "بدون برون‌داد در درگاه خروجی استاندارد(stdout)، فقط هشدارها در درگاه استاندارد خطاها (stderr)"
 
@@ -1340,161 +1342,156 @@
 msgid "run Pdb on exception"
 msgstr "ایراد در اجرای Pdb"
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "پرونده‌های %r پیدا نشدند"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "نمی توان گزینه‌ی -a را با نام پرونده‌ها ترکیب کرد"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "امکان باز کردن پرونده هشدار نبود %r: %s"
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "نشانوند گزینه‌ی D- می‌بایست در قالب نام=مقدار (name=value) باشد"
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "نشانوند گزینه‌ی A- می‌بایست در قالب نام=مقدار (name=value) باشد"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "درج خودکار رشته‌مستندات را از پیمانه‌ها"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "آزمایش خودکار تکّه‌کدها در قسمت‌های مختلف پیمانه‌ی doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "پیوند بین اسناد Sphinx از پروژه های گوناگون"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "نوشتن مدخل‌های لیست اقدام‌ها (\"todo\")که در ساخت می تواند نشان داده و یا پنهان شوند"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "بررسی برای پوشش اسناد"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "گنجاندن رابطه‌های ریاضی که در قالب PNG یا SVG به نمایش در آمده"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "گنجاندن رابطه‌های ریاضی که MathJax در مرورگر نمایش در آورده"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "گنجاندن شرطی محتوا بر اساس مقادیر پیکربندی"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "گنجاندن ویندهای کد منبع اشیاء مستند شده‌ی پایتون"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "ساخت پرونده‌ی nojekyll  برای انتشار سند در صفحات گیت-هاب"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "لطفاً نام مسیر معتبری را وارد کنید."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "لطفاً متنی وارد کنید."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "لطفاً یکی از  %s وارد کنید."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "لطفاً یا y و یا n وارد کنید."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "لطفاً یک پسوند را وارد کنید، مثل: '.rst'  یا '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "به ابزار شروع سریع اسفینکس %s خوش آمدید."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "لطفاً مقدارهای تنظیمات زیر را وارد کنید\n(اگر مقدار پیش‌گزیده‌ای درون داده کروشه شده بود، برای برای پذیرش آن فقط کلید Enter‌را فشار دهید)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "مسیر برگزیده‌ی ریشه‌ی مستندات: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "مسیر ریشه‌ی مستندات را وارد کنید."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "مسیر ریشه‌ی مستندات"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "خطا: در مسیر ریشه‌ی انتخاب شده‌، پرونده‌ی conf.pyی دیگری یپدا شد."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "ابراز شروع سریع اسفینکس روی پروژه‌های از قبل موجود اسفینکس بازنویسی نمی‌کند."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "لطفاً یک مسیر ریشه‌ی جدید وارد کنید (یا برای خروج Enter‌ را بزنید)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 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 "شما برای تعیین شاخه‌ی ساخت برای برون‌داد اسفینکس دو گزینه دارید.\nیا از شاخه‌ای با نام \"_build\" درون شاخه‌ی ریشه استفاده کنید،\nو یا شاخه‌های را درون یک مسیر ریشه با نام‌های منبع (source) و ساخت (build) جدا کنید."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "شاخه‌های منبع و ساخت از یکدیگر جدا شوند؟(y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "درون شاخه‌ی ریشه، دو شاخه‌ی دیگر ساخته خواهد شد؛\n\"_templates\" برای قالب‌های سفارشی HTML و \"_static\" برای قالب برگه‌ها و بقیّه‌ی پرونده‌های ثابت.\nشما می‌توانید پیشوند دیگری (مانند «.») برای جایگزینی نویسه‌ی خط به کار ببرید."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "برای  شاخه‌های قالب‌ها (templates) و ثابت‌ها (static) نویسه‌ی پیشوندی را بنویسید"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "نام پروژه در چندین جا در سند ساخته شده به کار می‌رود."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "نام پروژه"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "نام نویسنده (ها)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1503,15 +1500,15 @@
 "just set both to the same value."
 msgstr "اسفینکس نظریّه‌ای برای یک «نسخه» و یک «نگارش» برای نرم افزار دارد.\nهر نسخه‌ای می تواند چندید نگارش داشته باشد.\n مثلاً برای پایتون نسخه‌ چیزی شبیه به ۲/۵ یا ۳/۰ است،\n در حالی که انتشار چیزیست شبیه به ۲/۵/۱ یا ۳/۰a۱ \n.\nاگر شما نیازی به این ساختار دوگانه ندارید، هر دو را یکی تعیین کنید."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "نسخه انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1521,21 +1518,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "اگر مستندات قرار است با زبانی غیر از انگلیسی نوشته شود،\nمی توانید همین‌جا یک زبان را با انتخاب کد زبانیش انتخاب کنید.\nاسفینکس سپس متن‌هایی را که تولید می‌کند را به آن زبان ترجمه می‌کند.\n\nبرای فهرست زبان‌های پشتیبانی شده، به این نشانی مراجعه کنید\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "زبان پروژه"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 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 "پسوند نام پرونده برای پرونده‌های منبع. معمولاً این پسوند یا \".txt\" است و یا \".rst\".\nفقط پرونده‌هایی بای این پسوند به عنوان اسناد در نظر گرفته می‌شوند."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "پسوند پرونده‌ی منبع"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1540,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "یک سند از آن جهت خاص است که  به عنوان بست بالایی «درختواره‌ی محتوا» در نظر گرفته می‌شود.\nیعنی، این سند ریشه‌ی ساختار سلسله مراتبی اسناد است.\nمعمولاً سند این کار «نمایه» است، ولی اگر سند «نمایه‌»‌ی شما قالب سفارشی است؛ می توانید آن را به نام دیگری تغییر دهید."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "نام سند اصلی شما (بدون پسوند)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "خطا: پرونده‌ی اصلی %s از قبل در مسیر ریشه‌ی برگزیده بوده‌است."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "ابراز شروع سریع اسفینکس روی پرونده‌های از قبل موجود بازنویسی نمی‌کند."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "لطفاُ یک نام جدید وارد کنید، یا نام پرونده‌ی موجود را تغییر دهید و Enter‌ را فشار دهید"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "مشخّص کنید کدام یک از این افزونه‌های اسفینکس باید فعّال باشد:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "یادداشت: ابزارهای‌ imgmath و mathjax نمی‌توانند در یک زمان فعّال باشند. انتخاب imgmath لغو شد."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "پرونده‌های خط‌فرمان ویندوز و Makefile می‌توانند برای شما تولید شوند، به گونه‌ای که شما فقط نیاز باشد تا مثلاً فرمان `make html' را به جای فراخوان مستقیم ابزار ساخت اسفینکس اجرا کنید."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "آیا پرونده‌ی‌ make ایجاد شود؟ (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "آیا پرونده‌ی خط فرمان ویندوز ساخته شود؟ (y/n)ٍ"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "ایجاد پرونده‌ی %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "پرونده‌ی %s در حال حاضر وجود دارد، رد شدن."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "پایان یافت: ساختار آغازین شاخه ایجاد شد."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "شما باید حالا دیگر پرونده‌ی اصلی‌تان %s را جمع آوری کنید\n و بقیّه‌ی پرونده‌های منبع مستندات را ایجاد کنید. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "از Makefile  برای ساختن مستندات استفاده کنید، مانند این:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "از فرمان ساخت اسفینکس برای ساختن مستندات استفاده کنید، مانند این:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "که در آن سازنده یکی از سازنده‌های پشتیبانی شده است، مانند html, latex و یا linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,230 +1634,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nتولید پرونده‌های مورد نیاز برای یک پروژه‌ی اسفینکس\n\nابزار شروع سریع اسفینکس ابزاری تعاملی است که شماری سؤال درباره‌ی پروژه‌یتان از شما می پرسد\nو سپس یک شاخه‌ی کامل مستندات و پرونده ساخت Makefile را برای استفاده به همراه ابزار ساخت اسفینکس تولید می‌کند.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "حالت سکوت"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "ریشه‌ی پروژه"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "گزینه‌های ساختار"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "در صورتی مشخّص شدن، شاخه‌های منبع و ساخت از یکدیگر جدا می‌شوند"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "در صورت مشخّص بودن، شاخه‌ی build (ساخت) را درون شاخه‌ی منبع بساز"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "جایگزینی نقطه در _templates (قالب‌ها) و ... ."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "گزینه‌های اساسی پروژه"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "نام پروژه"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "نام نویسندگان"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "نسخه انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "انتشار پروژه"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "زبان سند"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "پسوند پرونده‌ی منبع"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "نام سند اصلی"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "استفاده epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "گزینه‌های افزونه"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "فعّال‌سازی %s افزونه"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "فعّال‌سازی افزونه‌های اختیاری"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "ایجاد Makefile و Batchfile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "ایجاد پرونده‌ی سازنده (makefile)"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "پرونده‌ی سازنده (makefile) را ایجاد نکن"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "ایجاد Batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "batchfile را ایجاد نکن"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "عدم اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "قالب سازی پروژه"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "شاخه‌ی قالب شامل پرونده‌های قالب"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "تعریف متغیّر قالب"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "حالت «ساکت» تعیین شده، ولی یکی از موارد «پروژه» یا «نویسنده» مشخّص نشده."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "خطا: مسیر مشخّص شده پوشه نیست، یا از قبل پرونده‌های اسفینکس وجود داشته‌اند."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "ابزار شروع سریع اسفینکس فقط یک پوشه‌ی خالی درست می کند. لطفاً یک مسیر ریشه‌ی جدید مشخّص کنید."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "متغیرهای نامعتبرقالب؛ %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr "غیرفاصله‌ در فرآیند حذف فاصله‌ از ابتدای سطر حذف شد"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "برچسب نامعتبر:%s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "شماره‌ی سطر مشخّص شده خارج از بازه‌ی (1-%d) است: %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "امکان استفاده از هر دوی %sو%s نیست"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "پرونده‌ی گنجانده شده %r یا پیدا نشد و یا خواندن آن شکست خورد"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "کدگذاری %r که باری خواندن پرونده‌ی گنجانده شده‌ی %r اسفتاده شده به نظر می رسد اشتباه باشد، استفاده از گزینه‌ی کدگذاری ( :encoding:) را امتحان کنید"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "شیئ با نام %r در پرونده‌ی %r پیدا نشد"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "امکان استفاده‌ی گزینه‌ی «هم‌خوان شماره‌ی سطر» (lineno-match) با مجموعه‌ی سطرهای گسیخته وجود ندارد"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "سطر مشخّص شده %r: هیچ سطری از پرونده‌ی گنجانده شده %r بیرون کشیده نشده"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "درختواره‌ی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "نویسنده این بخش: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "نویسنده این ماژول: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "نویسنده ی کد: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "نویسنده: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1871,559 +1868,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr "اعلان C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. c:%s:: %s' است."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "پارامترها"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "بازگشت ها"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "نوع برگشتی"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "عضو"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "متغیّر"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "تابع"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "ماکرو"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr "ساختار"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "اجتماع"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "شمارش"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "شمارنده"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "گونه"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "مؤلّفه‌ی تابع"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "جدید در نسخه %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "تغییر داده شده در نسخه %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "منسوخ شده از نسخه %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "نقل‌قول %s تکراری، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "نقل %s قول ارجاع داده نشده."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr "اعلان ++C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. cpp:%s:: %s' است."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "پارامترهای قالب"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "ایجاد"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "کلاس"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "کانسپت"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "مؤلّفه‌ی قالب"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (توابع درونی)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s متد)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s (کلاس)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (متغیّر عمومی یا مقدار ثابت)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s مشخصه)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "نشانوندها"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (ماژول)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "متد"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "داده"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "مشخّصه"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "ماژول"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "توضیح %s تکراری از %s، مورد دیگر%s در %s قرار دارد"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "بر چسب معادله ی %s تکرار است، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "قالب مرجع معادله‌‌ی ریاضی (math_eqref_format) نامعتبر: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "کلمه کلیدی"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "عملگر"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "شیء"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "ایراد"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "گذاره"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "توابع درونی"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "متغیر ها"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "برانگیختن"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (در ماژول %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (در ماژول %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (متغیر درونی)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (کلاس درونی)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (کلاس در %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s شگرد کلاس)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s(%sویژگی)"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s متد استاتیک)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s(%sویژگی)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "نمایه ی ماژول های پایتون"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "ماژول ها"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "منسوخ شده"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "class method"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "متد استاتیک"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "ویژگی"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "توضیح تکراری شیئ %s، نمونه‌ی دیگر در %s قرار دارد، برای یک مورد از :noindex: استفاده کنید"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (منسوخ)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (دستورالمعل)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr "%s (گزینه‌ی دستورالمعل)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (نقش)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "دستورالمعل"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "گزینه‌ی دستورالمعل"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "نقش"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "توضیح تکراری از %s %s، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "متغیرهای عمومی؛ %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "توضیح بدشکل برای گزینه‌ی %r، باید شبیه این‌ها باشد \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" یا \"+opt args\""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s گزینه‌ی خط فرمان"
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "گزینه خط فرمان"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "یک خط خالی باید پیش از اصطلاح واژه‌نامه باشد"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "اصطلاحات واژه‌نامه نباید با خطوط خالی از هم جدا شوند"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "به نظر می رسد واژه‌نامه اشتباه شکل داده شده است، فاصله‌گذاری از ابتدای سطر را بررسی کنید"
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "اصطلاح واژه‌نامه"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "نشانه ی گرامری"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "برچسب ارجاع"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "متغیّر عمومی"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "اختیارات برنامه"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "سند"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "فهرست ماژول ها"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "صفحه جستجو"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "بر چسب تکراری %s، مورد دیگر در %s قرار دارد"
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "تکرار توضیح %s از %s، مورد دیگر در%s قرار دارد"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "شماره‌ی شکل غیر فعّال است. گزینه‌ی :numref: نادیده گرفته می‌شود."
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "شکست در ایجاد ارجاع متقابل. هیچ شماره انتساب داده نشده: %s"
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "پیوند هیچ برچسبی ندارد: %s"
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "قالب شماره‌ی شکل نامعتبر: %s (%r)"
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "قالب شماره‌ی شکل نامعتبر:  %s"
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "برچشب تعریف نشده:  %s"
+msgid "undefined label: %r"
+msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "شکست در ایجاد ارجاع متقابل. عنوان یا زیرنویس پیدا نشد: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "پیکربندی جدید"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "پیکربندی تغییر داده شد"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "افزونه‌ها تغییر کردند"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "نسخه‌ی محیط ساخت به‌روز نیست"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "شاخه ی منبع تغییر کرد"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "این محیط با سازنده‌ی انتخاب شده سازگار نیست، لطفاً یک خوشه‌ی اسناد دیگری را انتخاب کنید."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "پویش اسناد %s: %r شکست خورد"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "دامنه ی %r ثبت نشده"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "درختواره‌ی فهرست مطالب با ارجاع به خود پیدا شده. نادیده گرفته می‌شود."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "سند در هیچ درختواره‌ی فهرست مطالبی گنجانده نشده"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%s را ببینید"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "%s را هم ببینید"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "نوع ناشناخته مدخل نمایه %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "نماد ها"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "دور تسلسل در درختواره‌ی ارجاعات فهرست مطالب تشخیص داده شده، نادیده گرفته می‌شوند: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "پرونده‌ی تصویر خوانا نیست: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "پرونده‌ی عکس  %s خوانا نیست:  %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "پرونده‌ی دریافت شده خوانا نیست: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "شماره‌ی قسمت‌ها پیش‌تر به %s نسبت داده شده ( آیا درختواره‌ی فهرست مطالب شماره‌گذاری تو در تو دارد؟)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "پرونده‌ی %s را می سازد."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2438,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nبه صورت بازگشتی در مسیر <MODULE_PATH> دنبال پیمانه‌هاو بسته‌های پایتون بگرد و \nبا به ازای دستورالمعل‌های خودکار پیمانه‌ی هر بسته در مسیر خروجی <OUTPUT_PATH> یک پرونده‌ی reST بساز.\n\nالگوی استثتاء های <EXCLUDE_PATTERN> می‌تواند الگوی پرونده‌ها و یا شاخه‌هایی باشد که از تولید کنار گذاشته شده‌اند.\n\nتوجّه: به صورت پیش فرض این اسکریپت روی پرونده‌های از پیش ساخته شده دوباره نویسی نمی‌کند."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "مسیر پیمانه به سند"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "الگوها‌ی به سبک fnmatch در پرونده و یا شاخه برای کنار گذاشتن از تولید"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "نهایت عمق زیر پیمانه‌ها برای نشان دادن در فهرست مطالب (پیش‌گزیده: ۴)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "بازنویسی پرونده‌های موجود"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ردگیری پیوند نمادین. وقتی با collective.recipe.omelette ترکیب می‌شود توانمند است."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "اجرای اسکریپت بدون ساخت پرونده"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "قرار دادن مستندات هر پیمانه در صفحه‌ی خودش"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "در برداشتن پیمانه‌های «خصوصی»(_private)"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "نام پرونده فهرست مطالب (پیش‌گزیده: پیمانه‌ها)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "پرونده‌ی فهرست مطالب را ایجاد نکن"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "برای بسته‌ها و پیمانه‌ها سربرگ نساز (مثلاً وقتی رشته‌متن‌های مستندات از قبل آن‌ها را داشته باشند)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "قرار دادن مستندات پیمانه پیش از مستندات پیمانه‌ی زیرمجموعه‌‌اش"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "تفسیر مسیرهای پیمانه بر اساس ویژگی‌های ضمنی فضای نام‌ها در PEP -0420"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "پسوند پرونده ( پیش فرض: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "تولید یک پروژه‌ی کامل با ابزار شروع سریع اسفینکس"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "پیوست مسیر پیمانه (module_path) به مسیر سیستم (sys.path)، هنگامی به کار می‌رود که گزینه‌ی full-- داده شود"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "نام پروژه (پیش‌گزیده: نام پیمانه‌ی ریشه)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "نویسنده(های) پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "نسخه‌ی پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "نگارش پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود، پیش‌گزیده همان شماره‌ی نسخه (--doc-version) است"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "گزینه های افزونه"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s شاخه نیست."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "عبارت باقاعده‌ی نامعتبر %r در %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "آزمودن پوشش  منابع پایان یافت، به نتایج در %(outdir)spython.txt نگاهی بیاندازید."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "عبارات باقاعده‌ی نامعتبر %r در پوشش عبارت باقاعده‌ی زبان سی (coverage_c_regexes)"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr "رابط برنامه‌نویسی مستند نشده‌ی C: %s %s در پرونده‌ی %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "امکان وارد کردن پیمانه‎ی %s نبود: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "تابع پایتونی بدون مستندات: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "کلاس مستندسازی نشده‌ی پایتون: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "شگرد مستندسازی نشده‌ی پایتون: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "فاقد «+» یا «-» در گزینه‌ی '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "\"%s\" یک گزینه‌ی معتبر نیست."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' یک گزینه‌ی معتبر نسخه‌ی پایتون (pyversion) نیست"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "نوع TestCode  نامعتبر"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "آزمایش مستندات منابع به پایان رسید، به نتایج در %(outdir)s/output.txt نگاهی بیاندازید."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "بدون کد/خروجی در تکّه‌ی %s در %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "نادیده گرفتن کد پیمانه‌ی doctest : %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== کند ترین زمان خواندن ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "دستورالعمل Graphviz نمی تواند هم نشانوند محتوا را داشته باشد و هم نام پرونده"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "پرونده گنجانده شده‌ی خارجی Graphviz  %r یا پیدا نشد و یا خواندنش با شکست رو به رو شد"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "نادیده گرفتن دستورالعمل «graphviz» بدون محتوا."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2655,14 @@
 "%r"
 msgstr "dot  هیچ پرونده‌ی برون‌دادی تولید نکرد:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "فرمان dot %r نمی‌تواند اجرا شود (زیرا نیازمند برون‌داد graphviz است)، تنظیمات graphviz_dot را بررسی کنید"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2672,35 @@
 "%r"
 msgstr "dot  با خطایی از کار افتاد:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "قالب خروجی graphviz باید یکی از قالب های 'png' یا  'svg' باشد ولی %r است"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "کد دات: %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "گراف:%s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "گراف:"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter بررسی کنید: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2710,173 @@
 "%r"
 msgstr "تبدیل با خطایی از کار افتاد:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter را بررسی کنید"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "فرمان لتکس %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_latex را بررسی کنید"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%sفرمان %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_%s را بررسی کنید"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "نمایش لتکس: %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "لتکس بین سطری: %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "پیوند ثابت به این معادله"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "سیاهه‌ی بین اسفینکس جا به جایی را انجام داد: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "بارگذاری سیاهه‌ی بین اسفینکس از %s..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "مشکلاتی در برخی از سیاهه‌ها به وجود آمد،ولی این مشکلات راه‌های جایگزین های داشته‌اند:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "شکست در رسیدن به یکی از سیاهه‌ها به خاطر مشکلات زیر:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(در %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(در %s )"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "شناساگر بین اسفینکس %r رشته‌متن نیست. نادیده گرفته شد"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "شکست در خواندن intersphinx_mapping%s، نادیده گرفته می‌شود: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "منبع"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "در دست انجام"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "مدخل فهرست اقدام پیدا شد: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<original entry> در%s و سطر %d جای گرفته است.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "مدخل اصلی"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "برجسته کردن کد پیمانه... "
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "مستندات"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "کد ماژول"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>کد منبع برای %s </h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "بررسی اجمالی: کد ماژول"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1> همه‌ی پیمانه‌هایی که برایشان کد در دسترس است</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "مقدار نامعتبر برای گزینه‌ی ترتیب اعضا (member-order): %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "مقدار نامعتبر برای گزینه‌ی «از مستندات کلاس» class-doc-from:%s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "امضای ناشناخته‌ برای %s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "خطا در قالب بندی نشانوند برای %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "ویژگی ناموجود %s در شیئ %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2884,112 @@
 "explicit module name)"
 msgstr "مشخّص نیست کدام پیمانه را برای مستندسازی خودکار فراخوان کند %r (سعی کنید دستورالعمل «module» یا «currentmodule» را در سند قرار دهید، یا یک نام واضح برای پیمانه ارائه دهید)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr "شیئ ساختگی شناسایی شد: %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "خطا در قالب بندی امضا برای %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\"  در پیمانه‌ی خودکار معنی نمی‌دهد"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "نشانوند‌های امضا یا یادداشت مقدار برگشتی داده شده برای پیمانه‌ی خودکار %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ باید لیستی از رشته‌متن ها باشد، نه %r (در پیمانه‌ی %s) -- __all__ نادیده گرفته می‌شود"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "ویژگی نایاب در گزینه‌ی :members: قید شده: پیمانه‌ی:%s، ویژگی %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "شکست در دریافت امضای تابع برای %s: مؤلّفه پیدا نشد: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "شکست در دریافت امضای سازنده‌ی شیئ برای %s: مؤلّفه پیدا نشد: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "پایه ها:%s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "ویژگی ناموجود %s در شیئ %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "نام جانشین %s"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "نام جانشین نوع متغیر(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "شکست در دریافت امضای شگرد برای %s: مؤلّفه پیدا نشد: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "__slots__ نامعتبر در %sیدا شد و نادیده گرفته شد."
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr "اعضای مستندسازی خودکار (autodoc_member_order) حالا دیگر ترتیب الفبایی «alphabetical» را به جای حالت منتسب به الفبا «alphabetic» می‌پذیرد. لطفاً تنظیمات خود را به روز رسانی کنید."
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "شکست در تحلیل مقدار پیش‌گزیده‌‌ی نشانوند برای %r: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "شکست در به روز رسانی امضا برای %r: مؤلّفه پیدا نشد: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "شکست در تحلیل نوع یادداشت برای %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "ارجاعات خلاصه‌ی خودکار سند %r حذف کنار گذاشته. نادیده گرفته می‌شود."
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "خلاصه‌ی خودکار: خرده‌پرونده‌ی %r پیدا نشد. تنظیمات تولید خلاصه‌ی خودکار(autosummary_generate) را بررسی کنید."
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "خلاصه‌ی خودکار عنوان‌ٔار نیازمند گزینه‌ی :toctree: است، نادیده گرفته می‌شود."
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +2997,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "شکست در تجزیه تحلیل نام %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "شکست در وارد کردن شیئ %s"
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "تولید خلاصه خودکار: پرونده پیدا نشد: %s"
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "خلاصه‌ی خودکار به طور داخلی پرونده‌های rst را ایجاد می‌کند. ولی پسوند منبع شما شامل rst نیست. نادیده گرفته می‌شود."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "خلاصه‌ی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "خلاصه‌ی خودکار تولید خلاصه‌ی خودکار برای: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "خلاصه‌ی خودکار نوشتن در %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3044,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3059,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nتولید ReStructuredText با استفاده از دستورالعمل‌های خلاصه‌ی خودکار.\n\nخودکارساز اسفینکس رابط کابر پسندی برای sphinx.ext.autosummary.generate (پیمانه‌ی افزونه‌ی خلاصه‌ساز اسفنیکس) است.\nاین افزونه پرونده های متن reStructuredText را از دستورالعمل‌های خلاصه‌ی خودکاری تولید می‌کند که در پرونده‌های درون‌داد مشخّص شده قرار دارد.\n\nقالب دستورالعمل خلاصه‌ی خودکار درپیمانه‌ی افزونه‌ی خلاصه‌ی خودکار اسفنیکس (sphinx.ext.autosummary) مستند سازی شده می توان آن را با دستور زیر خواند::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "پرونده‌های منبع برای تولید پرونده‌های rST"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها در آن"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "پسوند پیش فرض برای پرونده‌ها (پیش‌فرض: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "شاخه‌ی سفارشی قالب (پیش‌گزیده: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "اجزای فراخوان شده‌ی سند (پیش‌گزیده: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "نشانوندهای کلیدی"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "مثال"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "نمونه‎ها"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "یادداشت‌ها"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "مؤلّفه‌های دیگر"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr "دریافت‌ها"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "منابع"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "هشدارها"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "فرآورده"
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "مقدار نامعتبر تعیین شده (بدون کمانک انتهایی): %s"
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "مقدار نامعتبر تعیین شده (بدون کمانک ابتدایی): %s"
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول انتهایی): %s"
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول ابتدایی): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "دقت"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "ملاحظه"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "خطر"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "خطا"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "راهنمایی"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "مهم"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "توجه"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "همچنین ملاحظه نمائید"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "نکته"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "هشدار"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "ادامه از صفحه‌ی قبل"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "ادامه در صفحه‌ی بعد"
@@ -3193,7 +3212,7 @@
 msgid "Table of Contents"
 msgstr "فهرست عناوین"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "جستجو"
@@ -3274,35 +3293,35 @@
 msgid "Navigation"
 msgstr "ناوبری"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "جستجو در %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "درباره این مستندات"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "کپی رایت"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">حق نشر</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; حق نشر%(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "آخرین بروز رسانی در %(last_updated)s ."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3366,12 @@
 msgstr "جستجو"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "نتایج جستجو"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,280 +3413,278 @@
 msgid "Other changes"
 msgstr "دگر تغییرات"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "پیوند ثابت به این سر مقاله"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "پیوند ثابت به این تعریف"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "عدم نمایش نتایج یافت شده"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "در حال جست و جو"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "آماده سازی جست و جو..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "جستجو پایان یافت و %sصفحه نتایج مطابق جستار پیدا شدن."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr "، در "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "گسترش نوار کناره"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "عدم نمایش نتایج یافت شده"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "تا کردن نوار کناره"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "گسترش نوار کناره"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "محتوا ها"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "نمایه‌ای بر پایه‌ی ۴ ستون پیدا شد. شاید یک اشکال برنامه‌نویسی از افزونه‌هایی که استفاده می‌کنید باشد: %r"
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "پانویس %s ارجاع داده نشده است."
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "پانویس # ارجاع داده نشده است."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ارجاعات پانویس ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "ارجاعات ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ارجاعات نقل قول ادبی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ارجاعات اصطلاحی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr "امکان تشخیص متن جایگزین برای ارجاع متقابل نبود. شاید یک اشکال برنامه نویسی باشد."
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "برای «هر» ارجاع متقابل بیشتر از یک هفد پیدا شد: %r شاید %s باشد"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr "%s:%s  مرجع هدف پیدا نشد: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "مقصد ارجاع %r پیدا نشد %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "قالب تصویر ناشناخته: %s..."
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "نویسه‌ی منبع غیرقابل رمزگشایی، جایگزین با «؟» : %r"
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "رد شدن و نادیده انگاشتن"
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "شکست خورد"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "نام نقش یا دستورالعمل ناشناخته: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "بست از نوع ناشناخته: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "خطای خواندن: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "خطای نوشتن: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "پوشه‌ی محلّی %s وجود ندارد"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "قالب تاریخ ناشناخته. اگر می‌خواهید از رشته‌متن مستقیماً خروجی بگیرید، آن را با نقل قول رشته‌متنی محصور کنید: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "درختواره‌ی فهرست مطالب شامل ارجاع به پرونده ناموجود %r است"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "ایراد در هنگام ارزیابی تنها عبارت دستور العمل: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "نقش پیش‌فرض %s یافت نشد"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "پیوند ثابت به این تعریف"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "قالب عدد شکل برای %s تعریف نشده"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "هر کدام از شناسه‌هایی که به بست %s اختصاص داده نشده"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "پیوند ثابت به این اصطلاح"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "پیوند ثابت به این جدول"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "پیوند ثابت به این کد"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "پیوند ثابت به این تصویر"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "پیوند ثابت به این فهرست عنوان ها"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "امکان دست یابی به اندازه‌ی عکس نبود. گزینه‌ی تغییر اندازه :scale: نادیده گرفته می‌شود."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "قسمت‌بندی رده‌بالای %r ناشناخته برای کلاس %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr "مقدار بسیار بزرگ :maxdepth:، نادیده گرفته شد."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "عنوان سند یک بست متنی نیست"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "به بست عنوانی برخورد که در قسمت، موضوع، جدول، اندرز یا نوارکناری نبود"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "پانویس ها"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "هر دو مقدار tabularcolumns و :widths: داده شده، بنابراین :widths: حذف می شود."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "ابعاد واحد %sنامعتبر است و نادیده گرفته شد."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "نوع ناشناخته مدخل نمایه%s پیدا شد"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "تصویر%s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "تصویر"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "عنوان درون شکل نیست."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "بست به کار نرفته: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fi/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fi/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fi/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fi/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fi/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fi/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2009\n"
 "Language-Team: Finnish (http://www.transifex.com/sphinx-doc/sphinx-1/language/fi/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: fi\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Moduulitaso"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Yleinen sisällysluettelo"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "hakemisto"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ">"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "<"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Sisällysluettelo"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Luvun kirjoittaja: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Moduulin kirjoittaja: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Tekijä: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,414 +1865,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Uusi versiossa %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Muutettu versiossa %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Poistettu versiosta %s alkaen"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (moduuli)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "moduuli"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduulit"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Poistettu"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (poistettu)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Moduuli sisällysluettelo"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Etsi sivu"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2285,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Tehtävä vielä"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Huom"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Varoitus"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Vaara"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Virhe"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Vihje"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Tärkeä"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Muista"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Katso myös"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Vihje"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Varoitus"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Etsi"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "Navikointi"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Tietoja tästä documentistä"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "etsi"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Etsinnän tulos"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Piilota löydetyt"
-
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr ""
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Piilota löydetyt"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fr/LC_MESSAGES/sphinx.js Changed

@@ -23,15 +23,13 @@
         "Index": "Index",
         "Index &ndash; %(key)s": "Index &ndash; %(key)s",
         "Index pages by letter": "Indexer les pages par lettre",
-        "Indices and tables:": "Indices et tables :",
+        "Indices and tables:": "Index et tables :",
         "Last updated on %(last_updated)s.": "Mis \u00e0 jour le %(last_updated)s.",
         "Library changes": "Modifications de la biblioth\u00e8que",
         "Navigation": "Navigation",
         "Next topic": "Sujet suivant",
         "Other changes": "Autres modifications",
         "Overview": "R\u00e9sum\u00e9",
-        "Permalink to this definition": "Lien permanent vers cette d\u00e9finition",
-        "Permalink to this headline": "Lien permanent vers ce titre",
         "Please activate JavaScript to enable the search\n    functionality.": "Veuillez activer le JavaScript pour que la recherche fonctionne.",
         "Preparing search...": "Pr\u00e9paration de la recherche...",
         "Previous topic": "Sujet pr\u00e9c\u00e9dent",
@@ -39,7 +37,7 @@
         "Search": "Recherche",
         "Search Page": "Page de recherche",
         "Search Results": "R\u00e9sultats de la recherche",
-        "Search finished, found %s page(s) matching the search query.": "La recherche est finie, %s page(s) trouv\u00e9e(s) qui corresponde(nt) \u00e0 la recherche.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "Recherche termin\u00e9e, ${resultCount} page(s) correspondant \u00e0 la requ\u00eate de recherche ont \u00e9t\u00e9 trouv\u00e9es.",
         "Search within %(docstitle)s": "Recherchez dans %(docstitle)s",
         "Searching": "Recherche en cours",
         "Searching for multiple words only shows matches that contain\n    all words.": "Une recherche sur plusieurs mots ne retourne que les r\u00e9sultats contenant tous les mots.",
@@ -59,5 +57,5 @@
         "search this documentation": "rechercher dans cette documentation",
         "the documentation for": "la documentation pour"
     },
-    "plural_expr": "(n > 1)"
+    "plural_expr": "(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fr/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fr/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -10,14 +10,15 @@
 # cyrille gachot <cyrille.gachot@smile.fr>, 2019
 # David Georges, 2021
 # Larlet David <david@larlet.fr>, 2008
-# Denis Bitouzé <dbitouze@wanadoo.fr>, 2020-2021
+# Denis Bitouzé <dbitouze@wanadoo.fr>, 2020-2022
 # fgallaire <fgallaire@gmail.com>, 2010
 # fgallaire <fgallaire@gmail.com>, 2010
 # François Poirotte <clicky@erebot.net>, 2016-2017,2020
 # Georg Brandl <g.brandl@gmx.net>, 2014
 # Hugo Herbelin <Hugo.Herbelin@inria.fr>, 2021
 # Jean-Daniel Browne <jeandaniel.browne@gmail.com>, 2010
-# Jean-François B. <jfbu@free.fr>, 2017-2019
+# Jean-François B. <jfbu@free.fr>, 2017-2019,2022
+# Jérémie Tarot <silopolis@gmail.com>, 2022
 # Julien Palard <github@mandark.fr>, 2017
 # Julien Malard <julien.malard@mail.mcgill.ca>, 2019
 # Kim S. <kim.sylvestre@gmail.com>, 2019
@@ -34,134 +35,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Jérémie Tarot <silopolis@gmail.com>, 2022\n"
 "Language-Team: French (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: fr\n"
-"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Impossible de trouver le répertoire source (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "Le répertoire de sortie (%s) n'est pas un répertoire"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Les dossiers source et destination ne doivent pas être identiques"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s en cours d'exécution"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ce projet nécessite au minimum Sphinx v%s et ne peut donc être construit avec cette version."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
-msgstr "création du dossier de destinataire"
+msgstr "Création du répertoire de sortie"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "lors de l'initialisation de l'extension %s :"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' tel que défini dans conf.py n'est pas un objet Python appelable. Veuillez modifier sa définition pour en faire une fonction appelable. Ceci est nécessaire pour que conf.py se comporte comme une extension Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "chargement des traductions %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "fait"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "traductions indisponibles"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "Chargement de l'environnement pickled"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "échec : %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Aucun constructeur sélectionné, utilisation du défaut : html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "a réussi"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "s'est terminée avec des problèmes"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "La compilation %s, %s avertissement (avec les avertissements considérés comme des erreurs)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "La compilation %s, %s avertissements (avec les avertissements considérés comme des erreurs)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "La compilation %s, %s avertissement."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "La compilation %s, %s avertissements."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "La compilation %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "la classe de nœud %r est déjà enregistrée, ses visiteurs seront écrasés"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "la directive %r est déjà enregistrée, elle sera écrasée"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "le rôle %r est déjà enregistré, il sera écrasé"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -169,12 +170,12 @@
 "explicit"
 msgstr "l’extension %s ne se déclare pas compatible à la lecture en parallèle, on supposera qu’elle ne l'est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "l'extension %s n'est pas compatible avec les lectures parallèles"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -182,64 +183,70 @@
 "explicit"
 msgstr "l’extension %s ne se déclare pas compatible à l’écriture en parallèle, on supposera qu’elle ne l’est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "l'extension %s n'est pas compatible avec les écritures parallèles"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "sérialisation en cours %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "Le dossier de configuration ne contient pas de fichier conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "Valeur de configuration invalide trouvée: 'language = None'. Mettez à jour la configuration avec un code de langage valide. Utilisation de 'en' (English) comme substitut."
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "impossible d'écraser le dictionnaire de configuration %r ; ignoré (utilisez %r pour modifier les éléments individuellement)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "nombre non valide %r pour l'option de configuration %r ; ignoré"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "impossible de remplacer le paramètre de configuration %r par un type non-supporté ; ignoré"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "paramètre de configuration %r inconnu dans override ; ignoré"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Option de configuration inexistante : %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "L'option de configuration %r est déjà présente"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Votre fichier de configuration comporte une erreur de syntaxe : %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Le fichier de configuration (ou un des modules qu'il utilise) génère un sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -247,898 +254,894 @@
 "%s"
 msgstr "Votre fichier de configuration comporte une erreur de programmation : \n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Le paramètre « source_suffix » s'attend à recevoir une chaîne de caractères, une liste de chaînes de caractères ou un dictionnaire. Mais vous avez fourni un « %r »."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Section %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tableau %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Code source %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "La valeur « {current} » du paramètre « {name} » ne figure pas dans la liste des possibilités valables « {candidates} »."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Le type du paramètre de configuration « {name} » doit être {permitted} et non « {current.__name__} »."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Le paramètre de configuration « {name} » a pour type « {current.__name__} », tandis que le type par défaut est « {default.__name__} »."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r non trouvé; ignoré."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "Depuis sa version 2.0, Sphinx utilise \"index\" comme root_doc par défaut. Veuillez ajouter \"root_doc = 'contents'\" à votre conf.py."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Évènement %r déjà présent"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nom d'évènement inconnu : %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
-msgstr ""
+msgstr "Le gestionnaire %r de l'évènement %r a créé une exception."
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "L'extension %s  est exigée par le paramètre needs_extensions, mais n'est pas chargée."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ce projet nécessite que l'extension %s soit au minimum en version %s et par conséquent il ne peut pas être construit avec la version chargée (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Le nom du l'analyseur Pygments %r est inconnu"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Analyse lexicale de literal_bloc impossible en \"%s\". Mise en évidence annulée."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
-msgstr ""
+msgstr "plusieurs fichiers trouvés pour le document \"%s\" : %r\nUtiliser %r pour la compilation."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "document illisible, il sera ignoré."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "La classe Builder %s n'a pas d'attribut « name »"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Le constructeur %r existe déjà (dans le module %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Le nom de Constructeur %s n'est ni enregistré ni accessible par point d'entrée"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Constructeur %s non enregistré"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domaine %s déjà enregistré"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domaine 1%s pas encore enregistré"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "La directive %r est déjà enregistrée sur le domaine %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Le rôle %r est déjà enregistré sur le domaine %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "L'index %r est déjà enregistré sur le domaine %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "Le type de l'objet %r est déjà enregistré"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "Le type %r crossref_type est déjà enregistré"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "L'extension source %r est déjà enregistrée"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser pour %r est déjà enregistré"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "source_parser pour %s non enregistré"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Il existe déjà un traducteur pour %r"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "Les kwargs pour add_node() doivent être un tuple de fonction (visite, départ) : %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r est déjà enregistré"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
-msgstr ""
+msgstr "le moteur de rendu mathématique %s est déjà enregistré"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "l'extension %r a été intégrée à Sphinx depuis la version %s ; cette extension est ignorée."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Exception initiale :\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "L'extension %s ne peut pas être importée"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "l'extension %r n'a pas de fonction setup(); est-elle réellement un module d'extension de Sphinx ?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "L'extension %s utilisée par ce projet nécessite au moins Sphinx v%s ; il ne peut donc pas être construit avec la version courante."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "l'extension %r a renvoyé par sa fonction setup() un type d'objet non supporté ; elle devrait renvoyer None ou un dictionnaire de méta-données"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
-msgstr ""
+msgstr "numéro PEP %s non valide"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
-msgstr ""
+msgstr "numéro RFC %snon valide"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "Le thème %r n'a pas de paramètre « theme »"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "Le thème %r n'a pas de paramètre « inherit »"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "Aucun thème nommé %r n'est trouvé, hérité de %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "le paramètre %s.%s n'apparaît dans aucune des configurations de thème recherchées"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "L'option %r n'est pas supportée pour ce thème"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "le fichier %r dans le dossier des thèmes n'est pas une archive zip valide ou ne contient aucun thème"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "Le thème nommé %r n'a pas été trouvé (le fichier theme.conf est-il bien présent ?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "Construction en cours mo : "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "Écriture... "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "tous les %d fichiers po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "cibles spécifiées pour les fichiers po %d"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "cibles périmées pour les fichiers po %d"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "tous les fichiers source"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr "le fichier %r passé dans la ligne de commande n'existe pas, "
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "le fichier %r saisi en ligne de commande n'est pas présent dans le dossier source, il sera ignoré"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "le fichier %r saisi en ligne de commande n'existe pas, il sera ignoré"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr "le fichier %r passé dans la ligne de commande n'est pas un document valide, ignoré"
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d fichiers source saisis en ligne de commande"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "cibles périmées pour les fichiers sources %d"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "Construction %s : "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "Recherche des fichiers périmés... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d trouvé"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "aucun résultat"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "Environnement de sérialisation"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "Vérification de la cohérence"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "Aucune cible n'est périmée."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "Mise à jour de l'environnement : "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s ajouté(s), %s modifié(s), %s supprimé(s)"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "Lecture des sources... "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "En attente des processus parallélisés..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "documents à écrire : %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "Document en préparation"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "Entrées dupliquées de la table des matières trouvées : %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "Copie des images... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "impossible de lire le fichier image %r: il sera copié à la place"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "impossible de copier le fichier image %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "impossible d'écrire le fichier image %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillow introuvable - copie des fichiers image"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "écriture du type MIME du fichier ..."
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
-msgstr ""
+msgstr "écriture du fichier META-INF/container.xml..."
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
-msgstr "enregistrement du fichier content.opf..."
+msgstr "Enregistrement du fichier content.opf..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "mimetype inconnu pour %s, il sera ignoré"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
-msgstr "enregistrement du fichier toc.ncx"
+msgstr "Enregistrement du fichier toc.ncx..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "fichier %s en cours d'écriture..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Le fichier d'aperçu se trouve dans %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "aucun changement dans la version %s"
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "écriture du fichier de résumé..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Fonctions de base"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Module"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "Copie des fichiers sources..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "impossible de lire %r pour la création du changelog"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "Le constructeur factice ne génère aucun fichier."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Le fichier ePub se trouve dans %(outdir)s ."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
-msgstr "enregistrement du fichier nav.xhtml..."
+msgstr "Enregistrement du fichier nav.xhtml..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "la variable de configuration \"epub_language\" (ou \"language\") ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "le paramètre de configuration \"epub_uid\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_title\" (ou \"html_title\") ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_author\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_contributor\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_description\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_publisher\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_copyright\" (ou \"copyright\") ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"epub_identifier\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "le paramètre de configuration \"version\" ne peut pas être vide pour EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
-msgstr "fichier CSS invalide : %r, le fichier sera ignoré"
+msgstr "Fichier CSS invalide : %r, sera ignoré"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "La liste des messages se trouve dans %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "cibles pour les modèles de fichiers %d"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "lecture des gabarits... "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "écriture des catalogues de messages... "
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Recherchez les éventuelles erreurs dans la sortie ci-dessus ou dans %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "lien mort: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Ancre '%s' non trouvée"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
-msgstr ""
+msgstr "Échec de la compilation de la regex dans linkcheck_allowed_redirects : %r%s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Le manuel se trouve dans %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "aucun valeur de configuration \"man_pages\" trouvée; aucun page du manuel ne sera enregistrée"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
-msgstr "enregistrement"
+msgstr "Enregistrement"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "le paramètre de configuration \"man_pages\" référence un document inconnu %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Les pages HTML sont dans %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "création du document unique"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "Enregistrement des fichiers supplémentaires"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Les fichiers Texinfo se trouvent dans %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à makeinfo\n(ou 'make info' directement ici pour l'automatiser)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "aucun paramètre de configuration \"texinfo_documents\" trouvé: aucun document ne sera écrit"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "La valeur du paramètre \"texinfo_documents\" référence un document inconnu %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
-msgstr "traitement en cours %s"
+msgstr "Traitement de %s en cours"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "résolution des références..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(dans"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "Copie des fichiers de support Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "erreur lors l'écriture du fichier Makefile : %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Les fichiers texte se trouvent dans %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "erreur lors l'écriture du fichier %s : %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Les fichiers XML se trouvent dans %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Le fichier pseudo-XML se trouve dans %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
-msgstr "le fichier de configuration de construction est corrompu : %r"
+msgstr "Le fichier de configuration de construction est corrompu : %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Les pages HTML sont dans %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Échec de lecture du fichier de configuration de construction : %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Index général"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "suivant"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "précédent"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "Génération des index"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
-msgstr "écriture des pages additionnelles"
+msgstr "Écriture des pages additionnelles"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "Copie des fichiers téléchargeables... "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "impossible de copier le fichier téléchargeable %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "Échec de la copie du fichier dans html_static_file : %s : %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
-msgstr "copie des fichiers statiques"
+msgstr "Copie des fichiers statiques"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "impossible de copier le fichier static %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "Copie des fichiers complémentaires"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
-msgstr "copie des fichiers supplémentaires impossible %r"
+msgstr "Copie des fichiers supplémentaires impossible %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Échec d'écriture du fichier de configuration de construction : %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "L'index de recherche n'a pas pu être chargé, mais tous les documents ne seront pas construits: l'index sera incomplet."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr "la page %s correspond à deux modèles dans html_sidebars: %r et %r"
+msgstr "La page %s correspond à deux motifs dans html_sidebars: %r et %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "une erreur Unicode est survenue lors du rendu de la page %s. Veuillez vous assurer que toutes les valeurs de configuration comportant des caractères non-ASCII sont des chaînes Unicode."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Un erreur est survenue lors de la génération de la page: %s.\nLa raison est: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "Export de l'inventaire des objets"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
-msgstr "Export de l'index de recherche dans %s"
+msgstr "Export de l'index de recherche en %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
-msgstr "le fichier js_file : %r est invalide, il sera ignoré"
+msgstr "Fichier js_file : %r invalide, sera ignoré"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Plusieurs math_renderers sont enregistrés. Mais aucun n'est sélectionné."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
-msgstr "math_renderer saisi %r inconnu."
+msgstr "math_renderer inconnu %r saisi."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
-msgstr "l'entrée html_extra_path %r n'existe pas"
+msgstr "L’entrée %r de html_extra_path n’existe pas"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr "l'entrée html_extra_path %r se trouve à l'intérieur de outdir"
+msgstr "L’entrée %r de html_extra_path se trouve à l’intérieur de outdir"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
-msgstr "l'entrée html_static_path %r n'existe pas"
+msgstr "L’entrée %r de html_static_path n’existe pas"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr "l'entrée html_static_path %r se trouve à l'intérieur de outdir"
+msgstr "L’entrée %r de html_static_path se trouve à l’intérieur de outdir"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
-msgstr "le fichier de logo %r n'existe pas"
+msgstr "Le fichier de logo %r n’existe pas"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
-msgstr "le fichier de favicon %r n'existe pas "
+msgstr "Le fichier de favicon %r n’existe pas "
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr "Le support pour la génération de sortie en HTML 4 est obsolète et sera supprimé dans Sphinx 7. (\"html4_writer=True\" détecté dans les options de configuration)"
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "Documentation %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Les fichiers LaTex se trouvent dans %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à (pdf)latex\n(ou 'make latexpdf' directement ici pour l’automatiser)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "aucune valeur de configuration \"latex_documents\" trouvée; aucun document de sera généré"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "La valeur du paramètre \"latex_documents\" référence un document inconnu %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Version"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "Aucune option Babel disponible pour la langue %r"
@@ -1147,94 +1150,94 @@
 msgid "copying TeX support files"
 msgstr "Copie des fichiers de support TeX"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "Copie des fichiers de support TeX..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "Copie de fichiers supplémentaires"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "Clé de configuration inconnue : latex_elements%r; ignorée."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
-msgstr ""
+msgstr "Option de thème inconnue : latex_theme_options%r, ignoré."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r n'a pas d'option « theme »"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r n'a pas d'option « %s »"
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Une exception a été levée lors de la génération, démarrage du débogueur :"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "Interrompu !"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "Erreur de balise reST  :"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Erreur d'encodage :"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
-msgstr "Le traceback complet a été sauvé dans %s, au cas où vous souhaiteriez signaler le problème aux développeurs."
+msgstr "La trace d’appels complète a été sauvegardée dans %s, au cas où vous souhaiteriez signaler le problème aux développeurs."
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Erreur de récursion :"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "Cela peut se produire avec des fichiers sources très volumineux ou profondément imbriqués. Vous pouvez  augmenter avec attention la limite de récursivité par défaut de Python de 1000 dans conf.py avec p. ex. :"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Une exception a été levée :"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Merci de rapporter ceci s'il s'agit d'une erreur utilisateur, afin d'améliorer le message d'erreur à l'avenir."
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Un rapport d'erreur peut être déposé dans le système de tickets à <https://github.com/sphinx-doc/sphinx/issues>. Merci !"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "Le numéro du job doit être strictement positif"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "Pour plus d'informations, visitez le site <https://www.sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1251,290 +1254,285 @@
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\nGénération de la documentation à partir des fichiers sources.\n\nsphinx-build génère de la documentation à partir des fichiers de SOURCEDIR et la place\ndans OUTPUTDIR. Il recherche 'conf.py' dans SOURCEDIR pour les paramètres de configuration.\nL'outil 'sphinx-quickstart' peut être utilisé pour générer des fichiers modèles,\ny compris 'conf.py'.\n\nsphinx-build peut créer de la documentation dans différents formats. Un format est\nsélectionné en spécifiant le nom du constructeur sur la ligne de commande ; le format par défaut est\nHTML. Les constructeurs peuvent également effectuer d'autres tâches liées au traitement de la documentation.\n\nPar défaut, tout ce qui est obsolète est construit. La sortie pour les fichiers sélectionnés seulement\npeut être construite en spécifiant des noms de fichiers individuels.\n"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "chemin des fichiers sources de la documentation"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "chemin du répertoire de sortie"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "une liste de fichiers spécifiques à reconstruire. Sera ignoré si l'option -a est spécifiée."
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "options générales"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "constructeur à utiliser (par defaut: HTML)"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
-msgstr "enregistrement des tous les fichiers (par défaut : enregistrement des nouveaux fichiers et des fichiers qui ont été modifiés)"
+msgstr "enregistrer tous les fichiers (par défaut : enregistrer seulement les fichiers nouveaux ou modifiés)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "ne pas utiliser un environnement sauvegardé, relire toujours tous les fichiers"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "chemin pour le cache d'environnement et de fichiers doctree (défaut : OUTPUTDIR/.doctrees) "
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "build parallèle avec N processus si possible (la valeur spéciale \"auto\" ajuste N à cpu-count)"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "chemin dans lequel se trouve le fichier de configuration (conf.py). (valeur par défaut : identique à SOURCEDIR)."
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "n'utilisez aucun fichier de configuration, seulement l'option -D"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "outre passer un paramètre du fichier de configuration"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "passer une valeur aux templates HTML"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "définit une balise : seules les blocs \"only\" avec TAG seront inclus"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "mode sourcilleux, signale toute référence manquante"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "options de la console de sortie"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "augmenter la verbosité (peut être répété)"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "aucune sortie vers stdout, seulement les avertissements vers stderr"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "aucune sortie du tout, même pas les avertissements"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "émettre une sortie de couleur (par défaut : auto-détection)"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "ne pas émettre une sortie de couleur (par défaut : auto-détection)"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "écrire les avertissements (et les erreurs) vers le fichier spécifié"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "modifier les avertissements en erreurs"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "avec -W, l'exécution se poursuit en cas d'avertissements"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
-msgstr "montrer le retraçage complet en cas d'exception"
+msgstr "montrer la trace d’appels complète si une exception est levée"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "exécuter Pdb si une exception se produit."
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "fichier %r introuvable"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "impossible de combiner l'option -a avec le nom du fichier"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "impossible d'ouvrir le fichier des avertissements %r : %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "l'option -D doit être sous la forme nom=valeur"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "l'option -A doit être sous la forme nom=valeur"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "insère automatiquement les docstrings des modules"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "tester automatiquement des extraits de code dans des blocs doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "lien entre la documentation Sphinx de différents projets"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "entrées \"todo\" pouvant être montrées ou cachées à la compilation"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "vérification de la couverture de la documentation"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "expressions mathématiques, traduites en images PNG ou SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "expressions mathématiques, transmises dans le navigateur à MathJax"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "inclusion conditionnelle du contenu basé sur la valeur de configuration"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "inclure des liens vers le code source documenté des objets Python"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "crée un fichier .nojekyll pour publier le document sur GitHub pages"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Merci de saisir un chemin valide."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Merci de saisir du texte."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Merci de saisir un des %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Merci de saisir 'y' ou 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Merci de saisir l'extension du fichier, par exemple '.rst' ou '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Bienvenue dans le kit de démarrage rapide de Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Veuillez saisir des valeurs pour les paramètres suivants (tapez Entrée pour accepter la valeur par défaut, lorsque celle-ci est indiquée entre crochets)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Chemin racine sélectionné : %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Saisissez le répertoire racine de la documentation."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "racine de la documentation."
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Erreur : un fichier conf.py a été trouvé dans le répertoire racine."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart n'écrasera pas un projet Sphinx existant."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Merci de saisir un nouveau répertoire racine (ou tapez juste Entrée)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 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 "Vous avez deux options pour l'emplacement du répertoire de construction de la sortie de Sphinx.\nSoit vous utilisez un répertoire \"_build\" dans le chemin racine, soit vous séparez les répertoires \"source\" et \"build\" dans le chemin racine."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
-msgstr "Séparer les répertoires build et source (y/n)"
+msgstr "Séparer les répertoires source et de sortie (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 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 "Dans le répertoire racine, deux autres répertoires seront créés : \"_templates\" pour les modèles HTML personnalisés et \"_static\" pour les feuilles de style personnalisées et autres fichiers statiques. Vous pouvez entrer un autre préfixe (p. ex. \".\") pour remplacer le tiret bas (\"_\")."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Préfixe de nom pour les répertoires static et de gabarits (templates)"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Le nom du projet apparaîtra à plusieurs endroits dans la documentation construite."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Nom du projet"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
-msgstr "Nom(s) de l'auteur"
+msgstr "Nom(s) de(s) l'auteur(s)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "Sphinx a la notion de « version » et de « release » pour le\nlogiciel. Chaque version peut avoir plusieurs « releases ». Par exemple, pour\nPython, la version est quelque chose comme 2.5 ou 3.0, tandis que la « release » est\nquelque chose comme 2.5.1 ou 3.0a1. Si vous n'avez pas besoin de cette double structure,\nmettez simplement la même valeur aux deux."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Version du projet"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
-msgstr "version du projet"
+msgstr "Version du projet"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1544,21 +1542,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Si les documents doivent être rédigés dans une langue autre que l’anglais, vous pouvez sélectionner une langue ici grâce à son identifiant. Sphinx utilisera ensuite cette langue pour traduire les textes que lui-même génère.\n\nPour une liste des identifiants supportés, voir\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Langue du projet"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 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 "L'extension de fichier pour les fichiers sources. En général : \".txt\" ou \".rst\". Seuls les fichiers avec cette extension sont considérés."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Extension des fichiers sources"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1566,91 +1564,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "Un document est particulier en ce sens qu'il est considéré comme le nœud supérieur de \"l'arbre des contenus\", c'est-à-dire la racine de la structure hiérarchique des documents. Normalement, il s'agit d'un \"index\", mais si votre \"index\" est un modèle personnalisé, vous pouvez également le définir sous un autre nom de fichier."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Non du fichier principal (sans extension)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Erreur : le fichier principal %s est déjà présent dans le répertoire racine du projet."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart n'écrasera pas les fichiers existants."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Merci de saisir un nouveau nom de fichier, ou de renommer le fichier existant et valider avec Entrée"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indiquer lesquelles de ces extensions Sphinx doivent être activées :"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Note : imgmath et mathjax ne peuvent pas être activés en même temps. imgmath a été désactivé."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 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 "Un fichier Makefile et un fichier de commandes Windows peuvent être générés pour vous, afin que vous puissiez exécuter par exemple `make html' au lieu d'appeler directement sphinx-build."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Création du Makefile ? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Création du fichier de commandes Windows ? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Fichier en cours de création %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Le fichier %s existe déjà, il ne sera pas remplacé"
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Terminé : la structure initiale a été créée."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Vous devez maintenant compléter votre fichier principal %s et créer d'autres fichiers sources de documentation. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Utilisez le Makefile pour construire la documentation comme ceci :\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Utilisez sphinx-build pour construire la documentation comme ceci : \n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "où « builder » est l'un des constructeurs disponibles, tel que html, latex, ou linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1660,648 +1658,649 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nEngendre les fichiers requis pour un projet Sphinx.\n\nsphinx-quickstart est un outil interactif qui pose des questions à propos de votre projet et génère un répertoire avec la structure complète nécessaire ainsi qu'un Makefile qui peut être utilisé comme alternative à sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "mode silencieux"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "racine du projet"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Options de structure"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "si spécifié, les répertoires source et build seront séparés"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "si spécifié, créé le dossier build dans le dossier source"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "remplace le point dans _templates etc."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Options basiques du projet."
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "nom du projet"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "nom de l'auteur"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "version du projet"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "version du projet"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "langue du document"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "préfixe des fichiers source"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "nom du document principal"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "utilisé epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Options d'extension"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "autoriser l'extension %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "active l'emploi d'extensions quelconques"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Création des fichiers Batchfile et Makefile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "créer un fichier makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "ne pas créer un fichier makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "créer un fichier batch"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "ne pas créer un fichier batch"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "utiliser make-mode pour Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "ne pas utiliser make-mode pour Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Gabarits de projet"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "répertoire des templates"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "définissez une variable de template"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "vous avez spécifiez \"quit\" , mais \"project\" ou \"author\" ne sont pas spécifiés."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Erreur : le chemin spécifié n'est pas un répertoire, ou les fichiers Sphinx existent déjà."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart peut générer ces fichiers seulement dans un répertoire vide. Merci de spécifier un nouveau répertoire racine."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variable de template invalide : %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
-msgstr ""
+msgstr "les espaces non blancs sont supprimés par dedent"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Légende invalide: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "le numéro de ligne spécifiée est en dehors des limites (1-%d):%r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Impossible d'utiliser les options \"%s\" et \"%s\" en même temps."
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Le fichier d'include %r est introuvable ou sa lecture a échouée."
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "L’encodage %r utilisé pour lire le fichier inclus %r semble erroné, veuillez ajouter une option :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "L'objet nommé %r est introuvable dans le fichier d'include %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "On ne peut pas utiliser \"lineno-match\" avec un \"lines\" non contigu "
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Spécification de lignes %r : aucune ligne extraite du fichier inclus %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
-msgstr ""
+msgstr "le motif global toctree %r ne correspond à aucun document"
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "le toctree contient une référence à des documents exclus %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "la table des matières contient des références à des documents inexistants %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr "entrée dupliquée trouvée dans toctree: %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Auteur de la section : "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Auteur du module : "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Auteur du code : "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Auteur : "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
-msgstr ""
+msgstr "... le contenu de acks n'est pas une liste"
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
-msgstr ""
+msgstr "... le contenu de hlist n'est pas une liste"
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
-msgstr ""
+msgstr "L'option \":file :\" de la directive csv-table reconnaît désormais un chemin absolu comme un chemin relatif du répertoire source. Veuillez mettre à jour votre document."
 
 #: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
-msgstr ""
+msgstr "Déclaration C dupliquée, également définie à %s:%s.\nLa déclaration est '.. c:%s:: %s'."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
-msgstr ""
+msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Paramètres"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
-msgstr ""
+msgstr "Valeurs retournées"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Renvoie"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Type renvoyé"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "membre"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variable"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "fonction"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
-msgstr ""
+msgstr "structure"
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "union"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "énumération"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "énumérateur"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
-msgstr ""
+msgstr "paramètre de fonction"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nouveau dans la version %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Modifié dans la version %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsolète depuis la version %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citation dupliquée %s, une autre instance dans %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "La citation %s n'est pas référencée"
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
-msgstr ""
+msgstr "Déclaration C++ dupliquée, également définie à %s:%s.\nLa déclaration est '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Paramètres du modèle"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Déclenche"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "concept"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "paramètre du modèle"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (fonction de base)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (méthode %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variable globale ou constante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (attribut %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Arguments"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "méthode"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "données"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "module"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "description de %s dupliquée pour%s; l'autre %s se trouve dans %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "Libellé dupliqué pour l'équation %s, autre instance dans %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "math_eqref_format invalide : %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "mot-clé"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "opérateur"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objet"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "exception"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "état"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "fonction de base"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variables"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Lève"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (dans le module %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (dans le module %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variable de base)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe de base)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe dans %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (méthode de la classe %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (méthode statique %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (propriété %s)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Index des modules Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Obsolète"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "méthode de classe"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "méthode statique"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "propriété"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "description dupliquée pour l'objet %s; l'autre instance se trouve dans %s, utilisez :noindex: sur l'une d'elles"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "plusieurs cibles trouvées pour le renvoi %r : %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (obsolète)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (option de directive)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "directive"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "option de directive"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "description dupliquée pour %s %s; l'autre instance se trouve dans %s"
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "variable d'environnement; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "description de l'option malformée, elle doit ressembler à \nMalformed option description %r, should look like \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" or \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "option de ligne de commande %s"
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "option de ligne de commande"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "le terme du glossaire doit être précédé d'une ligne vide"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "les termes du glossaire ne doivent pas être séparés par des lignes vides"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "le glossaire semble être mal formaté; vérifiez l'indentation"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "terme du glossaire"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "élément de grammaire"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "étiquette de référence"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "variable d'environnement"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "option du programme"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Index du module"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Page de recherche"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "libellé dupliqué %s, l'autre instance se trouve dans %s"
@@ -2311,142 +2310,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "description %s dupliquée pour %s; l'autre instance se trouve dans %s"
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "le paramètre numfig est désactivé : le paramètre :numref: est ignoré"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "Impossible de créer une référence croisée. Aucun nombre n'est attribué: %s"
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "le lien n'a pas de légende : %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
-msgstr "format de numfig_format invalide : %s (%r)"
+msgstr "numfig_format invalide : %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
-msgstr "format de numfig_format invalide : %s"
+msgstr "numfig_format invalide : %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "lablel non défini: 1%s"
+msgid "undefined label: %r"
+msgstr "label non défini: %r"
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "Impossible de créer une référence croisée. Titre ou légende introuvable: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr "Échec de création d'une référence. Ni titre ni légende trouvé : %r"
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "nouvelle configuration"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "la configuration a changé"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "les extensions ont changé"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "version non à jour de l’environnement de construction"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "le répertoire racine a changé"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Cet environnement est incompatible avec le constructeur sélectionné, veuillez choisir un autre répertoire doctree."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Échec du scan des documents dans %s : %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "le domaine %r n'est pas enregistré."
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "une table des matières auto-référencée a été trouvée. Elle sera ignorée."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
-msgstr "Le document n'est inclus dans aucune table des matières de l'arborescence."
+msgstr "Le document n'est inclus dans aucune toctree."
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "voir %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "voir aussi %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "type d'index saisie inconnu %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboles"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "table des matières avec une référence circulaire détectée, elle sera ignorée : %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "la table des matières contient une référence à un document %r qui n'a pas de titre : aucun lien ne sera généré"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr "toctree contient une référence au document non inclu %r"
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "fichier image %s illisible "
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "fichier image %s illisible : %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "le fichier téléchargé n’est pas lisible: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s a déjà des numéros de section attribués (toctree numérotés emboîtés ?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "Créerait le fichier %s."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2458,209 +2462,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nCherche récursivement dans <MODULE_PATH> des modules et packages Python et crée\ndans <OUTPUT_PATH> un fichier reST par package avec des directives automodule.\n\nLes <EXCLUDE_PATTERN>s peuvent être tout pattern de fichiers et/ou de répertoires à exclure.\n\nNote : par défaut ce script n'écrasera pas des fichiers déjà créés."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "chemin vers le module à documenter"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "patterns de fichier fnmatch-style et/ou répertoire à exclure"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "répertoire où placer toutes les sorties"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "Nombre maximum de sous-modules visibles dans la table des matières (par défaut : 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "remplacer les fichiers existants"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "suivre les liens symboliques. Très utile en combinaison avec collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "exécuter le script sans créer les fichiers"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "afficher la documentation de chaque module sur sa propre page"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "inclure le module \"_private\""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "nom du fichier de table des matières (défaut : modules)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "ne pas créer de fichier de table des matières"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "ne pas créer de titres pour le module ou package (e.g. lorsque les doctrings en fournissent déjà)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "mettre la documentation du module avant celle du sous-module"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interprète les chemins de module selon la spécification PEP-0420 des espaces implicites de noms"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "extension du fichier (par défaut : rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "générer un projet complet avec sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "ajoute module_path à la fin de sys.path, utilisé lorsque --full est présent"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "nom du projet (par défaut : nom du module principal)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "auteur(s) du projet, utilisé quand l'option -full est précisée"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "version du projet, utilisé quand l'option -full est précisée"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "révision du projet, utilisé lorsque --full est présent, par défaut reprend --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "options relatives aux extensions"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s n'est pas un répertoire"
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr "la section \"%s\" est étiquettée \"%s\""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "regex invalide %r dans %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Vérification du taux de couverture documentaire dans les sources achevée, voir les résultats dans %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "regex invalide %r dans coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr "API C non documentée : %s %s dans le fichier %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "le module %s ne pas être importé : %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "fonction python non documentée: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "classe python non documentée: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "méthode python non documentée: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "option '+' ou '-' manquante dans %s."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' n'est pas une option valide."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "%s n'est pas une option pyversion valide"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
-msgstr "type TestCode invalide"
+msgstr "type invalide de TestCode"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Exécution des doctests des sources achevée, voir les résultats dans %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "pas de code ou sortie dans le bloc %s en %s : %s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
-msgstr "code doctest invalide ignoré : %r"
+msgstr "code doctest invalide sera ignoré : %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== durées de lecture les plus lentes ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
-msgstr ""
+msgstr "le lien %r codé en dur pourrait être remplacé par un extlink (essayez d'utiliser %r à la place)"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "La directive Graphviz ne peut pas avoir simultanément du contenu et un argument de nom de fichier"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Fichier externe Graphviz %r non trouvé ou échec de sa lecture"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Directive « graphviz » sans contenu ignorée."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2670,14 +2679,14 @@
 "%r"
 msgstr "dot n'a pas produit de fichier de sortie : \nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "la commande dot %r ne peut pas être exécutée (nécessaire pour le rendu graphviz). Vérifiez le paramètre graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2687,33 +2696,35 @@
 "%r"
 msgstr "dot a terminé avec une erreur :\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format doit être « png » ou « svg »,  mais est %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot code %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graphe: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graphe"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr "Impossible d’exécuter la commande de conversion d'image %r. 'sphinx.ext.imgconverter' nécessite par défaut ImageMagick. Assurez-vous que ce dernier est installé, ou configurez l’option 'image_converter' pour faire référence à une commande de conversion ad hoc.\n\nTrace d’appels : %s"
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2723,163 +2734,173 @@
 "%r"
 msgstr "convert a terminé avec une erreur :\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "La commande LaTeX %r (nécessaire pour le rendu des équations mathématiques), ne peut pas être exécutée, vérifier le paramètre imgmath_latex"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "La commande de %s, %r, ne pas être exécuté (nécessaire pour display mathématique), vérifier la configuration imgmath_%s"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "latex de type display %r : %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex en ligne %r : %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Lien permanent vers cette équation"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "l’inventaire intersphinx a bougé : %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "chargement de l'inventaire intersphinx de %s..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "quelques problèmes ont été rencontrés avec quelques uns des inventaires, mais ils disposaient d'alternatives fonctionnelles :"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "échec d'accès à un quelconque inventaire, messages de contexte suivants :"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(disponible dans %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(dans %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr "inventaire pour la référence croisée externe non trouvé : %s"
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr "rôle pour la référence croisée externe non trouvé : %s"
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "%sexterne :%s cible de référence non trouvée : %s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "l’identifiant intersphinx %r n'est pas une chaîne. Il sera ignoré"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "Échec de la lecture de intersphinx_mapping%s; ignoré : %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "source"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "À faire"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Entrée TODO trouvée : %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<entrée originale>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(l'<<entrée originale>> se trouve dans %s, à la ligne %d)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "entrée originale"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
-msgstr "coloration syntaxique du code du module..."
+msgstr "Coloration syntaxique du code du module..."
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Code du module"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Code source de %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Vue d'ensemble : code du module"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Modules pour lesquels le code est disponible</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
-msgstr ""
+msgstr "valeur invalide pour l'option member-order : %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
-msgstr ""
+msgstr "valeur invalide pour l'option class-doc-from : %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "signature invalide pour auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "erreur pendant la mise en forme de l'argument %s:%s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "attribut manquant %s dans l'objet %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc : n'a pas réussi à déterminer %s.%s (%r) devait être documenté, l'exception suivante a été levée :\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2887,168 +2908,167 @@
 "explicit module name)"
 msgstr "module à importer pour auto-documenter %r est inconnu (essayer de placer une directive \"module\" ou \"currentmodule\" dans le document, ou de donner un nom de module explicite)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
-msgstr ""
+msgstr "Un faux objet a été détecté : %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
-msgstr ""
+msgstr "erreur lors du formatage de la signature pour %s : %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" dans le nom d'automodule n'a pas de sens"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "arguments de signature ou annotation de return donnés pour l’automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ devrait être une liste de chaînes, pas %r (dans module %s) -- __all__ sera ignoré"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
-msgstr ""
+msgstr "attribut manquant mentionné dans l'option :members: : module %s, attribut %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "Échec pour obtenir la signature de la fonction pour %s : %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "Échec pour obtenir la signature du constructeur pour %s : %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Bases : %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "attribut manquant %s dans l'objet %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "alias de %s"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "alias de TypeVar(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "Échec pour obtenir la signature de la méthode pour %s : %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
+msgstr "Invalide __slots__ trouvé sur %s. Ignoré."
 
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
-msgstr ""
+msgstr "Impossible d'analyser une valeur d'argument par défaut pour %r : %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
-msgstr ""
+msgstr "Échec de la mise à jour de la signature pour %r : paramètre non trouvé : %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "Échec de l'analyse de type_comment pour %r : %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "autosummary fait référence au document exclu %r. Ignoré"
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary : fichier stub non trouvé %r. Vérifiez votre paramètre autosummary_generate."
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
-msgstr ""
+msgstr "Un résumé automatique sous-titré nécessite l'option :toctree:. Ignoré."
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "autosummary : échec de l'importation de %s.\nIndications possibles :\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "échec de l’analyse du nom %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "échec d’importation de l'object %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate : fichier nontrouvé : %s"
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary engendre les fichiers .rst de manière interne. Mais votre source_suffix ne contient pas .rst. Ignoré."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary engendrement d’un auto-sommaire pour : %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary écriture dans %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "autosummary échec de l'importation de %s.\nIndications possibles :\n%s"
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3063,138 +3083,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nEngendre du ReStructuredText par les directives autosummary.\n\nsphinx-autogen est une interface à sphinx.ext.autosummary.generate. Il\nengendre les fichiers reStructuredText à partir des directives autosummary\ncontenues dans les fichiers donnés en entrée.\n\nLe format de la directive autosummary est documentée dans le module\nPython \"sphinx.ext.autosummary\" et peut être lu via : ::\n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "fichiers sources pour lesquels il faut produire des fichiers rST"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "répertoire où placer toutes les sorties"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "extension par défaut pour les fichiers (par défaut : %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "répertoire des templates spécifiques (par défaut : %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "membres importés du document (défaut : %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
-msgstr ""
+msgstr "documenter exactement les membres dans l'attribut __all__ du module. (par défaut : %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Arguments de mots-clés"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Exemple"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Exemples"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Notes"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Autres paramètres"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
-msgstr ""
+msgstr "Reçoit"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Références"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Avertissements"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "Yields"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
-msgstr ""
+msgstr "ensemble invalide de valeurs (accolade fermante manquante) : %s"
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
-msgstr ""
+msgstr "ensemble invalide de valeurs  (accolade ouvrante manquante) :%s"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "chaîne littérale malformée (guillemet fermant manquant) : %s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "chaîne littérale malformée (guillemet ouvrant manquant) : %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Attention"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Prudence"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Danger"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Erreur"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Indication"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Note"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Voir aussi"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Astuce"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Avertissement"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "suite de la page précédente"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "suite sur la page suivante"
@@ -3216,7 +3236,7 @@
 msgid "Table of Contents"
 msgstr "Table des matières"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Recherche"
@@ -3247,7 +3267,7 @@
 
 #: sphinx/themes/basic/defindex.html:20
 msgid "Indices and tables:"
-msgstr "Indices et tables :"
+msgstr "Index et tables :"
 
 #: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
@@ -3297,35 +3317,35 @@
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Recherchez dans %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "À propos de ces documents"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Mis à jour le %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3370,12 +3390,12 @@
 msgstr "rechercher"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Résultats de la recherche"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3417,280 +3437,278 @@
 msgid "Other changes"
 msgstr "Autres modifications"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Lien permanent vers ce titre"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Lien permanent vers cette définition"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Cacher les résultats de la recherche"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "Recherche terminée, ${resultCount} page(s) correspondant à la requête de recherche ont été trouvées."
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Recherche en cours"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Préparation de la recherche..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "La recherche est finie, %s page(s) trouvée(s) qui corresponde(nt) à la recherche."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", dans"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Agrandir la barre latérale"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Cacher les résultats de la recherche"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Réduire la barre latérale"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Agrandir la barre latérale"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Contenu"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "index trouvé avec style ancien à 4 colonnes. Possiblement un bogue d’extensions que vous utilisez : %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "La note de bas de page %s n'est pas référencée."
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "La note de bas de page # n'est pas référencée."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "incohérences de références de notes de bas de page dans le message traduit. Original : {0}, traduit : {1} "
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "incohérences de références dans le message traduit. Original : {0}, traduit : {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "incohérences de références de citation dans le message traduit. Original : {0}, traduit : {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "ncohérences de références de terme dans le message traduit. Original : {0}, traduit : {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
-msgstr ""
+msgstr "Impossible de déterminer le texte de remplacement pour le renvoi. Il peut s'agir d'un bogue."
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "plus d'une cible trouvée pour la référence %r de type 'any' : pourrait être %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
-msgstr ""
+msgstr "%s:%s cible de référence non trouvée : %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
-msgstr ""
+msgstr "%r cible de référence non trouvée : %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "impossible d'atteindre l'image distante %s%d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "impossible d'atteindre l'image distante %s%s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Format d'image inconnu : %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "le caractère source est indécodable, il sera remplacé par \"?\" : %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "ignoré"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "échoué"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
-msgstr ""
+msgstr "Problème dans le domaine %s : le champ est censé utiliser le rôle '%s', mais ce rôle ne figure pas dans le domaine."
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "nom de rôle ou de directive inconnu: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "type de node inconnu : %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "erreur de lecture : %s,%s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "erreur d'écriture : %s,%s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "le répertoire locale_dir %s n'existe pas"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Format de date invalide. Insérez la chaîne de caractères entre des guillemets simples si vous voulez l'afficher telle quelle : %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "la table des matières contient des références à des fichiers inexistants %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "exception pendant l’évaluation de l'expression de la directive only : %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "rôle par défaut %s introuvable"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Lien permanent vers cette définition"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format n'est pas défini %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Aucun ID assigné au node %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "Lien permanent vers ce terme"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "Lien permanent vers cette rubrique"
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Lien permanent vers ce tableau"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Lien permanent vers ce code"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Lien permanent vers cette image"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Lien permanent vers cette table des matières"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "impossible d'obtenir la taille de l'image. L'option :scale: est ignorée."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "toplevel_sectioning %r inconnu pour la classe %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: trop grand, ignoré."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "le titre du document n'est pas un unique node de type Text"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "le titre de node rencontré n'est apparenté à aucun parmi section, topic, table, admonition ou sidebar"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Notes de bas de page"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "options tabularcolumns et :widths: simultanément présentes. :widths: sera ignoré."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "%s est invalide comme unité de dimension. Ignoré."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "le type inconnu d’entrée d’index %s a été trouvé"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "image: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "image"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "la légende n'est pas à l'intérieur de la figure."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "type de node non-implémenté : %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "",
         "Other changes": "",
         "Overview": "",
-        "Permalink to this definition": "",
-        "Permalink to this headline": "",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "",
         "Previous topic": "",
@@ -39,7 +37,7 @@
         "Search": "",
         "Search Page": "",
         "Search Results": "",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",
@@ -59,5 +57,5 @@
         "search this documentation": "",
         "the documentation for": ""
     },
-    "plural_expr": "(n > 1)"
+    "plural_expr": "(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: French (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr_FR/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: fr_FR\n"
-"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/he/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/he/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u05e0\u05d5\u05e9\u05d0 \u05d4\u05d1\u05d0",
         "Other changes": "\u05e9\u05d9\u05e0\u05d5\u05d9\u05d9\u05dd \u05d0\u05d7\u05e8\u05d9\u05dd",
         "Overview": "\u05e1\u05e7\u05d9\u05e8\u05d4 \u05db\u05dc\u05dc\u05d9\u05ea",
-        "Permalink to this definition": "\u05e7\u05d9\u05e9\u05d5\u05e8 \u05e7\u05d1\u05d5\u05e2 \u05dc\u05d4\u05d2\u05d3\u05e8\u05d4 \u05d6\u05d5",
-        "Permalink to this headline": "\u05e7\u05d9\u05e9\u05d5\u05e8 \u05e7\u05d1\u05d5\u05e2 \u05dc\u05db\u05d5\u05ea\u05e8\u05ea \u05d6\u05d5",
         "Please activate JavaScript to enable the search\n    functionality.": "\u05d0\u05e0\u05d0 \u05d4\u05e4\u05e2\u05dc \u05d2'\u05d0\u05d5\u05d0\u05e1\u05e7\u05e8\u05d9\u05e4\u05d8 \u05e2\"\u05de \u05dc\u05d0\u05e4\u05e9\u05e8 \u05d0\u05ea\n    \u05d4\u05d7\u05d9\u05e4\u05d5\u05e9.",
         "Preparing search...": "",
         "Previous topic": "\u05e0\u05d5\u05e9\u05d0 \u05e7\u05d5\u05d3\u05dd",
@@ -39,7 +37,7 @@
         "Search": "\u05d7\u05d9\u05e4\u05d5\u05e9",
         "Search Page": "\u05d3\u05e3 \u05d7\u05d9\u05e4\u05d5\u05e9",
         "Search Results": "\u05ea\u05d5\u05e6\u05d0\u05d5\u05ea \u05d4\u05d7\u05d9\u05e4\u05d5\u05e9",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "\u05d7\u05e4\u05e9 \u05d1\u05ea\u05d5\u05da %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/he/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/he/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/he/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/he/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FIRST AUTHOR <EMAIL@ADDRESS>, 2011\n"
 "Language-Team: Hebrew (http://www.transifex.com/sphinx-doc/sphinx-1/language/he/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: he\n"
 "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: (n % 10 == 0 && n % 1 == 0 && n > 10) ? 2 : 3;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "רמת המודול"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(בתוך"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "אינדקס"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "הבא"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "הקודם"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "תיעוד %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "אינדקס"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "מהדורה"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,35 +1229,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1301,7 +1303,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1337,161 +1339,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "מחבר הקטע:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "מחבר המודול:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "מחבר הקוד:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "מחבר:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,559 +1865,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "פרמטרים"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "משתנה"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "פונקציה"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "מאקרו"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "חדש בגרסה %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "השתנה בגרסה %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr " לא מומלץ לשימוש מגרסה %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "מחלקה"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "מודול"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "מילת מפתח"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "משתנים"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "משתנה סביבה; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "משתנה סביבה"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "מודול אינדקס"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "דף חיפוש"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "ראה %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "ראה גם %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "מקור"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "לעשות"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "הטקסט המקורי"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "תיעוד"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>הראה קוד מקור ל %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>כל המודולים שיש להם קוד זמין</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "תשומת לב"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "זהירות"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "סכנה"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "שגיאה"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "רמז"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "חשוב"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "הערה"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "ראה גם"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "טיפ"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "אזהרה"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "המשך מעמוד קודם"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "חיפוש"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "ניווט"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "חפש בתוך %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "על מסמכים אלו"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "זכויות שמורות"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "עודכן לאחרונה ב %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "חיפוש"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "תוצאות החיפוש"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr "שינויים אחרים"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "קישור קבוע לכותרת זו"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "קישור קבוע להגדרה זו"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "הסתר תוצאות חיפוש"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "הרחב סרגל צד"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "הסתר תוצאות חיפוש"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "כווץ סרגל צד"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "הרחב סרגל צד"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "תוכן"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "קישור קבוע להגדרה זו"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "הערות שוליים"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "תמונה"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hi/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0905\u0917\u0932\u093e \u092a\u094d\u0930\u0915\u0930\u0923",
         "Other changes": "\u0905\u0928\u094d\u092f \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928",
         "Overview": "\u0938\u093f\u0902\u0939\u093e\u0935\u0932\u094b\u0915\u0928",
-        "Permalink to this definition": "\u0907\u0938 \u092a\u0930\u093f\u092d\u093e\u0937\u093e \u0915\u0940 \u0938\u094d\u0925\u093e\u092f\u0940 \u0915\u095c\u0940",
-        "Permalink to this headline": "\u0907\u0938 \u0936\u0940\u0930\u094d\u0937-\u092a\u0902\u0915\u094d\u0924\u093f \u0915\u0940 \u0938\u094d\u0925\u093e\u092f\u0940 \u0915\u095c\u0940",
         "Please activate JavaScript to enable the search\n    functionality.": "\u0916\u094b\u091c \u0915\u093e\u0930\u094d\u092f \u0915\u0947 \u0932\u093f\u090f \u091c\u093e\u0935\u093e \u0938\u094d\u0915\u094d\u0930\u093f\u092a\u094d\u091f \u0915\u093e \u0939\u094b\u0928\u093e \u0906\u0935\u0936\u094d\u092f\u0915 \u0939\u0948. \u0915\u0943\u092a\u092f\u093e \u091c\u093e\u0935\u093e \u0938\u094d\u0915\u094d\u0930\u093f\u092a\u094d\u091f \u0915\u094b \u0936\u0941\u0930\u0942 \u0915\u0930\u0947\u0902.",
         "Preparing search...": "\u0916\u094b\u091c \u0915\u0940 \u0924\u0948\u092f\u093e\u0930\u0940",
         "Previous topic": "\u092a\u093f\u091b\u0932\u093e \u092a\u094d\u0930\u0915\u0930\u0923",
@@ -39,7 +37,7 @@
         "Search": "\u0916\u094b\u091c",
         "Search Page": "\u0916\u094b\u091c \u092a\u0943\u0937\u094d\u0920",
         "Search Results": "\u0916\u094b\u091c \u092a\u0930\u0940\u0923\u093e\u092e ",
-        "Search finished, found %s page(s) matching the search query.": "\u0916\u094b\u091c \u092a\u0942\u0930\u094d\u0923, \u0916\u094b\u091c \u0935\u093f\u0937\u092f \u0915\u0947 \u0905\u0928\u0941\u0915\u0942\u0932 %s \u092a\u0943\u0937\u094d\u0920 \u092e\u093f\u0932\u093e (\u092e\u093f\u0932\u0947).",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "%(docstitle)s \u092e\u0947\u0902 \u0916\u094b\u091c\u0947\u0902",
         "Searching": "\u0916\u094b\u091c \u091c\u093e\u0930\u0940",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hi/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hi/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -11,134 +11,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Sumanjali Damarla <damarlasumanjali@gmail.com>, 2020\n"
 "Language-Team: Hindi (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: hi\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "स्रोत निर्देशिका (%s) नहीं मिली"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "स्रोत निर्देशिका और गंतव्य निर्देशिका समरूप नहीं हो सकतीं"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "स्फिंक्स %s संस्करण चल रहा है"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "इस परियोजना में स्फिंक्स का कम से कम %s संस्करण चाहिए और इसलिए इस संस्करण से बनाना संभव नहीं है."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "परिणाम निर्देशिका बनाई जा रही है"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "%s आयाम को स्थापित करते हुए:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'स्थापना' को जैसा कि अभी कोन्फ़.पाई में परिभाषित किया गया है, पाइथन से निर्देशित नहीं है. कृपया इसकी परिभाषा में परिवर्तन करके इसे निर्देश योग्य कर्म बनाएं. कोन्फ़.पाई को स्फिंक्स के आयाम की तरह व्यवहार के लिए इसकी आवश्कयता है."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "%s अनुवाद पढ़ा जा रहा है..."
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "संपन्न"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "अंतर्निर्मित संदेशों में उपलब्ध नहीं है"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "रक्षित स्थिति को लागू किया जा रहा है"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "असफल: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "किसी निर्माता को नहीं चुना गया, मानक उपयोग: एच्.टी.ऍम.एल."
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "सफल हुआ"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "समस्याओं के साथ समाप्त हुआ"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "%s निर्माण, चेतावनी %s (चेतावनी को गलती माने)| "
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "%s सम्पूर्ण, %s चेतावनी."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "%s निर्मित."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "निर्देशक कक्षा #node class# %r पहले से पंजीकृत है, इसके अभ्यागत निरस्त हो जाएंगे "
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "निर्देश %r पहले से पंजीकृत है, यह निरस्त हो जाएगा"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "भूमिका %r पहले से पंजीकृत है, यह निरस्त हो जाएगी"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +146,12 @@
 "explicit"
 msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर पाठन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें."
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "समानांतर पठन के लिए यह %s विस्तार अथवा आयाम सुरक्षित नहीं है | "
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +159,70 @@
 "explicit"
 msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर लेखन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें."
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "समानांतर लेखन के लिए  %s विस्तार अथवा आयाम सुरक्षित नहीं है | "
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "%s पर काम कर रहे हैं"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "विन्यास निर्देशिका में कोन्फ़.पाय #conf.py# फाइल (%s) नहीं है "
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "शब्दकोष विन्यास मान %r की उल्लंघन नहीं किया जा सकता, अनदेखा किया गया (प्रत्येक अवयव का मान रखने के लिए %r का उपयोग करें)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "विन्यास मान %r के लिए अमान्य संख्या %r, अनदेखा किया गया"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "असमर्थित प्रकार के साथ विन्यास मान %r का उल्लंघन नहीं किया जा सकता, अनदेखा किया गया"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "आरोहण में अज्ञात विन्यास मान %r, अनदेखा किया गया"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "ऐसा कोई विन्यास मान नहीं है: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "विन्यास मान %r पहले से विद्यमान है"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "आपकी विन्यास फाइल में रचनाक्रम की त्रुटि है: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "विन्यास फाइल (अथवा इसके द्वारा आयातित प्रभागों) द्वारा sys.exit() का आह्वान किया गया"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,898 +230,894 @@
 "%s"
 msgstr "विन्यास फाइल में प्रोग्राम के योग्य त्रुटि है:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "विन्यास मान `source_suffix' में अक्षर-समूह, अक्षर-समूहों की सूची, अथवा कोष की अनुमति है. लेकिन `%r' दिया गया है."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "भाग %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "चित्र %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "सारणी %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "सूची %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "`{name}` विन्यास मान, {candidates} में से एक होना चाहिए, परन्तु `{current}` दिया गया है."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; अपेक्षित {permitted}."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; मानक `{default.__name__}' का प्रयोग किया गया."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r नहीं मिला, अनदेखा किया गया."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "%r घटना पहले से विद्यमान है"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "अज्ञात घटना नाम: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "आयाम %s की needs_extensions मान में आवश्कता है, पर यह नहीं चढ़ाया गया है."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "इस परियोजना में आयाम %s का कम से कम %s संस्करण चाहिए इसलिए उपलब्ध संस्करण (%s) से बनाना संभव नहीं है."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "पिगमेंटस लेक्सर नाम %r अज्ञात है"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "literal_block का \"%s\" नियमन नहीं हो सका. विशेषअंकन छोड़ दिया गया."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "लेखपत्र पठनीय नहीं है. उपेक्षित."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "निर्माण वर्ग %s का कोई \"नाम\" भाव नहीं है"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "निर्माता %r पहले से (%s प्रभाग में) उपलब्ध है"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "निर्माता नाम %s पंजीकृत नहीं है अथवा प्रवेश स्थान पर उपलब्ध नहीं है."
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "निर्माता नाम %s पंजीकृत नहीं है"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "अधिकारक्षेत्र %s पहले से पंजीकृत है"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "अधिकारक्षेत्र %s अभी पंजीकृत नहीं है"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r निर्देश पहले से अधिकार-क्षेत्र %s में पंजीकृत है, "
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r भूमिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है, "
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r अनुक्रमणिका  पहले से अधिकार-क्षेत्र %s में पंजीकृत है"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type पहले से पंजीकृत है"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type पहले से पंजीकृत है"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r पहले से पंजीकृत है"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r का source_parser पहले से पंजीकृत है"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s का स्रोत व्याख्याता पंजीकृत नहीं है"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r के लिए अनुवादक पहले से विद्यमान है"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() के kwargs एक (visit, depart) फंक्शन टपल #function tuple# होने चाहिए: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r पहले से पंजीकृत है"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "%r आयाम को %sसंस्करण से स्फिंक्स में सम्मिलित किया जा चुका है; आयाम की उपेक्षा की गयी."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "मौलिक अपवाद:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "%s आयाम का आयात नहीं किया जा सका"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "आयाम %r में कोई सेटअप #setup()# कारक नहीं है; क्या यह वास्तव में स्फिंक्स का परिवर्धक प्रभाग है?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "इस परियोजना में प्रयुक्त %s परिवर्धक को स्फिंक्स का कम से कम %s संस्करण चाहिए; इसलिए इस संस्करण से बनाना संभव नहीं है."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "परिवर्धक %r के सेटअप() कर्म से एक असहाय वस्तु वापस मिली है; इसको 'कुछ नहीं' अथवा मेटाडाटा कोश भेजना चाहिए था"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "पाइथन अभिवृद्धि प्रस्ताव; पी.ई.पी. %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "रुपविन्यास %r में कोई \"रूप\" मान नहीं है"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "रुपविन्यास %r में कोई अनुगत मान नहीं है"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "%r नाम से कोई रूप नहीं मिला, %r द्वारा अनुगत"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "विन्यास मान %s.%s खोजे गए किसी भी रूप विन्यास में नहीं दिखा"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "विन्यास का असमर्थित रूप विकल्प %r दिया गया"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "रुपविन्यास के पथ में फाइल %r कोई प्रमाणिक ज़िप फाइल नहीं है या इसमें कोई रुपविन्यास नहीं सहेजा गया है"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "%r नामक कोई रूप विन्यास नहीं मिला (theme.conf अनुपस्थित?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s.(%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "निर्माणाधीन mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "परिणाम लिखा जा रहा है..."
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "सभी %d पी.ओ. फाइलें"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "निर्दिष्ट %d पी.ओ. फाइलों के लक्ष्य"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "%d पी.ओ. फाइलों के लक्ष्य कालातीत है"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "सभी स्रोत फाइलें"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "आदेश स्थान में दी गयी फाइल %r स्रोत निर्देशिका में नहीं है, उपेक्षा की जा रही है"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "आदेश स्थान में दी गयी फाइल %r का  नहीं है, उपेक्षा कर दी गई"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d स्रोत फाइलें आदेश स्थान में दी "
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d  फाइलों के लक्ष्य कालातीत है"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "निर्माणाधीन %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "अप्रचलित फाइलों को चिन्हित किया जा रहा है..."
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d मिला"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "एक भी नहीं मिला"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "स्थिति को परिरक्षित किया जा रहा है"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "संगतता की जांच की जा रही है"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "कोई प्रयोजन कालातीत नहीं है"
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "स्थिति का नवीनीकरण किया जा रहा है"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s जोड़ा गया, %s बदला गया, %s हटाया गया"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "स्रोतों को पढ़ा जा रहा है..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "कर्मियों की प्रतीक्षा हो रही है"
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "लेखन के लिए शेष लेखपत्र: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "लेखपत्र बनाए जा रहे हैं"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "विषय-सूची प्रविष्टि की प्रतिलिपि पायी गई: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "चित्रों की प्रतिलिपि बनाई जा रही है..."
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "चित्रलेख फाइल %r नहीं पढ़ा जा सका: इसकी प्रतिलिपि बनाई जा रही है"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "चित्रलेख फाइल %r की प्रतिलिपि नहीं की जा सकी:%s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "चित्रलेख फाइल %r नहीं लिखा जा सका:%s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "पिलो नहीं मिला - चित्र फाइलों की प्रतिलिपि बनाई जा रही है"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "%s के लिए अज्ञात लेख प्रकार, छोड़ा गया"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "%s फाइल को लिखा जा रहा है..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "संक्षिप्त विवरण फाइल %(outdir)s में है."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "%s संस्करण में कोई परिवर्तन नहीं हैं."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "सार फाइल को लिखा जा रहा है..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "अंतर्निर्मित"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "प्रभाग स्तर"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "स्रोत फाइलों की प्रतिलिपि बनाई जा रही है..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "परिवर्तन सूची बनाने के लिए %r को नहीं पढ़ा जा सका"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "मूक निर्माता से किसी फाइलों की उत्पत्ति नहीं होती."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ई-पब फाइल %(outdir)s में है."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_language\" (अथवा \"language\") खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_uid\" एक्स.एम्.एल. नाम होना चाहिए"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_title\" (अथवा \"html_title\") खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_author\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_contributor\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_description\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_publisher\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_copyright\" (अथवा \"copyright\") खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"epub_identifier\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "ई-पब3 के लिए विन्यास मान \"version\" खाली नहीं होना चाहिए"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "अमान्य css_file: %r, उपेक्षित"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "सन्देश सूचीपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d नमूना फाइलों के लक्ष्य"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "नमूनों को पढ़ा जा रहा है..."
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "सन्देश सूचीपत्रों को लिखा जा रहा है..."
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "उपरोक्त परिणाम में अथवा %(outdir)s /output.txt में त्रुटियाँ ढूँढने का प्रयास "
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "खंडित कड़ी: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "लक्ष्य '%s' नहीं मिला"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "पुस्तिका पृष्ठ %(outdir)sमें हैं."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "कोई \"man_pages\" विन्यास मान नहीं मिला; कोई नियमावली पृष्ठ नहीं लिखे जाएंगे"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "लिखा जा रहा है"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें है."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "एकल लेखपत्र संकलन किया जा रहा है"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "अतिरिक्त फाइलों को लिखा जा रहा है"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "टेक्सइन्फो पृष्ठ %(outdir)sमें हैं."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nइन्हें मेकइन्फो से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'मेक इन्फो' आदेश का उपयोग करें)"
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "कोई \"texinfo_documents\" विन्यास मान नहीं मिला; कोई लेखपत्र नहीं लिखे जाएंगे"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "\"texinfo_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "%s की प्रक्रिया जारी"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "सन्दर्भों का विश्लेषण किया जा रहा है..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (में"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "टेक्सइन्फो सहायक फाइलों की प्रतिलिपि की जा रही है..."
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "मेकफाइल लिखने में त्रुटि: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "पाठ फाइल %(outdir)s में हैं."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "%s फाइल लिखने में व्यवधान: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "छद्म-एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "निर्माण सूचनापत्र फाइल खंडित है: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें हैं."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "निर्माण सूचनापत्र फाइल को नहीं पढ़ा जा सका: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "सामान्य अनुक्रमाणिका"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "अनुक्रमणिका"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "आगामी"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "पूर्ववर्ती"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "अनुक्रमाणिका निर्मित की जा रही है"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "अतिरिक्त पृष्ठ लिखे जा रहे हैं"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "उतारी गई फाइलों की प्रतिलिपि बनाई जा रही है..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "उतारी गई फाइलों %r की प्रतिलिपि नहीं की जा सकी: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "स्थैतिक फाइल %r की प्रतिलिपि नहीं की जा सकी"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "अतिरिक्त फाइलों की प्रतिलिपियां बनाये जा रहे है| "
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "अतिरिक्त फाइल %r की प्रतिलिपि नहीं की जा सकी"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "निर्माण फाइल को नहीं लिखा जा सका: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "खोज अनुक्रमाणिका नहीं चढाई जा सकी, लेकिन सभी लेखपत्र नहीं बनाए जाएंगे: अनुक्रमणिका अपूर्ण रहेगी."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "पृष्ठ %s html_sidebars में दो आकृतियों से मिलता है: %r  %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "पृष्ठ %s की प्रस्तुति करते समय यूनिकोड त्रुटि हुई. कृपया यह सुनिश्चित कर लें कि सभी नॉन-असकी #non-ASCII# विहित विन्यास मान यूनिकोड अक्षरों में हैं."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "पृष्ठ %s की प्रस्तुति करते समय एक त्रुटि हुई.\nकारण: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "विषयवस्तुओं का भंडार बनाया जा रहा है"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s में खोज अनुक्रमाणिका भंडार बनाया जा रहा है"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "अमान्य js_file: %r, उपेक्षित"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "कई math_renderers पंजीकृत हैं. लेकिन कोई math_renderers नहीं चुना गया है."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "अज्ञात math_renderer %r दिया गया."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path प्रविष्टि %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path का प्रविष्टि %r outdir में है|  "
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path प्रविष्टि %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path का  प्रविष्टि %r outdir में है|  "
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "प्रतीकचिन्ह फाइल %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "इष्ट चिन्ह फाइल %r का अस्तित्व नहीं है"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s दिग्दर्शिका"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "लाटेक्स लेखपत्र %(outdir)s में हैं."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nइन्हें (pdf)latex से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'make latexpdf' आदेश का उपयोग करें)"
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "कोई \"latex_documents\" विन्यास मान नहीं मिला; कोई  नहीं लिखे जाएंगे"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "\"latex_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "अनुक्रमणिका"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "आवृत्ति"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r भाषा के लिए कोई बाबेल विकल्प नहीं "
@@ -1124,94 +1126,94 @@
 msgid "copying TeX support files"
 msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..."
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "अतिरिक्त फाइलों की प्रतिकृति बनाई जा रही है"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r में कोई \"रूप\" मान नहीं है"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r में कोई \"%s \" मान नहीं है"
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "निर्माण के दौरान अपवाद घटित हुआ है, दोष-मुक्तक चालू किया जा रहा "
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "कार्य खंडित "
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "रेस्ट सुसज्जा त्रुटि:"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "कूटलेखन त्रुटि:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "यदि आप इस विषय को कूटलिपिकारों के संज्ञान में लाना चाहते है तो   पिछला पूरा विवरण %s में सहेज दिया गया है"
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "पुनरावर्तन त्रुटि:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "अपवाद घटित:"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "यदि यह प्रयोक्ता की गलती थी तो कृपया इसको भी रिपोर्ट करें ताकि अगली बार गलती होने पर अधिक अर्थपूर्ण सन्देश दिया जा सके."
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "त्रुटि की सूचना <https://github.com/sphinx-doc/sphinx/issues> पर उपस्थित पंजिका में दर्ज की जा सकती है. धन्यवाद!"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "कार्य संख्या एक धनात्मक संख्या होनी चाहिए"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,271 +1232,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "अभिलेख की स्रोत फाइलों का पथ"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "परिणाम निर्देशिका का पथ"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "पुनर्निर्माण के लिए निश्चित फाइलों की सूची. यदि -a निर्दिष्ट है तो उपेक्षा कर दी जाएगी"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "सामान्य विकल्प"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "प्रयोग के लिए निर्माता (मानक: एच.टी.एम्.एल. #html#)"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "सभी फाइलें लिखें (मानक: केवल नई और परिवर्तित फाइलें लिखें)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "सहेजी गयी परिस्थिति का प्रयोग न करें, सदैव सभी फाइलों को पढ़ें"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "संचित परिस्थिति और डॉक-ट्री फाइलों का पथ (मानक: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "यदि संभव हो तो समानांतर N प्रक्रियाओं में निर्माण करें (ऑटो #auto# विशेष मान द्वारा cpu-count को N पर लगा दिया जाएगा)"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "पथ जहाँ पर विन्यास फाइल (conf.py) स्थित है (मानक: SOURCEDIR के समरूप)"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "किसी भी विन्यास फाइल का उपयोग ही न करें, मात्र -D विकल्प"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "विन्यास फाइल के एक मान का उल्लंघन करें "
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "एच.टी.एम्.एल. के नमूने में राशि प्रेषित करें"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "नाम-पत्र परिभाषित करें: केवल नाम-पत्र वाले खण्डों का समावेश करें"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "गहन जांच का पालन करें, सभी अनुपस्थित संदर्भों के बारे में सचेत करें"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "प्रदर्शित परिणामों के विकल्प"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "शब्द-प्रयोग बढ़ाएं (पुनरावृत्ति की जा सकती है) "
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "एस.टी.डी आउट #stdout# पर कोई परिणाम नहीं, एस.टी.डी एरर #stderr# पर चेतावनियाँ "
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "कुछ भी निर्गमित नहीं, यहाँ तक कि चेतावनी भी नहीं"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "रंगीन परिणाम ही दिखाएँ (मानक: स्वतः अनुमानित)"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "रंगीन परिणाम नहीं दिखाएँ (मानक: स्वतः अनुमानित)"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "चेतावनियाँ (और त्रुटियाँ) दी गई फाइल में लिखें"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "चेतावनियों को अशुद्धि मानें"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "अपवाद होने पर पूरा विलोम-अनुगमन देखें"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "अपवाद होने पर पी.डी.बी. चलाएं"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "%r फाइलों को नहीं ढूँढा जा सका"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "-a विकल्प और फाइल के नामों को सम्मिलित नहीं किया जा सकता"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "चेतावनी फाइल %r नहीं खोली जा सकी: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "-D विकल्प का मान नाम = मान के रूप में होना आवश्यक है"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "-A विकल्प का मान नाम = मान के रूप में होना आवश्यक है"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "प्रभागों में से डॉक्-स्ट्रिंग स्वतःसम्मिलित करें"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "डॉक्-टेस्ट अंशों के निर्देश भाग की स्वतः जाँच करें"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "भिन्न परियोजनाओं के स्फिंक्स प्रलेखों का पारस्परिक सम्बन्ध करने दें"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "वह \"शेष\" प्रविष्टियाँ लिख लें, जिन्हें निर्माण के समय दिखाया या छिपाया जा सकता है"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "प्रलेखों की व्याप्ति की जाँच करें"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "गणित को सम्मिलित करें, पी.एन.जी. अथवा एस.वी.जी. में चित्रित"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "गणित को सम्मिलित करें, दिग्दर्शक में मैथजाक्स #MathJax# द्वारा प्रदर्शित"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "विन्यास मान के आधार पर सामिग्री का सशर्त समावेश"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "पाइथन विषयवस्तुओं के प्रलेखों के स्रोत निर्देश की कड़ी जोड़ें"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "गिटहब GitHub पर लेखपत्र प्रकाशित करने के लिए .nojekyll फाइल बनाएं"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "कृपया एक मान्य पथ का नाम दें"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "कृपया कुछ वाक्यांश लिखें"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "%s में से एक चुनें"
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "कृपया हाँ के लिए 'y' अथवा नहीं के लिए 'n' मात्र दें. "
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "कृपया एक फाइल प्रत्यय दें, जैसे कि '.rst' अथवा '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "स्फिंक्स %s त्वरित-आरंभ #sphinx-quickstart# उपकरण के लिए अभिनन्दन"
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "कृपया निम्न विन्यासों के लिए मान प्रदान करें (मानक मान, यदि कोष्ठक में हो तो, स्वीकार करने के लिए एन्टर दबाएँ)"
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "चुना हुआ बुनियादी तथा मूल स्थान: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "आलेख का बुनियादी स्थान बताएं."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "आलेख का बुनियादी पथ"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "त्रुटि: एक मौजूदा conf.py फाइल दिए गए मूल पथ में प्राप्त हुई है."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "स्फिंक्स-त्वरित-आरम्भ #sphinx-quickstart# मौजूदा स्फिंक्स परियोजनाओं पर पुनर्लेखन नहीं करेगा."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "कृपया एक नया मूल पथ दें (अथवा निकलने हेतु सिर्फ एन्टर #Enter# कर दें)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "आपके पास Sphinx द्वारा बनाई गई फाइलों को सहेजने के लिए दो विकल्प हैं.\nया तो आप मूल स्थान में ही \"_build\" निर्देशिका प्रयोग करें, अथवा\nमूल पथ में भिन्न \"स्रोत\" और \"build\" निर्देशिका प्रयोग करें."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "विभिन्न स्रोत और निर्माण डायरेक्टरी (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "मूल निर्देशिका के अन्दर, दो और निर्देशिका बनाई जाएँगी;\nपरिवर्धित एच.टी.एम्.एल. नमूनों के लिए \"_templates\" और परिवर्धित रुपपत्रों और अन्य स्थैतिक फाइलों के लिए \"_static\"\nआप अधोरेखा के स्थान पर अन्य पूर्व-प्रत्यय (जैसे कि \".\") का प्रयोग कर सकते हैं."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "नमूने और स्थैतिक डायरेक्टरी के लिए पूर्व-प्रत्यय"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "परियोजना का नाम बनाये गए प्रपत्रों में बहुत से स्थानों पर प्रयुक्त होगा."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "परियोजना का नाम"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "लेखक(कों) का नाम"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1503,15 +1500,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "परियोजना संस्करण"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "परियोजना आवृत्ति"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1521,21 +1518,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "यदि प्रलेखों को अंग्रेजी के अलावा अन्य किसी भाषा में लिखा जाना है,\nतो यहाँ पर आप भाषा का कूटशब्द दे सकते हैं. स्फिंक्स तदपुरांत,\nजो वाक्यांश बनाता है उसे उस भाषा में अनुवादित करेगा.\n\nमान्य भाषा कूटशब्द सूची यहाँ पर देखें\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "परियोजना की भाषा"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "स्रोत फाइल का प्रत्यय"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1540,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "आपने मुख्य लेखपत्र का नाम दें (प्रत्यय रहित)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "त्रुटि: मुख्य फाइल %s चुने हुए मूल पथ में पहले से उपलब्ध है."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "स्फिंक्स-त्वरित-आरम्भ मौजूदा फाइलों पर पुनर्लेखन नहीं करेगा."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "कृपया एक नया फाइल नाम दें, अथवा मौजूदा फाइल का पुनर्नामकरण करें और एन्टर दबाएँ"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "इनमें से कौन सा स्फिंक्स आयाम प्रयोग करना है, इंगित करें:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "टिप्पणी: imgmath और mathjax एक साथ समर्थ नहीं हो सकते. imgmath को अचिन्हित कर दिया गया है."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "मेकफाइल बनाएं? (हाँ के लिए y/ ना के लिए n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "विंडोज़ कमांड फाइल बनाएं? (हाँ के लिए y/ ना के लिए n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "फाइल बनाई जा रही है ...%s"
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "फाइल %s पहले से उपस्थित है, छोड़ दी गई."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "समाप्त: एक प्रारंभिक निर्देशिका का ढांचा बना दिया गया है."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,230 +1634,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nस्फिंक्स परियोजना के लिए आवश्यक फाइल बनाएं.\n\nस्फिंक्स-त्वरित-आरम्भ एक संवादपूर्ण उपकरण है जो आपकी परियोजना के \nबारे में कुछ प्रश्न पूछकर पूरी प्रलेखों की निर्देशिका और नमूना मेकफाइल \nबना देता है जिसे स्फिंक्स-बिल्ड में प्रयोग किया जा सकता है.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "शांत ढंग "
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "ढांचे के विकल्प"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "यदि निर्दिष्ट हो तो विभिन्न स्रोत और निर्माण पथ"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "_templates आदि में बिंदु का बदलाव"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "परोयोजना के मूलभूत विकल्प"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "परियोजना का नाम"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "लेखकों के नाम"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "परियोजना का संस्करण"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "परियोजना की आवृत्ति"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "लेखपत्र की भाषा"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "स्रोत फाइल का प्रत्यय"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "मुख्य लेखपत्र का नाम"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "ई-पब प्रयोग करें"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "आयाम के विकल्प"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "आयाम %s सक्षम करें"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "स्वेच्छित आयाम सक्षम करें"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "मेकफाइल और बैचफाइल का सर्जन"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "मेकफाइल बनाएं"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "मेकफाइल नहीं बनाएं"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "बैचफाइल बनाएं"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "बैचफाइल नहीं बनाएं"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat के लिए make-mode का प्रयोग करें"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat के लिए make-mode का प्रयोग नहीं करें"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "परियोजना नमूनावृत्ति"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "नमूना फाइलों के लिए नमूना निर्देशिका"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "नमूना चर-पद का निरूपण करें"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"शांत\" निर्दिष्ट है, परन्तु कोई भी \"परियोजना\" अथवा \"लेखक\" निर्दिष्ट नहीं है."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "त्रुटि: दिया गया पथ निर्देशिका नहीं है, अथवा स्फिंक्स फाइलें पहले से उपस्थित हैं."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "स्फिंक्स-त्वरित-आरम्भ केवल एक खाली निर्देशिका में कार्यशील हो सकती है. कृपया एक नया मूल पथ निर्दिष्ट करें."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "अमान्य नमूना चर-पद: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "अमान्य शीर्षक: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "पंक्ति संख्या का ब्यौरा सीमा से बाहर है (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "दोनों \"%s\" और \"%s\" विकल्पों का प्रयोग नहीं किया जा सकता"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "समावेशित फाइल %r नहीं मिली अथवा पढने में असफलता मिली"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "कूटलेखन %r जो कि सम्मिलित फाइल %r में प्रयुक्त है, अशुद्ध प्रतीत हो रही है, एक :encoding: विकल्प देकर प्रयत्न करें"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "%r नामक विषयवस्तु सम्मिलित फाइल %r में नहीं मिली"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "\"lineno-match\" का प्रयोग बिना जुडी \"lines\" के युग्म के साथ नहीं हो सकता"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "लाइन ब्यौरा %r: सम्मिलित फाइल %r से कोई लाइन नहीं ली जा सकीं"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "विषय-सूची-संरचना में छोड़े गए लेखपत्र %r का सन्दर्भ है"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "विषय-सूची-संरचना में अविद्यमान लेखपत्र %r का सन्दर्भ है"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "भाग के लेखक:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "प्रभाग लेखक:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "निर्देश लेखक:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "लेखक:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1871,414 +1868,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "मापदण्ड"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "प्रदत्त "
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "प्रदत्त प्रकार "
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "सदस्य"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "चर पद"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "फंक्शन"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "मैक्रो"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "युग्म"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "गणक"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "प्रगणक "
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "प्रकार"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "संस्करण %s से नया "
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "संस्करण %s से अलग "
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "संस्करण %s से प्रतिबंधित "
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "प्रतिरूप उद्धरण %s, दूसरी प्रतिकृति %s में है "
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "उद्धरण %s सन्दर्भ कहीं नहीं है"
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "नमूना मानदण्ड "
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "देता है "
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "वर्ग"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "अवधारणा "
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (अंतर्निर्मित फंक्शन)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s विधि)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (वर्ग)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (वैश्विक चरपद अथवा अचर) "
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s लक्षण)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "चर "
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (प्रभाग)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "पद्धति"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "आंकड़े "
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "लक्षण"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "प्रभाग"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "समीकरण का प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है "
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "अमान्य math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "मुख्य-शब्द "
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "चालक"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "वस्तु"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "अपवाद "
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "वक्तव्य "
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "अंतर्निर्मित कर्म"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "चर पद "
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "उभारता है "
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s प्रभाग में )"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s प्रभाग में )"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (अंतर्निर्मित चर पद)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (अंतर्निर्मित वर्ग)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s वर्ग में)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s वर्ग विधि) "
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s स्थैतिक विधि)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "पाइथन प्रभाग सूची"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "प्रभाग"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "अवमानित "
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "वर्ग विधि"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "स्थैतिक पद्धति"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "पारस्परिक-सन्दर्भों के लिए एक से अधिक लक्ष्य मिले %r: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr "(अवमानित)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (निर्देश)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (भूमिका)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "निर्देश"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "भूमिका"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "परिस्थिति चर पद; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "अशुद्ध रूप विकल्प विवरण %r, अपेक्षित प्रारूप \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" अथवा \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "पारिभाषिक पद"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "व्याकरण संकेत "
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "सन्दर्भ शीर्षक"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "परिस्थिति चर पद "
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "प्रोग्राम विकल्प "
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "लेखपत्र"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "प्रभाग सूची"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "खोज पृष्ठ"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है "
@@ -2288,142 +2286,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig असमर्थ है. :numref: उपेक्षित है."
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "कड़ी का कोई शीर्षक नहीं है: %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "अमान्य numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "अमान्य numfig_format: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "नव विन्यास"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "विन्यास परिवर्तित"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "आयाम परिवर्तित"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "निर्मित परिस्थिति वर्तमान संस्करण नहीं है "
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "स्रोत निर्देशिका परिवर्तित हो चुकी है "
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "यह परिस्थिति चुने गए निर्माता से मेल नहीं खाती, कृपया दूसरी डॉक-ट्री निर्देशिका चुनें. "
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "लेखपत्रों के पर्यवेक्षण में असफलता %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "अधिकारक्षेत्र %r पंजीकृत नहीं है"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "स्वयं-संदर्भित विषय-सूची-संरचना मिली है. उपेक्षा की गई."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "लेखपत्र किसी भी विषय-सूची-संरचना में सम्मिलित नहीं है"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%s देखिए"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "%s भी देखिए"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार अज्ञात %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "संकेत "
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "पारस्परिक संदर्भित विषय-सूची-संरचना सन्दर्भ पाए गए, उपेक्षा की जा रही है: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "विषय-सूची-संरचना में लेखपत्र %r, जिसका कोई शीर्षक नहीं है, का सन्दर्भ है: कोई सम्बन्ध नहीं बनाया जा सकेगा"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "चित्र फाइल पठनीय नहीं है: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "चित्र फाइल %s पठनीय नहीं है: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "उतारी गई फाइल पठनीय नहीं है: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s में पहले से भाग संख्या नियत है (एक के अन्दर दूसरा अंकित विषय-सूची-संरचना)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "%s फाइल बन जाएगी."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2438,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\n<MODULE_PATH> में पाइथन प्रभाग और पैकेज की पुनरावर्तित खोज करें और\nस्वतःप्रभाग निर्देश द्वारा <OUTPUT_PATH> में प्रति पैकेज एक रेस्ट #reST# फाइल बनाएं.\n\n<EXCLUDE_PATTERN> फाइल और/ अथवा निर्देशिका स्वरुप हो सकते हैं\nजो निर्माण प्रकिया में छोड़ दिए जाएंगे.\n\nनोट: सामान्यतया यह स्क्रिप्ट किसी पहले से बनाई गई फाइल पर पुनर्लेखन नहीं करती."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "प्रभाग से लेखपत्र का पथ"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "fnmatch-style फाइल और/ अथवा निर्देशिका स्वरुप जो निर्माण प्रक्रिया से छोड़ने हैं"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "सभी परिणामों को सहेजने के लिए निर्देशिका"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "विषय-सूची में दिखाए जाने वाले उपप्रभागों की अधिकतम गहराई (मानक: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "मौजूदा फाइलों पर पुनर्लेखन करें"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "सांकेतिक कड़ियों का अनुसरण करें. कलेक्टिव.रेसिपी.ऑमलेट के साथ प्रभावशाली. "
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "फाइलों को बनाए बिना स्क्रिप्ट चलाएं "
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "प्रत्येक प्रभाग के आलेख उसके अपने पृष्ठ में रखें"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "\"_private\" प्रभाग को सम्मिलित करें "
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "विषय-सूची की फाइल का नाम (मानक: प्रभाग) "
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "विषय-सूची की फाइल न बनाएं "
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "प्रभाग/पैकेज पैकेजों का शीर्षक न बनाएं (उदाहरणार्थ, जब डॉकस्ट्रिंग्स में यह पहले से हों) "
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr " मुख्य प्रभाग के आलेख को उपप्रभाग के आलेख से पहले रखें"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "प्रभाग पथ की व्याख्या 'पी.ई.पी.-0420 निहित नामराशि विवरण' के आधार पर करें "
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "फाइल प्रत्यय (मानक: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "स्फिंक्स-त्वरित-आरम्भ के साथ पूर्ण परियोजना उत्पन्न करें "
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "मोड्यूल_पाथ #module_path# को सिस.पाथ #sys.path# में जोड़ें, जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "परियोजना का नाम (मानक: मूल प्रभाग का नाम) "
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "परियोजना लेखक(गण), जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "परियोजना संस्करण, जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "परियोजना आवृत्ति, जब --full दिया जाता है तब इसका प्रयोग होता है "
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "आयाम विकल्प "
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s एक निर्देशिका नहीं है. "
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "अमान्य रेगएक्स #regex# %r, %s में "
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "स्रोतों की व्यापकता की जांच पूरी, परिणाम %(outdir)spython.txt में देखें. "
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "अमान्य रेगएक्स #regex# %r, coverage_c_regexes में "
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "प्रभाग %s का आयत नहीं किया जा सका: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "'%s' विकल्प में अनुपस्थित '+' या '-'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' एक मान्य विकल्प नहीं है."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' एक मान्य पाईवर्शन #pyversion# विकल्प नहीं है. "
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "अमान्य टेस्टकोड का प्रकार "
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "स्रोतों में डॉकटेस्ट्स की जांच पूरी, परिणाम %(outdir)s/output.txt में देखें. "
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "%s भाग में %s पर कोई निर्देश / परिणाम नहीं: %s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "अमान्य डॉकटेस्ट निर्देश की उपेक्षा की जा रही है: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "ग्राफविज़ निर्देश में दोनों मापदंड, विषय-वस्तु और फाइल का नाम, नहीं हो सकते"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "बाहरी ग्राफविज़ फाइल %r नहीं मिली अथवा पढने में असफलता मिली"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "विषय-वस्तु के बिना ग्राफविज़ निर्देश की उपेक्षा की जा रही है. "
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2655,14 @@
 "%r"
 msgstr "डॉट ने किसी परिणाम फाइल का नहीं बनाया:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "डॉट निर्देश %r नहीं चलाया जा सकता (ग्राफविज़ परिणाम के लिए आवश्यक), ग्राफविज़_डॉट मान की जांच करें"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2672,35 @@
 "%r"
 msgstr "डॉट त्रुटि के साथ बहार आ गया:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "ग्राफविज़_आउटपुट_फॉर्मेट का 'पी.एन.जी', 'एस.वी.जी.', होना आवश्यक है, पर यह %r है"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "डॉट निर्देश %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graph: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graph"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2710,173 @@
 "%r"
 msgstr "परिवर्तक त्रुटि के साथ बहार आ गया:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "लाटेक्स आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). आई.एम्.जी.मैथ_लाटेक्स मान की जाँच करें"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). imgmath_%s मान की जाँच करें"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "लाटेक्स दिखाएँ %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "पंक्तिबद्ध लाटेक्स %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "इस समीकरण की स्थायी कड़ी"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "इन्टरस्फिंक्स सामान स्थानांतरित हो चुका है: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "इन्टरस्फिंक्स सामान को %s से चढ़ाया जा रहा है ..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "कुछ चीजों के साथ कुछ समस्या है, लेकिन काम के दूसरे विकल्प उपलब्ध हैं: "
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "कुछ चीजों पहुँचने में असफलता मिली और यह समस्याएँ मिलीं: "
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s में)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(%s में)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "इन्टरस्फिंक्स निर्धारक %r अक्षरमाला नहीं है. उपेक्षित"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "स्रोत"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "अपूर्ण "
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "अपूर्ण प्रविष्टि मिली: %s "
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<मूल प्रविष्टि>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<मूल प्रविष्टि>> %s, पंक्ति %d में उपस्थित है.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "मौलिक प्रविष्टि"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "प्रभाग निर्देश विशिष्ट रूप से दर्शाया जा रहा है..."
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "प्रभाग निर्देश"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s का स्रोत निर्देश </h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "सिंहावलोकन: प्रभाग निर्देश"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>सभी प्रभाग जिनके लिए निर्देश उपलब्ध है</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "स्वतः %s (%r) के लिए अमान्य हस्ताक्षर"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "%s के पदों का प्रारूप बनाने में व्यवधान: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "%s गुण %s वस्तु में अनुपस्थित"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2884,112 @@
 "explicit module name)"
 msgstr "पता नहीं है कि कौन सा प्रभाग स्वतःप्रलेखन %r के लिए आयात करना है (लेखपत्र में \"प्रभाग\" या \"वर्तमान-प्रभाग\" निर्देश रख कर देखें; अथवा स्पष्ट प्रभाग नाम देकर देखें)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "स्वतः प्रभाग नाम में \"::\"  विवेकहीन है"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "स्वतः-प्रभाग %s के लिए हस्ताक्षर पद अथवा प्रत्युत्तरित टिप्पणी प्रदान की गई"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) --  __all__ की उपेक्षा की जाएगी"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "आधार: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "%s गुण %s वस्तु में अनुपस्थित"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +2997,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "पद-विच्छेदन में असफलता: %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "विषय-वस्तु के आयात में असफलता: %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "ऑटोसमरी आतंरिक रूप से आर.एस.टी. फाइलें बनाता है. आपके सोर्स_सफिक्स में आर.एस.टी. सम्मिलित नहीं है. छोड़ा गया."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "ऑटोसमरी अब इसका स्वतःसारांश बना रहा है: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "ऑटोसमरी %s पर लिख रहा है"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3044,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3059,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nस्वतः सारांश #autosummary# निर्देश का प्रयोग करते हुए पुर्नसरंचितपाठ बनाता है.\n\nस्फिंक्स-ऑटोजेन स्फिंक्स.एक्स्ट.ऑटोसमरी.जेनेरेट का मुखड़ा है.\nयह प्रदत्त फाइलों में सम्मिलित ऑटो समरी निर्देशों के अनुसार पुर्नसरंचितपाठ बनाता है\n\nस्वतः सारांश #autosummary# निर्देश का प्रारूप स्फिंक्स.एक्स्ट.ऑटोसमरी \nपाइथन प्रभाग में निबंधित है और इसे आप निम्नलिखित माध्यम से पढ़ सकते हैं:\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "आर.एस.टी. फाइलें बनाने के लिए स्रोत फाइलें"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "सभी परिणाम रखने के लिए निर्देशिका"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "फाइलों के लिए मानक प्रत्यय (मानक: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "पारंपरिक प्रारूप निर्देशिका (मानक: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "लेखपत्र आयातित सदस्य (मानक: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "मुख्य शब्दों के चर-पद"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "उदाहरण"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "कुछ उदाहरण"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "टिप्पणियाँ"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "अन्य मापदण्ड"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "सन्दर्भ"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "चेतावनी देता है"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "मिलता है"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "सावधानी"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "चेतावनी"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "खतरा"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "गलती"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "संकेत"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "महत्त्वपूर्ण"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "टिप्पणी "
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "यह भी देखिए"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "सलाह"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "चेतावनी"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "पिछले पृष्ठ से जारी"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "अगले पृष्ठ पर जारी"
@@ -3193,7 +3212,7 @@
 msgid "Table of Contents"
 msgstr "विषय-सूची"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "खोज"
@@ -3274,35 +3293,35 @@
 msgid "Navigation"
 msgstr "संचालन"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s में खोजें"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "इन लेखपत्रों के बारे में"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "सर्वाधिकार"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">सर्वाधिकार</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; सर्वाधिकार %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "अंतिम बार सम्पादित %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3366,12 @@
 msgstr "खोज"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "खोज परीणाम "
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,280 +3413,278 @@
 msgid "Other changes"
 msgstr "अन्य परिवर्तन"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "इस शीर्ष-पंक्ति की स्थायी कड़ी"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "इस परिभाषा की स्थायी कड़ी"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "खोजे गए जोड़े छिपाएं"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "खोज जारी"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "खोज की तैयारी"
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "खोज पूर्ण, खोज विषय के अनुकूल %s पृष्ठ मिला (मिले)."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", में "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "किनारे का स्थान बढ़ाएं"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "खोजे गए जोड़े छिपाएं"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "किनारे का स्थान घटाएं"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "किनारे का स्थान बढ़ाएं"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "विषय सामिग्री"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "4 पंक्तिबद्ध सूचियाँ मिलीं. यह आपके द्वारा उपयोग किए गए आयाम की त्रुटि हो सकती है: %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "पाद-टिप्पणी %s का कोई सन्दर्भ नहीं है."
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "पाद-टिप्पणी # सन्दर्भ कहीं नहीं है"
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "अनुवादित संदेश में असंगत पाद-टिप्पणी के प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "अनुवादित संदेश में असंगत प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "अनुवादित संदेश में असंगत उद्धरण के प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "अनुवादित संदेश में असंगत शब्द के प्रसंग. मूल: {0}, अनुवादित: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "किसी भी पारस्परिक-सन्दर्भ के लिए एक से अधिक लक्ष्य मिले %r: %s संभव"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "अज्ञात चित्र प्रारूप: %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "असाधनीय स्रोत अक्षर, \"?\" द्वारा बदले जा रहे हैं: %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "छोड़ा "
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "असफल"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "अज्ञात बिंदु प्रकार: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "अशुद्धि पाठन: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "अशुद्धि लेखन: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "अमान्य तिथि प्रारूप. यदि आप सीधे परिणाम में दर्शाना चाहते हैं तो अक्षरमाला को एकाकी उद्धरण चिन्ह द्वारा चिन्हित करें: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "विषय-सूची-संरचना में अविद्यमान फाइल %r का सन्दर्भ है"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "केवल निर्देशक भाव का मूल्यांकन करते समय अपवाद: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "मानक भूमिका '%s' नहीं मिली"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "इस परिभाषा की स्थायी कड़ी"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "%s के लिए नमफिग_फॉर्मेट नहीं बताया गया है"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "%s बिंदु के लिए कोई पहचान-चिन्ह नहीं दिया गया"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "इस सारणी की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "इस निर्देश की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "इस चित्र की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "इस विषय-सूची-संरचना की स्थायी कड़ी"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "चित्र का आकार नहीं मिल सका. :scale: विकल्प की उपेक्षा की जा रही है."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "अज्ञात %r उच्चतमस्तर_विभाजन #toplevel_sectioning# %r वर्ग के लिए"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr "अत्याधिक अधिकतम गहराई # :maxdepth: #, उपेक्षित किया गया."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "लेखपत्र का शीर्षक एकल पाठ बिंदु नहीं है"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "पाया गया शीर्ष बिंदु किसी भाग, प्रसंग, तालिका, विषय-प्रबोध अथवा पार्श्व-स्थान में नहीं है"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "पाद टिप्पणियां"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "दोनों तालिका-स्तंभ और :चौड़ाई: विकल्प दिए गए हैं. :चौड़ाई:  मान की उपेक्षा की जाएगी."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "परिमाण मात्रक %s अमान्य है. उपेक्षा की जाएगी."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार %s मिला"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "चित्र: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "चित्र"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "शीर्षक रेखाचित्र के भीतर नहीं है"
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "अकार्यान्वित बिंदु प्रकार: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Hindi (India) (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi_IN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: hi_IN\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hr/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hr/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Sljede\u0107a tema",
         "Other changes": "Ostale promjene",
         "Overview": "Pregled",
-        "Permalink to this definition": "Link na tu definiciju",
-        "Permalink to this headline": "Link na taj naslov",
         "Please activate JavaScript to enable the search\n    functionality.": "Molimo omogu\u0107ite JavaScript\n    za djelovanje tra\u017eilice.",
         "Preparing search...": "Priprema pretrage...",
         "Previous topic": "Prija\u0161nja tema",
@@ -39,7 +37,7 @@
         "Search": "Tra\u017ei",
         "Search Page": "Tra\u017eilica",
         "Search Results": "Rezultati pretrage",
-        "Search finished, found %s page(s) matching the search query.": "Pretraga zavr\u0161ena, prona\u0111eno %s stranica.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Tra\u017ei izme\u0111u %(docstitle)s",
         "Searching": "Pretra\u017eivanje",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hr/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hr/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hr/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hr/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Mario Šarić, 2015-2020\n"
 "Language-Team: Croatian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: hr\n"
 "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nema izvornog direktorija (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Izvorni i odredišni direktorij ne smiju biti jednaki"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Izrada pomoću Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ovaj projekt se ne može izgraditi s instaliranom verzijom, potrebno je instalirati Sphinx v%s ili višu verziju."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "izrada izlazne mape"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' koji je postavljen u conf.py nije moguće pozvati. Molimo izmijenite definiciju 'setup' funkcije kako bi ju mogli izvršiti iz Pythona. Ovo je potrebno kako bi conf.py imao karakter Sphinx proširenja. "
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "učitavanje prijevoda %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "napravljeno"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "neuspješno: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Nije odabran format, koristi se zadani: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "uspješno"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "završeno uz probleme"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s upozorenje."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "u konfiguracijskom direktoriju ne postoji datoteka conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "ne može se nadjačati osnovna konf. postavka %r, zanemarena je (koristite %r za postavljanje pojedinačnih elemenata)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "nepravilan broj %r za konf. vrijednost %r, zanemaruje se"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "ne može se nadjačati konf. vrijednost %r zbog nepodržanog tipa, zanemareno"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "nepoznata konfiguracijska vrijednost %r, zanemaruje se"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Ne postoji konfiguracijska vrijednost: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfiguracijska vrijednost %r već postoji"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Postoji sintaksna greška u konfiguracijskoj datoteci: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Poglavlje %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Slika %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tablica %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Ispis %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r nije pronađen, zanemareno je."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Događaj %r već postoji"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nepoznato ime događaja: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ovaj projekt treba proširenje %s najmanje u verziji %si stoga se ne može izraditi s postojećom verzijom (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Klasa %s nema \"name\" svojstvo"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r već postoji (u modulu %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder imena %s nije registriran ili dostupan pomoću poziva"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder %s nije registriran"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domena %s je već registrirana"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domena %s nije još registrirana"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser za %r je već registriran"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "proširenje %r se već nalazi u Sphinxu od verzije %s; ovo proširenje se zanemaruje."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Izvorna iznimka:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Proširenje %s ne može biti uvezena"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "proširenje %r nema funkciju setup(); radi li se o ispravnom Sphinx modulu proširenja?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "%s proširenje traži Sphinx verzije v%s; stoga projekt ne može biti izgrađen s ovom verzijom."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "proširenje %r vratio je nepodržan objekt iz setup() funkcije;  rezultat treba biti None ili riječnik metapodataka"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r nema postavku \"theme\""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r nema postavku \"inherit\""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "tema %r nije pronađena, nasljeđuje ju %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "postavka %s.%s ne pojavljuje se u pretraženim konfiguracijama tema"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "datoteka %r iz teme nije ispravna (zip) arhiva ili ne sadrži temu"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nema teme %r (nedostaje theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Ugrađeni dijelovi"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Nivo modula"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (u "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Opceniti abecedni indeks"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "abecedni indeks"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "naprijed"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "nazad"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentacija"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Abecedni popis"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Distribucija"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,35 +1229,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1301,7 +1303,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1337,161 +1339,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Neispravan navod: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Ne mogu se istovremeno koristiti *%s* i *%s* opcije"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Include datoteka %r nije pronađena ili se ne može pročitati"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Encoding %r za čitanje import datoteke %r nije ispravan, pokušajte dodati :encoding: opciju"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objekt %r nije pronađen u include datoteci %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Ne može se koristiti \"lineno-match\" sa nespojivom grupom \"lines\""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Specifikacija retka %r: nema redaka preuzetih iz include datoteke %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor sekcije: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor modula: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autor koda:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,559 +1865,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Vraća"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Vraća tip"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "član"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "varijabla"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tip"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Novo u verziji %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Promijenjeno u verziji %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastarijelo od verzije %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parametri predloška"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Baca (iznimke)"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "razred"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (ugrađene funkcije)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metoda)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (razred)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globalna varijabla ili konstanta)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atribut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumenti"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metoda"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "podaci"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "dvostruka oznaka jednakosti %s, drugo pojavljivanje u %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "ključna riječ"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "izuzetak"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "izjava"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "ugrađen funkcije"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Varijable"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Podiže"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (u modulu %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (u modulu %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (ugrađene variable)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (ugrađen razred)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (razred u %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s metoda klase)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statična metoda)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python indeks modula"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "Moduli"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Zastarjelo"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "metoda klase"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statična metoda"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (zastarjelo)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "Direktive"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "uloga"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "varijabla okruženja; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "termin rječnika"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "token gramatike"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "referentna oznaka"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "varijabla okruženja"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programske mogućnosti"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Popis modula"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Tražilica"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "pogledajte %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "Dodatne informacije: %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboli"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "nedostaje '+' ili '-' u '%s' opciji."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' nije valjana opcija."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' nije valjana pyversion opcija"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Graphviz direktiva ne može imati i sadržaj i ime datoteke za argumente"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Vanjska Graphviz datoteka %r ne postoji ili se ne može čitati"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignoriranje \"graphviz\" direktive bez sadržaja."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot naredba %r ne može se pokrenuti (potrebna za graphviz izlaz), provjerite postavku graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format mora biti 'png' ili 'svg', ali je %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graph: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graph"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Link na tu definiciju"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(u %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "source"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> se nalazi u %s, redak %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "izvorna stavka"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Kod modula"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Izvorni kod za %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Pregled: kod modula"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Svi moduli za koje je dostupan kod</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Osnovice: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumenti"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Primjeri"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Pozor"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Pažnja"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Opasnost"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Greška"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Savjet"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Važno"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Napomena"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Više informacija"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Savjet"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Upozorenje"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "nastavak sa prethodne stranice"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Traži"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "Navigacija"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Traži između %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "O ovim dokumentima"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Sva prava zadržana"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Sva prava zadržana</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Sva prava zadržana %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Zadnji put ažurirano %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "traži"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Rezultati pretrage"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr "Ostale promjene"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link na taj naslov"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link na tu definiciju"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Sakrij rezultate pretrage"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Pretraživanje"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Priprema pretrage..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Pretraga završena, pronađeno %s stranica."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", u "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Pokaži pomoćnu traku"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Sakrij rezultate pretrage"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Sakrij pomoćnu traku"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Pokaži pomoćnu traku"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Sadržaj"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "više od jednog targeta za 'any' referencu %r: može biti %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Link na tu definiciju"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Permalink na ovu tablicu"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Permalink na ovaj kod"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Permalink na ovu sliku"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Permalink na ovaj sadržaj"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Fusnote"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "slika: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "slika"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hu/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hu/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "K\u00f6vetkez\u0151 t\u00e9mak\u00f6r",
         "Other changes": "Egy\u00e9b v\u00e1ltoz\u00e1sok",
         "Overview": "\u00c1ttekint\u00e9s",
-        "Permalink to this definition": "Hivatkoz\u00e1s erre a defin\u00edci\u00f3ra",
-        "Permalink to this headline": "Hivatkoz\u00e1s erre a fejezetc\u00edmre",
         "Please activate JavaScript to enable the search\n    functionality.": "K\u00e9rem enged\u00e9lyezze a JavaScriptet a keres\u0151 funkci\u00f3\n    haszn\u00e1lat\u00e1hoz.",
         "Preparing search...": "Felk\u00e9sz\u00fcl\u00e9s a keres\u00e9sre...",
         "Previous topic": "El\u0151z\u0151 t\u00e9mak\u00f6r",
@@ -39,7 +37,7 @@
         "Search": "Keres\u00e9s",
         "Search Page": "Keres\u00e9s",
         "Search Results": "Keres\u00e9si Eredm\u00e9nyek",
-        "Search finished, found %s page(s) matching the search query.": "A keres\u00e9s befejez\u0151d\u00f6tt, %s oldal egyezik a keres\u00e9si fel\u00e9teleknek.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Keres\u00e9s k\u00f6zt\u00fck: %(docstitle)s",
         "Searching": "Keres\u00e9s folyamatban",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hu/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hu/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/hu/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/hu/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -13,134 +13,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Balázs Úr, 2020\n"
 "Language-Team: Hungarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hu/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: hu\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nem található a forráskönyvtár (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "A forráskönyvtár és célkönyvtár nem lehet azonos"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx %s verzió futtatása"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ez a projekt legalább a Sphinx %s verzióját igényli, és emiatt nem állítható össze ezzel a verzióval."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "kimeneti könyvtár elkészítése"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "a(z) %s kiterjesztés beállításakor:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 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 "A „setup”, ahogy jelenleg a conf.py fájlban meg van határozva, nem meghívható Python függvény. Módosítsa a meghatározását, hogy meghívható függvénnyé tegye. Ez ahhoz szükséges, hogy a conf.py Sphinx kiterjesztésként viselkedjen."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "fordítások betöltése %s…"
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "kész"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "nem érhető el beépített üzenetekhez"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "pickle-t környezet betöltése"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "sikertelen: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Nincs összeállító kiválasztva, az alapértelmezett használata: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "sikerült"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "problémákkal befejeződött"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)"
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "%s összeállítás, %s figyelmeztetés."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "%s összeállítás, %s figyelmeztetés."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "%s összeállítás."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "a(z) %r csomópontosztály már regisztrálva van, a látogatói felül lesznek bírálva"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "a(z) %r direktíva már regisztrálva van, felül lesz bírálva"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -148,12 +148,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -161,64 +161,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "a beállítási könyvtár nem tartalmaz conf.py fájlt (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,898 +232,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "%s. bekezdés"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "%s. ábra"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "%s. táblázat"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "%s. felsorlás"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Fejlesztési Javaslatok; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Beépített"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Modul szint"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " ("
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Általános tárgymutató"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "nyitóoldal"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "következő"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "előző"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s dokumentáció"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Tárgymutató"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Kiadás"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1126,94 +1128,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1232,271 +1234,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1505,15 +1502,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1523,21 +1520,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1545,91 +1542,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1639,230 +1636,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "A megadott útvonal nem egy mappa vagy a sphinx állományok már léteznek."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Fejezet szerző: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Modul szerző: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Kód szerző: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Szerző: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1873,414 +1870,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Paraméterek"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Visszatérési érték"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Visszatérés típusa"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "tag"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "változó"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "függvény"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makró"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enumeráció"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerátor"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "típus"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Új a(z) %s verzióban"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "A %s verzióban változott"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Elavult a(z) %s verzió óta"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Sablonparaméterek"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Dob"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "osztály"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (beépített függvény)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metódus)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (osztály)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globális változó vagy konstans)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribútum)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumentum"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metódus"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "adat"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attribútum"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "kulcsszó"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operátor"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objektum"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "kivétel"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "utasítás"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "beépített függvény"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Változók"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Kivétel"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s modulban)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s modulban)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (beépített változó)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (beépített osztály)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (osztály %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s osztály metódus)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statikus metódus)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python Modul Mutató"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "modulok"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Elavult"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "osztály szintű metódus"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statikus metódus"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (elavult)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktíva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (szerepkör)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktíva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "szerepkör"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "környezeti változó; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "szójegyzék"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "nyelvtani jel"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "referencia cimke"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "környezeti változó"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "program opció"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Modulok"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Keresés"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2290,142 +2288,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "forrás mappa megváltozott"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "lásd %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "lásd még %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Szimbólumok"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2437,209 +2440,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s nem mappa"
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2649,14 +2657,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2666,33 +2674,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graph: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graph"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2702,163 +2712,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Állandó hivatkozás erre az egyenletre"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "source"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Tennivaló"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "eredeti bejegyzés"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Modul forráskód"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s forráskódja</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Áttekintés: modul forráskód"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Az összes modul, melynek forrása elérhető</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2866,113 +2886,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2980,46 +2999,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3027,7 +3046,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3042,138 +3061,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Figyelem"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Figyelem"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Veszély"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Hiba"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Tipp"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Fontos"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Megjegyzés"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Lásd még"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Javaslat"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Figyelem"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "folytatás az előző oldalról"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3195,7 +3214,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Keresés"
@@ -3276,35 +3295,35 @@
 msgid "Navigation"
 msgstr "Navigáció"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Keresés köztük: %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Névjegy ezekről a dokumentumokról"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Minden jog fenntartva"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Utolsó frissítés %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3349,12 +3368,12 @@
 msgstr "keresés"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Keresési Eredmények"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3396,280 +3415,278 @@
 msgid "Other changes"
 msgstr "Egyéb változások"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Hivatkozás erre a fejezetcímre"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Hivatkozás erre a definícióra"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Keresési Találatok Elrejtése"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Keresés folyamatban"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Felkészülés a keresésre..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "A keresés befejeződött, %s oldal egyezik a keresési felételeknek."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Oldalsáv kinyitása"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Keresési Találatok Elrejtése"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Oldalsáv összezárása"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Oldalsáv kinyitása"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Tartalom"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Hivatkozás erre a definícióra"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Permalink erre a táblázatra"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Permalink erre a kódrészletre"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Permalink erre a képre"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Lábjegyzetek"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "image: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "image"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/id/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/id/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Topik berikutnya",
         "Other changes": "Perubahan lain",
         "Overview": "Tinjauan",
-        "Permalink to this definition": "Link permanen untuk definisi ini",
-        "Permalink to this headline": "Link permanen untuk headline ini",
         "Please activate JavaScript to enable the search\n    functionality.": "Tolong aktifkan JavaScript untuk melakukan pencarian.\n ",
         "Preparing search...": "Penyiapkan pencarian...",
         "Previous topic": "Topik sebelumnya",
@@ -39,7 +37,7 @@
         "Search": "Pencarian",
         "Search Page": "Pencarian Halaman",
         "Search Results": "Hasil Pencarian",
-        "Search finished, found %s page(s) matching the search query.": "Pencarian selesai, menemukan %s halaman yang cocok dengan kueri pencarian.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Pencarian dalam %(docstitle)s",
         "Searching": "Pencarian",
         "Searching for multiple words only shows matches that contain\n    all words.": "Mencari beberapa kata hanya menunjukkan kecocokan yang mengandung\n \u00a0\u00a0 semua kata.",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/id/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/id/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/id/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/id/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -12,134 +12,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: oon arfiandwi <oon.arfiandwi@gmail.com>, 2019-2020\n"
 "Language-Team: Indonesian (http://www.transifex.com/sphinx-doc/sphinx-1/language/id/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: id\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Tidak dapat menemukan direktori sumber (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Direktori sumber dan direktori tujuan tidak boleh sama"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Menjalankan Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Proyek ini memerlukan sedikitnya Sphinx v%s dan maka itu tidak bisa dibangun dengan versi ini."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "membuat direktori keluaran"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "saat menyiapkan ekstensi %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' yang saat ini didefinisikan pada conf.py bukanlah sebuah Python callable. Silakan modifikasi definisinya untuk membuatnya menjadi fungsi callable. Hal ini diperlukan guna conf.py berjalan sebagai ekstensi Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "memuat terjemahan %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "selesai"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "tidak tersedia untuk built-in messages"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "memuat lingkungan yang diawetkan"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "gagal: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Tidak ada builder yang dipilih, menggunakan default: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "berhasil"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "selesai with masalah"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "bangun %s, %s peringatan (dengan peringatan dianggap sebagai kesalahan)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s peringatan."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "kelas simpul %r sudah terdaftar, pengunjungnya akan diganti"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "pengarahan %r sudah terdaftar, itu akan diganti"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "peran %r sudah terdaftar, itu akan diganti"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -147,12 +147,12 @@
 "explicit"
 msgstr "ekstensi %s tidak akan dinyatakan jika itu aman untuk pembacaan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "ekstensi %s tidak aman untuk pembacaan paralel"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -160,64 +160,70 @@
 "explicit"
 msgstr " \nekstensi %s tidak akan dinyatakan jika itu aman untuk penulisan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "ekstensi %s tidak aman untuk penulisan paralel"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "mengerjakan serial %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "direktori konfigurasi tidak berisi berkas conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "tidak dapat menulis ulang pengaturan direktori konfigurasi %r, mengabaikan (gunakan %r untuk mengatur elemen-elemen satuan)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "nomor %r yang salah untuk konfigurasi nilai %r, mengabaikan"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "tidak dapat menulis ulang pengaturan konfigurasi %r dengan tipe yang tidak didukung, mengabaikan"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "nilai konfigurasi %r yang tidak dikenal pada penulisan ulang, mengabaikan"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Tidak terdapat nilai konfigurasi demikian: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Nilai konfigurasi %r sudah ada"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Ada kesalahan sintaksis dalam file konfigurasi Anda: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Berkas konfigurasi (atau salah satu dari modul terimpor) disebut sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -225,898 +231,894 @@
 "%s"
 msgstr "Terdapat kesalahan programmable dalam berkas konfigurasi anda:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Nilai konfigurasi `source_suffix 'mengharapkan sebuah string, daftar string, atau kamus. Tetapi `%r' diberikan."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Bab %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Gambar. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabel %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Daftar %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Nilai konfigurasi `{name}` harus salah satu dari {candidates}, tapi `{current}` diberikan."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Nilai konfigurasi `{name}' memiliki tipe `{current.__name__}'; diharapkan {permitted}."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Nilai konfigurasi `{name}` bertipe `{current.__name__}', default menjadi `{default.__name__}'."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r tidak ditemukan, diabaikan."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Event %r sudah ada"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nama event tidak dikenal: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Ekstensi %s diperlukan oleh pengaturan needs_extensions, tapi itu tidak dimuat."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Proyek ini memerlukan ekstensi %s sedikitnya pada versi %s dan maka itu tidak bisa dibangun dengan versi yang dimuat (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Nama Pygments lexer %r tidak diketahui"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Tidak dapat menjalankan lex literal_block sebagai \"%s\". Menyoroti yang terlewat."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "dokumen tidak dapat dibaca. Diabaikan."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Class Builder %s tidak punya atribut \"name\""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r sudah ada (di modul %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Nama Builder %s todal terdaftar atau tersedia melalui entry point"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Nama Builder %s tidak terdaftar"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domain %s telah terdaftar"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domain %s belum didaftarkan"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Pengarahan %r sudah terdaftar di domain %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Peran %r sudah terdaftar di domain %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Indeks %r sudah terdaftar ke domain %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "object_type %r telah didaftarkan"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "crossref_type %r telah didaftarkan"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r telah didaftarkan"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser untuk %r telah didaftarkan"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Parser sumber untuk %s tidak terdaftar"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Penerjemah untuk %r sudah ada"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs untuk add_node() harus berupa (visit, depart) function tuple: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r telah terdaftar"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "ekstensi %r telah digabungkan dengan Sphinx sejak versi %s; ekstensi diabaikan."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Eksepsi orisinal:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Tidak dapat mengimpor ekstensi %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "ekstensi %r tidak memiliki fungsi setup(); apa itu benar-benar sebuah modul ekstensi Sphinx?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Ekstensi %s yang digunakan proyek ini memerlukan sedikitnya Sphinx v%s; maka itu tidak bisa dibangun dengan versi ini."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "ekstensi %r mengembalikan objek yang tidak didukung dari fungsi setup() nya; seharusnya mengembalikan None atau dictionary metadata"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r tidak memiliki pengaturan \"tema\""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r tidak memiliki pengaturan \"inherit\""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "tema berjudul %r tidak ditemukan, inherited oleh %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "pengaturan %s.%s terjadi pada tak satupun konfigurasi tema yang dicari"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "opsi tema yang tidak didukung %r diberikan"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "berkas %r pada path tema merupakan berkas zip yang tidak valid atau tidak berisi tema"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "tema bernama %r tidak ditemukan (kehilangan theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "membangun mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "menulis keluaran... "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "semua dari %d berkas po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "target untuk %d berkas po yang telah ditetapkan"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "target untuk %d berkas po telah usang"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "semua berkas sumber"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "berkas %r yang diberikan di command line tidak berada dalam direktori sumber, mengabaikan"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "berkas %r yang diberikan di command line tidak tersedia, mengabaikan"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d berkas sumber diberikan di command line"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "target untuk %d berkas sumber yang telah usang"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "membangun %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "mencari berkas yang kini-usang... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d ditemukan"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "tidak ditemukan apapun"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "lingkungan pengawetan"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "memeriksa konsistensi"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "tidak ada target yang usang."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "memperbarui lingkungan:"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s ditambahkan, %s diubah, %s dihapus"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "membaca sumber... "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "menunggu workers..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames yang akan ditulis: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "menyiapkan dokumen"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "entri ToC ganda ditemukan: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "menyalin gambar... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "tidak dapat membaca berkas gambar %r: menyalin gambar sebagai gantinya"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "tidak dapat menyalin berkas gambar %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "tidak dapat menulis berkas gambar %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillow tidak ditemukan - menyalin berkas gambar"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "mimetype yang tidak dikenal untuk %s, mengabaikan"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "menulis %s berkas..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Berkas tinjauan berada di %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "tidak ada pengubahan dalam versi %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "menulis berkas ringkasan..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Modul Internal"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Level Modul"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "menyalin berkas sumber..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "tidak dapat membaca %r untuk pembuatan changelog"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "Builder contoh tidak menghasilkan berkas apapun."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Berkas ePub berada di %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "nilai conf \"epub_language\" (atau \"language\") tidak seharsunya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "nilai conf \"epub_uid\" harus berupa XML NAME untuk EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "nilai conf \"epub_title\" (atau \"html_title\") tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_author\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_contributor\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_description\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_publisher\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "nilai conf \"epub_copyright\" (atau \"copyright\") tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "nilai conf \"epub_identifier\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "bilai conf \"version\" tidak seharusnya kosong untuk EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file yang salah: %r, mengabaikan"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Katalog pesan berada di %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "target untuk %d berkas templat"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "membaca templat... "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "menulis katalog pesan... "
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Mencari kesalahan sembarang dalam keluaran di atas atau di %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "tautan rusak: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Anchor '%s' tidak ditemukan"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Halaman manual berada di %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "tidak ditemukan nilai konfigurasi \"man_pages\"; halaman manual tidak akan ditulis"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "penulisan"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" nilai konfigurasi mengacu pada dokumen tidak diketahui %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Halaman HTML berada di %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "merakit dokumen tunggal"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "menulis file tambahan"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Berkas Texinfo berada di %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui makeinfo\n(gunakan 'make info' di sini untuk melakukannya secara otomatis)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "tidak ditemukan nilai konfigurasi \"texinfo_documents\"; dokumen tidak akan ditulis"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "nilai konfigurasi \"texinfo_documents\" mereferensikan dokumen yang tidak dikenal %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "memroses %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "memecahkan referensi..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (dalam "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "menyalin berkas pendukung Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "kesalahan menulis berkas Makefile: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Berkas teks berada di %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "kesalahan menulis berkas %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Berkas XML berada di %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Berkas pseudo-XML berada di %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "berkas info build rusak: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Halaman HTML berada di %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Gagal membaca berkas info build: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indeks Umum"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "berikut"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "sebelum"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "menghasilkan indeks"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "menulis halaman tambahan"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "menyalin berkas yang dapat diunduh... "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "tidak dapat menyalin berkas yang dapat diunduh %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "tidak dapat menyalin berkas statik %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "menyalin berkas tambahan"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "tidak dapat menyalin berkas ekstra %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Gagal menulis berkas info build: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "indeks pencarian tidak dapat dimuat, tapi tidak semua dokumen akan dibangun: indeks akan jadi tidak lengkap."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "halaman %s sebanding dengan dua pola dalam html_sidebars: %r dan %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "kesalahan Unicode terjadi saat render halaman %s. Silakan pastikan semua nilai konfigurasi yang berisi konten non-ASCII adalah string Unicode."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Kesalahan terjadi saat render halaman %s.\nAlasan: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "menyisihkan persediaan obyek"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file yang salah: %r, mengabaikan"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Banyak math_renderers teregistrasi. Namun tidak satu pun math_renderer yang dipilih."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "math_renderer %r yang tidak diketahui diberikan."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "entri html_extra_path %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "entri html_static_path %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "berkas logo %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "berkas favicon %r tidak ada"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentasi %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Berkas LaTeX berada di %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui (pdf)latex\n(gunakan 'make latexpdf' di sini untuk melakukannya secara otomatis)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "tidak ditemukan nilai konfigurasi \"latex_documents\"; dokumen tidak akan ditulis"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "nilai konfigurasi \"latex_documents\" mereferensikan dokumen yang tidak dikenal %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Rilis"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "tidak ada opsi Babel yang dikenal untuk bahasa %r"
@@ -1125,94 +1127,94 @@
 msgid "copying TeX support files"
 msgstr "menyalin berkas pendukung TeX"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "menyalin berkas pendukung TeX... "
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "menyalin berkas tambahan"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Eksepsi terjadi saat membangun, memulai debugger:"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "Diinterupsi"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "markup reST salah:"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Kesalahan encoding:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Traceback lengkap telah disimpan di %s, bila ingin melaporkan masalah ini kepada developer."
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Kesalahan rekursi:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Terjadi eksepsi:"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Mohon juga melaporkan hal ini jika sebuah kesalahan pengguna sehingga lain kali perintah salah yang lebih baik dapat disediakan."
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Laporan bug dapat diisi pada tracker di <https://github.com/sphinx-doc/sphinx/issues>. Terima kasih!"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "job number seharusnya sebuah bilangan positif"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1231,271 +1233,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "path ke berkas sumber"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "path ke direktori output"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "daftar berkas spesifik yang dibuat ulang. Diabaikan jika -a ditentukan"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "opsi umum"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "builder yang digunakan (default: html)"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "tulis semua berkas (default: hanya tulis berkas yang baru dan diubah)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "jangan pakai saved environment, selalu baca semua berkas"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "path untuk the cached environment dan berkas doctree (default: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "build secara parallel dengan N processes jika memungkinkan (nilai spesial \"auto\" akan menetapkan N ke cpu-count)"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "path tempat berkas konfigurasi (conf.py) berada (default: sama seperti SOURCEDIR)"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "jalankan tanpa berkas sama sekali, hanya opsi -D"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "override sebuah aturan di berkas konfigurasi"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "masukkan sebuah nilai ke templat HTML"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "define tag: masukkan blok \"only\" dengan TAG"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "mode nit-picky, ingatkan tentang semua referensi yang hilang"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "opsi output konsol"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "tingkatkan verbosity (dapat diulang)"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "tanpa output pada stdout, hanya peringatan pada stderr"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "tanpa output sama sekali, peringatan sekalipun"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "siarkan output berwarna (default: auto-detect)"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "jangan siarkan output berwarna (default: auto-detect)"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "tulis peringatan (dan galat) pada berkas terpilih"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "ubah peringatan menjadi galat"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "tampilkan traceback penuh pada eksepsi"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "jalankan Pdb pada eksepsi"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "tidak dapat mencari berkas %r"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "tidak dapat menggabungkan opsi -a dan nama berkas"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "tidak dapat membuka berkas peringatan %r: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "argumen opsi -D harus dalam bentuk name=value"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "argumen opsi -A harus dalam bentuk name=value"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "masukkan docstrings secara otomatis dari modules"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "uji snippet kode secara otomatis pada blok doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "tautkan antara dokumentasi Sphinx dari berbagai proyek"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "tulis entri \"todo\" yang dapat ditampilan atau disembunyikan dalam build"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "periksa coverage dokumentasi"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "masukkan math, yang dirender sebagai gambar PNG atau SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "masukkan math, yang dirender di perambah sebagai gambar PNG atau SVG"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "inklusi bersyarat untuk isi berdasarkan nilai konfig"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "masukkan tautan ke sumber kode untuk objek Python yang terdokumentasi"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "buat berkas .nojekyll untuk menerbitkannya di halaman GitHub"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Mohon masukkan nama path yang sah."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Mohon masukan teks."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Mohon masukkan satu dari %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Mohon ketik salah satu dari 'y' atau 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Mohon masukkan satu suffiks berkas, contohnya '.rst' atau '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Selamat datang ke alat quickstart Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Silakan masukkan nilai untuk pengaturan berikut (cukup tekan Enter to\nmenerima nilai bawaan, jika diberikan dalam tanda kurung)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Masukkan jalur root untuk dokumentasi."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Root path dokumentasi"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Galat: berkas conf.py telah ditemukan dalam root path terpilih."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart tidak akan menulis ulang proyek Sphinx yang ada."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Silakan masukkan root path baru (atau tekan Enter untuk keluar)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Pisahkan direktori source dan build (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Nama prefiks untuk dir templat dan static"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Nama proyek akan muncul di beberapa tempat dalam dokumentasi yang dibuat."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Nama proyek"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Nama(-nama) pembuat"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1504,15 +1501,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Versi proyek"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Rilis proyek"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1522,21 +1519,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Bahasa proyek"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Akhiran berkas sumber"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1544,91 +1541,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Nama dokumen master Anda (tanpa akhiran)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Kesalahan: file master %s telah ditemukan di jalur utama yang dipilih."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart tidak akan menimpa berkas yang sudah ada."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Silakan masukkan nama file baru, atau ganti nama file yang ada dan tekan Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Tunjukkan ekstensi Sphinx berikut mana yang harus diaktifkan:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Catatan: imgmath dan mathjax tidak dapat diaktifkan secara bersamaan. imgmath telah diubah tidak pilih."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Buat Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Buat berkas perintah Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Membuat file %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "File %s sudah ada, lewati."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Selesai: Struktur direktori awal telah dibuat."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "di mana \"pembangun\" adalah salah satu pembangun yang didukung, mis. html, lateks, atau periksa tautan."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1638,230 +1635,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nHasilkan file yang diperlukan untuk proyek Sphinx. \n\nsphinx-quickstart adalah alat interaktif yang menanyakan beberapa pertanyaan tentang proyek Anda \ndan kemudian menghasilkan direktori dokumentasi lengkap dan contoh \nMakefile untuk digunakan dengan sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "mode diam"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "root proyek"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Opsi struktur"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "jika ditentukan, pisahkan direktori sumber dan pembangunan"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "pengganti dot di _templates dll."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Opsi dasar proyek"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "nama proyek"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "nama penulis"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "versi proyek"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "rilis proyek"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "bahasa dokumen"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "akhiran berkas sumber"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "nama dokumen utama"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "gunakan epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Opsi ekstensi"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "aktifkan ekstensi %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "aktifkan ekstensi berubah-ubah"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Pembuatan Makefile dan Batchfile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "buat makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "jangan membuat makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "buat batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "jangan membuat batchfile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "gunakan mode-make untuk Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "jangan gunakan make-mode untuk Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Membuat templat proyek"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "direktori templat untuk berkas templat"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "mendefinisikan variabel templat"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" ditentukan, tetapi tidak ada \"project\" atau \"author\" yang ditentukan."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Kesalahan: jalur yang ditentukan bukan direktori, atau file sphinx sudah ada."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart hanya menghasilkan direktori kosong. Silakan tentukan jalur utama baru."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variabel templat tidak valid: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Keterangan tidak valid: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "spesifikasi nomor baris di luar kisaran (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Tidak dapat menggunakan kedua opsi \"%s\" dan \"%s\""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Berkas yang disertakan %r tidak ditemukan atau gagal membacanya"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Pengkodean %r yang digunakan untuk membaca file yang disertakan %r tampaknya salah, mencoba berikan opsi :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objek bernama %r tidak ditemukan disertakan di berkas %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Tidak dapat menggunakan \"lineno-match\" dengan rangkaian \"baris\" yang terpisah"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Spesifikasi baris %r: tidak ada baris yang ditarik dari berkas %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree berisi referensi ke dokumen yang dikecualikan %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree berisi referensi ke dokumen yang tidak ada %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Penyusun bagian:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Penyusun modul: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Penulis kode:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Penyusun: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1872,414 +1869,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parameter"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Kembali"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Return type"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "anggota"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variabel"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "fungsi"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "union"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipe"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Baru pada versi %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Berubah pada versi %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Ditinggalkan sejak versi %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "kutipan rangkap %s, contoh lain dalam %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Kutipan %s tidak dirujuk."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parameter Templat"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Throws"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "class"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "konsep"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (fungsi built-in)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (method %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (class)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variabel global atau konstan)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumen"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "method"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplikasi label persamaan %s, misalnya di %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Math_eqref_format tidak valid: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "keyword"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "object"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "eksepsi"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "statement"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "fungsi built-in"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variabel"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Raises"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (di modul %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (di modul %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variabel built-in)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (class built-in)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (class di %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (method class %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (method static %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Indeks Modul Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "modul"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Akan ditinggalkan"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "method class"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "method static"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "lebih dari satu target ditemukan untuk referensi silang %r: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (obsolet)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktif)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktif"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "opsi-direktif"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "variabel environment; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Deskripsi opsi salah bentuk %r, seharusnya terlihat seperti \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" atau \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "opsi baris perintah"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "Daftar Istilah kata sulit harus didahului dengan baris kosong"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "Daftar istilah kata sulit tidak boleh dipisahkan oleh garis kosong"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "Daftar istilah kata sulit tampaknya salah format, periksa indentasi"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "daftar istilah"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "token grammar"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "label referensi"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "variabel environment"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opsi program"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "dokumen"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Indeks Modul"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Pencarian Halaman"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "label rangkap %s, contoh lain dalam %s"
@@ -2289,142 +2287,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig dinonaktifkan. :numref: diabaikan."
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "tautan tidak memiliki teks: %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "numfig_format tidak valid: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "numfig_format tidak valid: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "konfigurasi baru"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "konfigurasi berubah"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "ekstensi berubah"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "membangun lingkungan bukan versi saat ini"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "direktori sumber telah berubah"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Lingkungan ini tidak kompatibel dengan pembangun yang dipilih, silakan pilih direktori doctree lain."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Gagal memindai dokumen dalam %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Domain %r tidak terdaftar"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "totree referensikan sendiri ditemukan. Diabaikan"
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "dokumen tidak termasuk dalam toctree"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "lihat %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "lihat juga %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "tipe entri indeks tidak dikenal %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simbol"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "referensi toctree melingkar terdeteksi, mengabaikan: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree berisi referensi ke dokumen %r yang tidak memiliki judul: tidak ada tautan yang akan dihasilkan"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "berkas gambar tidak dapat dibaca: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "berkas gambar %s tidak dapat dibaca: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "berkas unduhan tidak dapat dibaca: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s sudah diberi nomor bagian (penomoran bersarang toctree?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "Akan membuat berkas %s."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2436,209 +2439,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nLihat secara rekursif dalam <MODULE_PATH> untuk modul dan paket Python dan buat \nsatu berkas reST dengan arahan automodule per paket di <OUTPUT_PATH>. \n\n<EXCLUDE_PATTERN> dapat berupa pola berkas dan/atau direktori yang akan \ndikecualikan dari pembuatan. \n\nCatatan: Secara bawaan skrip ini tidak akan menimpa berkas yang sudah dibuat."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "jalur ke modul ke dokumen"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "Berkas gaya-fnmatch dan/atau pola direktori untuk dikecualikan dari pembuatan"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "direktori untuk menempatkan semua keluaran"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "kedalaman maksimum submodul untuk ditampilkan di TOC (bawaan: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "menimpa file yang ada"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ikuti tautan simbolik. Berdaya bila digabungkan dengan collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "operasikan skrip tanpa membuat file"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "letakkan dokumentasi untuk setiap modul di halamannya sendiri"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "termasuk modul \"_private\""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "nama file daftar isi (bawaan: modul)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "jangan membuat berkas daftar isi"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "jangan membuat judul untuk paket modul/paket (mis. ketika docstrings sudah berisi hal tersebut)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "letakkan dokumentasi modul sebelum dokumentasi submodul"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "menafsirkan jalur modul sesuai dengan spesifikasi namespaces implisit PEP-0420"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "akhiran berkas (bawaan: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "menghasilkan proyek penuh dengan sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "menambahkan module_path ke sys.path, digunakan ketika --full diberikan"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "nama proyek (bawaan: nama modul utama)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "penulis-(penulis) proyek, digunakan ketika --full diberikan"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "versi proyek, digunakan ketika --full diberikan"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "rilis proyek, digunakan ketika --full diberikan, bawaan ke --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "opsi ekstensi"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s bukan direktori."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "regex tidak valid %r dalam %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Pengujian cakupan di sumber selesai, lihat hasilnya dalam %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "%r regex tidak valid di coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "modul %s tidak dapat diimpor: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "tidak ada '+' atau '-' dalam opsi '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' bukan opsi yang valid."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' bukan opsi pyversion yang valid"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "tipe TestCode tidak valid"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Pengujian dokumen di sumber selesai, lihat hasil dalam %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "tidak ada kode/keluaran dalam blok %s pada %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "mengabaikan kode dokumen yang tidak valid: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Pengarahan Graphviz tidak dapat memiliki konten dan argumen nama berkas sekaligus"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Berkas Graphviz eksternal %r tidak ditemukan atau gagal dibaca"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Mengabaikan pengarahan \"graphviz\" tanpa konten."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2648,14 +2656,14 @@
 "%r"
 msgstr "dot tidak menghasilkan berkas output: \nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "perintah dot %r tidak dapat dioperasikan (diperlukan untuk keluaran graphviz), periksa pengaturan graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2665,33 +2673,35 @@
 "%r"
 msgstr "dot keluar dengan kesalahan: \nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format harus salah satu dari 'png', 'svg', tetapi %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "kode dot %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graph: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graph"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2701,163 +2711,173 @@
 "%r"
 msgstr "convert keluar dengan kesalahan: \nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Perintah LaTeX %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_latex"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s perintah %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_%s"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "tampilkan latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "inline latex %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Tautan untuk persamaan ini"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "pengimpanan intersphinx telah dipindahkan: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "memuat penyimpanan intersphinx dari %s..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "mengalami beberapa masalah dengan beberapa inventaris, tetapi mereka memiliki alternatif berfungsi:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "gagal mencapai salah satu inventaris dengan masalah berikut:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(di %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(dalam %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "pengenal intersphinx %r bukan string. Diabaikan"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "sumber"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Entri TODO ditemukan: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> terletak di %s, baris %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "entri asli"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "menyoroti kode modul..."
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Kode modul"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kode sumber untuk %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Tinjauan: kode modul"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Semua modul dimana kode tersedia</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "tanda tangan tidak valid untuk outo %s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "kesalahan saat memformat argumen untuk %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "atribut hilang %s dalam objek %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2865,113 +2885,112 @@
 "explicit module name)"
 msgstr "tidak tahu modul mana yang akan diimpor untuk autodocumenting %r (coba letakkan pengarahan \"module\" atau \"currentmodule\" dalam dokumen, atau berikan nama modul yang eksplisit)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" dalam nama automodule tidak masuk akal"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "argumen tanda tangan atau anotasi kembalian diberikan untuk automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ harus berupa daftar string, bukan %r (dalam modul %s) -- mengabaikan __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Basis: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "atribut hilang %s dalam objek %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2979,46 +2998,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "gagal mengurai nama %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "gagal mengimpor objek %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary menghasilkan file .rst secara internal. Tapi source_suffix Anda tidak mengandung .rst. Dilewati."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary menghasilkan autosummary untuk: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary menulis ke %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3026,7 +3045,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3041,138 +3060,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nHasilkan ReStructuredText menggunakan pengarahan autosummary.\n\nsphinx-autogen adalah tampilan depan ke sphinx.ext.autosummary.generate. Ini menghasilkan \nfile reStructuredText dari pengarahan autosummary yang terkandung dalam \nfile input yang diberikan.\n\nFormat pengarahan autosummary didokumentasikan dalam \nmodul ``sphinx.ext.autosummary`` dan dapat dibaca menggunakan::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "berkas sumber untuk menghasilkan file rST untuk"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "direktori untuk menempatkan semua keluaran dalam"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "akhiran bawaan untuk berkas (bawaan: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "direktori templat ubahsuai (bawaan: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "mendokumentasikan anggota yang diimpor (bawaan: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumen Kata Kunci"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Contoh"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Contoh-contoh"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Catatan"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Parameter lainnya"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Referensi"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Peringatkan"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "Hasil"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Pehatian"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Hati-hati"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Bahaya"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Kesalahan"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Petunjuk"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Penting"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Catatan"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Lihat juga"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Peringatan"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "lanjutan dari halaman sebelumnya"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "berlanjut ke halaman berikutnya"
@@ -3194,7 +3213,7 @@
 msgid "Table of Contents"
 msgstr "Daftar Isi"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Pencarian"
@@ -3275,35 +3294,35 @@
 msgid "Navigation"
 msgstr "Navigasi"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Pencarian dalam %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Tentang dokumen ini"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Hak Cipta"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Hak cipta</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Hak cipta %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Terakhir diperbarui pada %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3348,12 +3367,12 @@
 msgstr "pencarian"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Hasil Pencarian"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3395,280 +3414,278 @@
 msgid "Other changes"
 msgstr "Perubahan lain"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link permanen untuk headline ini"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link permanen untuk definisi ini"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Sembunyikan Hasil Pencarian"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Pencarian"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Penyiapkan pencarian..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Pencarian selesai, menemukan %s halaman yang cocok dengan kueri pencarian."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", di"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Buka sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Sembunyikan Hasil Pencarian"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Tutup sidebar"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Buka sidebar"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Konten"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "4 kolom berdasarkan indeks ditemukan. Ini mungkin bug ekstensi yang Anda gunakan: %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Catatan kaki %s tidak dirujuk."
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "Catatan kaki # tidak dirujuk."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referensi catatan kaki yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referensi yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referensi kutipan tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referensi istilah yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "lebih dari satu target ditemukan untuk referensi silang 'any' %r: bisa %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "Tidak dapat mengambil gambar jarak jauh: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "Tidak dapat mengambil gambar jarak jauh: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Format gambar tidak dikenal: %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "karakter sumber undecodable, menggantinya dengan \"?\": %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "dilewati"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "gagal"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "tipe simpul tidak dikenal: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "kesalahan membaca: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "kesalahan menulis: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Format tanggal tidak valid. Kutip string dengan kutipan tunggal jika Anda ingin menampilkannya secara langsung: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree berisi ref ke berkas yang tidak ada %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "pengecualian saat mengevaluasi hanya ekspresi pengarahan: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "peran bawaan %s tidak ditemukan"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Link permanen untuk definisi ini"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format tidak didefinisikan untuk %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Tidak ada ID apa pun yang ditugaskan untuk simpul %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Link permanen untuk table ini"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Link permanen untuk kode ini"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Link permanen untuk gambar ini"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Tautan ke daftar isi ini"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Tidak dapat memperoleh ukuran gambar. :scale: option diabaikan."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "%r toplevel_sectioning tidak diketahui untuk kelas %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: terlalu besar, diabaikan."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "judul dokumen bukan simpul Text tunggal"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "simpul judul tidak ditemui dalam bagian, topik, tabel, peringatan atau sisi bilah"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Catatan kaki"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "opsi tabularcolumns dan :widths: opsi diberikan bersamaan. :widths: diabaikan."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "unit dimensi %s tidak valid. Diabaikan"
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "entri indeks tidak diketahui ditemukan tipe %s"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "gambar: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "gambar"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "keterangan tidak di dalam gambar."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "tipe simpul tidak diterapkan: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/is/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/is/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "N\u00e6sta efni",
         "Other changes": "",
         "Overview": "",
-        "Permalink to this definition": "Varanlegur hlekkur \u00e1 \u00feessa skilgreiningu",
-        "Permalink to this headline": "Varanlegur hlekkur \u00e1 \u00feennan titil",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "Undirb\u00fdr leit...",
         "Previous topic": "Fyrra efni",
@@ -39,7 +37,7 @@
         "Search": "Leit",
         "Search Page": "Leitars\u00ed\u00f0a",
         "Search Results": "Leitarni\u00f0urst\u00f6\u00f0ur",
-        "Search finished, found %s page(s) matching the search query.": "Leit loki\u00f0, fann %s s\u00ed\u00f0u(r) sem p\u00f6ssu\u00f0u vi\u00f0 leitarskilyr\u00f0in.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Leita \u00ed %(docstitle)s",
         "Searching": "Leitar",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/is/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/is/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/is/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/is/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Tryggvi Kalman <tkj3@hi.is>, 2021\n"
 "Language-Team: Icelandic (http://www.transifex.com/sphinx-doc/sphinx-1/language/is/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: is\n"
 "Plural-Forms: nplurals=2; plural=(n % 10 != 1 || n % 100 == 11);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Kafli %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Mynd %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tafla %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Listi %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Almennt yfirlit"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "yfirlit"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "næsta"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "fyrri"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Yfirlit"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Útgáfa"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,414 +1865,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Leitarsíða"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2285,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "sjá %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "sjá einnig %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Varanlegur hlekkur á þessa jöfnu"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Athugið"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Aðgát"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Hætta"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Villa"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Ábending"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Mikilvægt"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Athugasemd"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Sjá einnig"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Ábending"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Aðvörun"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "framhald frá fyrri síðu"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "framhald á næstu síðu"
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr "Efnisyfirlit"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Leit"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Leita í %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "leita"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Leitarniðurstöður"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Varanlegur hlekkur á þennan titil"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Varanlegur hlekkur á þessa skilgreiningu"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Fela leitarniðurstöður"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Leitar"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Undirbýr leit..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Leit lokið, fann %s síðu(r) sem pössuðu við leitarskilyrðin."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr ""
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Fela leitarniðurstöður"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Varanlegur hlekkur á þessa skilgreiningu"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "Varanlegur hlekkur á þetta hugtak"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Varanlegur hlekkur á þessa töflu"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Varanlegur hlekkur á þennan kóða"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Varanlegur hlekkur á þessa mynd"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "mynd: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "mynd"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/it/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/it/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Argomento successivo",
         "Other changes": "Altre modifiche",
         "Overview": "Sintesi",
-        "Permalink to this definition": "Link a questa definizione",
-        "Permalink to this headline": "Link a questa intestazione",
         "Please activate JavaScript to enable the search\n    functionality.": "Attiva JavaScript per abilitare la funzione\u23ce\ndi ricerca.",
         "Preparing search...": "Preparo la ricerca...",
         "Previous topic": "Argomento precedente",
@@ -39,7 +37,7 @@
         "Search": "Cerca",
         "Search Page": "Cerca",
         "Search Results": "Risultati della ricerca",
-        "Search finished, found %s page(s) matching the search query.": "Ricerca completata, trovata/e %s pagina/e corrispondenti.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Cerca in %(docstitle)s",
         "Searching": "Cerca",
         "Searching for multiple words only shows matches that contain\n    all words.": "",
@@ -59,5 +57,5 @@
         "search this documentation": "cerca in questa documentazione",
         "the documentation for": "la documentazione per"
     },
-    "plural_expr": "(n != 1)"
+    "plural_expr": "n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/it/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/it/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/it/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/it/LC_MESSAGES/sphinx.po Changed

@@ -1,8 +1,9 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
+# Antonari Palmio, 2022
 # Denis Cappellin <denis@cappell.in>, 2018
 # Paolo Cavallini <cavallini@faunalia.it>, 2013-2017
 # Roland Puntaier <roland.puntaier@chello.at>, 2013
@@ -12,134 +13,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Antonari Palmio, 2022\n"
 "Language-Team: Italian (http://www.transifex.com/sphinx-doc/sphinx-1/language/it/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: it\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Plural-Forms: nplurals=3; plural=n == 1 ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
-msgstr ""
+msgstr "Impossibile trovare la cartella sorgente ( %s )"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
-msgstr ""
+msgstr "La cartella di output  (%s) non è una cartella"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
-msgstr ""
+msgstr "La cartella sorgente e la cartella di destinazione non possono essere identiche"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
-msgstr ""
+msgstr "Sto eseguendo Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
-msgstr ""
+msgstr "Questo progetto necessita almeno di Sphinx v%s per cui non può essere creato con la versione attuale."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
-msgstr ""
+msgstr "sto creando la cartella di output"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
-msgstr ""
+msgstr "caricamento traduzioni %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "fatto"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "terminato con problemi"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -147,12 +148,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -160,64 +161,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -225,898 +232,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Sezione %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabella %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Listato %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "il primary_domain %r non  è stato trovato, tralasciato."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Al livello del modulo"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indice generale"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indice"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "successivo"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "precedente"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentazione"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indice"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1125,94 +1128,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1231,271 +1234,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1504,15 +1502,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1522,21 +1520,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1544,91 +1542,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1638,230 +1636,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Didascalia non valida: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Impossibile usare contemporaneamente le opzioni  \"%s\" e \"%s\""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autore della sezione: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autore del modulo: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autore del codice: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autore: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1872,414 +1870,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Ritorna"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Tipo di ritorno"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "membro"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variabile"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funzione"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumeratore"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nuovo nella versione %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Cambiato nella versione %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Deprecato dalla versione %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parametri del modello"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Solleva"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "concetto"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funzione built-in)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metodo)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variabile globale o costante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attributo)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Parametri"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulo)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metodo"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dati"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attributo"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modulo"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "etichetta dell'equazione %s duplicata, altra istanza in %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "keyword"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operatore"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "oggetto"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "eccezione"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "statement"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "funzione built-in"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variabili"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Solleva"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (nel modulo %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (nel modulo %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variabile built-in)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe built-in)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe in %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s metodo della classe)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s metodo statico)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Indice del modulo Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduli"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Deprecato"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "metodo della classe"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "metodo statico"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (deprecato)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direttiva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (ruolo)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direttiva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "ruolo"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "variabile d'ambiente, %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "voce del glossario"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "elemento grammaticale"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "etichetta di riferimento"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "variabile d'ambiente"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opzione del programma"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "documento"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Indice dei moduli"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Cerca"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2289,142 +2288,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "vedi %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "vedi anche %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboli"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2436,209 +2440,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "manca  '+' or'-' nell'opzione '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' non è un'opzione valida."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2648,14 +2657,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2665,33 +2674,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "grafico: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "grafico"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2701,163 +2712,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Permalink a questa equazione"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "sorgente"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Da fare"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<elemento originale>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(L'<<elemento originale>> si trova in %s, linea %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "riga originale"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "documenti"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Codice del modulo"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Codice sorgente per %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Vista generale: codice del modulo"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Tutti i moduli di cui è disponibile il codice</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2865,113 +2886,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "   Basi: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2979,46 +2999,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3026,7 +3046,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3041,138 +3061,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argomenti parole chiave"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Esempi"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Attenzione"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Attenzione"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Pericolo"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Errore"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Suggerimento"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Vedi anche"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Suggerimento"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Avvertimento"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continua dalla pagina precedente"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3194,7 +3214,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Cerca"
@@ -3275,35 +3295,35 @@
 msgid "Navigation"
 msgstr "Navigazione"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Cerca in %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "A proposito di questi documenti"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Ultimo aggiornamento %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3348,12 +3368,12 @@
 msgstr "cerca"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Risultati della ricerca"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3395,280 +3415,278 @@
 msgid "Other changes"
 msgstr "Altre modifiche"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link a questa intestazione"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link a questa definizione"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Nascondi i risultati della ricerca"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Cerca"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Preparo la ricerca..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Ricerca completata, trovata/e %s pagina/e corrispondenti."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", in "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Espandi la barra laterale"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Nascondi i risultati della ricerca"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Comprimi la barra laterale"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Espandi la barra laterale"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Contenuti"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Link a questa definizione"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Link a questa tabella"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Link a questo codice"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Link a questa immagine"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Link a questo indice"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Note a piè di pagina"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "immagine: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "immagine"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ja/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ja/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u6b21\u306e\u30c8\u30d4\u30c3\u30af\u3078",
         "Other changes": "\u305d\u306e\u4ed6\u306e\u5909\u66f4",
         "Overview": "\u6982\u8981",
-        "Permalink to this definition": "\u3053\u306e\u5b9a\u7fa9\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af",
-        "Permalink to this headline": "\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af",
         "Please activate JavaScript to enable the search\n    functionality.": "\u691c\u7d22\u6a5f\u80fd\u3092\u4f7f\u3046\u306b\u306f JavaScript \u3092\u6709\u52b9\u306b\u3057\u3066\u304f\u3060\u3055\u3044\u3002",
         "Preparing search...": "\u691c\u7d22\u3092\u6e96\u5099\u3057\u3066\u3044\u307e\u3059...",
         "Previous topic": "\u524d\u306e\u30c8\u30d4\u30c3\u30af\u3078",
@@ -39,7 +37,7 @@
         "Search": "\u691c\u7d22",
         "Search Page": "\u691c\u7d22\u30da\u30fc\u30b8",
         "Search Results": "\u691c\u7d22\u7d50\u679c",
-        "Search finished, found %s page(s) matching the search query.": "\u691c\u7d22\u304c\u5b8c\u4e86\u3057\u3001 %s \u30da\u30fc\u30b8\u898b\u3064\u3051\u307e\u3057\u305f\u3002",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "%(docstitle)s \u5185\u3092\u691c\u7d22",
         "Searching": "\u691c\u7d22\u4e2d",
         "Searching for multiple words only shows matches that contain\n    all words.": "\u8907\u6570\u306e\u5358\u8a9e\u3092\u691c\u7d22\u3059\u308b\u3068\u3001\u6b21\u3092\u542b\u3080\u4e00\u81f4\u306e\u307f\u304c\u8868\u793a\u3055\u308c\u307e\u3059\n \u00a0\u00a0\u00a0 \u3059\u3079\u3066\u306e\u7528\u8a9e\u3002",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ja/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ja/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ja/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ja/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -13,10 +13,10 @@
 # sutefu7, 2019-2020
 # shirou - しろう <shirou.faw@gmail.com>, 2017
 # Taizo Ito <taizo.ito@hennge.com>, 2019
-# Takayuki Shimizukawa <shimizukawa@gmail.com>, 2013-2016
-# Takayuki Shimizukawa <shimizukawa@gmail.com>, 2016-2017,2019
-# Komiya Takeshi <i.tkomiya@gmail.com>, 2016-2017,2019
-# Tetsuo Koyama <tkoyama010@gmail.com>, 2020-2021
+# Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>, 2013-2016
+# Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>, 2016-2017,2019
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2016-2017,2019,2022
+# Tetsuo Koyama <tkoyama010@gmail.com>, 2020-2023
 # tomo, 2019
 # shirou - しろう <shirou.faw@gmail.com>, 2014
 # Yasushi Masuda <whosaysni@gmail.com>, 2008
@@ -24,134 +24,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Tetsuo Koyama <tkoyama010@gmail.com>, 2020-2023\n"
 "Language-Team: Japanese (http://www.transifex.com/sphinx-doc/sphinx-1/language/ja/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ja\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "ソースディレクトリが存在しません (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "出力先ディレクトリ (%s) はディレクトリではありません"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "出力先ディレクトリにはソースディレクトリと異なるディレクトリを指定してください"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s を実行中"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "このプロジェクトはSphinx v%s以降のバージョンでなければビルドできません。"
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "出力先ディレクトリを作成しています"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "拡張機能のセットアップ中 %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "conf.pyにある'setup'はPythonのcallableではありません。定義を修正してcallableである関数にしてください。これはconf.pyがSphinx拡張として動作するのに必要です。"
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "翻訳カタログをロードしています %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "完了"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "翻訳が用意されていません"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "保存された環境データを読み込み中"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "失敗: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "ビルダーが選択されていないので、デフォルトの html を使用します"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "成功"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "完了（問題あり）"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "警告%s、%sをビルドします（警告はエラーとして扱われます）。"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "警告%s、%sをビルドします（警告はエラーとして扱われます）。"
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "ビルド %s, %s warning."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "ビルド %s, %s 警告."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "ビルド %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "nodeクラス %r は既に登録されています。visitor関数は上書きされます"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "ディレクティブ %r は既に登録されています。ディレクティブは上書きされます"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "ロール %r は既に登録されています。ロールは上書きされます"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -159,12 +159,12 @@
 "explicit"
 msgstr "拡張 %s は並列読み込みが可能かどうかを宣言していないため、おそらく並列読み込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "%s拡張は並列読み込みに対して安全ではありません"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -172,64 +172,70 @@
 "explicit"
 msgstr "拡張 %s は並列書き込みが可能かどうかを宣言していないため、おそらく並列書き込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "%s拡張は並列書き込みに対して安全ではありません"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "直列で %sします"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "conf.py が設定ディレクトリに存在しません (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "無効な設定値が見つかりました: 'language = None' 。設定を有効な言語コードに更新してください。 'en' （英語）にフォールバックしています。"
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "設定値の辞書 %r は上書きないため無視されました (%r を使って個別に設定してください)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "%r は設定値 %r の正しい値ではないため無視されました"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "%r は正しい型ではないため無視されました"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "不明な設定値 %r による上書きは無視されました"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "%s という設定値はありません"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "設定値 %r は既に登録済みです"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "設定ファイルに文法エラーが見つかりました: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "設定ファイル（あるいはインポートしたどれかのモジュール）がsys.exit()を呼びました"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -237,898 +243,894 @@
 "%s"
 msgstr "設定ファイルにプログラム上のエラーがあります:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "設定値 `source_suffix' に `%r' が指定されましたが、文字列、文字列のリスト、辞書、のいずれかを指定してください。"
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "%s 章"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "図 %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "表 %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "リスト %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr " 設定値 `{name}` に `{current}` が指定されましたが、  {candidates} のいずれかを指定してください。"
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されていますが、 {permitted} 型を指定してください。"
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されています。デフォルト値は `{default.__name__}' です。"
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r が見つかりません。無視します。"
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "v2.0以降、Sphinxはデフォルトで \"index \" をroot_docとして使用しています。conf.pyに \"root_doc = 'contents'\" を追加してください。"
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "イベント %r はすでに登録されています"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "不明なイベント名: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "イベント %r のハンドラ %r で例外が発生しました。"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "needs_extensions設定で %s 拡張が要求されていますが、その拡張がありません。"
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "このプロジェクトは拡張 %s の %s 以降のバージョンが必要なため、現在のバージョン(%s)ではビルドできません。"
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments に %r というlexerがありません"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "リテラルブロックを \"%s\" として解釈できませんでした。ハイライト処理をスキップします。"
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "ドキュメント \"%s\" で複数のファイルが見つかりました: %r\nビルドには %r を使用してください。"
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "ドキュメントを読めません。無視します。"
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "ビルダークラス %s には\"name\"属性がありません"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "ビルダー %r (モジュール %s) がすでに登録されています"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "ビルダー名 %s は登録されておらず、entry pointにもありません"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "ビルダー名 %s は登録されていません"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "ドメイン %s はすでに登録されています"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "ドメイン %s はまだ登録されていません"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "ディレクティブ %r は既に%sドメインに登録されています"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "ロール %r は既にドメイン%sに登録されています"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "インデックス %r はすでに%sドメインに登録されています"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "object_type %r はすでに登録されています"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "classref_type %r はすでに登録されています"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r はすでに登録されています"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r のsource_parserはすでに登録されています"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s のsource_parserは登録されていません"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r のTranslatorはすでに登録されています"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() のキーワード引数は (visit, depart) の形式で関数をタプルで指定してください: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r はすでに登録されています"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "math renderer %s はすでに登録されています"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "拡張 %r はSphinxのバージョン%sでSphinxに統合されています。この拡張は無視されます。"
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "元の例外:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "拡張 %s をimportできません"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "拡張 %r には setup() 関数がありません。これは本当にSphinx拡張ですか？"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "このプロジェクトで使われている拡張 %s はSphinx v%s 以降が必要なため、現在のバージョンではビルドできません。"
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "拡張 %r のsetup()関数が、対応していないオブジェクトを返しました。Noneまたはメタデータ辞書を返してください"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
-msgstr ""
+msgstr "無効なPEP番号 %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
-msgstr ""
+msgstr "無効なRFC番号 %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "テーマ %r に \"theme\" 設定がありません"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "テーマ %r に \"inherit\" 設定がありません"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "テーマ %r が %r から継承されていますが、見つかりませんでした"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "設定 %s.%s がテーマ設定にありません"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "サポートされていないテーマオプション %r が指定されました"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "テーマパス上のファイル %r は正しいzipファイルではないか、テーマを含んでいません"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "sphinx_rtd_theme (< 0.3.0) が検出されました。Sphinx-6.0 以降では利用できなくなります。"
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "テーマ %r がありません(theme.confが見つからない?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%sビルダー向けの画像形式が見つかりません: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%sビルダー向けの画像形式が見つかりません: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "ビルド中 mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "出力中..."
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "全%d件のpoファイル"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "指定された %d 件のpoファイル"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "更新された %d 件のpoファイル"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "全てのソースファイル"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr "コマンドラインに指定されたファイル %r がないため, "
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "コマンドラインに指定されたファイル %r はソースディレクトリ以下にないため無視されます"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "コマンドラインに指定されたファイル %r がないため無視されます"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "コマンドラインで指定された%d件のソースファイル"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "更新された %d 件のソースファイル"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "ビルド中 %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "更新されたファイルを探しています... "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d 件見つかりました"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "見つかりませんでした"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "環境データを保存中"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "整合性をチェック中"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "更新が必要な対象はありませんでした"
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "環境データを更新中"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s 件追加, %s 件更新, %s 件削除"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "ソースを読み込み中..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "ワーカーの終了を待っています..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "書き込むdocname: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "ドキュメントの出力準備中"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "Tocエントリーが重複しています: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "画像をコピー中... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "画像ファイル %r をPILで読み込めないため、そのままコピーします"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "画像ファイル %r をコピーできません: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "画像ファイル %r を書き込めません: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillowがインストールされていません。代わりに画像をコピーします"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "mimetype を書き込み中..."
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "META-INF/container.xml を書き込み中..."
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "content.opf を書き込み中..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "不明なmimetype %sのため無視します"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "tox.ncx を書き込み中..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "ファイル %s を書き込み中..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "ファイルは%(outdir)sにあります"
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "バージョン %s での変更はありません"
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "概要ファイルを書き出し中..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "組み込み"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "モジュールレベル"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "ソースファイルをコピー中..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "Changelog作成中に %r を読み込めませんでした"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "dummyビルダーはファイルを出力しません"
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePubファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "nav.xhtml を書き込み中..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_language\" (あるいは \"language\") の指定が必要です"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "EPUB3では設定値  \"epub_uid\" はXML NAMEにするべきです"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_title\" (あるいは \"html_title\") の指定が必要です"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_author\" の指定が必要です"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_contributor\" が必要です"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_description\" が必要です"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_publisher\" の指定が必要です"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_copyright\" (あるいは \"copyright\") の指定が必要です"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"epub_identifier\" の指定が必要です"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "EPUB3出力では設定値 \"version\" が必要です"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "無効な css_file %r は無視されました"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "メッセージカタログは%(outdir)sにあります。"
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "指定された %d 件のテンプレートファイル"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "テンプレートの読み込み中..."
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "メッセージカタログを出力中... "
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "上記の出力結果、または %(outdir)s /output.txt を見てエラーを確認してください"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "リンクが切れています: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "アンカー '%s' が見つかりません"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr "linkcheck_allowed_redirects 内の正規表現のコンパイルに失敗しました: %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "マニュアルページは %(outdir)s にあります。"
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "設定値 \"man_pages\" が見つかりません。マニュアルページは書かれません"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "書き込み中"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "設定値 \"man_pages\" が不明なドキュメント %s を参照しています"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML ページは%(outdir)sにあります。"
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "ドキュメントを1ページにまとめています"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "追加のファイルを出力"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfoファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nmakeinfo コマンドで処理するため、そのディレクトリで 'make' を実行してください。\n（これを自動的に行うには、ここで 'make info' を使用してください）。"
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "設定値 \"texinfo_documents\" が見つかりません。ドキュメントは書き込まれません"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "設定値 \"texinfo_documents\" は、不明なドキュメント %s を参照しています"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "処理中 %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "参照を解決しています..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "Texinfo 関連ファイルをコピーしています"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "Makefile の書き込みエラー: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "テキストファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "ファイル書き込みエラー %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XMLファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "pseudo-XMLファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "build info ファイルが壊れています: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTMLページは%(outdir)sにあります。"
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "build info ファイルの読み込みに失敗しました: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y年%m月%d日"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "総合索引"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "索引"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "次へ"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "前へ"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "索引を生成中"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "追加のページを出力中"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "ダウンロードファイルをコピー中..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "ダウンロードファイル %r をコピーできません: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "html_static_file 内のファイルのコピーに失敗しました: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr "静的ファイルをコピー中"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "静的ファイル %r をコピーできません"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "extraファイルをコピー中"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "extraファイル %r をコピーできませんでした"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "build info ファイル %r の出力に失敗しました"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "検索インデックスを読み込めず、ドキュメントビルドの一部が不完全です。"
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "ページ %s がhtml_sidebarsの複数のパターンに一致しました: %r と %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ページ%sの読み込み中にUnicodeエラーが発生しました。非アスキー文字を含む設定値は全てUnicode文字列にしてください。"
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "%sページのレンダリング中にエラーが発生しました。\n理由: %r "
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "オブジェクト インベントリを出力"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s の検索インデックスを出力"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "無効な js_file %r は無視されました"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "複数の math_renderer が登録されています。しかし math_renderer は選択されていません。"
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "不明な math_renderer %r が指定されました。"
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path %r が見つかりません"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path %r がoutdir内に配置されます"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path %r が見つかりません"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path %r がoutdir内に配置されます"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "ロゴファイル %r がありません"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon ファイル %r がありません"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr "html_add_permalinksはv3.5.0以降、非推奨となりました。代わりにhtml_permalinksとhtml_permalinks_iconを使用してください。"
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s ドキュメント"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeXファイルは%(outdir)sにあります。"
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\n(pdf)latex コマンドで処理するために、そのディレクトリで 'make' を実行してください。\n（これを自動的に行うには、ここで 'make latexpdf' を使用してください）。"
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "設定値 \"latex_documents\" が見つかりません。ドキュメントは書き込まれません"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "設定値 \"latex_documents\" は、不明なドキュメント %s を参照しています"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "索引"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "リリース"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r 言語向けの 既知の Babel オプションはありません"
@@ -1137,94 +1139,94 @@
 msgid "copying TeX support files"
 msgstr "TeX 関連ファイルをコピーしています"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "TeX 関連ファイルをコピー中..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "追加のファイルをコピーしています"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "不明な設定値 latex_elements%r は無視されました。"
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr "不明なテーマオプション latex_theme_options%r は無視されました。"
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r に \"theme\" 設定がありません"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r に \"%s\" 設定がありません"
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "ビルド中に例外が発生しました。デバッガを起動します:"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "割り込まれました！"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "reST マークアップエラー:"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "エンコードエラー:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "完全なトレースバックを%sに保存しました。問題を開発者に報告するときに添付してください。"
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "再起呼び出しエラー:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "これは、非常に大きなソースファイルや深くネストされたソースファイルで発生する可能性があります。conf.py で、Python のデフォルトの再帰回数制限である 1000 を、例えば次のように慎重に増やすことができます: "
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "例外が発生しました"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "次期バージョンでのエラーメッセージ改善のために、ユーザーエラーの場合にも報告してください。"
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "バグ報告はこちらにお願いします <https://github.com/sphinx-doc/sphinx/issues> 。ご協力ありがとうございます！"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "ジョブ番号は正数でなければなりません"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "詳しくは、<https://www.sphinx-doc.org/>を見てください。"
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1241,290 +1243,285 @@
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\nソースファイルからドキュメントを生成します。\n\nsphinx-build は、SOURCEDIR 内のファイルをもとにドキュメントを生成し、\nOUTPUTDIR 内に配置します。またコンフィグ\n設定用に SOURCEDIR 内から\n 'conf.py' を探します。'sphinx-quickstart' ツールを使うと\n 'conf.py' を含むテンプレートファイルを生成することができます。\n\nsphinx-build は、さまざまな形式のドキュメントを作成することができます。フォーマットは、\nコマンドラインでビルダー名を指定して選択します。デフォルトは\nHTML です。ビルダーはドキュメント化処理に関連した他のタスクも実行できます。\n\nデフォルトでは、古いものはすべてビルドされています。個別にファイル名を指定することで、\n選択したファイルのみ出力することもできます。\n"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "ドキュメントソースファイルへのパス"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "出力先ディレクトリへのパス"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "再構築するための設定ファイルのリスト。 -a が指定されている場合は無視されます"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "一般的なオプション"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "使用するビルダー（デフォルト：html）"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "すべてのファイルに書き込む（デフォルト: 新規ファイルまたは変更されたファイルのみ）"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "保存された環境は使わず、常に全てのファイルを読み込む"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "キャッシュされた環境とDoctreeファイルへのパス（デフォルト：OUTPUTDIR/.doctrees）"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "可能な場合、ビルドを N 個のプロセスで並列実行する（特別な値 \"auto\" は N を cpu-count に設定する）"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "設定ファイル（conf.py）がある場所のパス（デフォルト：SOURCEDIRと同じ場所）"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "設定ファイルを使用せず、-Dオプションのみを使用"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "設定ファイルの設定を上書きする"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "HTMLテンプレートに値を渡す"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "定義タグ: TAG ブロック\"のみ\"含む"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "nit-picky モード。不足しているすべての参照について警告する"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "コンソール出力オプション"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "精度の増加（繰り返し可能）"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "標準出力には出力せず、標準エラー出力に警告を出すのみ"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "何も出力せず、警告もしない"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "色分けで出力する（デフォルト：自動検出）"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "色分けの出力をしない（デフォルト：自動検出）"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "指定ファイルに警告（およびエラー）を書き込む"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "警告をエラーとして扱う"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "-Wを指定すると、警告が表示されたときは実行を続ける"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "例外時にフルトレースバックを表示する"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "例外が発生したときにPdbを実行する"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "ファイル %r が見つかりません"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "-aオプションとファイル名を組み合わせることはできません"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "警告ファイル %r を開けません: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "-Dオプション引数は name = value の形式でなければなりません"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "-Aオプション引数は name = value の形式でなければなりません"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "モジュールから自動的に docstring を挿入する"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "doctest ブロック内のコードスニペットを自動的にテストする"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "異なるプロジェクトのSphinxドキュメント間のリンク"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "ビルド時に表示または非表示にできる \"todo\" エントリを書く"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "ドキュメントの適用範囲を確認する"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "PNG または SVG 画像としてレンダリングされた数学を含む"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "MathJax によってブラウザにレンダリングされた数学を含む"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "設定値に基づくコンテンツの条件付き包含"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "文書化された Python オブジェクトのソースコードへのリンクを含める"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "GitHub ページにドキュメントを公開するための .nojekyll ファイルを作成する"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "有効なパス名を入力してください。"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "何か入力してください。"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "%sのいずれかを入力してください。 "
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "'y' または 'n' を入力してください。"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "ファイルの拡張子を入力してください。例:  '.rst' または '.txt'。"
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Sphinx %s クイックスタートユーティリティへようこそ。"
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "以下の設定値を入力してください（Enter キーのみ押した場合、\nかっこで囲まれた値をデフォルト値として受け入れます）。"
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "選択されたルートパス: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "ドキュメントのルートパスを入力してください。"
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "ドキュメントのルートパス"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "エラー：選択されたルートパスに既存の conf.py が見つかりました。"
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart は、既存の Sphinx プロジェクトを上書きしません。"
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "新しいルートパスを入力してください（または Enter を押すことで終了します）。"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Sphinx 出力用のビルドディレクトリを配置する方法は2つあります。\nルートパス内にある \"_build\" ディレクトリを使うか、\nルートパス内に \"source\" と \"build\" ディレクトリを分ける方法です。"
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "ソースディレクトリとビルドディレクトリを分ける（y / n）"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "プロジェクトのルートディレクトリに 2つ以上のディレクトリが作成されます。\nカスタマイズしたHTMLテンプレート用の\"_templates\"ディレクトリと、カスタマイズしたスタイルシート等を置く\"_static\"ディレクトリがあります。\nこれらのディレクトリは \"_\" で始まっていますが、別の文字(\".\"など)で始まるように指定できます。"
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "テンプレートと静的ディレクトリの名前プレフィックス"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "プロジェクト名は、ビルドされたドキュメントのいくつかの場所にあります。"
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "プロジェクト名"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "著者名（複数可）"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "Sphinx には、ソフトウェアに対して \"バージョン\" と \"リリース\" という概念が\nあります。各バージョンは複数のリリースを持つことができます。\n例えば、Python だとバージョンが 2.5 や 3.0 のように分かれているように、\nリリースも 2.5.1 や 3.0a1 のように分けて持つことができます。もしこのような多重構成が必要ない場合は、\n両方を同じ値に設定するだけです。"
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "プロジェクトのバージョン"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "プロジェクトのリリース"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1534,21 +1531,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "ドキュメントを英語以外の言語で書く場合は、\n 言語コードで言語を選択できます。Sphinx は生成したテキストをその言語に翻訳します。\n\nサポートされているコードのリストについては、\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language を参照してください。"
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "プロジェクトの言語"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 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 "ソースファイルのファイル名の拡張子。一般的には、\".txt\"または\".rst \"のどちらかです。この拡張子を持つファイルだけがドキュメントとみなされます。"
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "ソース・ファイルサフィックス"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1556,91 +1553,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "1つのドキュメントは、\"コンテンツツリー\"の最上位ノードと\n見なされるという点で特別です。つまり、それはドキュメントにおける階層構造のルートである\nということです。通常、これは \"index\" ですが、\n\"index\" ドキュメントがカスタムテンプレートの場合、これを別のファイル名に設定することもできます。"
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "マスター文書の名前（拡張子を除く）"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "エラー：マスタファイル %s は、選択されたルートパス上で既に存在します。"
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart は既存のファイルを上書きしません。"
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "新しいファイル名を入力するか、既存のファイルの名前を変更してEnterキーを押してください。"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "次の Sphinx 拡張機能のうちどれを有効にするかを指定します。"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "注：imgmath と mathjax を同時に有効にすることはできません。 imgmath は未選択になります。"
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Makefile と Windows コマンドファイルは生成することができるので、\n後は実行するだけです。例えば、直接 sphinx-build を実行する代わりに `make html` を\n実行します。"
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Makefile を作成しますか？ （y/n）"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Windows コマンドファイルを作成しますか？（y/n）"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "ファイル %s を作成しています。"
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "ファイル %s は既に存在しますのでスキップします。"
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "終了：初期ディレクトリ構造が作成されました。"
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "マスターファイル %s を作成して\n他のドキュメントソースファイルを作成します。"
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "次のように Makefile を使ってドキュメントを作成します。\n make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "次のように、ドキュメントを構築するには sphinx-build コマンドを使用してください。\n sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "\"builder\" はサポートされているビルダーの 1 つです。 例: html, latex, または linkcheck。"
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1650,230 +1647,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nSphinx プロジェクトに必要なファイルを生成します。\n\nsphinx-quickstart は、いくつかの質問であなたの\nプロジェクトを生成するためのディレクトリと、sphinx-build と一緒に使える\nサンプルのMakefileを作成してくれるインタラクティブなツールです。\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "Quiet モード"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "project root"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "構成オプション"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "記述した場合、ソースとビルドのディレクトリを分割します。"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "指定された場合、ソースディレクトリの下にビルドディレクトリを作成します。"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "_templates などのドットの置き換え"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "プロジェクトの基本オプション"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "プロジェクト名"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "著者名"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "プロジェクトのバージョン"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "プロジェクトのリリース"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "ドキュメント言語"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "ソース・ファイルサフィックス"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "マスタードキュメント名"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "epubを利用する"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "拡張オプション"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "%s 拡張を有効にする"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "任意の拡張を有効にする"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Makefileとbatファイルの生成オプション"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "makefileを作成する"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "makefileを作成しない"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "batファイルを作成する"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "batファイルを作成しない"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile / make.bat 向けに make-mode を使う"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile / make.bat 向けに make-mode を使わないでください。"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "プロジェクトテンプレート"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "テンプレートファイルのテンプレートディレクトリ"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "テンプレート変数の定義"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" が指定されていますが、 \"project\" または \"author\" のいずれも指定されていません。"
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "エラー：指定されたパスはディレクトリではないか、または sphinx ファイルが既に存在します。"
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart は空のディレクトリにのみ生成します。新しいルートパスを指定してください。"
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "無効なテンプレート変数: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr "デデントによる空白の除去"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "不正な caption です: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "行番号の指定が範囲外です (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "\"%s\" と \"%s\" のオプションは同時に使用できません"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "インクルードファイル %r が見つからないか読み込めません"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "エンコーディング %r はインクルードファイル %r の読み込みに適さないようです。:encoding: オプションを追加してみてください"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "%r という名前のオブジェクトがインクルードファイル %r 内に見つかりません"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr " \"lineno-match\" は不連続な \"lines\" に対して使用できません"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "指定された %r に一致する行がインクルードファイル %r にありませんでした"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr "toctree グローブ・パターン %r はどのドキュメントにもマッチしませんでした。"
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree に除外したドキュメントへの参照が含まれています %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree に存在しないドキュメントへの参照が含まれています %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr "toctree で重複したエントリが見つかりました: %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "この節の作者: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "モジュールの作者: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "コードの作者: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "作者: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1884,414 +1881,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "パラメータ"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr "戻り値"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "戻り値"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "戻り値の型"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "のメンバ変数"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "変数"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "の関数"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "のマクロ"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr "struct"
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "union"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "列挙型"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "のデータ型"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "関数パラメータ"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "バージョン %s で追加"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "バージョン %s で変更"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "バージョン %s で非推奨"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "引用 %s はすでに %s で使われています"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "引用 %s は参照されていません。"
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "テンプレートパラメータ"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "例外"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "クラス"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "コンセプト"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "テンプレート・パラメータ"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (組み込み関数)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s のメソッド)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (クラス)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (グローバル変数または定数)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s の属性)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "引数"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (モジュール)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "メソッド"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "データ"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "の属性"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "モジュール"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "%s の記述 %s はすでに %s で %s が使われています"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "数式 %s のラベルはすでに %s で使われています"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "無効な math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "キーワード"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "演算子"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "オブジェクト"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "例外"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "文"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "組み込み関数"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "変数"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "例外"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s モジュール)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s モジュール)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (組み込み変数)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (組み込みクラス)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s のクラス)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s のクラスメソッド)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s (%s のプロパティ)"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s の静的メソッド)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (%s のプロパティ)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Pythonモジュール索引"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "モジュール"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "非推奨"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "クラスメソッド"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "の静的メソッド"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "プロパティ"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "%s のオブジェクト記述、 %s の他のインスタンスを複製し、そのうちの1つに :noindex: を使用します"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "相互参照 %r に複数のターゲットが見つかりました: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (非推奨)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (ディレクティブ)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (ディレクティブオプション)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (ロール)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "ディレクティブ"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "ディレクティブオプション"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "ロール"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "%s の記述 %s はすでに %s で使われています"
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "環境変数; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "不正なオプションの説明 %r は、\"opt\"、\"-opt args\"、\"--opt args\"、\"/opt args\" または \"+opt args\" のようになります。"
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s コマンドラインオプション"
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "コマンドラインオプション"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "用語集の前に空行が必要です"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "用語集の用語は空行で区切ってはいけません"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "用語集のフォーマットが間違っているようです。インデントを確認してください"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "用語集の項目"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "文法トークン"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "参照ラベル"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "環境変数"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "プログラムオプション"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "モジュール索引"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "検索ページ"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "ラベル %s はすでに %s で使われています"
@@ -2301,142 +2299,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "%s の記述 %s はすでに %s で使われています"
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig は無効です。:numref: は無視されます。"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "クロスリファレンスの作成に失敗しました。番号が割り当てられていません: %s"
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "リンクにキャプションがありません: %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "無効な numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "無効な numfig_format: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "未定義のラベル: %s"
+msgid "undefined label: %r"
+msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "クロスリファレンスの作成に失敗しました。タイトルまたはキャプションが見つかりませんでした: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "新しい設定"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "変更された設定"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "変更された拡張"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "ビルド環境のバージョンが最新ではありません"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "ソースディレクトリが変更されました"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "この環境は選択したビルダーと互換性がありません。別の doctree ディレクトリーを選択してください。"
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "%s のドキュメントをスキャンできませんでした: %r "
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "ドメイン %r はまだ登録されていません"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "自己参照している toctree が見つかりました。無視します。"
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "ドキュメントはどの toctree にも含まれていません"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%sを参照"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "%sも参照"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "不明なインデックスエントリタイプ %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "記号"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "循環参照している toctree が検出されましたので無視します: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree にはタイトルのないドキュメント %r への参照が含まれています: リンクは生成されません"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "画像ファイルが読み込めません: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "画像ファイル %s が読み込めません: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "ダウンロードファイルが読み込めません: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s はすでにセクション番号が割り当てられています (入れ子になった番号の toctree ?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "ファイル %s を作成したものとします。"
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2448,209 +2451,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\n<MODULE_PATH> 内を再帰的に調べてPython のモジュールとパッケージ、\n後は1つのreST ファイルを <OUTPUT_PATH> 内にあるパッケージ毎の automodule ディレクティブに作成します。\n\n<EXCLUDE_PATTERN> は、ファイル、またはディレクトリ、または両方のパターンを\n生成処理から除外することができます。\n\n注：デフォルトでは、このスクリプトはすでに作成されているファイルを上書きしません。"
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "ドキュメントへのモジュールパス"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "生成処理から除外するための、ファイル、ディレクトリ、または両方のパターンを記した fnmatch-style 形式"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "すべての生成データを配置するディレクトリ"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "目次に表示するサブモジュールの最大深度 (デフォルト: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "存在するファイルは上書きする"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "シンボリックリンクをたどります。collective.recipe.omeletteと組み合わせると強力です。"
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "ファイルを作成せずにスクリプトを実行する"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "各モジュールのドキュメントをそれぞれのページに配置する"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "\"_private\" モジュールを含めます。"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "目次のファイル名 (デフォルト: モジュール)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "目次ファイルを生成しない"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "module/package パッケージの見出しを生成しない (例: docstring にすでにそれらが含まれている場合など)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "サブモジュールのドキュメントの前に、モジュールのドキュメントを置く"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "PEP-0420 暗黙の名前空間の指定に従って、モジュールパスを解釈する"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "ファイルの拡張子 (デフォルト: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "sphinx-quickstart を使って完全なプロジェクトを生成する"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "module_pathを sys.path に追加します。--full が与えられたときに使用されます。"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "プロジェクト名 (デフォルト: ルートモジュール名)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "プロジェクト著者名(複数可)。--full が与えられたときに使用されます。"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "プロジェクトバージョン。--full が与えられたときに使用されます。"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "プロジェクトのリリースバージョン。--full が与えられたときに使用されます。デフォルトは --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "拡張オプション"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s はディレクトリではありません。"
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "無効な正規表現 %r が %s 内に見つかりました"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "ソース内のカバレッジのテストが終了したら、%(outdir)spython.txt の結果を確認してください。"
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "coverage_c_regexes 内に無効な正規表現 %r があります"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "モジュール %s をインポートできませんでした: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "'%s' オプション内に '+' または '-' が不足しています"
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' は正しいオプションではありません"
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' は正しい pyversion オプションではありません"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "無効な TestCode タイプ"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "ソース内の doctests のテストが終了したら、%(outdir)s/output.txt の結果を確認してください。"
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "%sブロックにあるコード/出力 が %s にありません: %s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "無効な doctest コードは無視されます: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== 最も遅い読み取り時間 ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr "ハードコードされたリンク %r は 拡張リンクに置き換えられる可能性があります (代わりに %r を使用してみてください)。"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Graphviz ディレクティブはコンテンツとファイル名の両方の引数を持つことは出来ません"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "外部の Graphviz ファイル %r が見つからないか読み込めません"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "コンテンツのない \"graphviz\" ディレクティブを無視します"
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2660,14 +2668,14 @@
 "%r"
 msgstr "dotは出力ファイルを生成しませんでした:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot コマンド %r は実行できません (graphviz 出力のために必要です)。graphviz_dot の設定を確認してください"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2677,33 +2685,35 @@
 "%r"
 msgstr "dot はエラー終了しました:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format は %r ではなく 'png' か 'svg' でなければなりません"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot コード %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "グラフ: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "グラフ"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "convert コマンド %r を実行できません。image_converter の設定を確認してください: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2713,163 +2723,173 @@
 "%r"
 msgstr "変換処理はエラー終了しました:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "convert コマンド %r は実行できません。image_converter の設定を確認してください"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "LaTeX コマンド %r を実行できません (数式表示のために必要です)。imgmath_latex の設定を確認してください"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s コマンド %r を実行できません (数式表示のために必要です)。imgmath_%s の設定を確認してください"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "latex の表示 %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex のインライン表示 %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "この数式へのパーマリンク"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "intersphinx インベントリは移動しました: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "%s から intersphinx インベントリをロード中..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "いくつかのインベントリでいくつかの問題に遭遇しましたが、代替手段を持っていました:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "以下の問題があるため、いくつかのインベントリは到達できませんでした:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(in %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "intersphinx 識別子 %r は文字列ではありません。無視します"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "intersphinx_mapping %s の読み取りに失敗しました。無視します: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "ソース"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "課題"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "TODO エントリーが見つかりました: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> は、 %s の %d 行目です)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "元のエントリ"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "モジュールコードをハイライトしています..."
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "ドキュメント"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "モジュールコード"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s のソースコード</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "概要: モジュールコード"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>全モジュールのうち、コードを読めるもの</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "member-order オプションに無効な値があります: %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "class-doc-from オプションに無効な値があります: %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "auto%s (%r) の署名が無効です"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "%sの引数のフォーマット中にエラーが発生しました: %s "
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "オブジェクト %s に属性 %s がありません"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2877,113 +2897,112 @@
 "explicit module name)"
 msgstr "ドキュメントの自動生成 %r のためにどのモジュールをインポートするのか分かりません (ドキュメントに \"module\"または \"currentmodule\"ディレクティブを配置するか、明示的なモジュール名を指定してください)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr "モックオブジェクトが検出されました: %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "%s のシグネチャをフォーマット中にエラーが発生しました: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "automodule 名の \"::\" は意味がありません"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "automodule に与えられた署名引数、または戻り値となるアノテーション %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ は文字列のリストでなければなりません。%r (%s モジュールの中) ではないです -- ignoring __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "members: オプションで指定された属性がありません: モジュール %s、属性 %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "%s の関数シグネチャの取得に失敗しました: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "%s のコンストラクタ署名の取得に失敗しました: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "ベースクラス: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "オブジェクト %s に属性 %s がありません"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "%sの別名です。"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "TypeVar(%s)のエイリアスです。"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "%s のメソッド・シグネチャの取得に失敗しました: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "無効な __slots__ が %s で見つかりました。無視されました。"
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr "autodoc_member_order が \"alphabetic\" の代わりに \"alphabetical\" を受け入れるようになりました。設定を更新してください。"
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "%r の既定の引数値の解析に失敗しました: %s。"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "%r のシグネチャの更新に失敗しました: パラメータが見つかりません: %s。"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "%rのtype_commentを解析できませんでした: %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "autosummary は除外したドキュメント %r を参照しています。無視されます。"
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: stubファイルが見つかりません%r。autosummary_generate設定を確認してください。"
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "キャプション付きオートサマリーには :toctree: オプションが必要です。"
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2991,46 +3010,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "%sの名前を解析できませんでした "
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "%sオブジェクトをインポートできませんでした "
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: ファイルが見つかりません: %s"
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary は内部的に rst ファイルを生成します。しかしあなたの source_suffix は rst ファイルに含まれていませんでした。スキップします。"
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary %s の autosummary を生成中"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary %s に書き込み中"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3038,7 +3057,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3053,138 +3072,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nautosummary ディレクティブを使って ReStructuredText を生成します。\n\nsphinx-autogen は sphinx.ext.autosummary.generate のフロントエンドです。\n入力されたファイルを含む autosummary ディレクティブから reStructuredText ファイルを\n生成します。\n\nautosummary ディレクティブのフォーマットは\n``sphinx.ext.autosummary`` に記載されています。Pythonモジュールと :: を使って読むことができます。\n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "rST ファイルを生成するためのソースファイル"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "すべての生成データを配置するディレクトリ"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "ファイルのデフォルト拡張子 (デフォルト: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "カスタムテンプレートディレクトリ (デフォルト: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "インポートしたメンバーのドキュメント (デフォルト: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr "モジュール __all__ 属性に含まれるメンバーのみを対象としたドキュメントを作成します。(デフォルト: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "キーワード引数"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "サンプル"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "サンプル"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "メモ"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "その他のパラメータ"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr "受け取る"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "参照"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "警告"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "列挙"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "無効な値セット (終了括弧がありません): %s"
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "無効な値セット (開始括弧がありません): %s"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "不正な文字列リテラル (終了引用符がありません): %s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "不正な文字列リテラル (開始引用符がありません): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "危険"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "エラー"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "ヒント"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "重要"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "注釈"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "参考"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
-msgstr "ちなみに"
+msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "警告"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "前のページからの続き"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "次のページに続く"
@@ -3206,7 +3225,7 @@
 msgid "Table of Contents"
 msgstr "目次"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "検索"
@@ -3287,35 +3306,35 @@
 msgid "Navigation"
 msgstr "ナビゲーション"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s 内を検索"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "このドキュメントについて"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "著作権"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "最終更新: %(last_updated)s"
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3360,12 +3379,12 @@
 msgstr "検索"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "検索結果"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3407,280 +3426,278 @@
 msgid "Other changes"
 msgstr "その他の変更"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "このヘッドラインへのパーマリンク"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "この定義へのパーマリンク"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "検索結果を隠す"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "検索中"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "検索を準備しています..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "検索が完了し、 %s ページ見つけました。"
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", in "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "サイドバーを展開"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "検索結果を隠す"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "サイドバーをたたむ"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "サイドバーを展開"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "コンテンツ"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "4列ベースのインデックスが見つかりました。あなたが使っている拡張子のバグかもしれません: %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Footnote %s は参照されていません。"
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "Footnote # は参照されていません。"
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "翻訳されたメッセージの footnote 参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "翻訳されたメッセージの参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "翻訳されたメッセージの引用参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "翻訳されたメッセージの用語参照が矛盾しています。原文: {0}、翻訳: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr "相互参照用のフォールバックテキストを決定できませんでした。バグかもしれません。"
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "'any' クロスリファレンス %r のターゲットが1つ以上みつかりました。 %s に参照を設定します。"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
-msgstr ""
+msgstr "%s:%s 参照先が見つかりません: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "%r 参照先が見つかりません: %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "リモート画像を取得できませんでした: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "リモート画像を取得できませんでした: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "不明な画像フォーマット: %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "デコードできないソース文字です。\"?\" に置き換えます: %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "スキップしました"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "失敗しました"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "不明なディレクティブまたはロール名: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "不明なノードタイプ: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "読み取りエラー: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "書き込みエラー: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "locale_dir %s は存在しません"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "日付形式が無効です。直接出力したい場合は、文字列を一重引用符で囲みます: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree に存在しないファイルへの参照が含まれています %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "only ディレクティブの条件式の評価中に例外が発生しました: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "デフォルトのロール %s が見つかりません"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "この定義へのパーマリンク"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "%s に numfig_format は定義されていません"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "いくつかの ID が %s ノードに割り当てられていません"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "この用語の解説へ"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "この見出しへのパーマリンク"
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "このテーブルへのパーマリンク"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "このコードへのパーマリンク"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "この画像へのパーマリンク"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "この目次へのパーマリンク"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "画像サイズを取得できませんでした。:scale: オプションは無視されます。"
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "不明なクラス %r の toplevel_sectioning %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: が大きすぎるので無視されます。"
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "ドキュメントのタイトルは、単一の Text ノードではありません"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "セクション、トピック、表、訓戒またはサイドバーにないタイトルノードが見つかりました。"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "注記"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "tabularcolumns と :widths: オプションの両方が設定されています。:widths: は無視されます。"
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "ディメンション単位 %s が無効です。無視されます。"
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "不明なインデックスエントリタイプ %s が見つかりました"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "画像: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "画像"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "キャプションは図の中にはありません。"
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "未実装のノードタイプ: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ko/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ko/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\ub2e4\uc74c \ud56d\ubaa9",
         "Other changes": "\ub2e4\ub978 \ubcc0\uacbd \uc0ac\ud56d",
         "Overview": "\uac1c\uc694",
-        "Permalink to this definition": "\uc774 \uc815\uc758\uc5d0 \ub300\ud55c \ud37c\uba38\ub9c1\ud06c",
-        "Permalink to this headline": "\uc774 \ud45c\uc81c\uc5d0 \ub300\ud55c \ud37c\uba38\ub9c1\ud06c",
         "Please activate JavaScript to enable the search\n    functionality.": "\uac80\uc0c9 \uae30\ub2a5\uc744 \uc0ac\uc6a9\ud558\ub824\uba74 JavaScript\ub97c \ud65c\uc131\ud654\ud558\uc2ed\uc2dc\uc624.",
         "Preparing search...": "\uac80\uc0c9 \uc900\ube44 \uc911\u2026",
         "Previous topic": "\uc774\uc804 \ud56d\ubaa9",
@@ -39,7 +37,7 @@
         "Search": "\uac80\uc0c9",
         "Search Page": "\uac80\uc0c9 \ud398\uc774\uc9c0",
         "Search Results": "\uac80\uc0c9 \uacb0\uacfc",
-        "Search finished, found %s page(s) matching the search query.": "\uac80\uc0c9\uc774 \uc644\ub8cc\ub418\uc5c8\uc73c\uba70, \uac80\uc0c9\uc5b4\uc640 \uc77c\uce58\ud558\ub294 %s \uac1c \ud398\uc774\uc9c0\ub97c \ucc3e\uc558\uc2b5\ub2c8\ub2e4.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "\uac80\uc0c9\uc774 \uc644\ub8cc\ub418\uc5c8\uc73c\uba70, \uac80\uc0c9\uc5b4\uc640 \uc77c\uce58\ud558\ub294 ${resultCount} \uac1c \ud398\uc774\uc9c0\ub97c \ucc3e\uc558\uc2b5\ub2c8\ub2e4.",
         "Search within %(docstitle)s": "%(docstitle)s\uc5d0\uc11c \ucc3e\uae30",
         "Searching": "\uac80\uc0c9 \uc911",
         "Searching for multiple words only shows matches that contain\n    all words.": "\uc5ec\ub7ec \ub2e8\uc5b4\ub97c \uac80\uc0c9\ud558\uba74 \ubaa8\ub4e0 \ub2e8\uc5b4\uac00 \ud3ec\ud568\ub41c \uc77c\uce58 \ud56d\ubaa9\ub9cc \ud45c\uc2dc\ub429\ub2c8\ub2e4.",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ko/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ko/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ko/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ko/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-05 10:17+0000\n"
-"Last-Translator: YT H <dev@theYT.net>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: YT H <dev@theYT.net>, 2019-2022\n"
 "Language-Team: Korean (http://www.transifex.com/sphinx-doc/sphinx-1/language/ko/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ko\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "원본 디렉토리를 찾을 수 없습니다 (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "출력 디렉토리 %s은(는) 디렉토리가 아닙니다."
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "원본 디렉토리와 대상 디렉토리는 같을 수 없습니다"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx 버전 %s 실행 중"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "이 프로젝트는 최소 Sphinx 버전 %s이(가) 필요하므로 현재 버전으로 빌드할 수 없습니다."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "출력 디렉토리 만드는 중"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "확장 기능 %s 설정 중:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "현재 conf.py 파일에 정의된 'setup'은 호출 가능한 Python 객체가 아닙니다. 호출 가능한 함수가 되도록 정의를 수정하십시오.\n이것은 conf.py가 Sphinx 확장 기능으로 동작하는 데 필요합니다."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "번역을 불러오는 중 %s… "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "완료"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "기본 제공 메시지를 사용할 수 없습니다"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "pickle로 저장된 환경을 불러오는 중"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "실패: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "선택한 빌더가 없으므로, 기본값인 html을 사용합니다"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "성공"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "완료했으나 문제점 발견"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "빌드 %s, 경고가 %s 개 발생했습니다."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "빌드 %s, 경고가 %s 개 발생했습니다."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "빌드 %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "%r 노드 클래스가 이미 등록되어 있으며, 방문자를 무시합니다"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "%r 지시문이 이미 등록되어 있으며, 재정의됩니다"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "%r 역할이 이미 등록되어 있으며, 재정의됩니다"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr "%s 확장 기능은 병렬 읽기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "%s 확장 기능은 병렬 읽기에 안전하지 않습니다"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr "%s 확장 기능은 병렬 쓰기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "%s 확장 기능은 병렬 쓰기에 안전하지 않습니다"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "병렬 %s 처리"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "설정 디렉토리에 conf.py 파일이 없습니다 (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "잘못된 구성 값을 찾았습니다: 'language = None'. 유효한 언어 코드로 구성을 업데이트하십시오. 대신 'en'(영어)을 사용합니다."
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "Dictionary 구성 설정 %r을(를) 재정의할 수 없으며, 무시합니다 (개별 요소를 설정하기 위해 %r 사용)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "숫자 %r이(가) 설정값 %r에 대해 유효하지 않으며, 무시합니다"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "지원되지 않는 유형의 구성 설정 %r을(를) 재정의 할 수 없으며, 무시합니다"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "재정의 중 알 수 없는 설정값 %r, 무시합니다"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "해당 설정값이 없습니다: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "설정값 %r이(가) 이미 존재합니다"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "구성 파일에 구문 오류가 있습니다: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "구성 파일(또는 가져온 모듈 중 하나)에서 sys.exit()을 호출했습니다"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr "구성 파일에 프로그램 오류가 있습니다:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "설정값 'source_suffix'는 문자열, 문자열의 목록 또는 dictionary를 예상합니다. 그러나 `%r'이(가) 지정되었습니다."
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "제 %s 절"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "그림 %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "표 %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "예시 %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "설정값 `{name}`은(는) {candidates} 중 하나여야 하지만, `{current}`이(가) 지정되었습니다."
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, {permitted} 유형을 기대했습니다."
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, 기본값은 `{default.__name__}'입니다."
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r(이)가 없으므로, 무시합니다."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "2.0 버전부터 Sphinx는 기본적으로 \"index\"를 root_doc으로 사용합니다. conf.py에 \"root_doc = 'contents'\"를 추가하십시오."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "이벤트 %r이(가) 이미 존재합니다"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "알 수 없는 이벤트 이름: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "처리기 %r (이벤트 %r에 대한) 에서 예외를 발생했습니다"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "%s 확장 기능은 needs_extensions 설정에 따라 필요하지만, 로드되지 않았습니다."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "이 프로젝트에는 최소한 %s 버전의 %s 확장 기능이 필요하므로 로드 된 버전(%s)으로 빌드 할 수 없습니다."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments 구문 분석기 이름 %r을(를) 확인할 수 없습니다"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "literal_block을 \"%s\"(으)로 구문 분석할 수 없습니다. 구문 강조를 건너뜁니다."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "문서 \"%s\"에 대해 여러 파일을 발견했습니다: %r\n빌드에 %r을(를) 사용합니다."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "문서를 읽을 수 없습니다. 무시합니다."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "빌더 클래스 %s에 \"name\" 속성이 없습니다"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "%r 빌더가 이미 존재합니다 (%s 모듈에 있음)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "빌더 이름 %s이(가) 등록되지 않았거나 진입점을 통해서만 사용할 수 있습니다"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "빌더 이름 %s이(가) 등록되지 않았습니다"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "%s 영역이 이미 등록되었습니다"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "%s 영역이 아직 등록되지 않았습니다"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r 지시문이 %s 영역에 이미 등록되었습니다"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r 역할이 %s 영역에 이미 등록되었습니다"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r 색인이 %s 영역에 이미 등록되었습니다"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type이 이미 등록되었습니다"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type이 이미 등록되었습니다"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r이(가) 이미 등록되었습니다"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r에 대한 source_parser가 이미 등록되었습니다"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s에 대한 소스 해석기가 등록되지 않았습니다"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r에 대한 변환기가 이미 존재합니다"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node()에 대한 kwargs는 반드시 (visit, depart)의 함수 튜플이어야 합니다: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r이(가) 이미 등록되었습니다"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "수식 렌더러 %s이(가) 이미 등록되었습니다"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "%r 확장 기능은 Sphinx에 버전 %s 이후로 이미 병합되었습니다. 이 확장 기능은 무시됩니다."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "원래 예외:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "확장 기능 %s을(를) 가져올 수 없습니다"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "확장 기능 %r에 setup() 함수가 없습니다. Sphinx 확장 모듈이 맞습니까?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "이 프로젝트에서 사용하는 %s 확장 기능에는 최소한 Sphinx v%s이(가) 필요합니다. 따라서 이 버전으로 빌드 할 수 없습니다."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "확장 기능 %r이(가) setup() 함수에서 지원되지 않는 개체를 반환했습니다. None 또는 메타데이터 dictionary를 반환해야 합니다"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python 향상 제안; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr "잘못된 PEP 번호 %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr "잘못된 RFC 번호 %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "테마 %r에 \"theme\" 설정이 없습니다"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "테마 %r에 \"inherit\" 설정이 없습니다"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "이름이 %r인 테마가 없으며, %r에서 상속합니다"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "검색된 테마 구성에서 %s.%s 설정이 존재하지 않습니다"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "지원하지 않는 테마 옵션 %r을(를) 설정했습니다"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "테마 경로의 %r 파일이 유효한 ZIP 파일이 아니거나 테마를 포함하지 않습니다"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "sphinx_rtd_theme (< 0.3.0) 가 발견되었습니다. 이 테마는 Sphinx 6.0부터 사용할 수 없습니다."
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "이름이 %r인 테마를 찾을 수 없습니다 (theme.conf 파일 누락?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "빌드 중 mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "출력을 쓰는 중… "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "모든 %d 개의 po 파일"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "지정된 %d 개의 po 파일 대상"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "오래된 %d 개의 po 파일 대상"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "모든 원본 파일"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "명령줄에 지정된 파일 %r이(가) 원본 디렉토리에 있지 않으므로, 무시합니다"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "명령줄에 지정된 파일 %r이(가) 존재하지 않으므로, 무시합니다"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "명령줄에 지정된 %d 개의 원본 파일"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "오래된 %d 개의 원본 파일 대상"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "빌드 중 %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "오래된 파일을 찾는 중… "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d 개 찾음"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "찾은 것이 없음"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "pickle로 환경을 저장하는 중"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "일관성 확인 중"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "오래된 대상이 없습니다."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "환경을 갱신하는 중: "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s 개 추가됨, %s 개 변경됨, %s 개 제거됨"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "원본을 읽는 중… "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "작업자를 기다리는 중…"
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "기록할 문서 이름: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "문서 준비 중"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "중복된 목차 항목 발견: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "이미지를 복사하는 중… "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "이미지 파일 %r을(를) 읽을 수 없으며, 대신 복사합니다"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "이미지 파일 %r을(를) 복사할 수 없습니다: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "이미지 파일 %r을(를) 기록할 수 없습니다: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillow를 찾을 수 없습니다 - 이미지 파일을 복사합니다"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "mimetype 파일 쓰는 중…"
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "META-INF/container.xml 파일 쓰는 중…"
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "content.opf 파일 쓰는 중…"
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "%s은(는) 알 수 없는 MIME 유형이며, 무시합니다"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "toc.ncx 파일 쓰는 중…"
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "%s 파일을 기록하는 중…"
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "개요 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "버전 %s에는 변경 사항이 없습니다."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "요약 파일 작성 중…"
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "내장"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "모듈 수준"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "원본 파일을 복사하는 중…"
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "변경 로그 생성을 위해 %r을(를) 읽을 수 없습니다"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "더미 빌더는 파일을 생성하지 않습니다."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePub 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "nav.xhtml 파일 쓰는 중…"
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "설정값 \"epub_language\"(또는 \"language\")는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "설정값 \"epub_uid\"는 EPUB3의 경우 XML 이름이어야 합니다"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "설정값 \"epub_title\"은 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "설정값 \"epub_author\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "설정값 \"epub_contributor\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "설정값 \"epub_description\"은 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "설정값 \"epub_publisher\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "설정값 \"epub_copyright\"(또는 \"copyright\")는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "설정값 \"epub_identifier\"는 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "설정값 \"version\"은 EPUB3의 경우 비워 둘 수 없습니다"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "잘못된 css_file: %r, 무시합니다"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "메시지 카탈로그는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d 개의 템플릿 파일 대상"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "템플릿을 읽는 중… "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "메시지 카탈로그 작성 중… "
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오"
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "끊어진 링크: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "앵커 '%s'을(를) 찾을 수 없습니다"
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr "linkcheck_allowed_redirects에서 정규식을 컴파일하지 못했습니다: %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "매뉴얼 페이지는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "\"man_pages\" 설정값이 없으므로, 매뉴얼 페이지를 작성하지 않습니다"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "작성 중"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML 페이지는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "단일 문서 조합 중"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "추가 파일 작성 중"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nmakeinfo를 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make info'를 사용하십시오)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "\"texinfo_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "\"texinfo_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "%s 처리 중"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "참조 처리 중…"
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (문서 "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "Texinfo 지원 파일을 복사하는 중"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "Makefile 쓰기 오류: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "텍스트 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "%s 파일 쓰기 오류: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "의사 XML 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "빌드 정보 파일이 손상되었습니다: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML 페이지는 %(outdir)s에 있습니다."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "빌드 정보 파일을 읽을 수 없습니다: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y년 %m월 %d일"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "전체 색인"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "색인"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "다음"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "이전"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "색인 생성 중"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "추가 페이지 작성 중"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "다운로드 가능한 파일을 복사하는 중… "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "다운로드 가능한 파일 %r을(를) 복사할 수 없습니다: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "html_static_file에 있는 파일을 복사할 수 없습니다: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr "정적 파일을 복사하는 중"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "정적 파일을 복사할 수 없습니다: %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "추가 파일을 복사하는 중"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "추가 파일을 복사할 수 없습니다: %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "빌드 정보 파일 쓰기 실패: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "검색 색인을 불러올 수 없지만 모든 문서가 작성되지는 않은 것은 아닙니다. 색인이 불완전합니다."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "%s 페이지가 html_sidebars의 두 패턴(%r 및 %r)과 일치합니다"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "%s 페이지를 렌더링 할 때 유니코드 오류가 발생했습니다. ASCII가 아닌 내용을 포함하는 모든 설정값이 유니코드 문자열인지 확인하십시오."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "%s 페이지를 렌더링하는 중에 오류가 발생했습니다.\n원인: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "객체 인벤토리 덤프 중"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s에서 검색 인덱스 덤프 중"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "잘못된 js_file: %r, 무시합니다"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "여러 math_renderers가 등록되어 있습니다. 하지만 math_renderer가 선택되지 않았습니다."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "알 수 없는 math_renderer %r이(가) 지정되었습니다."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path 항목 %r이(가) 없습니다"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path 항목 %r이(가) outdir 안에 있습니다"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path 항목 %r이(가) 없습니다"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path 항목 %r이(가) outdir 안에 있습니다"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "로고 파일 %r이(가) 존재하지 않습니다"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "Favicon 파일 %r이(가) 존재하지 않습니다"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr "html_add_permalinks는 3.5.0 버전부터 더 이상 사용되지 않습니다. 대신 html_permalinks 및 html_permalinks_icon을 사용하십시오."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s 문서"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeX 파일은 %(outdir)s에 있습니다."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\n(pdf)latex을 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make latexpdf'를 사용하십시오)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "\"latex_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "\"latex_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "색인"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "릴리스"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r 언어에 대해 알려진 Babel 옵션이 없습니다"
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr "TeX 지원 파일을 복사하는 중"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "TeX 지원 파일을 복사하는 중…"
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "추가 파일을 복사하는 중"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "알 수 없는 설정 키: latex_elements%r, 무시합니다."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr "알 수 없는 테마 옵션: latex_theme_options%r, 무시합니다."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r에 \"theme\" 설정이 없습니다"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r에 \"%s\" 설정이 없습니다"
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "빌드하는 동안 예외 발생, 디버거 시작:"
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "중단되었습니다!"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "reST 마크업 오류:"
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "인코딩 오류:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "개발자에게 문제를 보고할 경우를 위해, 전체 역추적 정보가 %s에 저장되었습니다."
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "재귀 오류:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "이 상황은 매우 크거나 많이 중첩된 원본 파일에서 발생할 수 있습니다. 다음과 같이 conf.py에서 Python 재귀 제한 기본값 1000을 늘릴 수 있습니다 (주의):"
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "예외 발생:"
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "사용자 오류인 경우에도 이를 보고하여, 다음에 더 나은 오류 메시지를 제공할 수 있도록 해 주십시오."
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "버그 보고서는 <https://github.com/sphinx-doc/sphinx/issues>의 트래커에 제출할 수 있습니다. 감사합니다!"
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "작업 숫자는 양수여야 합니다"
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "자세한 내용은 <https://www.sphinx-doc.org/>를 참조하십시오."
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,35 +1230,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr "\n소스 파일로부터 문서를 생성합니다.\n\nsphinx-build는 SOURCEDIR에 있는 파일로부터 문서를 생성하여 OUTPUTDIR에 저장합니다.\n구성 설정을 위해 SOURCEDIR에서 'conf.py' 파일을 찾습니다.\n'sphinx-quickstart' 도구는 'conf.py'를 포함하여 템플릿 파일을 생성하는 데 사용할 수 있습니다.\n\nsphinx-build는 다양한 형식으로 문서를 생성할 수 있습니다.\n형식은 명령줄에서 빌더 이름을 지정하여 선택하며, 기본값은 HTML입니다.\n빌더는 문서 처리와 관련한 다른 태스크를 수행할 수도 있습니다.\n\n기본적으로 오래된 모든 항목을 빌드합니다.\n개별 파일명을 지정하여 선택한 파일에 대한 출력만 빌드할 수 있습니다.\n"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "문서 원본 파일의 경로"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "출력 디렉토리 경로"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "다시 빌드 할 특정 파일의 목록. -a가 지정되면 무시합니다"
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "일반 옵션"
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "사용할 빌더 (기본값: html)"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "모든 파일 기록 (기본값: 새 파일과 변경된 파일만 기록)"
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "저장된 환경을 사용하지 않고, 항상 모든 파일 읽기"
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1302,7 +1304,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr "상세도 높임 (반복 가능)"
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "stdout에 출력하지 않고, stderr에 경고만 표시"
 
@@ -1338,161 +1340,156 @@
 msgid "run Pdb on exception"
 msgstr "예외 발생 시 Pdb 실행"
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "파일을 찾을 수 없습니다: %r"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "-a 옵션과 파일 이름을 함께 사용할 수 없습니다"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "경고 기록 파일 %r을(를) 열 수 없습니다: %s"
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "-D 옵션 인수는 name=value 형식이어야 합니다"
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "-A 옵션 인수는 name=value 형식이어야 합니다"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "모듈에서 자동으로 docstring 삽입"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "doctest 블록의 코드 조각을 자동으로 테스트"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "다른 프로젝트의 Sphinx 문서 간 링크"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "빌드 시 표시하거나 숨길 수 있는 \"할 일\" 항목 작성"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "문서의 커버리지 확인"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "PNG나 SVG 이미지로 렌더링 된 수식 포함"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "MathJax로 브라우저에서 렌더링 하는 수식 포함"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "설정값을 기반으로 콘텐츠를 조건부 포함"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "문서화 된 Python 객체의 소스 코드에 대한 링크 포함"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "GitHub 페이지에 문서를 게시하기 위해 .nojekyll 파일 생성"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "유효한 경로 이름을 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "텍스트를 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "%s 중 하나를 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "'y' 또는 'n'을 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "파일 접미사를 입력하십시오 (예: '.rst' 또는 '.txt')."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Sphinx %s 빠른 시작 유틸리티에 오신 것을 환영합니다."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "다음 설정에 대한 값을 입력하십시오 (대괄호로 묶여 있는 기본값이 존재하고\n이 값을 사용하려면 바로 Enter를 누릅니다)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "선택한 루트 경로: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "문서의 루트 경로를 입력하십시오."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "문서의 루트 경로"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "오류: 선택한 루트 경로에서 기존 conf.py 파일이 발견되었습니다."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart는 기존 Sphinx 프로젝트를 덮어 쓰지 않습니다."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "새 루트 경로를 입력하십시오 (또는 Enter를 눌러 종료)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Sphinx 출력을 위한 빌드 디렉토리를 배치하는 두 가지 옵션이 있습니다.\n루트 경로 내에서 \"_build\" 디렉토리를 사용하거나, 루트 경로 내에서\n\"source\"와 \"build\" 디렉토리로 분리합니다."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "원본과 빌드 디렉토리 분리 (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 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 "루트 디렉토리 내에 두 개의 추가 디렉토리가 생성됩니다. 사용자 정의 HTML 템플릿의\n경우 \"_templates\", 사용자 정의 스타일시트 및 기타 정적 파일의 경우 \"_static\"\n입니다. 다른 접두사(\".\" 과 같은)를 입력하여 밑줄 문자를 변경할 수 있습니다."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "템플릿 및 정적 디렉토리의 이름 접두사"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "프로젝트 이름은 빌드 된 문서의 여러 위치에 표시됩니다."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "프로젝트 이름"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "작성자 이름"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr "Sphinx는 소프트웨어에 대한 \"버전\"과 \"릴리스\"라는 개념을 가지고 있습니다.\n각 버전에는 여러 릴리스가 있을 수 있습니다. 예를 들어 Python의 경우 버전은\n2.5나 3.0과 같은 반면 릴리스는 2.5.1 또는 3.0a1과 같습니다.\n이러한 이중 구조가 필요하지 않으면 둘 다 동일한 값으로 설정하십시오."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "프로젝트 버전"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "프로젝트 릴리스"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "문서를 영어 이외의 언어로 작성하려는 경우, 여기에서 해당 언어 코드로 언어를\n선택할 수 있습니다. 그러면 Sphinx가 생성한 텍스트를 해당 언어로 번역합니다.\n\n지원되는 코드 목록은\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language\n를 참조하십시오."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "프로젝트 언어"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 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 "원본 파일의 파일 이름 접미사. 일반적으로 \".txt\" 또는 \".rst\" 입니다. 이 접미사가\n있는 파일만 문서로 간주됩니다."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "원본 파일 접미사"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "한 문서는 \"컨텐츠 트리\"의 최상위 노드, 즉 문서 계층 구조의 루트로 간주된다는\n점에서 특별합니다. 일반적으로 이 값은 \"index\" 이지만, \"index\" 문서가\n사용자 정의 템플릿일 경우 이를 다른 파일 이름으로 설정할 수도 있습니다."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "마스터 문서의 이름 (접미사 없이)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "오류: 선택한 루트 경로에 마스터 파일 %s이(가) 이미 있습니다."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart는 기존 파일을 덮어 쓰지 않습니다."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "새 파일 이름을 입력하거나 기존 파일의 이름을 바꾸고, Enter를 누르십시오"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "다음 Sphinx 확장 기능 중 사용 설정해야 하는 항목을 지정하십시오:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "참고: imgmath와 mathjax는 동시에 활성화 할 수 없습니다. imgmath가 선택 취소되었습니다."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Makefile 및 Windows 명령 파일을 생성할 수 있으므로, sphinx-build를 직접 호출하는\n대신 (예를 들어) `make html'을 실행하기만 하면 됩니다."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Makefile을 만드시겠습니까? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Windows 명령 파일을 만드시겠습니까? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "%s 파일을 만드는 중입니다."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "%s 파일이 이미 존재하여, 건너뜁니다."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "완료됨: 초기 디렉토리 구조가 생성되었습니다."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "이제 마스터 파일 %s을(를) 채우고 다른 원본 문서 파일을 만들어야 합니다. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Makefile을 사용하여 다음과 같이 문서를 빌드하십시오:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "sphinx-build 명령을 사용하여 다음과 같이 문서를 빌드하십시오:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "여기서 \"builder\"는 지원되는 빌더 중 하나(예: html, latex, linkcheck)입니다."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nSphinx 프로젝트에 필요한 파일을 생성합니다.\n\nsphinx-quickstart는 대화형 도구로서, 프로젝트에 대한 몇 가지 질문을 한 다음\n완전한 문서 디렉토리와 (sphinx-build와 함께 사용할 수 있는) 견본 Makefile을 생성합니다.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "조용한 모드"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "프로젝트 루트 디렉토리"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "구조 옵션"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "지정된 경우, 원본과 빌드 디렉토리를 구분합니다"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "지정된 경우, 원본 디렉토리 아래에 빌드 디렉토리를 만듭니다"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "_templates 등에서 마침표의 대체 문자"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "프로젝트 기본 옵션"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "프로젝트 이름"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "작성자 이름"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "프로젝트의 버전"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "프로젝트의 릴리스"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "문서 언어"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "원본 파일의 접미사"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "마스터 문서 이름"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "EPUB 사용"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "확장 기능 옵션"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "%s 확장 기능 사용"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "임의의 확장 기능 사용"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile과 배치 파일 생성"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "makefile 생성"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "makefile을 생성하지 않음"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "배치 파일 생성"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "배치 파일을 생성하지 않음"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat에서 make 모드 사용"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat에서 make 모드 사용하지 않음"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "프로젝트 템플릿"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "템플릿 파일에 대한 템플릿 디렉토리"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "템플릿 변수 정의"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\"이 지정되었지만, \"project\" 또는 \"author\"가 정의되지 않았습니다."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "오류: 지정된 경로가 디렉토리가 아니거나, Sphinx 파일이 이미 있습니다."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart는 빈 디렉토리에만 생성됩니다. 새 루트 경로를 지정하십시오."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "잘못된 템플릿 변수: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr "내어쓰기에 의해 비 공백 문자가 제거됨"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "잘못된 캡션: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "줄 번호 지정이 범위를 벗어남 (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "\"%s\"과(와) \"%s\" 옵션을 모두 사용할 수 없습니다"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "포함 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "포함 파일 %r을 읽는데 사용한 %r 인코딩이 잘못된 것 같습니다. :encoding: 옵션을 지정해 보십시오"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "포함 파일 %r에서 이름이 %r 인 객체를 찾을 수 없습니다"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "분리된 \"lines\" 집합과 함께 \"lineno-match\"를 사용할 수 없습니다"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "행 지정 %r: 포함 파일 %r에서 가져온 줄이 없습니다"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr "toctree glob 패턴 %r 이(가) 어느 문서와도 일치하지 않습니다"
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree에 제외된 문서 %r에 대한 참조가 있음"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree에 존재하지 않는 문서 %r에 대한 참조가 있음"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr "toctree에서 중복 항목이 발견됨: %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "구역 작성자: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "모듈 작성자: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "코드 작성자: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "작성자: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ".. acks 내용이 목록이 아닙니다"
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ".. hlist 내용이 목록이 아닙니다"
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,559 +1866,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr "중복 C 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. c:%s:: %s' 입니다."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "매개변수"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr "반환값"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "반환"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "반환 형식"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "멤버 변수"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "변수"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "함수"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "매크로"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr "구조체"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "공용체"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "열거형"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "열거자"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "자료형"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "함수 매개변수"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "버전 %s에 추가"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "버전 %s에서 변경"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "버전 %s부터 폐지됨"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "중복 인용 %s, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "인용 %s이(가) 참조되지 않았습니다."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr "중복 C++ 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. cpp:%s:: %s' 입니다."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "템플릿 매개변수"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "예외"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "클래스"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "콘셉트"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "템플릿 매개변수"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (내장 함수)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s 메서드)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (클래스)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (전역 변수 또는 상수)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s의 속성)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "인수"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (모듈)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "메서드"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "데이터"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "속성"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "모듈"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "중복된 %s 설명 (%s에 대한), 다른 항목은 %s (%s)에 있음"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "중복 레이블의 수식 %s, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "잘못된 math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "키워드"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "연산자"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "객체"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "예외"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "문"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "내장 함수"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "변수"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "예외 발생"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s 모듈)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s 모듈)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (내장 변수)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (내장 클래스)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s 클래스)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s의 클래스 메서드)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s (%s의 특성)"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s의 정적 메서드)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (%s의 특성)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python 모듈 목록"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "모듈"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "폐지됨"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "클래스 메서드"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "정적 메서드"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "특성"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "%s의 중복 객체 설명, 다른 인스턴스는 %s에 있으며, 이 중 하나에 :noindex:를 사용하십시오"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "상호 참조 %r에 대해 둘 이상의 대상을 찾았습니다: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (폐지됨)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (지시문)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (지시문 옵션)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (역할)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "지시문"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "지시문 옵션"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "역할"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "중복된 %s %s 설명, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "환경 변수; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "잘못된 옵션 설명 %r, \"opt\", \"-opt args\", \"--opt args\", \"/opt args\", \"+opt args\"와 같은 형식이어야 합니다"
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s 명령줄 옵션"
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "명령줄 옵션"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "용어 앞에는 빈 줄이 와야 합니다"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "용어 정의는 빈 줄로 구분하면 안됩니다."
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "용어 정의 형식이 잘못된 것 같습니다. 들여쓰기를 확인하십시오"
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "용어 항목"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "문법 토큰"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "참조 레이블"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "환경 변수"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "프로그램 옵션"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "문서"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "모듈 목록"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "검색 페이지"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "중복 레이블 %s, 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "중복된 %s 설명 (%s에 대한), 다른 인스턴스는 %s에 있음"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig가 비활성화되었습니다. :numref:는 무시됩니다."
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "상호 참조를 생성하지 못했습니다. 어떤 번호도 할당되지 않았습니다: %s"
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "링크에 캡션이 없습니다: %s"
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "잘못된 numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "잘못된 numfig_format: %s"
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "정의되지 않은 레이블: %s"
+msgid "undefined label: %r"
+msgstr "정의되지 않은 레이블: %r"
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "상호 참조를 생성하지 못했습니다. 제목 또는 캡션을 찾을 수 없습니다: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr "상호 참조를 생성하지 못했습니다. 제목 또는 캡션을 찾을 수 없습니다: %r"
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "새로운 설정"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "설정이 변경됨"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "확장 기능이 변경됨"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "빌드 환경 버전이 최신이 아님"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "원본 디렉토리가 변경됨"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "이 환경은 선택한 빌더와 호환되지 않습니다. 다른 doctree 디렉토리를 선택하십시오."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "%s에서 문서를 탐색하지 못했습니다: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "%r 영역이 등록되지 않았습니다"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "자체 참조된 toctree가 발견되었습니다. 무시합니다."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "문서가 어느 toctree에도 포함되어 있지 않음"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%s 문서"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "%s 참조"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "알 수 없는 색인 항목 유형 %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "기호"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "순환 toctree 참조가 감지되었으며, 무시합니다: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree에 제목이 없는 문서 %r에 대한 참조가 있습니다. 링크가 생성되지 않습니다"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "이미지 파일을 읽을 수 없음: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "이미지 파일 %s을(를) 읽을 수 없음: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "다운로드 가능 파일을 읽을 수 없음: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s에 이미 구역 번호가 할당되었습니다 (중첩된 번호 붙인 toctree?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "%s 파일을 작성합니다."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\n<MODULE_PATH>에서 Python 모듈 및 패키지를 재귀적으로 찾고\nautomodule 지시문이 있는 패키지 당 하나의 reST 파일을 <OUTPUT_PATH>에 만듭니다.\n\n<EXCLUDE_PATTERN>은 생성에서 제외할 파일 또는 디렉토리 패턴일 수 있습니다.\n\n참고: 기본적으로이 스크립트는 이미 생성된 파일을 덮어 쓰지 않습니다."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "문서에 대한 모듈 경로"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "생성에서 제외할 fnmatch 형식의 파일 또는 디렉토리 패턴"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "모든 출력을 저장할 디렉토리"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "목차에 표시할 하위 모듈의 최대 깊이 (기본값: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "기존 파일 덮어쓰기"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "심볼릭 링크를 따라갑니다. collective.recipe.omelette과 결합하면 강력합니다."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "파일을 생성하지 않고 스크립트 실행"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "각 모듈에 대한 문서를 개별 페이지에 배치"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "\"_private\" 모듈 포함"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "목차의 파일 이름 (기본값: modules)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "목차 파일을 만들지 않음"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "모듈/패키지에 대한 제목을 만들지 않음 (예: docstring에 이미 포함된 경우)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "서브 모듈 문서 앞에 모듈 문서를 넣음"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "PEP-0420 암시적 네임 스페이스 사양에 따라 모듈 경로 해석"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "파일 확장자 (기본값: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "sphinx-quickstart로 전체 프로젝트 생성"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "--full이 주어졌을 때, sys.path에 module_path 추가"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "프로젝트 이름 (기본값: 루트 모듈 이름)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "--full이 주어졌을 때, 프로젝트 작성자"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "--full이 주어졌을 때, 프로젝트 버전"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "--full이 주어졌을 때, 프로젝트의 릴리스이며 기본값은 --doc-version 값과 같음"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "확장 기능 옵션"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s은(는) 디렉토리가 아닙니다."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "잘못된 정규식 %r (%s에서)"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "소스에서 커버리지 테스트가 완료되었으며, %(outdir)s/python.txt 에서 결과를 확인하십시오."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "coverage_c_regexes의 잘못된 정규표현식 %r"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr "문서화되지 않은 C API: %s %s, 파일 %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "%s 모듈을 가져올 수 없습니다: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "문서화되지 않은 Python 함수: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "문서화되지 않은 Python 클래스: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "문서화되지 않은 Python 메소드: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "'%s' 옵션에 '+'나 '-'가 없습니다."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s'은(는) 유효한 옵션이 아닙니다."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s'은(는) 유효한 pyversion 옵션이 아닙니다"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "잘못된 TestCode 유형"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "소스에서 doctest 테스트가 완료되었으며, %(outdir)s/output.txt 에서 결과를 확인하십시오."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "%s 블록(%s:%s)에 코드/출력 없음"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "잘못된 doctest 코드 무시: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "====================== 가장 느린 읽기 시간 ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr "하드코딩 된 링크 %r은(는) extlink로 대체할 수 있습니다 (대신 %r을(를) 사용해 보십시오)"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Graphviz 지시문에 내용과 파일 이름 인수를 모두 지정할 수 없습니다"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "외부 Graphviz 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "내용이 없는 \"graphviz\" 지시문을 무시합니다."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr "dot이 출력 파일을 생성하지 않았습니다:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot 명령 %r을(를) 실행할 수 없습니다 (graphviz 출력에 필요). graphviz_dot 설정을 확인하십시오."
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr "dot이 오류와 함께 종료되었습니다:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format은 'png', 'svg' 중 하나여야 하지만, 값이 %r 입니다"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "dot 코드 %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "그래프: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "그래프"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr "이미지 변환 명령 %r을(를) 실행할 수 없습니다. 'sphinx.ext.imgconverter'에는 기본적으로 ImageMagick이 필요합니다. 해당 프로그램이 설치되어 있는지 확인하거나, 'image_converter' 옵션을 사용자 정의 변환 명령으로 설정하십시오.\n\n역추적: %s"
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr "convert가 오류와 함께 종료되었습니다:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오."
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "LaTeX 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_latex 설정을 확인하십시오"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_%s 설정을 확인하십시오"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "표시 LaTeX %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "인라인 LaTeX %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "이 수식에 대한 퍼머링크"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "intersphinx 인벤토리가 이동함: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "%s 에서 intersphinx 인벤토리 로드 중…"
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "일부 인벤토리에서 몇 가지 문제가 발생했지만, 동작하는 대체 인벤토리로 처리했습니다:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "다음 문제가 있어 어느 인벤토리도 도달하지 못했습니다:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s에서)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(%s에서)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr "외부 상호 참조에 대한 인벤토리를 찾을 수 없음: %s"
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr "외부 상호 참조에 대한 역할을 찾을 수 없음: %s"
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "외부 %s:%s 참조 대상을 찾을 수 없음: %s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "intersphinx 식별자 %r이(가) 문자열이 아닙니다. 무시합니다"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "intersphinx_mapping%s을(를) 읽지 못했으며, 무시합니다: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "소스"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "할 일"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "TODO 항목 발견: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<원래 항목>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<원래 항목>>은 %s 파일, %d 행에 있습니다.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "원래 항목"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "모듈 코드 강조 중… "
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "문서"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "모듈 코드"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s의 소스 코드</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "개요: 모듈 코드"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>코드를 확인할 수 있는 모든 모듈</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "member-order 옵션에 대해 잘못된 값: %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "class-doc-from 옵션에 대해 잘못된 값: %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "auto%s (%r)에 대한 잘못된 서명"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "%s에 대한 인수를 서식화하는 동안 오류 발생: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "%s 속성이 %s 객체에 없음"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autodoc: 문서화 할 %s.%s (%r) 을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr "%r의 자동 문서화를 위해 가져올 모듈을 알 수 없습니다 (문서에 \"module\" 또는 \"currentmodule\" 지시문을 배치하거나, 명시적으로 모듈 이름을 지정해 보십시오)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr "모의 객체가 감지되었습니다: %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "%s에 대한 서명을 서식화하는 동안 오류 발생: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "automodule 이름의 \"::\"은 의미가 없음"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "automodule %s에 대해 서명 인수 또는 반환 값 주석이 지정됨"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__은 %r이(가) 아닌 문자열의 목록이어야 합니다 (모듈 %s) -- __all__을 무시합니다"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ":members: 옵션에 언급된 속성이 없습니다: 모듈 %s, 속성 %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "%s에 대한 함수 서명을 가져오지 못했습니다: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "%s에 대한 생성자 서명을 가져오지 못했습니다: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "기반 클래스: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "%s 속성이 %s 객체에 없음"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "%s의 별칭"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "TypeVar(%s)의 별칭"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "%s에 대한 메소드 서명을 가져오지 못했습니다: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "%s에서 잘못된 __slots__ 가 발견되었습니다. 무시합니다."
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr "autodoc_member_order는 이제 \"alphabetical\" 대신 \"alphabetic\"을 허용합니다. 설정을 업데이트하십시오."
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "%r에 대한 기본 인수 값을 해석하지 못했습니다: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "%r에 대한 서명을 업데이트하지 못했습니다. 매개변수를 찾을 수 없습니다: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "%r에 대한 type_comment를 해석하지 못했습니다: %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "autosummary가 제외된 문서 %r을(를) 참조합니다. 무시합니다."
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: 스텁 파일 %r을(를) 찾을 수 없습니다. autosummary_generate 설정을 확인하십시오."
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "캡션이 있는 자동 요약에는 :toctree: 옵션이 필요합니다. 무시합니다."
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr "autosummary: %s을(를) import 하지 못했습니다.\n가능한 힌트:\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "이름 %s을(를) 해석하지 못함"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "객체 %s을(를) import 하지 못함"
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: 파일을 찾을 수 없음: %s"
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary는 내부적으로 .rst 파일을 생성합니다. 하지만 source_suffix에 .rst가 포함되어 있지 않습니다. 건너뜁니다."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary 자동 요약 생성: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary %s에 기록"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr "autosummary %s을(를) import 하지 못했습니다.\n가능한 힌트:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nautosummary 지시문을 사용하여 ReStructuredText를 생성합니다.\n\nsphinx-autogen은 sphinx.ext.autosummary.generate의 프런트엔드입니다.\n주어진 입력 파일에 포함된 autosummary 지시문에서 reStructuredText 파일을 생성합니다.\n\nautosummary 지시문의 형식은 ``sphinx.ext.autosummary`` Python 모듈에 문서화되어 있으며 다음 명령을 사용하여 읽을 수 있습니다.\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "rST 파일을 생성할 원본 파일"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "모든 출력을 저장할 디렉토리"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "파일의 기본 확장자 (기본값: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "사용자 정의 템플릿 디렉토리 (기본값: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "가져온 멤버 문서화 (기본값: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr "모듈 __all__ 속성의 구성원만 정확히 문서화합니다. (기본값: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "키워드 매개변수"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "예제"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "예제"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "참고"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "기타 매개변수"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr "수신"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "참조"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "경고"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "생성"
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "잘못된 값 세트 (닫는 중괄호 누락): %s"
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "잘못된 값 세트 (여는 중괄호 누락): %s"
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "잘못된 문자열 리터럴 (닫는 따옴표 누락): %s"
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "잘못된 문자열 리터럴 (여는 따옴표 누락): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "주의"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "조심"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "위험"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "오류"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "힌트"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "중요"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "참고"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "더 보기"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "팁"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "경고"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "이전 페이지에서 계속"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "다음 페이지에 계속"
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr "목차"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "검색"
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr "탐색"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s에서 찾기"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "이 문서 정보"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "저작권"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">저작권</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; 저작권 %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "최종 업데이트: %(last_updated)s"
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "검색"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "검색 결과"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr "다른 변경 사항"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "이 표제에 대한 퍼머링크"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "이 정의에 대한 퍼머링크"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "검색 일치 숨기기"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "검색이 완료되었으며, 검색어와 일치하는 ${resultCount} 개 페이지를 찾았습니다."
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "검색 중"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "검색 준비 중…"
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "검색이 완료되었으며, 검색어와 일치하는 %s 개 페이지를 찾았습니다."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", 문서 - "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "사이드바 열기"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "검색 일치 숨기기"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "사이드바 닫기"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "사이드바 열기"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "내용"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "4 개 열 기반 색인을 찾았습니다. 사용하고 있는 확장 기능의 버그일 수 있습니다: %r"
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "각주 %s이(가) 참조되지 않았습니다."
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "각주 #이 참조되지 않았습니다."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "번역된 메시지의 각주 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "번역된 메시지의 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "번역된 메시지의 인용 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "번역된 메시지의 용어 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr "상호 참조에 대한 대체 텍스트를 결정할 수 없습니다. 버그일 수 있습니다."
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "'any' 상호 참조 %r에 대해 둘 이상의 대상이 발견되었습니다: %s 일 수 있습니다"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr "%s:%s 참조 대상을 찾을 수 없음: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "%r 참조 대상을 찾을 수 없음: %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "원격 이미지를 가져올 수 없습니다: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "원격 이미지를 가져올 수 없습니다: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "알 수 없는 이미지 형식: %s…"
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "디코드 할 수 없는 원본 문자이며, \"?\"로 대체합니다: %r"
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "건너뜀"
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "실패"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr "%s 영역에서 문제 발생: 필드가 '%s' 역할을 사용해야 하지만, 해당 역할이 도메인에 없습니다."
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "알 수 없는 지시문 또는 역할 이름: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "알 수 없는 노드 유형: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "읽기 오류: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "쓰기 오류: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "locale_dir %s이(가) 존재하지 않습니다"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "잘못된 날짜 형식입니다. 바로 출력하려면 작은 따옴표로 문자열을 인용하십시오: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree에 존재하지 않는 파일 %r에 대한 참조가 있음"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "only 지시문 식을 평가하는 동안 예외 발생: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "기본 역할 %s을(를) 찾을 수 없음"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "이 정의에 대한 퍼머링크"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format이 %s에 대해 정의되지 않음"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "%s 노드에 할당되지 않은 ID"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "이 용어에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "이 제목에 대한 퍼머링크"
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "이 표에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "이 코드에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "이 이미지에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "이 목차에 대한 퍼머링크"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "이미지 크기를 얻어올 수 없습니다. :scale: 옵션을 무시합니다."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "알 수 없는 %r toplevel_sectioning (클래스 %r)"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth:가 너무 크며, 무시합니다."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "문서 제목이 단일 텍스트 노드가 아님"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "구역, 주제, 표, 조언, 사이드바 안에 있지 않은 제목 노드가 발견됨"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "각주"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "tabularcolumns와 :widths: 옵션이 모두 설정되었습니다. :widths:는 무시됩니다."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "치수 단위 %s이(가) 잘못되었습니다. 무시합니다."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "알 수 없는 색인 항목 유형 %s이(가) 발견됨"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "그림: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "그림"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "캡션이 그림 안에 있지 않습니다."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "구현되지 않은 노드 유형: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lt/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/lt/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Kita tema",
         "Other changes": "Kiti pakeitimai",
         "Overview": "Ap\u017evalga",
-        "Permalink to this definition": "Nuoroda \u012f \u0161\u012f apibr\u0117\u017eim\u0105",
-        "Permalink to this headline": "Nuoroda \u012f \u0161i\u0105 antra\u0161t\u0119",
         "Please activate JavaScript to enable the search\n    functionality.": "Pra\u0161ome aktyvuoti JavaScript, kad veikt\u0173 paie\u0161kos\n    funkcionalumas.",
         "Preparing search...": "",
         "Previous topic": "Praeita tema",
@@ -39,7 +37,7 @@
         "Search": "Paie\u0161ka",
         "Search Page": "Paie\u0161kos puslapis",
         "Search Results": "Paie\u0161kos rezultatai",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Ie\u0161koti tarp %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lt/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/lt/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lt/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/lt/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: DALIUS DOBRAVOLSKAS <DALIUS@SANDBOX.LT>, 2010\n"
 "Language-Team: Lithuanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lt/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: lt\n"
 "Plural-Forms: nplurals=4; plural=(n % 10 == 1 && (n % 100 > 19 || n % 100 < 11) ? 0 : (n % 10 >= 2 && n % 10 <=9) && (n % 100 > 19 || n % 100 < 11) ? 1 : n % 1 != 0 ? 2: 3);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Įtaisytieji"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Modulio lygis"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (kuris yra "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y-%m-%d"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Bendras indeksas"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indeksas"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "kitas"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "praeitas"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indeksas"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Leidimas"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,35 +1229,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1301,7 +1303,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1337,161 +1339,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Skyriaus autorius: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Modulio autorius: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Kodo autorius: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autorius: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,559 +1865,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametrai"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Grąžinamos reikšmės"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Grąžinamos reikšmės tipas"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "narys"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "kintamasis"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makrokomanda"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipas"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nauja %s versijoje"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Pakeista %s versijoje"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Nebepalaikoma nuo %s versijos"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Išmeta"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klasė"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (itaisytoji funkcija)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metodas)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasė)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globalus kintamasis arba konstanta)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atributas)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumentais"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulis)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metodas"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "duomenys"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribudas"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modulis"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "bazinis žodis"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operatorius"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objektas"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "išimtis"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "sakinis"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "įtaisytoji funkcija"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Kintamieji"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Sukelia"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (modulyje %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (modulje %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (įtaisytasis kintamasis)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (įtaisytoji klasė)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasė iš %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s klasės metodas)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statinis metodas)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduliai"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Atmestas"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klasės metodas"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statinis metodas"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (atmestas)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktyva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rolė)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktyva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rolė"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "aplinkos kintamasis; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "aiškinamasis terminas"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "gramatinė leksema"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "nuorodos požymis"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "aplinkos kintamasis"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programos parinktis"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Modulio indeksas"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Paieškos puslapis"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "šaltinis"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Padaryti"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "originalus įrašas"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumentai"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Modulio kodas"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kodas %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Apžvalga: modulio kodas"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Visi moduliai turintys kodą</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Dėmesio"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Atsargiai"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Pavojinga"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Klaida"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Patarimas"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Svarbu"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Pastaba"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Taip pat žiūrėkite"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Patarimas"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Įspėjimas"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "tęsinys iš praeito puslapio"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Paieška"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "Navigacija"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Ieškoti tarp %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Apie šiuos dokumentus"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Autoriaus teisės"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Paskutinis atnaujinimas %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "ieškoti"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Paieškos rezultatai"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr "Kiti pakeitimai"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Nuoroda į šią antraštę"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Nuoroda į šį apibrėžimą"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Paslėpti paieškos rezultatus"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Išplėsti šoninę juostą"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Paslėpti paieškos rezultatus"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Paslėpti šoninę juostą"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Išplėsti šoninę juostą"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Turinys"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Nuoroda į šį apibrėžimą"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Išnašos"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "paveiksliukas"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lv/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/lv/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "n\u0101ko\u0161a t\u0113ma",
         "Other changes": "Citas izmai\u0146as",
         "Overview": "Apskats",
-        "Permalink to this definition": "Past\u0101v\u012bga nor\u0101de uz \u0161o defin\u012bciju",
-        "Permalink to this headline": "Past\u0101v\u012bga nor\u0101de \u0161o virsrakstu",
         "Please activate JavaScript to enable the search\n    functionality.": "Lai iesp\u0113jotu mekl\u0113\u0161anu, l\u016bdzu aktiviz\u0113t JavaScript.",
         "Preparing search...": "",
         "Previous topic": "iepriek\u0161\u0113ja t\u0113ma",
@@ -39,7 +37,7 @@
         "Search": "Mekl\u0113t",
         "Search Page": "Atlases lapa",
         "Search Results": "Atlases rezult\u0101ti",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Mekl\u0113t iek\u0161 %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lv/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/lv/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/lv/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/lv/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Latvian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lv/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: lv\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Iebūvētie"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Moduļu līmenis"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (iekš "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d.%m.%Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Vispārējs indekss"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indekss"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "nākošais"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "iepriekšējs"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indekss"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Izlaidums"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Sekcijas autors: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Moduļa autors: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Koda autors: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autors: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Atgriež"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Atgriežamais tips"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "loceklis"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "mainīgais"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makross"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tips"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Jauns versijā %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Mainīts versijā %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Neieteicams no versijas %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Izmet"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klase"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (iebūvēta funkcija)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metods)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globālais mainīgais vai konstanta)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atributs)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumenti"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modulis)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metods"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dati"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atributs"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modulis"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "atslēgas vārds"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operators"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekts"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "izņēmums"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "priekšraksts"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "iebūvēta funkcija"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Mainīgie"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Ceļ"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (moduļī %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (moduļī %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (iebūvētais mainīgais)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (iebūvēta klase)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klase iekš %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s klases metods)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statiskais metods)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduļi"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Nav ieteicams"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klases metods"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statiskais metods"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktīva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (role)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktīva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "role"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "apkārtnes mainīgais; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "glosārija termins"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "gramatiskais marķieris"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "atsauces virsraksts"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "apkārtnes mainīgais"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programmas opcija"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Moduļu indekss"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Atlases lapa"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "kods"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Jāizdara"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "sākotnējs ieraksts"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumenti"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Moduļa teksts"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s izejas teksts</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Apskats: moduļa teksts"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Visi moduļi, kuriem ir izejas teksti</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Uzmanību"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Uzmanies"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Bīstami"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Kļūda"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Mājiens"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Svarīgi"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Piezīme"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Skat.arī"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Padoms"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Brīdinājums"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "turpinājums no iepriekšējās lappuses"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Meklēt"
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr "Navigācija"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Meklēt iekš %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Par šiem dokumentiem"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Pēdējas izmaiņas %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr "meklēt"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Atlases rezultāti"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr "Citas izmaiņas"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Pastāvīga norāde šo virsrakstu"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Pastāvīga norāde uz šo definīciju"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Paslēpt atlases vārdus"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Izplest sānjoslu"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Paslēpt atlases vārdus"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Savērst sānjoslu"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Izplest sānjoslu"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Saturs"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Pastāvīga norāde uz šo definīciju"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Vēres"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "attēls: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "attēls"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/mk/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/mk/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/mk/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/mk/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/mk/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/mk/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Vasil Vangelovski <vvangelovski@gmail.com>, 2013\n"
 "Language-Team: Macedonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/mk/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: mk\n"
 "Plural-Forms: nplurals=2; plural=(n % 10 == 1 && n % 100 != 11) ? 0 : 1;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Предлог за подобрување на Python; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Вградени"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Ниво на модул"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (во "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Главна содржина"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "содржина"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "следна"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "претходна"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s документација"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Автор на секцијата:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Автор на модул:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Автор на код:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Автор: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,414 +1865,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Параметри"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Враќа"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Повратен тип"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "член"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "променлива"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "функција"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "макро"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "тип"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Фрла"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "класа"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (вградена функција)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s метод)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (класа)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2285,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "погледни %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "погледни %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Симболи"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Norwegian Bokmål (Norway) (http://www.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: nb_NO\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Innebygde"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Modulnivå"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(i "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Hovedindex"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "neste"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "forrige"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Utgivelse"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Seksjon forfatter: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Modul forfattar: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Kildekode forfatter: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Forfatter: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametere"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Returnere"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Retur type"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "medlem"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variabel"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funksjon"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nytt i version %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Endret i version %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Foreldet siden version %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Kaster"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klasse"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (innebygd funksjon)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metode)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasse)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variabel eller konstant)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argument"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metode"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attributt"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "nøkkelord"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "untak"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "uttrykk"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "innebygde funksjoner"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variabler"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Hever"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (i modul %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (i modul %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (innebygd variabel)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (innebygd klasse)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasse i %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s klassemetode)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statisk metode)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python Modulindex"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduler"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Foreldet"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klassemetode"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statisk metode"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (foreldet)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiv)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rolle)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktiv"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rolle"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "miljøvariabel; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "ordliste"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "grammatikk token"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "referanse-etikett"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "miljøvariabel"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programvalg"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Modulindex"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Søkeside"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "se %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "se også %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "kilde"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "opprinnelig oppføring"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumentasjon"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Modul kildekode"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kildekode for %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Oversikt: modulkildekode"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alla moduler hvor kildekode finnes</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Obs"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Advarsel"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Fare"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Feil"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Hint"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Viktig"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Obs"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Se også"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tips"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Advarsel"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "fortsettelse fra forrige side"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Søk"
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr "Navigering"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Søk blant %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Om disse dokumenter"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Sist oppdatert %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr "søk"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Søkeresultat"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr "Andre endringer"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Permalink til denne oversikten"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Permalink til denne definisjonen"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Skjul søkeresultat"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Utvid sidepanelet"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Skjul søkeresultat"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Skjul sidepanelet"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Utvid sidepanelet"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Innhold"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Permalink til denne definisjonen"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Fotnoter"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "bilde"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ne/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ne/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u092a\u091b\u093f\u0932\u094d\u0932\u094b \u0935\u093f\u0937\u092f",
         "Other changes": "\u0905\u0930\u0941 \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928\u0939\u0930\u0941 ",
         "Overview": "\u092a\u0941\u0928\u0930\u093e\u0935\u0932\u094b\u0915\u0928 ",
-        "Permalink to this definition": "\u092f\u094b \u0905\u0930\u094d\u0925\u0915\u094b \u0932\u093e\u0917\u093f \u092a\u0930\u094d\u092e\u093e\u0932\u093f\u0928\u094d\u0915",
-        "Permalink to this headline": "\u092f\u094b \u0936\u093f\u0930\u094d\u0937\u0915\u0915\u094b \u0932\u093e\u0917\u093f \u092a\u0930\u094d\u092e\u093e\u0932\u093f\u0928\u094d\u0915 \u0964 ",
         "Please activate JavaScript to enable the search\n    functionality.": "\u0916\u094b\u091c\u094d\u0928\u0947 \u0915\u093e\u0930\u094d\u092f \u0906\u0917\u093e\u0921\u0940 \u092c\u0922\u093e\u0909\u0928\u0915\u094b \u0932\u093e\u0917\u093f \u091c\u093e\u092d\u093e\u0938\u094d\u0915\u0943\u092a\u094d\u091f \u091a\u0932\u093e\u0908\u0926\u093f\u0928\u0941\u0939\u094b\u0938 ",
         "Preparing search...": "",
         "Previous topic": "\u0905\u0918\u093f\u0932\u094d\u0932\u094b \u0935\u093f\u0937\u092f ",
@@ -39,7 +37,7 @@
         "Search": "\u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d ",
         "Search Page": "\u092a\u093e\u0928\u093e\u092e\u093e \u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d",
         "Search Results": "\u0916\u094b\u091c\u0947\u0915\u094b \u0928\u0924\u093f\u091c\u093e",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ne/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ne/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ne/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ne/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2016\n"
 "Language-Team: Nepali (http://www.transifex.com/sphinx-doc/sphinx-1/language/ne/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ne\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "बिइल्टिन्स"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "मडुलको तह"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(in"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "सामान्य  अनुसुची"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "अनुसुची"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "पछिल्लो"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "अघिल्लो"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "अनुसुची"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "रीलीज"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,271 +1230,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "सेक्सनको लेखक"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "मडुलको लेखक"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Codeको लेखक "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "लेखक"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,414 +1866,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parameters"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Returns"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Return type"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "सदस्य"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "चल"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "फन्क्सन"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "बृहत"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "किसिम"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "भर्सन %s मा नयाँ"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "भर्सन  %s मा बदलिएको"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Deprecated since version %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Throws"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "कक्षा"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (built-in function)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s विधी)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (कक्षा)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variable or constant)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribute)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Arguments"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (मडुल)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "विधी"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attribute"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "मडुल"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "मुख्य शब्द"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "सन्चालक"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "object"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "अपबाद"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "भनाई"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "built-in फन्क्सन"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "चलहरू"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Raises"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (in मडुल %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in मडुल %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (built-in चल)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (built-in कक्षा)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (कक्षा in %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s कक्षा विधी)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s static विधी)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python Module Index"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Deprecated"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "कक्षा विधी"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "static विधी"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr "(deprecated)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (निर्देशिक)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (भूमिका)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "निर्देशिक"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "भूमिका"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "environment variable; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "शब्द-अर्थमा भएको"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "grammar token"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "सन्दर्व सामग्री"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "environment variable"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "कार्यक्रमका बिकल्प"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "मडुल अनुसुची"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "पानामा खोज्नुहोस्"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2286,142 +2284,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%s हेर्नुहोस्"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "%s पनि हेर्नुहोस् "
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "स्रोत"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "मौलिक इन्ट्री"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Module code"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Source code for %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "पुनरावलोकन: module code"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 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:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "ध्यानाकर्षण"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "होसियार "
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "खतरा"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "गलत"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "सङ्केत"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "जरुरी"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "टिप्पणी"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "पनि हेर्नुहोस"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "साबधान"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "अघिल्लो पानासँग जोडीएको"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "खोज्नुहोस् "
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr "नेभिगेसन "
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "यी डकुमेन्टहरुको बारेमा"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "कपिराइट "
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "यो भन्दा अगाडी %(last_updated)s मा अपडेट भएको"
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "खोज्नुहोस्"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "खोजेको नतिजा"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr "अरु परिवर्तनहरु "
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "यो शिर्षकको लागि पर्मालिन्क । "
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "यो अर्थको लागि पर्मालिन्क"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "खोजेको नतिजाहरु लुकाउनुहोस्"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "साइडबर ठुलो बनाउनुहोस्"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "खोजेको नतिजाहरु लुकाउनुहोस्"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "साइडबर सानो बनाउनुहोस्"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "साइडबर ठुलो बनाउनुहोस्"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "विषयसूची"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "यो अर्थको लागि पर्मालिन्क"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "फूट्नोट्स"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "चित्र"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nl/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/nl/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Volgend onderwerp",
         "Other changes": "Andere veranderingen",
         "Overview": "Overzicht",
-        "Permalink to this definition": "Permalink naar deze definitie",
-        "Permalink to this headline": "Permalink naar deze titel",
         "Please activate JavaScript to enable the search\n    functionality.": "Activeer JavaSscript om de zoekfunctionaliteit in te schakelen.",
         "Preparing search...": "Zoeken aan het voorbereiden...",
         "Previous topic": "Vorig onderwerp",
@@ -39,7 +37,7 @@
         "Search": "Zoeken",
         "Search Page": "Zoekpagina",
         "Search Results": "Zoekresultaten",
-        "Search finished, found %s page(s) matching the search query.": "Zoekopdracht voltooid, %s pagina(s) gevonden die overeenkomen met de zoekterm.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Zoeken in %(docstitle)s",
         "Searching": "Bezig met zoeken",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nl/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/nl/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/nl/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/nl/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -14,134 +14,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2021\n"
 "Language-Team: Dutch (http://www.transifex.com/sphinx-doc/sphinx-1/language/nl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: nl\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kan bronmap niet vinden (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Bron- en doelmap kunnen niet identiek zijn"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx v%s start op"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Dit project vereist tenminste Sphinx v%s, en kan daarom niet worden gebouwd met deze versie."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "aanmaken doelmap"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' gedefinieerd in conf.py is niet aanroepbaar (geen Python-callable). Pas a.u.b. de definitie aan zodat het een oproepbare functie wordt. Dit is nodig voor conf.py om zich als een Sphinx extensie te gedragen."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "laden van vertalingen %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "klaar"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "mislukt: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Geen bouwer geselecteerd, dus de standaardbouwer wordt gebruikt: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "gelukt"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "afgerond met problemen"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "bouwen %s, %s waarschuwing."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "bouwen %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -149,12 +149,12 @@
 "explicit"
 msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel lezen, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -162,64 +162,70 @@
 "explicit"
 msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel schrijven, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "seriële verwerking van %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "configuratiemap bevat geen conf.py bestand (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "kan dictionary-instelling %r niet overschrijven in configuratie, wordt genegeerd (gebruik %r om individuele elementen te overschrijven)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "ongeldig getal %r voor configuratiewaarde %r, wordt genegeerd"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "kan instelling %r niet overschrijven met zo'n waarde van een niet-ondersteund type; wordt genegeerd"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "onbekende configuratiewaarde %r tijdens overschrijven, wordt genegeerd"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Ongeldige configuratiewaarde: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Configuratiewaarde %r was reeds aangevoerd"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -227,898 +233,894 @@
 "%s"
 msgstr "Een fout heeft zich voorgedaan in uw configuratiebestand:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Sectie %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabel %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Codefragment %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r onbekend, wordt genegeerd."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Gebeurtenis %r bestaat reeds"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Onbekende gebeurtenisnaam: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Dit project vereist extensie %s met versie %s of hoger, en kan daarom niet met de geladen versie (%s) worden gebouwd"
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Bouwerklasse %s heeft geen \"name\"-attribuut"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Bouwer %r bestaat reeds (in module %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Bouwernaam %s is niet geregistreerd of beschikbaar via entrypoint"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Bouwernaam %s is niet geregistreerd"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domein %s was reeds geregistreerd"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domein %s nog niet geregistreerd"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser voor %r is reeds geregistreerd"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Broncode-parser voor %s is niet geregistreerd"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "extensie %r is reeds in Sphinx ingevoegd sinds Sphinx-versie %s; deze extensie wordt genegeerd."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Oorspronkelijke exceptie:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Kon extensie %s niet importeren"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "extensie %r heeft geen setup() functie; weet u zeker dat het een Sphinx-extensiemodule is?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Dit project gebruikt extensie %s, maar die extensie heeft Sphinx-versie v%s of hoger nodig; het project kan daarom niet worden gebouwd met deze versie."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "de setup() functie van extensie %r retourneerde een niet-ondersteund object; dit moet None of een metadata dictionary zijn"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "thema %r heeft geen \"theme\" instelling"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "thema %r heeft geen \"inherit\" instelling"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "thema met naam %r niet gevonden, geërfd door %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "instelling %s.%s komt niet voor in de doorzochte thema configuraties"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "bestand %r in thema pad is geen geldige zipfile of bevat geen thema"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "thema met naam %r niet gevonden (ontbrekende theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "bestand %r zoals gegeven op de opdrachtregel is niet aanwezig in de bronmap, wordt genegeerd"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Builtins"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Moduleniveau"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (in "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Algemene index"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "volgende"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "vorige"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentatie"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1127,94 +1129,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1233,35 +1235,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "pad naar doelmap"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1307,7 +1309,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1343,161 +1345,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Naam van het project"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Auteur(s)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1506,15 +1503,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Versie van het project"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Release van het project"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1524,21 +1521,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1546,91 +1543,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Bestandsnaam van het hoofddocument (zonder bestandsextensie)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Fout: hoofddocumentbestandsnaam %s is reeds aanwezig op het aangewezen pad."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Afgerond: een beginstructuur van mappen is aangemaakt."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1640,230 +1637,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "release van project"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "documenttaal"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "bestandsextensie van bronbestanden"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "bestandsnaam van hoofddocument"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "sjabloonmap voor sjabloonbestanden"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Ongeldig onderschrift: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Gebruik van zowel \"%s\" als \"%s\" opties is niet toegestaan"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Include bestand %r is niet gevonden of het lezen is mislukt"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Encodering %r gebruikt voor het lezen van include-bestand %r lijkt verkeerd, probeer een :encoding: optie te specificeren"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Object met naam %r is niet gevonden in include bestand %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "\"lineno-match\" kan niet gebruikt worden met een disjuncte set \"lines\""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Regels %r: geen regels gebruikt uit include-bestand %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Auteur van deze sectie: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Auteur van deze module: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Auteur van deze broncode:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Auteur: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1874,559 +1871,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parameters"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Returns"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Return type"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "member"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variabele"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "functie"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "type"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nieuw in versie %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Veranderd in versie %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Verouderd sinds versie %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Sjabloonparameters"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Werpt"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klasse"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "concept"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (ingebouwde functie)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s methode)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasse)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globale variabele of constante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribuut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumenten"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (module)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "methode"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attribuut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "module"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplicaatlabel van formule %s, andere in %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "trefwoord"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "object"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "exceptie"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "statement"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "ingebouwde functie"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variabelen"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Veroorzaakt"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (in module %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (in module %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (geïntegreerde variabele)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (geïntegreerde klasse)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasse in %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s klassemethode)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statische methode van %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python-moduleïndex"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "modules"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Verouderd"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klassemethode"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statische methode"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (verouderd)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directive)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "directive"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "omgevingsvariabele; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "woordenlijstterm"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "grammaticatoken"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "verwijzingslabel"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "omgevingsvariabele"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programmaoptie"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "document"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Module-index"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Zoekpagina"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "onderschrift ontbreekt voor link: %s"
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "bronmap is gewijzigd"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "zie %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "zie %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symbolen"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2438,209 +2441,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "bestandsextensie (standaardwaarde: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s is geen map."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "ontbrekende '+' of '-' in optie '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' is geen geldige optie."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' is geen geldige pyversion optie"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Graphviz directive mag niet zowel inhoud als een bestandsnaam argument hebben"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Extern Graphviz bestand %r niet gevonden of het lezen is mislukt"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "\"graphviz\" directive zonder inhoud wordt genegeerd."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2650,14 +2658,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "dot commando %r kan niet worden uitgevoerd (vereist voor graphviz output), controleer de instelling graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2667,33 +2675,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format moet 'png' of 'svg' zijn, maar is %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graaf: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graaf"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2703,163 +2713,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Permalink naar deze formule"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(in %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(in %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "broncode"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Te doen"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<origineel item>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(Het <<originele item>> bevindt zich in %s, regel %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "originele item"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "documentatie"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Modulebroncode"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Broncode voor %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Overzicht: module broncode"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alle modules waarvoor de broncode beschikbaar is</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2867,113 +2887,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Basisklassen: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2981,46 +3000,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3028,7 +3047,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3043,138 +3062,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Sleutelwoordargumenten"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Verwijzingen"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Let op"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Pas op"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Gevaar"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Fout"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Hint"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Belangrijk"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Notitie"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Zie ook"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Waarschuwing"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "Vervolgd van vorige pagina"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "Vervolgt op volgende pagina"
@@ -3196,7 +3215,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Zoeken"
@@ -3277,35 +3296,35 @@
 msgid "Navigation"
 msgstr "Navigatie"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Zoeken in %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Over deze documenten"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Laatste aanpassing op %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3350,12 +3369,12 @@
 msgstr "zoeken"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Zoekresultaten"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3397,280 +3416,278 @@
 msgid "Other changes"
 msgstr "Andere veranderingen"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Permalink naar deze titel"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Permalink naar deze definitie"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Zoekresultaten verbergen"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Bezig met zoeken"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Zoeken aan het voorbereiden..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Zoekopdracht voltooid, %s pagina(s) gevonden die overeenkomen met de zoekterm."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", in"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Zijpaneel uitklappen"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Zoekresultaten verbergen"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Zijpaneel inklappen"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Zijpaneel uitklappen"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Inhoudsopgave"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "meer dan één doel gevonden voor 'any' kruisverwijzing %r: is mogelijk %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Permalink naar deze definitie"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Permalink naar deze tabel"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Permalink naar deze broncode"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Permallink naar deze afbeelding"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Permalink naar deze toctree"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Voetnoten"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "afbeelding: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "afbeelding"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "onderschrift niet binnen figuur."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pl/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pl/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Nast\u0119pny temat",
         "Other changes": "Inne zmiany",
         "Overview": "Przegl\u0105d",
-        "Permalink to this definition": "Sta\u0142y odno\u015bnik do tej definicji",
-        "Permalink to this headline": "Sta\u0142y odno\u015bnik do tego nag\u0142\u00f3wka",
         "Please activate JavaScript to enable the search\n    functionality.": "Aby umo\u017cliwi\u0107 wyszukiwanie, prosz\u0119 w\u0142\u0105czy\u0107 JavaScript.",
         "Preparing search...": "Inicjalizacja wyszukiwania...",
         "Previous topic": "Poprzedni temat",
@@ -39,7 +37,7 @@
         "Search": "Szukaj",
         "Search Page": "Wyszukiwanie",
         "Search Results": "Wyniki wyszukiwania",
-        "Search finished, found %s page(s) matching the search query.": "Wyszukiwanie zako\u0144czone. Liczba znalezionych stron pasuj\u0105cych do zapytania: %s.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Szukaj po\u015br\u00f3d %(docstitle)s",
         "Searching": "Wyszukiwanie",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pl/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pl/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pl/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pl/LC_MESSAGES/sphinx.po Changed

@@ -1,9 +1,10 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
-# m_aciek <maciej.olko@gmail.com>, 2017-2020
+# Maciej Olko <maciej.olko@gmail.com>, 2017-2020
+# Maciej Olko <maciej.olko@gmail.com>, 2022
 # Michael Gielda <michal.gielda@gmail.com>, 2014
 # Komiya Takeshi <i.tkomiya@gmail.com>, 2018
 # Tawez, 2013-2019
@@ -11,134 +12,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Maciej Olko <maciej.olko@gmail.com>, 2022\n"
 "Language-Team: Polish (http://www.transifex.com/sphinx-doc/sphinx-1/language/pl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: pl\n"
 "Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nie odnaleziono katalogu źródłowego (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
-msgstr ""
+msgstr "Katalog wyjściowy (%s) nie jest katalogiem"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Katalog źródłowy i katalog docelowy nie mogą być identyczne"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Uruchamianie Sphinksa v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ten projekt potrzebuje Sphinksa w wersji co najmniej %s, dlatego nie może zostać zbudowany z tą wersją."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "tworzenie katalogu wyjścia"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "podczas ustawiania rozszerzenia %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' podany w conf.py nie jest wywoływalny. Prosimy zmienić jego definicję tak, aby była wywoływalną funkcją. Jest to potrzebne w conf.py, aby zachowywało się jak rozszerzenie Sphinksa."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "ładowanie tłumaczeń %s..."
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "gotowe"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "niedostępne dla wbudowanych wiadomości"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "ładowanie zapakowanego środowiska"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "nie powiodło się: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Nie wybrano buildera, używamy domyślnego: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
-msgstr "udało się"
+msgstr "zakończony sukcesem"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
-msgstr "zakończono z problemami"
+msgstr "zakończony z problemami"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr ""
+msgstr "build %s, %s ostrzeżenie (z ostrzeżeniami traktowanymi jako błędy)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s ostrzeżenie."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "build %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "klasa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "dyrektywa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "rola %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +147,12 @@
 "explicit"
 msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do czytania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenie o sprawdzenie i zadeklarowania tego wprost"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +160,70 @@
 "explicit"
 msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do pisania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenia o sprawdzenie i zadeklarowanie tego wprost"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "tworzenie serii %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "folder konfiguracyjny nie zawiera pliku conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "nie można nadpisać słownikowego ustawienia konfiguracji %r, ignorowanie (użyj %r, by ustawić poszczególne elementy)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "niepoprawna liczba %r dla wartości konfiguracji %r, ignorowanie"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "nie można nadpisać ustawienia konfiguracji %r nie wspieranym typem, ignorowanie"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "nieznana wartość konfiguracji %r w nadpisaniu, ignorowanie"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Nie ma takiej wartości konfiguracyjnej: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Wartość konfiguracji %r już podana"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "W twoim piku konfiguracyjnym jest błąd składniowy: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Plik konfiguracyjny (albo jeden z modułów przez niego zaimportowanych) wywołał sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,898 +231,894 @@
 "%s"
 msgstr "W twoim piku konfiguracyjnym jest błąd programowalny: \n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Rozdział %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Rys. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabela %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Listing %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Wartość konfiguracyjna `{name}` musi być jednym z {candidates}, a podany jest `{current}`."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "Nie odnaleziono primary_domain %r, zignorowano."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Zdarzenie %r już obecne"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nieznana nazwa zdarzenia: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ten projekt potrzebuje rozszerzenia %s co najmniej w wersji %s, dlatego nie może zostać zbudowany z załadowaną wersją (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Klasa buildera %s nie ma atrybutu \"name\""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r już istnieje (w module %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder o nazwie %s jest niezarejestrowany lub dostępny przez punkt wejścia"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder o nazwie %s jest niezarejestrowany"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domena %s jest już zarejestrowana"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domena %s nie została jeszcze zarejestrowana"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type jest już zarejestrowany"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type jest już zarejestrowany"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r jest już zarejestrowany"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser dla %r jest już zarejestrowany"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Parser źródeł dla %s jest nie zarejestrowany"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r już zarejestrowany"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "rozszerzenie %r zostało już włączone do Sphinx'a, począwszy od wersji %s; to rozszerzenie jest zignorowane."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Pierwotny wyjątek:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Nie można zaimportować rozszerzenia %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "rozszerzenie %r nie zawiera funkcji setup(); czy to na pewno moduł rozszerzenia Sphinx?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Rozszerzenie %s używane przez ten projekt potrzebuje Sphinksa w wersji co najmniej %s; dlatego nie może zostać zbudowane z tą wersją."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "rozszerzenie %r zwróciło nie wspierany obiekt ze swojej funkcji setup(); powinno zwrócić None lub słownik metadanych"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "motyw %r nie ma ustawienia \"theme\""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "motyw %r nie ma ustawienia \"inherit\""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "nie znaleziono motywu o nazwie %r, z którego dziedziczy %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "ustawienie %s.%s nie występuje w żadnej z przeszukiwanych konfiguracji motywów"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "plik %r na ścieżce motywu nie jest poprawnym plikiem zip lub nie zawiera motywu"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nie znaleziono motywu o nazwie %r (brak theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "budowanie mo:"
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "pisanie wyjścia..."
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "wszystkie z %d plików po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "wsztstkie pliki źródłowe"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "plik %r podany w wierszu poleceń nie znajduje się w katalogu źródłowym, ignoruję"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "plik %r podany w wierszu poleceń nie istnieje, ignoruję"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d plików źródłowych podano w wierszu poleceń"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "znaleziono %d"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "nic nie znaleziono"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "kopiowanie obrazków..."
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "nieznany mimetype dla %s, ignoruję"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "pisanie pliku %s..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "brak zmian w wersji %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Wbudowane"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Poziom modułu"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "kopiowanie plików źródłowych..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Plik ePub znajduje się w %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "nieprawidłowy css_file: %r, zignorowano"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "wczytywanie szablonów... "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "zepsuty odnośnik: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Nie znaleziono kotwicy '%s'"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Strona HTML jest w %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Pliki Texinfo znajdują się w %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "nie znaleziono wartości konfiguracyjnej \"texinfo_documents\"; żadne dokumenty nie zostaną zapisane"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "wartość konfiguracyjna \"texinfo_documents\" odwołuje się do nieznanego dokumentu %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (w "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Pliki tekstowe są w %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "błąd zapisu pliku %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Pliki XML znajdują się w %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Pliki pseudo-XML są w %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Strony HTML są w %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Indeks ogólny"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "indeks"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "dalej"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "wstecz"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "kopiowanie plików do pobrania..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "nie można skopiować pliku statycznego %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "nie można skopiować dodatkowego pliku %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Wystąpił błąd podczas renderowania strony %s.\nPowód: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "nieprawidłowy js_file: %r, zignorowano"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Podano nieznany math_renderer %r."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "plik favicon %r nie istnieje"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s - dokumentacja"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Pliki LaTeX znajdują się w %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "nie znaleziono wartości konfiguracyjnej \"latex_documents\"; żadne dokumenty nie zostaną zapisane"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "wartość konfiguracyjna \"latex_documents\" odwołuje się do nieznanego dokumentu %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Indeks"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Wydanie"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1124,94 +1127,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Błąd kodowania:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Błąd rekursji:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Wystąpił wyjątek:"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Raport o błędzie można zgłosić pod adresem <https://github.com/sphinx-doc/sphinx/issues>. Dzięki!"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,271 +1233,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "ogólne opcje"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "zapisz wszystkie pliki (domyślnie: zapisz tylko nowe i zmienione pliki)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "zastąp ustawienie w pliku konfiguracyjnym"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "przekaż wartość do szablonów HTML"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "zwiększ szczegółowość (może być powtórzone)"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "zapisz ostrzeżenia (i błędy) do podanego pliku"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "zamień ostrzeżenia na błędy"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "nie można znaleźć plików %r"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "Argument opcji -D musi mieć postać nazwa=wartość"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "Argument opcji -A musi mieć postać nazwa=wartość"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "warunkowe włączenie treści na podstawie wartości konfiguracyjnych"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Wprowadź poprawną nazwę ścieżki."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Wprowadź \"y\" lub \"n\"."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Podaj rozszerzenie pliku, na przykład '.rst' lub '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Witamy w narzędziu quickstart Sphinksa %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Ścieżka root dla dokumentacji"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Błąd: znaleziono istniejący conf.py na wskazanej ścieżce root."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart nie nadpisze istniejących projektów Sphinx."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Wprowadź, prosimy, nową ścieżkę root (lub tylko Enter, aby wyjść)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Rozdziel katalogi source i build (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Prefiks nazw dla katalogów templates i static"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Nazwa projektu"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Nazwisko autora"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1503,15 +1501,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Wersja projektu"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Wydanie projektu"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1521,21 +1519,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Język projektu"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Sufiks pliku źródłowego"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1541,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart nie nadpisze istniejącego pliku."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Wskaż, które z następujących rozszerzeń Sphinx powinny być włączone:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Stworzyć Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Tworzenie pliku %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Plik %s już istnieje, pomijam."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Zakończono: Utworzono początkową strukturę katalogów."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,230 +1635,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "tryb cichy"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Podstawowe opcje projektu"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "nazwa projektu"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "nazwiska autorów"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "wersja projektu"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "język dokumentu"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "rozszerzenie pliku źródłowego"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "nazwa głównego dokumentu"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Opcje rozszerzeń"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "włącz rozszerzenie %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "utwórz plik makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "nie twórz pliku makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "twórz plik wsadowy"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "nie twórz pliku wsadowego"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Nieprawidłowy podpis: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Nie można użyć jednocześnie opcji \"%s\" i \"%s\""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Plik include %r nie znaleziony lub nie powiódł się jego odczyt"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Kodowanie %r użyte do odczytu pliku include %r wydaje się być złe, spróbuj dając opcję :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Nie znaleziono obiektu o nazwie %r w pliku include %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Nie można użyć „lineno-match” z rozłącznym zbiorem „lines”"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Specyfikacja linii %r: nie wyciągnięto żadnych linii z pliku include %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor rozdziału: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor modułu: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autor kodu: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1871,414 +1869,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametry"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Zwraca"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Typ zwracany"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "pole"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "zmienna"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcja"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "unia"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nowe w wersji %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Zmienione w wersji %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Niezalecane od wersji %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Cytat %s nie ma odniesienia."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parametry szablonu"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Wyrzuca"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klasa"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "koncepcja"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funkcja wbudowana)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metoda)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasa)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (zmienna globalna lub stała)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atrybut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumenty"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (moduł)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metoda"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dane"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atrybut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "moduł"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "zduplikowana etykieta równania %s, inne wystąpienie w %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Nieprawidłowy math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "słowo kluczowe"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "obiekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "wyjątek"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "instrukcja"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "funkcja wbudowana"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Zmienne"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Wyrzuca"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (w module %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (w module %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (zmienna wbudowana)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (klasa wbudowana)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasa w module %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s metoda klasy)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s metoda statyczna)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Indeks modułów Pythona"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduły"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Niezalecane"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "metoda klasy"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statyczna metoda"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (niezalecane)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (dyrektywa)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rola)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "dyrektywa"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rola"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "zmienna środowiskowa; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "termin glosariusza"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "symbol gramatyki"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "etykieta odsyłacza"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "zmienna środowiskowa"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opcja programu"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Indeks modułów"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Wyszukiwanie"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2288,142 +2287,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "nowa konfiguracja"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "konfiguracja zmieniona"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "rozszerzenie zmienione"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "katalog źródłowy został zmieniony"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Domena %r nie jest zarejestrowana"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "zobacz %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "zobacz także %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symbole"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2439,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "maksymalna głębokość submodułów wyświetlanych w spisie treści (domyślnie: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "nadpisz istniejące pliki"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "wykonaj skrypt bez tworzenia plików"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "nie twórz pliku spisu treści"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "rozszerzenie pliku (domyślnie: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s nie jest katalogiem."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "nieprawidłowe wyrażenie regularne %r w %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "nieprawidłowe wyrażenie regularne %r w coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "moduł %s nie mógł zostać zaimportowany: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "brak '+' lub '-' w opcji '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' nie jest prawidłową opcją."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' nie jest prawidłową opcją pyversion."
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "dyrektywa Graphviz nie może mieć jednocześnie argumentów content i filename"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Nie znaleziono zewnętrznego pliku Graphviz %r lub jego odczyt się nie powiódł"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorujemy dyrektywę „graphviz” bez treści."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2656,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "komenda dot %r nie może zostać uruchomiona (potrzebna do wyjścia graphviz), sprawdź ustawienia graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2673,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format musi mieć wartość „png” lub „svg” a ma %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "wykres: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "wykres"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2711,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Stały odnośnik do tego równania"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(w %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr " (w %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "źródło"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<oryginalny wpis>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<Oryginalny wpis>> znajduje się w pliku %s, w linii %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "oryginalny wpis"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumentacja"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Kod modułu"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kod źródłowy modułu %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Przeglądanie: kod modułu"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Wszystkie moduły, dla których jest dostępny kod</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "błąd podczas formatowania argumentów dla %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "brakujący atrybut %s w obiekcie %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2885,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Klasy bazowe: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "brakujący atrybut %s w obiekcie %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +2998,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3045,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3060,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "domyślny sufiks dla plików (domyślnie: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumenty Nazwane"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Przykład"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Przykłady"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Uwagi"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Pozostałe parametry"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Uwaga"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Ostrzeżenie"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Niebezpieczeństwo"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Błąd"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Podpowiedź"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Ważne"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Informacja"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Zobacz także"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Wskazówka"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Ostrzeżenie"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "kontynuacja poprzedniej strony"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "ciąg dalszy na następnej stronie"
@@ -3193,7 +3213,7 @@
 msgid "Table of Contents"
 msgstr "Spis treści"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Szukaj"
@@ -3274,35 +3294,35 @@
 msgid "Navigation"
 msgstr "Nawigacja"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Szukaj pośród %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "O tych dokumentach"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Ostatnia modyfikacja %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3367,12 @@
 msgstr "szukaj"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Wyniki wyszukiwania"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,280 +3414,278 @@
 msgid "Other changes"
 msgstr "Inne zmiany"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Stały odnośnik do tego nagłówka"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Stały odnośnik do tej definicji"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Ukryj wyniki wyszukiwania"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Wyszukiwanie"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Inicjalizacja wyszukiwania..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Wyszukiwanie zakończone. Liczba znalezionych stron pasujących do zapytania: %s."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", w "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Rozwiń pasek boczny"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Ukryj wyniki wyszukiwania"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Zwiń pasek boczny"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Rozwiń pasek boczny"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Treść"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "znaleziono więcej niż jeden cel dla cross-referencji „any” %r: może być %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Nieznany format obrazka: %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "błąd odczytu: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "błąd zapisu: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Stały odnośnik do tej definicji"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Stały odnośnik do tej tabeli"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Stały odnośnik do tego bloku kodu"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Stały odnośnik do tego obrazu"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Stały odnośnik do tego spisu treści"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Przypisy"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "%s"
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "obraz: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "obraz"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "",
         "Other changes": "",
         "Overview": "",
-        "Permalink to this definition": "",
-        "Permalink to this headline": "",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "",
         "Previous topic": "",
@@ -39,7 +37,7 @@
         "Search": "",
         "Search Page": "",
         "Search Results": "",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",
@@ -59,5 +57,5 @@
         "search this documentation": "",
         "the documentation for": ""
     },
-    "plural_expr": "(n != 1)"
+    "plural_expr": "(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Portuguese (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: pt\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Pr\u00f3ximo t\u00f3pico",
         "Other changes": "Outras altera\u00e7\u00f5es",
         "Overview": "Vis\u00e3o geral",
-        "Permalink to this definition": "Link permanente para esta defini\u00e7\u00e3o",
-        "Permalink to this headline": "Link permanente para este t\u00edtulo",
         "Please activate JavaScript to enable the search\n    functionality.": "Por favor, ativar JavaScript para habilitar a\nfuncionalidade de busca.",
         "Preparing search...": "Preparando a busca...",
         "Previous topic": "T\u00f3pico anterior",
@@ -39,7 +37,7 @@
         "Search": "Buscar",
         "Search Page": "P\u00e1gina de Busca",
         "Search Results": "Resultados da Busca",
-        "Search finished, found %s page(s) matching the search query.": "Busca conclu\u00edda. %s p\u00e1gina(s) que atendem a consulta.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "Pesquisa finalizada, encontrada(s) ${resultCount} p\u00e1gina(s) correspondendo \u00e0 consulta da pesquisa.",
         "Search within %(docstitle)s": "Pesquisar dentro de %(docstitle)s",
         "Searching": "Buscando",
         "Searching for multiple words only shows matches that contain\n    all words.": "Pesquisando por v\u00e1rias palavras s\u00f3 mostra correspond\u00eancias\nque cont\u00eam todas as palavras.",
@@ -59,5 +57,5 @@
         "search this documentation": "Buscar nessa documenta\u00e7\u00e3o",
         "the documentation for": "documenta\u00e7\u00e3o para"
     },
-    "plural_expr": "(n > 1)"
+    "plural_expr": "(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -13,134 +13,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 02:45+0000\n"
-"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2019-2022\n"
 "Language-Team: Portuguese (Brazil) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_BR/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: pt_BR\n"
-"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Não foi possível encontrar o diretório de origem (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "O diretório de saída (%s) não é um diretório"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Diretório de origem e o diretório de destino não podem ser idênticos"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Executando Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilado com esta versão."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "criando o diretório de saída"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "enquanto definia a extensão %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "“setup”, conforme definido atualmente em conf.py, não é um invocável do Python. Modifique sua definição para torná-la uma função que pode ser chamada. Isso é necessário para o conf.py se comportar como uma extensão do Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "carregando traduções %s… "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "feito"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "não disponível para mensagens internas"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "carregando ambiente com pickle"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "falha: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Nenhum compilador selecionado, usando padrão: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "bem-sucedida"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "finalizada com problemas"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "compilação %s, %s aviso. (com avisos tratados como erros)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "compilação %s, %s avisos (com avisos tratados como erros)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "compilação %s, %s aviso."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "compilação %s, %s avisos."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "compilação %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "classe de nodo %r já está registrada, seus visitantes serão sobrescritos"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "diretiva %r já está registrada, ela será sobrescrita"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "papel %r já está registrado, ele será sobrescrito"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -148,12 +148,12 @@
 "explicit"
 msgstr "a extensão %s não declara se é segura para leitura em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "a extensão %s não é segura para leitura em paralelo"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -161,64 +161,70 @@
 "explicit"
 msgstr "a extensão %s não declara se é segura para escrita em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "a extensão %s não é segura para escrita em paralelo"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "fazendo serial %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "o diretório de configuração não contém um arquivo conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "não foi possível sobrescrever a configuração do dicionário %r ignorando (use %r para definir elementos individuais)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "número inválido %r para valor de configuração %r, ignorando"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "não é possível sobrescrever a configuração %r com tipo sem suporte, ignorando"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "valor de configuração desconhecido %r na sobrescrita, ignorando"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Valor de configuração inexistente: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Valor da configuração %r já presente"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Há um erro de sintaxe em seu arquivo de configuração: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "O arquivo de configuração (ou um dos módulos que ele importa) chamou sys.exit()"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,898 +232,894 @@
 "%s"
 msgstr "Há um erro de programável em seu arquivo de configuração:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "O valor da configuração “source_suffix” espera uma string, lista de strings ou dicionário. Mas “%r” é fornecido."
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Seção %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabela %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Listagem %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "O valor da configuração “{name}” deve ser um entre {candidates}, mas “{current}” é fornecido."
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; esperava {permitted}."
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; o padrão é “{default.__name__}”."
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r não encontrado, ignorado."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "Desde v2.0, Sphinx usa \"index\" como root_doc por padrão. Adicione \"root_doc = 'contents'\" ao seu conf.py."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Evento %r já presente"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Nome de evento desconhecido: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "O manipulador %r para evento %r levantou uma exceção"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "A extensão %s é requerida pelas configurações needs_extensions, mas não está carregada."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Este projeto precisa da extensão %s pelo menos na versão %s e, portanto, não pode ser compilado com a versão carregada (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Nome de analisador léxico Pygments %r não é conhecido"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Não foi possível fazer análise léxica de literal_block como “%s”. Realce de sintaxe ignorado."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "vários arquivos encontrados para o documento \"%s\": %r\nUse %r para a construção."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "documento não legível. Ignorado."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Classe de compilador %s possui nenhum atributo “name”"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Compilador %r já existe (no módulo %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Nome do compilador %s não registrado ou disponível através do ponto de entrada"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Nome do compilador %s não registrado"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domínio %s já registrado"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domínio %s ainda não registrado"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "A diretiva %r já está registrada para o domínio %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "O papel %r já está registrado para o domínio %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "O índice %r já está registrado para o domínio %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "O object_type %r já está registrado"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "O crossref_type %r já está registrado"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r já está registrado"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser para %r já está registrado"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Analisador de fonte para %s não registrado"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Tradutor para %r já existe"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs para add_node() deve ser uma tupla de função (visit, depart): %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r já registrado"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "renderizador matemático %s já está registrado"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "a extensão %r já foi mesclada com Sphinx desde a versão %s; esta extensão é ignorada."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Extensão original:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Não foi possível importar a extensão %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "a extensão %r possui nenhuma função setup(); é realmente um módulo de extensão do Sphinx?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "A extensão %s usada por este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilada com esta versão."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "a extensão %r retornou um objeto não suportado de sua função setup(); deve retornar None ou um dicionário de metadados"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Propostas Estendidas Python; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr "Número de PEP inválido %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr "Número de RFC inválido %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "o tema %r não tem a configuração “theme”"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "o tema %r não tem a configuração “inherit”"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "nenhum tema chamado %r encontrado, herdado por %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "a configuração %s.%s ocorre em nenhuma das configurações de tema pesquisadas"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "sem suporte à opção de tema %r fornecida"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "o arquivo %r no caminho de tema não é um arquivo zip válido ou contém nenhum tema"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "sphinx_rtd_theme (< 0.3.0) encontrado. Ele não estará disponível a partir do Sphinx-6.0"
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nenhum tema chamado %r encontrado (faltando theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "uma imagem adequada para o compilador %s não encontrada: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "uma imagem adequada para o compilador %s não encontrada: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "compilando mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "escrevendo saída… "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "todos os %d arquivos po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "alvos para %d arquivos po que estão especificados"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "alvos para %d arquivos po que estão desatualizados"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "todos os arquivos-fonte"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "o arquivo %r fornecido na linha de comando não está dentro do diretório fonte, ignorando"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "o arquivo %r fornecido na linha de comando não existe, ignorando"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d arquivos-fonte dados na linha de comando"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "alvos para %d arquivos fonte que estão desatualizados"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "compilando %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "procurando por arquivos agora desatualizados… "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d encontrado"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "nenhum encontrado"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "tornando um ambiente pickle"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "verificando consistência"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "nenhum alvo está desatualizado."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "atualizando ambiente: "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s adicionado(s), %s alterado(s), %s removido(s)"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "lendo fontes… "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "aguardando por workers…"
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "docnames para escrever: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "preparando documentos"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "entrada de tabela de conteúdos duplicada encontrada: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "copiando imagens… "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "não foi possível ler o arquivo de imagem %r: copiando-o"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "não foi possível copiar arquivo de imagem %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "não foi possível escrever arquivo de imagem %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillow não encontrado – copiando arquivos de imagem"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "escrevendo o arquivo mimetype..."
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "escrevendo o arquivo META-INF/container.xml..."
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "escrevendo o arquivo content.opf..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "tipo mime desconhecido para %s, ignorando"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "escrevendo o arquivo toc.ncx..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "escrevendo arquivo %s…"
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "O arquivo de visão geral está em %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "nenhuma alteração na versão %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "escrevendo arquivo de resumo…"
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Internos"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Nível do Módulo"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "copiando arquivos-fonte…"
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "não foi possível ler %r para criação do changelog"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "O compilador fictício não gera arquivos."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "O arquivo ePub está em %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "escrevendo o arquivo nav.xhtml..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_language” (ou “language”) não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "o valor da configuração “epub_uid” deve ser XML NAME para EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_title” (ou “html_title”) não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_author” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_contributor” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_description” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_publisher” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_copyright” (ou “copyright”) não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "o valor da configuração “epub_identifier” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "o valor da configuração “version” não deve estar vazio para EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file inválido: %r, ignorado"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Os catálogos de mensagens estão em %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "alvos para os %d arquivos de modelo"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "lendo modelos… "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "escrevendo catálogos de mensagens… "
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Procure por quaisquer erros na saída acima ou em %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "link quebrado: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Âncora “%s” não encontrada"
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr "Falha ao compilar regex em linkcheck_allowed_redirects: %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "As páginas de manual estão em %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "nenhum valor de configuração “man_pages” encontrado; nenhuma página de manual será escrita"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "escrevendo"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "o valor da configuração “man_pages” faz referência a um documento desconhecido %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "A página HTML está em %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "montando documento único"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "escrevendo arquivos adicionais"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Os arquivos Texinfo estão em %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nExecute \"make\" nesse diretório para executá-los com makeinfo\n(use \"make info\" aqui para fazer isso automaticamente)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "nenhuma valor de configuração “texinfo_documents” encontrado; nenhum documento será escrito"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "o valor da configuração “texinfo_documents” faz referência a documento desconhecido %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "processando %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "resolvendo referências…"
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (em "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "copiando arquivos de suporte Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "erro ao escrever o arquivo Makefile: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Os arquivos texto estão em %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "erro ao escrever o arquivo %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Os arquivos XML estão em %(outdir)s."
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Os arquivos pseudo-XML estão em %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "arquivo de informações da compilação está quebrado: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "As páginas HTML estão em %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Falha ao ler o arquivo de informações de compilação: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índice Geral"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "índice"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "próximo"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "gerando índices"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "escrevendo páginas adicionais"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "copiando arquivos baixáveis… "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "não foi possível copiar o arquivo baixável %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "Falha ao copiar um arquivo em html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr "copiando arquivos estáticos"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "não foi possível copiar o arquivo estático %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "copiando arquivos extras"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "não foi possível copiar o arquivo extra %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Falha ao escrever o arquivo de informações de compilação: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "não foi possível carregar o índice de pesquisa, mas nem todos os documentos serão compilados: o índice ficará incompleto."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "a página %s corresponde a dois padrões em html_sidebars: %r e %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ocorreu um erro Unicode ao renderizar a página %s. Verifique se todos os valores de configuração que contêm conteúdo não ASCII são strings Unicode."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ocorreu um erro ao renderizar a página %s.\nMotivo: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "despejando inventário de objetos"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "despejando índice de pesquisa em %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file inválido: %r, ignorado"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Muitos math_renders estão registrados, mas nenhum math_renderer está selecionado."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "math_renderer desconhecido %r é fornecido."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "a entrada de html_extra_path %r não existe"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "entrada de html_extra_path %r está posicionada dentro de outdir"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "a entrada de html_static_path %r não existe"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "entrada de html_static_path %r está posicionada dento de outdir"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "o arquivo logo %r não existe"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "o arquivo favicon %r não existe"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr "html_add_permalinks foi descontinuado desde v3.5.0. Use html_permalinks e html_permalinks_icon."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "documentação %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Os arquivos LaTeX estão em %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nExecute \"make\" nesse diretório para executá-los com (pdf)latex\n(use \"make latexpdf\" aqui para fazer isso automaticamente)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "nenhuma valor da configuração “latex_documents” encontrado; nenhum documento será escrito"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "o valor da configuração “latex_documents” faz referência a um documento desconhecido %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Índice"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Release"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "nenhuma opção Babel conhecida para o idioma %r"
@@ -1126,94 +1128,94 @@
 msgid "copying TeX support files"
 msgstr "copiando arquivos de suporte TeX"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "copiando arquivos de suporte TeX…"
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "copiando arquivos adicionais"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "Chave configuração desconhecida: latex_elements%r, ignorado."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr "Opção de tema desconhecida: latex_theme_options%r, ignorada."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r não possui a configuração \"theme\""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r não possui a configuração \"%s\""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Ocorreu uma exceção enquanto compilava, iniciando depurador:"
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "Interrompido!"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "Erro de marcação reST:"
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Erro de codificação:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "O rastro completo foi salvo em %s, caso você queira relatar o problema aos desenvolvedores."
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Erro de recursão:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "Isso pode acontecer com arquivos fonte muito grande e profundamente aninhados. Você pode aumentar com cuidado o limite padrão de recursão do Python de 1000 no conf.py com, por exemplo:"
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Ocorreu uma exceção:"
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Por favor, relate isso também se houver um erro do usuário, para que uma mensagem de erro melhor possa ser fornecida na próxima vez."
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Um relatório de erro pode ser preenchido no rastreador em <https://github.com/sphinx-doc/sphinx/issues>. Obrigado!"
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "número de tarefas deve ser um número positivo"
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "Para mais informações, visite <https://www.sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1232,35 +1234,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr "\nGera documentação de arquivos fonte.\n\nsphinx-build gera documentação a partir dos arquivos em SOURCEDIR e os coloca\nem OUTPUTDIR. Ele procura por \"conf.py\" em SOURCEDIR para a configuração\ndefinições. A ferramenta \"sphinx-quickstart\" pode ser usada para gerar\narquivos de modelo, incluindo \"conf.py\"\n\nsphinx-build pode criar documentação em diferentes formatos. Um formato é\nselecionado especificando o nome do construtor na linha de comandos; o padrão\né HTML. Os construtores também podem realizar outras tarefas relacionadas à\ndocumentação em processamento.\n\nPor padrão, tudo o que está desatualizado é construído. Saída apenas para\nselecionado os arquivos podem ser construídas especificando nomes de arquivos\nindividuais.\n"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "caminho para os arquivos-fonte da documentação"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "caminho para o diretório de saída"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "uma lista de arquivos específicos para recompilar. Ignorado se -a for especificado"
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "opções gerais"
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "compilador para usar (padrão: html)"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "escrever todos os arquivos (padrão: escrever apenas arquivos novos e alterados)"
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "não usa um ambiente salvo, sempre lê todos os arquivos"
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1306,7 +1308,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr "aumenta o nível de detalhamento (pode ser repetido)"
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "nenhuma saída para stdout, apenas avisos na stderr"
 
@@ -1342,161 +1344,156 @@
 msgid "run Pdb on exception"
 msgstr "executa Pdb na exceção"
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "não foi possível localizar os arquivos %r"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "não é possível combinar a opção -a e nomes de arquivos"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "não foi possível abrir o arquivo de aviso %r: %s"
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "o argumento da opção -D deve estar no formato nome=valor"
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "o argumento da opção -A deve estar no formato nome=valor"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "insere docstrings automaticamente a partir de módulos"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "testa trechos de código automaticamente em blocos de doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "cria link entre documentação Sphinx de diferentes projetos"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "escreve entradas “todo” que podem ser mostradas ou ocultadas na compilação"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "verifica por cobertura da documentação"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "inclui matemática, renderizada como imagens PNG ou SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "inclui matemática, renderizada no navegador por MathJax"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "inclusão condicional de conteúdo com base nos valores de configuração"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "inclui links para o código-fonte dos objetos Python documentados"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "cria um arquivo .nojekyll para publicar o documento em páginas do GitHub"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Insira um nome de caminho válido."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Insira algum texto."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Insira um entre %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Insira “y” ou “n”."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Insira um sufixo de arquivo, p.ex., “.rst” ou “.txt”."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Bem-vindo ao utilitário de início rápido do Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Digite valores para as seguintes configurações (basta pressionar Enter\npara aceitar um valor padrão, se houver um entre colchetes)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Caminho raiz selecionado: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Insira o caminho raiz para a documentação."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Caminho raiz para a documentação"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Erro: um conf.py existente foi encontrado no caminho raiz selecionado."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart não vai sobrescrever projetos Sphinx existentes."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Insira um novo caminho raiz (ou pressione Enter para sair)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Você tem duas opções para definir o diretório de compilação para a saída\nSphinx. Você pode usar um diretório \"_build\" no caminho raiz ou separar\nos diretórios de \"origem\" e \"compilação\" no caminho raiz."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Separar os diretórios de origem e compilação (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Dentro do diretório raiz, mais dois diretórios serão criados; \"_templates\"\npara modelos HTML personalizados e \"_static\" para folhas de estilo (CSS)\npersonalizadas e outros arquivos estáticos. Você pode inserir outro prefixo\n(como \".\") para substituir o sublinhado."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Prefixo do nome para o diretório de modelos e de arquivos estáticos"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "O nome do projeto vai aparecer em vários lugares na documentação compilada."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Nome do projeto"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Nome(s) de autor(es)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1505,15 +1502,15 @@
 "just set both to the same value."
 msgstr "O Sphinx tem a noção de uma \"versão\" e um \"lançamento\" para o software.\nCada versão pode ter vários lançamentos. Por exemplo, para Python a\nversão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1\nou 3.0a1. Se você não precisa dessa estrutura dupla, apenas defina ambos\ncom o mesmo valor."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Versão do projeto"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Lançamento do projeto"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1523,21 +1520,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Se os documentos forem escritos em um idioma diferente do inglês, você\npode selecionar um idioma aqui pelo seu código de idioma. O Sphinx,\nentão, traduzirá o texto gerado para esse idioma.\n\nPara obter uma lista dos códigos suportados, consulte\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Idioma do projeto"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr "O sufixo do nome de arquivo para arquivos fonte. Normalmente, isso é\n\".txt\" ou \".rst\". Apenas arquivos com este sufixo são considerados\ndocumentos."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Sufixo de arquivos-fonte"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1545,91 +1542,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "Um documento é especial por ser considerado o nó superior da \"árvore de\nconteúdo\", ou seja, é a raiz da estrutura hierárquica dos documentos.\nNormalmente, isso é \"index\", mas se o documento \"index\" for um modelo\npersonalizado, você também poderá configurá-lo para outro nome de arquivo."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Nome do seu documento mestre (sem sufixo)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Erro: o arquivo mestre %s já foi encontrado no caminho raiz selecionado."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart não vai sobrescrever o arquivo existente."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Insira um novo nome de arquivo, ou renomeie o arquivo existente e pressione Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Indique qual das seguintes extensões do Sphinx devem ser habilitadas:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Nota: imgmath e mathjax não podem ser habilitados ao mesmo tempo. imgmath foi desmarcado."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Um Makefile e um arquivo de comando do Windows podem ser gerados para você,\npara que você só precise executar, p.ex., \"make html\" em vez de invocar o\nsphinx-build diretamente."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Criar um Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Criar um arquivo de comando do Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Criando o arquivo %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "O arquivo %s já existe, ignorando."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Finalizado: uma estrutura de diretório inicial foi criada."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Agora você deve preencher seu arquivo mestre %s e criar outros arquivos-fonte\nda documentação. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Use o Makefile para compilar os documentos, assim:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Use o comando sphinx-build para compilar os documentos, assim:\n   sphinx-build -b compilador %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "sendo “compilador” um dos compiladores com suporte, p.ex., html, latex ou linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1639,230 +1636,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nGera os arquivos necessários para um projeto Sphinx.\n\nO sphinx-quickstart é uma ferramenta interativa que faz algumas perguntas\nsobre o seu projeto e gera um diretório de documentação completo e um\nMakefile de amostra para ser usado com o sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "modo silencioso"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "raiz do projeto"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Opção Estrutura"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "se especificado, separa diretórios de fonte e de compilação"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "se especificado, cria o dir de construção sob o dir fonte"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "substituto para ponto em _templates etc."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Opções básicas do projeto"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "nome do projeto"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "nomes de autores"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "versão do projeto"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "lançamento do projeto"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "idioma dos documentos"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "sufixo de arquivos-fonte"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "nome do documento mestre"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "usa epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Opções extensão"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "habilita a extensão %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "habilita extensões arbitrárias"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Criação de Makefile e arquivo Batch"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "cria makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "não cria makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "cria arquivo batch"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "não cria arquivo batch"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "usa modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "não usa modo make para Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Modelo de projeto"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "diretório para arquivos de modelos"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "define uma variável modelo"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "“quiet” está especificada, mas “project” ou “author” não foi."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Erro: o caminho especificado não é um diretório, ou arquivos sphinx já existem."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart só gera em um diretório vazio. Especifique um novo caminho raiz."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Variável de modelo inválida: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr "espaços não em branco eliminados por dedent"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Legenda inválida: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "especificação de número de linha está fora da faixa(1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Não é possível usar as opções “%s” e “%s” juntas"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Arquivo incluído %r não encontrado ou sua leitura falhou"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "A codificação %r usada para ler o arquivo incluído %r parece estar errada, tente passar uma opção :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "O objeto chamado %r não foi encontrado no arquivo incluído %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Não é possível usar “lineo-match” com um conjunto separado de “lines”"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Especificação de linha %r: nenhuma linha obtida do arquivo incluído %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr "o padrão de glob do toctree %r não correspondeu a nenhum documento."
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree contém referência ao documento excluído %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree contém referência ao documento inexistente %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr "entrada duplicada encontrada no toctree: %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor da seção: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor do módulo: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autor do código: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ".. conteúdo acks não está na lista"
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ".. conteúdo hlist não está na lista"
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1873,559 +1870,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr "Declaração C duplicada, também definida em %s:%s.\nA declaração é '.. c:%s:: %s'."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parâmetros"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr "Valores de retorno"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Retorna"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Tipo de retorno"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "membro"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variável"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "função"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr "struct"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "união"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerador"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "parâmetro de função"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Novo na versão %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Alterado na versão %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsoleto desde a versão %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citação duplicada %s, outra instância em %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "citação %s não é referenciada."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr "Declaração C++ duplicada, também definida em %s:%s.\nA declaração é '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parâmetros do Modelo"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Lança"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "conceito"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "parâmetro de modelo"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (função interna)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (método %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variável global ou constante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atributo %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumentos"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (módulo)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "método"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dado"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "módulo"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "descrição duplicada de %s de %s, outro %s em %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "rótulo duplicado da equação %s, outra instância em %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "math_eqref_format inválido: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "palavra-chave"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objeto"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "exceção"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "comando"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "função interna"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variáveis"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Levanta"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (no módulo %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (no módulo %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variável interna)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe interna)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe em %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (método de classe %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s (propriedade %s )"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (método estático %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (propriedade %s )"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Índice de Módulos Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "módulos"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Obsoleto"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "método de classe"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "método estático"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "propriedade"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "descrição duplicada de objeto de %s, outra instância em %s, use :noindex: para um deles"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "mais de um alvo localizado para referência cruzada %r: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (obsoleto)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (diretiva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (opção diretiva)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (papel)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "diretiva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "opção diretiva"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "papel"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "descrição duplicada de %s %s, outra instância em %s"
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "váriavel de ambiente; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Descrição de opção %r malformada, deve se parecer com “opt”, “-opt args”, “--opt args”, “/opt args” ou “+opt args”"
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s opção de linha de comando"
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "opção de linha de comando"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "um termo de glossário deve ser precedido por uma linha vazia"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "termos de glossário não devem ser separados por linhas vazias"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "o glossário parece estar mal formatado, confira o recuo"
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "Glossário de Termos"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "termo gramatical"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "marca referencial"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "váriavel de ambiente"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opção do programa"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "documento"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Índice do Módulo"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Página de Busca"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "rótulo duplicada %s, outra instância em %s"
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "descrição duplicada de %s de %s, outra instância em %s"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig está desabilitado. :numref: é ignorado."
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "Falha ao criar uma referência cruzada. Qualquer número não foi atribuído: %s"
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "o link não possui legenda: %s"
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "numfig_format inválido: %s (%r)"
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "numfig_format inválido: %s"
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "rótulo não definido: %s"
+msgid "undefined label: %r"
+msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "Falha ao criar uma referência cruzada. Título ou legenda não encontrado: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "nova configuração"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "configuração alterada"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "extensões alteradas"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "a versão do ambiente de compilação não é a atual"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "diretório de fontes foi alterado"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Este ambiente é incompatível com o compilador selecionado, por favor escolha outro diretório de doctree."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Falha ao procurar documentos em %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "O domínio %r ainda não está registrado"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "toctree autorreferenciada encontrada. Ignorado."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "o documento não está incluído em nenhum toctree"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "veja %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "veja também %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "tipo desconhecido de entrada de índice %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Símbolos"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "referências circulares à toctree detectadas, ignorando: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree contém referência ao documento %r que não possui título: nenhum link será gerado"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "arquivo de imagem não legível: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "arquivo de imagem %s não legível: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "arquivo de download não legível: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s já tem números de seção atribuídos (toctree numerada aninhada?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "Criaria o arquivo %s."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2437,209 +2440,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nProcura recursivamente em <MODULE_PATH> módulos e pacotes Python e cria um\narquivo reST com diretivas automodule por pacote no <OUTPUT_PATH>.\n\nOs <EXCLUDE_PATTERN>s podem ser padrões de arquivo e/ou diretório que serão\nexcluídos da geração.\n\nNota: Por padrão, este script não substituirá os arquivos já criados."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "caminho para o módulo a ser documentado"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "padrões de diretório e/ou arquivo no estilo fnmatch para excluir da geração"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "diretório para colocar toda a saída"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "profundidade máxima de submódulos para mostrar no TOC (padrão: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "sobrescreve arquivos existentes"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "segue links simbólicos. Poderoso quando combinado com collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "escreve o script sem criar arquivos"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "coloca a documentação para cada módulo em sua própria página"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "inclui módulos “_private”"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "nome de arquivo da tabela de conteúdo (padrão: modules)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "não cria um arquivo de tabela de conteúdo"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "não cria títulos para os pacotes de módulo/pacote (p.ex., quando as docstrings já os contêm)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "coloca documentação de módulo antes da documentação do submódulo"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpreta caminhos de módulos de acordo com a especificação de espaços de nomes implícitos PEP-0420"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "sufixo dos arquivos (padrão: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "gera um projeto completo com sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "acrescenta module_path a sys.path, usando quando --full é fornecido"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "nome do projeto (padrão nome do módulo raiz)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "autor(e)s do projeto, usado quando --full é fornecido"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "versão do projeto, usado quando --full é fornecido"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "lançamento do projeto, usado quando --full é fornecido, padrão é --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "opções de extensão"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s não é um diretório."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "regex inválida %r em %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Teste de cobertura nos fontes finalizada, confira os resultados em %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "regex inválida %r em coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr "api c não documentada: %s %s no arquivo %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "o módulo %s não pôde ser importado: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "função python não documentada: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "classe python não documentada: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "método python não documentado: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "faltando “+” ou “-” na opção “%s”."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "“%s” não é uma opção válida."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "“%s” não é uma opção de pyversion válida"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "Tipo de TestCode inválido"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Teste de doctests nos fontes finalizada, confira os resultados em %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "nenhum código/saída no bloco %s em %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "ignorando código de doctest inválido: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "=================== durações de leitura mais lentas ===================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr "O link codificado %r pode ser substituído por um extlink (tente usar %r)"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "A diretiva de Graphviz não pode ter conteúdo e argumento de nome de arquivo"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Arquivo externo de Graphviz %r não encontrado ou sua leitura falhou"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorando diretiva “graphviz” sem conteúdo."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2649,14 +2657,14 @@
 "%r"
 msgstr "DOT não produziu um arquivo de saída:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "comando de DOT %r não pode ser executado (necessário para a saída do graphviz), verifique a configuração do graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2666,33 +2674,35 @@
 "%r"
 msgstr "DOT encerrado com erro:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format deve ser um entre “png” e “svg”, mas é %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "código DOT %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "gráfico: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "gráfico"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2702,163 +2712,173 @@
 "%r"
 msgstr "convert encerrado com erro:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "o comando LaTeX %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_latex"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "o comando %s %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_%s"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "exibe latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex em linha %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Link permanente para essa equação"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "o inventário intersphinx foi movido: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "carregando inventário intersphinx de %s…"
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "encontrados alguns problemas com alguns dos inventários, mas eles tem alternativas em funcionamento:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "falha ao alcançar todos os inventários com os seguintes problemas:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(em %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(em %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr "inventário para referência cruzada externa não encontrado: %s"
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr "papel para referência cruzada externa não encontrado: %s"
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "alvo da referência externa %s:%s não encontrado: %s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "identificador intersphinx %r não é uma string. Ignorado"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "Falha ao ler intersphinx_mapping%s, ignorado: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "código fonte"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Por fazer"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Entrada de “TODO” encontrada: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(A <<original entry>> está localizada na %s, linha %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "entrada original"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "realçando código de módulo… "
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "documentos"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Código do módulo"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Código fonte para %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Visão geral: código do módulo"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Todos os módulos onde este código está disponível</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "valor inválido para a opção member-order: %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "valor inválido para a opção class-doc-from: %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "assinatura inválida para auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "erro ao formatar argumentos para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "faltando atributo %s no objeto %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autodoc: falhou em determinar %s.%s (%r) a ser documentado, a seguinte exceção foi levantada:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2866,113 +2886,112 @@
 "explicit module name)"
 msgstr "não sei qual módulo importar para documentação automática %r (tente colocar uma diretiva “module” ou “currentmodule” no documento ou forneça um nome explícito para o módulo)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr "Um objeto simulado foi detectado: %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "erro ao formatar assinatura para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "“::” no nome de automodule não faz sentido"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "argumentos de assinatura ou anotação de retorno fornecidos para automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ deve ser uma lista de strings, não %r (no módulo %s) -- ignorando __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "faltando atributo mencionado na opção :members: : módulo %s, atributo %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "Falha ao obter uma assinatura de função para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "Falha ao obter uma assinatura de construtor para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Base: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "faltando atributo %s no objeto %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "apelido de %s"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "apelido de TypeVar(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "Falha ao obter uma assinatura de método para %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "__slots__ inválido encontrado em %s. Ignorado."
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr "autodoc_member_order agora aceita \"alphabetical\" em vez de \"alphabetic\". Por favor, atualize sua configuração."
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "Falha ao analisar um valor de argumento padrão para %r: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "Falha ao atualizar a assinatura para %r: parâmetro não encontrado: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "Falha ao analisar type_comment para %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "referências de autosummmary excluíram o documento %r. Ignorado."
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: arquivo stub não encontrado %r. Verifique sua configuração autosummary_generate."
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "Um autosummary com legenda requer a opção :toctree:. Ignorado."
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2980,46 +2999,46 @@
 "%s"
 msgstr "autosummary: falha ao importar %s\nPossíveis dicas:\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "falha ao analisar o nome %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "falha ao importar o objecto %s"
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: arquivo não encontrado: %s"
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary gera arquivos .rst internamente. Mas seu source_suffix não contém .rst. Ignorado."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary gerando autosummary para: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary escrevendo em %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3027,7 +3046,7 @@
 "%s"
 msgstr "autosummary falha ao importar %s\nPossíveis dicas:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3042,138 +3061,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nGera ReStructuredText usando diretivas de resumo automático.\n\nsphinx-autogen é um frontend para sphinx.ext.autosummary.generate.\nEle gera os arquivos reStructuredText a partir de diretivas autosummary\ncontidas nos arquivos de entrada fornecidos.\n\nO formato da diretiva autosummary está documentado no módulo Python\n``sphinx.ext.autosummary`` e pode ser lido usando:\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "arquivos-fonte para gerar arquivos rST"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "diretório para colocar toda a saída"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "sufixo padrão para arquivos (padrão: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "diretório de modelos personalizado (padrão: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "documenta membros importados (padrão: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr "documenta exatamente os membros no módulo atributo __all__. (padrão: %(default)s)"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumentos de Palavras-chave"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Exemplo"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Exemplos"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Notas"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Outros Parâmetros"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr "Recebe"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Referências"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Avisos"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "Yields"
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "valor inválido definido (faltando chave de fechamento): %s"
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "valor inválido definido (faltando chave de abertura): %s"
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "string literal malformada (faltando aspas de fechamento): %s"
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "string literal malformada (faltando aspas de abertura): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Atenção"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Cuidado"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Perigo"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Erro"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Ver também"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Aviso"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continuação da página anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "continua na próxima página"
@@ -3195,7 +3214,7 @@
 msgid "Table of Contents"
 msgstr "Tabela de Conteúdo"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Buscar"
@@ -3276,35 +3295,35 @@
 msgid "Navigation"
 msgstr "Navegação"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Pesquisar dentro de %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Sobre esses documentos"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última atualização em %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3349,12 +3368,12 @@
 msgstr "buscar"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Resultados da Busca"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3396,280 +3415,278 @@
 msgid "Other changes"
 msgstr "Outras alterações"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link permanente para este título"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link permanente para esta definição"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Esconder Resultados da Busca"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "Pesquisa finalizada, encontrada(s) ${resultCount} página(s) correspondendo à consulta da pesquisa."
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Buscando"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Preparando a busca..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Busca concluída. %s página(s) que atendem a consulta."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", em "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Expandir painel lateral"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Esconder Resultados da Busca"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Recolher painel lateral"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Expandir painel lateral"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Conteúdos"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "Um índice de 4 colunas encontrado. Pode ser um erro de extensões que você usa: %r"
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Nota de rodapé %s não é referenciada."
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "Nota de rodapé # não é referenciada."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referências de nota de rodapé inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referências inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referências de citação inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referências de termo inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr "Não foi possível determinar o texto reserva para a referência cruzada. Pode ser um bug."
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "mais de um alvo localizado para “any” referência cruzada %r: poderia ser %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr "%s:alvo de referência %s não encontrado: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "alvo de referência %r não encontrado: %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "Não foi possível obter imagem remota: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "Não foi possível obter imagem remota: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Formato de imagem desconhecido: %s…"
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "caracteres de origem não codificáveis, substituindo por “?”: %r"
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "ignorado"
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "falhou"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr "Problema no domínio %s: o campo deveria usar o papel \"%s\", mas esse papel não está no domínio."
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "diretiva ou nome de papel desconhecida(o): %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "tipo de nó desconhecido: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "erro de leitura: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "erro de escrita: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "locale_dir %s não existe"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Formato de data inválido. Envolva a string com aspas simples se desejar emiti-la diretamente: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree contém referência ao arquivo inexistente %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "exceção ao avaliar apenas a expressão da diretiva: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "papel padrão %s não encontrado"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Link permanente para esta definição"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format não está definido para %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Quaisquer IDs não atribuídos ao nó %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "Link permanente para este termo"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "Link permanente para este cabeçalho"
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Link Permanente para essa tabela"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Link Permanente para esse código"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Link Permanente para essa imagem"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Link permanente para esse \"toctree\""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Não foi possível obter o tamanho da imagem. A opção :scale: foi ignorada."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "toplevel_sectioning %r desconhecido para a classe %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: grande demais, ignorado."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "título do documento não é um nó único em Text"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "nó de título encontrado não na section, topic, table, admonition ou sidebar"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Notas de rodapé"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "tabularcolumns e opção :widths: foram fornecidas. :widths: foi ignorada."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "a unidade de dimensão %s é inválida. Ignorada."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "tipo desconhecido de entrada de índice %s encontrado"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "imagem: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "imagem"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "legenda não dentro de uma imagem."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "tipo de nó não implementado: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Pr\u00f3ximo t\u00f3pico",
         "Other changes": "Outras altera\u00e7\u00f5es",
         "Overview": "Vis\u00e3o geral",
-        "Permalink to this definition": "Link permanente para esta defini\u00e7\u00e3o",
-        "Permalink to this headline": "Link permanente para este t\u00edtulo",
         "Please activate JavaScript to enable the search\n    functionality.": "Por favor ligue o JavaScript para habilitar a\nfuncionalidade de pesquisa.",
         "Preparing search...": "A preparar a pesquisa...",
         "Previous topic": "T\u00f3pico anterior",
@@ -39,7 +37,7 @@
         "Search": "Pesquisar",
         "Search Page": "P\u00e1gina de Pesquisa",
         "Search Results": "Resultados da Pesquisa",
-        "Search finished, found %s page(s) matching the search query.": "Pesquisa conclu\u00edda, foram encontrada(s) %s p\u00e1gina(s) que combinam com a consulta feita.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Pesquisar dentro de %(docstitle)s",
         "Searching": "A Pesquisar",
         "Searching for multiple words only shows matches that contain\n    all words.": "",
@@ -59,5 +57,5 @@
         "search this documentation": "Pesquisar esta documenta\u00e7\u00e3o",
         "the documentation for": "a documenta\u00e7\u00e3o de"
     },
-    "plural_expr": "(n != 1)"
+    "plural_expr": "(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>, 2016\n"
 "Language-Team: Portuguese (Portugal) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_PT/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: pt_PT\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Internos"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Módulos"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (em "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Índice Geral"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "índice"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "próximo"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "anterior"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "Documentação %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Índice"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Versão"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,271 +1230,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor da secção: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor do módulo: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autor do código: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,414 +1866,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parâmetros"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Retorno"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Tipo de retorno"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "membro"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variável"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "função"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tipo"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Novo na versão %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Alterado na versão %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Obsoleto desde a versão %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Gera"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "classe"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (função interna)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (método %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (classe)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variável global ou constante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atributo %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Parâmetros"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (módulo)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "método"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dados"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atributo"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "módulo"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "palavra-chave"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operador"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objecto"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "excepção"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "comando"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "função interna"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variáveis"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Levanta"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (no módulo %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (no módulo %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variável interna)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (classe interna)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (classe em %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (método de classe %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (método estático %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Índice de Módulos do Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "módulos"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Obsoleto"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "método de classe"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "método estático"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (obsoleto)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directiva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (papel)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "directiva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "papel"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "variável de ambiente; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "Termo de glossário"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "token de gramática"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "rótulo de referência"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "variável de ambiente"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opção de programa"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Índice de Módulos"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Página de Pesquisa"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2286,142 +2284,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "ver %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "ver também %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Símbolos"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "gráfico: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "gráfico"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(em %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "código fonte"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Por fazer"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "entrada original"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "documentos"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Código do módulo"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Código fonte de %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Visão geral: código do módulo"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Todos os módulos onde este código está disponível</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Atenção"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Cuidado"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Perigo"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Erro"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Importante"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Nota"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Veja também"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Dica"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Aviso"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continuação da página anterior"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Pesquisar"
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr "Navegação"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Pesquisar dentro de %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Sobre estes documentos"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Última actualização em %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "pesquisar"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Resultados da Pesquisa"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr "Outras alterações"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link permanente para este título"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link permanente para esta definição"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Esconder Resultados da Pesquisa"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "A Pesquisar"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "A preparar a pesquisa..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Pesquisa concluída, foram encontrada(s) %s página(s) que combinam com a consulta feita."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", em"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Expandir painel lateral"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Esconder Resultados da Pesquisa"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Recolher painel lateral"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Expandir painel lateral"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Conteúdo"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Link permanente para esta definição"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Notas de rodapé"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "imagem: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "imagem"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ro/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ro/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Subiectul urm\u0103tor",
         "Other changes": "Alte schimb\u0103ri",
         "Overview": "Prezentare general\u0103",
-        "Permalink to this definition": "Link permanent la aceast\u0103 defini\u021bie",
-        "Permalink to this headline": "Link permanent la acest titlu",
         "Please activate JavaScript to enable the search\n    functionality.": "Activeaz\u0103 JavaScript pentru a permite\nfunc\u021bia de c\u0103utare.",
         "Preparing search...": "Se preg\u0103te\u0219te c\u0103utarea...",
         "Previous topic": "Subiectul precedent",
@@ -39,7 +37,7 @@
         "Search": "C\u0103utare",
         "Search Page": "Pagin\u0103 de C\u0103utare",
         "Search Results": "Rezultatele C\u0103ut\u0103rii",
-        "Search finished, found %s page(s) matching the search query.": "C\u0103utare finalizat\u0103, au fost g\u0103site %s pagini care au corespuns c\u0103ut\u0103rii.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "Caut\u0103 \u00een %(docstitle)s",
         "Searching": "C\u0103utare",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ro/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ro/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ro/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ro/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Razvan Stefanescu <razvan.stefanescu@gmail.com>, 2015-2017\n"
 "Language-Team: Romanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ro/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ro\n"
 "Plural-Forms: nplurals=3; plural=(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1));\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Proiectul necesită minim Sphinx v%s și de aceea nu poate fi construit cu această versiune."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "eșuat: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "a reușit"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "a fost finalizat cu probleme"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Fig. %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabelul %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Cod %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Propuneri de Îmbunătățire Python; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Integrate"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Nivelul modul"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(în"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Index General"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "următor"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "precedent"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s documentație"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Versiune"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,271 +1230,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autorul secțiunii:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autorul modulului:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autorul codului:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,414 +1866,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametrii"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Întoarce"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Tipul întors"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "membru"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variabilă"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funcție"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tip"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nou în versiunea %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Schimbat în versiunea %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Învechit începând cu versiunea %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Generează"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "clasă"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funcție integrată)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metoda %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (clasă)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (variabilă globală sau constantă)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumente"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metodă"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "cuvânt cheie"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "obiect"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "excepție"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "declarație"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "funcție integrată"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variabile"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Generează"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (în modulul %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (în modulul %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (variabilă integrată)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (clasă integrată)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (clasa în %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (metoda clasei %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (metoda statică %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Indexul de Module Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "module"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Învechit"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "metoda clasei"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "metodă statică"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr "(învechit)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (directivă)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "directivă"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "variabilă de mediu; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "termen de glosar"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "element de gramatică"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "etichetă de referință"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "variabilă de mediu"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "opțiune a programului"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Index al modulelor"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Pagină de Căutare"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2286,142 +2284,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "vezi %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "vezi și %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simboluri"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "grafic: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "grafic"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(în %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "sursă"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "De făcut"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "înregistrarea inițială"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "documentație"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Codul modulului"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Codul sursă pentru %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Prezentare generală: codul modulului"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Toate modulele pentru care este disponibil codul sursă</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Atenție"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Avertisment"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Pericol"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Eroare"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Sugestie"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Important"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Notă"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Vezi și"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Sfat"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Atenționare"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "continuare din pagina precedentă"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Căutare"
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr "Navigare"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Caută în %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Despre aceste documente"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Drepturi de autor"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Ultima actualizare la %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "căutare"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Rezultatele Căutării"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr "Alte schimbări"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Link permanent la acest titlu"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Link permanent la această definiție"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Ascunde Rezultatele Căutării"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Căutare"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Se pregătește căutarea..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Căutare finalizată, au fost găsite %s pagini care au corespuns căutării."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", în"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Expandare bară laterală"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Ascunde Rezultatele Căutării"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Ascundere bară laterală"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Expandare bară laterală"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Cuprins"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Link permanent la această definiție"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Link permanent la acest tabel"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Link permanent la acest cod"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Link permanent la această imagine"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Link permanent la acest cuprins"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Note de subsol"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "figura: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "figură"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ru/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ru/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0421\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0439 \u0440\u0430\u0437\u0434\u0435\u043b",
         "Other changes": "\u0414\u0440\u0443\u0433\u0438\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f",
         "Overview": "\u041e\u0431\u0437\u043e\u0440",
-        "Permalink to this definition": "\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u044d\u0442\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u0435",
-        "Permalink to this headline": "\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u044d\u0442\u043e\u0442 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a",
         "Please activate JavaScript to enable the search\n    functionality.": "\u0414\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u043f\u043e\u0438\u0441\u043a\u0430 \u0432\u043a\u043b\u044e\u0447\u0438\u0442\u0435 JavaScript \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435.",
         "Preparing search...": "\u041f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0430 \u043f\u043e\u0438\u0441\u043a\u0430\u2026",
         "Previous topic": "\u041f\u0440\u0435\u0434\u044b\u0434\u0443\u0449\u0438\u0439 \u0440\u0430\u0437\u0434\u0435\u043b",
@@ -39,7 +37,7 @@
         "Search": "\u041f\u043e\u0438\u0441\u043a",
         "Search Page": "\u041f\u043e\u0438\u0441\u043a",
         "Search Results": "\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u043f\u043e\u0438\u0441\u043a\u0430",
-        "Search finished, found %s page(s) matching the search query.": "\u041f\u043e\u0438\u0441\u043a \u0437\u0430\u0432\u0435\u0440\u0448\u0451\u043d, \u043d\u0430\u0439\u0434\u0435\u043d\u043e %s \u0441\u0442\u0440\u0430\u043d\u0438\u0446, \u0443\u0434\u043e\u0432\u043b\u0435\u0442\u0432\u043e\u0440\u044f\u044e\u0449\u0438\u0445 \u0437\u0430\u043f\u0440\u043e\u0441\u0443.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "\u041f\u043e\u0438\u0441\u043a \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0435 \u00ab%(docstitle)s\u00bb",
         "Searching": "\u0418\u0434\u0451\u0442 \u043f\u043e\u0438\u0441\u043a",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ru/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ru/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ru/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ru/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,140 +7,141 @@
 # Dmitry Shachnev <mitya57@gmail.com>, 2013
 # ferm32 <ferm32@gmail.com>, 2014,2016,2019
 # FIRST AUTHOR <EMAIL@ADDRESS>, 2013
+# Il'ya <ilya@marshal.dev>, 2022
 # Konstantin Molchanov <moigagoo@live.com>, 2016
 # PyHedgehog <pywebmail@list.ru>, 2015,2017
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Il'ya <ilya@marshal.dev>, 2022\n"
 "Language-Team: Russian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ru/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ru\n"
 "Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Проект требует версию Sphinx не ниже v%s и не может быть построен текущей версией."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "готово"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "ошибка: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Сборщик не указан, по умолчанию используется html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "успешно"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "с ошибками"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "сборка завершена %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -148,12 +149,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -161,64 +162,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "в конфигурационной папке нет файла conf.py file (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Отсутствует ключ конфигурации %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Ключ конфигурации %r уже существует"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Файл конфигурации (или один из импортированных модулей) вызвал sys.exit()"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -226,898 +233,894 @@
 "%s"
 msgstr "В вашем файле конфигурации программная ошибка:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Раздел %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Рис. %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Таблица %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Список %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Событие %r уже существует"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Неизвестное событие: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Отсутствует аттрибут \"name\" у класса сборщика %s."
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Сборщик %r уже существует (в модуле %s)."
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Сборщик %s не зарегистрирован явно или через ресурсы пакетов."
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Сборщик %s не зарегистрирован."
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Изначальное исключение:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Не могу загрузить модуль расширения %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "расширение %r не определяет функцию setup(); это действительно модуль расширения Sphinx?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Предложения об улучшениях Python; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "Не получается считать файл изображение %r: скопируйте его"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "Не получается скопировать файл изображения %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "Не получается записать файл изображения %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "записывается %s файл..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Встроенные функции"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Модуль"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (в "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Алфавитный указатель"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "указатель"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "вперёд"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "назад"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "документация %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Алфавитный указатель"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Выпуск"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1126,94 +1129,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1232,35 +1235,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1306,7 +1309,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1342,161 +1345,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "Не получается найти файлы %r"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "Невозможно совмещать ключ -a и названия файлов"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "Не получается открыть файл с предупреждениями %r:%s "
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1505,15 +1503,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Версия проекта"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Релиз проекта"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1523,21 +1521,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Язык проекта"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1545,91 +1543,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Создание файла %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Файл %s уже существует, пропускаем."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1639,230 +1637,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "имя проекта"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "имена авторов"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "версия проекта"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "релиз проекта"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "язык проекта"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "использовать epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Некорректная подпись: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Автор раздела: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Автор модуля: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Автор кода:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Автор: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1873,559 +1871,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Параметры"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Результат"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Тип результата"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "поле"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "переменная"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "функция"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "макрос"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "перечисляемый тип"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "перечислитель"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "тип"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Добавлено в версии %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Изменено в версии %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Не рекомендуется, начиная с версии %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Параметры шаблона"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Бросает исключение"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "класс"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "концепт"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (встроенная функция)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (метод %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (класс)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (глобальная переменная или константа)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (атрибут %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Аргументы"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (модуль)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "метод"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "данные"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "атрибут"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "модуль"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "повторяющаяся метка уравнения %s, также используется в %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "ключевое слово"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "оператор"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "объект"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "исключение"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "команда"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "базовая функция"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Переменные"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Исключение"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (в модуле %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (в модуле %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (встроенная переменная)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (встроенный класс)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (класс в %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (метод класса %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (статический метод %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Содержание модулей Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "модули"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Не рекомендуется"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "метод класса"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "статический метод"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr "(использование не рекомендуется)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (директива)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (роль)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "директива"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "роль"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "переменная окружения; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "элемент словаря"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "токен грамматики"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "текст ссылки"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "переменная окружения"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "опция программы"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "документ"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Состав модуля"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Поиск"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "новая конфигурация"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "конфигурация изменена"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "см. %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "также см. %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Символы"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2437,209 +2441,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2649,14 +2658,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2666,33 +2675,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "иллюстрация: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "иллюстрация"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2702,163 +2713,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Ссылка на это уравнение"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(в %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "исходный код"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "План"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<исходная запись>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<Исходная запись>> находится в %s, строка %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "исходный элемент"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "документация"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Код модуля"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Исходный код %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Обзор: исходный код модуля"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Все модули, в которых есть код</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2866,113 +2887,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
-msgstr "   Базовые классы: %s"
+msgstr "Базовые классы: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2980,46 +3000,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3027,7 +3047,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3042,138 +3062,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Именованные аргументы"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Пример"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Примеры"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Заметки"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Другие параметры"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Предупрждения"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Внимание"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Осторожно"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Опасно"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Ошибка"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Подсказка"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Важно"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Примечание"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "См.также"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Совет"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Предупреждение"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "продолжение с предыдущей страницы"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3195,7 +3215,7 @@
 msgid "Table of Contents"
 msgstr "Оглавление"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Поиск"
@@ -3276,35 +3296,35 @@
 msgid "Navigation"
 msgstr "Навигация"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Поиск в документе «%(docstitle)s»"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Об этих документах"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Авторские права"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Обновлено: %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3349,12 +3369,12 @@
 msgstr "искать"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Результаты поиска"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3396,280 +3416,278 @@
 msgid "Other changes"
 msgstr "Другие изменения"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Ссылка на этот заголовок"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Ссылка на это определение"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Снять выделение"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Идёт поиск"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Подготовка поиска…"
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Поиск завершён, найдено %s страниц, удовлетворяющих запросу."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", в"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Развернуть боковую панель"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Снять выделение"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Свернуть боковую панель"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Развернуть боковую панель"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Содержание"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Ссылка на это определение"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Постоянная ссылка на таблицу"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Постоянная ссылка на код"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Постоянная ссылка на рисунок"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Постоянная ссылка на оглавление"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Сноски"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "рисунок: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "рисунок"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/si/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/si/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0d8a\u0dc5\u0d9f \u0db8\u0dcf\u0dad\u0dd8\u0d9a\u0dcf\u0dc0",
         "Other changes": "\u0dc0\u0dd9\u0db1\u0dad\u0dca \u0dc0\u0dd9\u0db1\u0dc3\u0dca\u0d9a\u0db8\u0dca",
         "Overview": "",
-        "Permalink to this definition": "",
-        "Permalink to this headline": "",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "\u0dc3\u0dd9\u0dc0\u0dd4\u0db8 \u0dc3\u0dd6\u0daf\u0dcf\u0db1\u0db8\u0dca \u0d9a\u0dbb\u0db8\u0dd2\u0db1\u0dca....",
         "Previous topic": "\u0db4\u0dd9\u0dbb \u0db8\u0dcf\u0dad\u0dd8\u0d9a\u0dcf\u0dc0",
@@ -39,7 +37,7 @@
         "Search": "\u0dc3\u0ddc\u0dba\u0db1\u0dca\u0db1",
         "Search Page": "\u0dc3\u0dd9\u0dc0\u0dd4\u0db8\u0dca \u0db4\u0dd2\u0da7\u0dd4\u0dc0",
         "Search Results": "\u0dc3\u0dd9\u0dc0\u0dd4\u0db8\u0dca \u0db4\u0dca\u200d\u0dbb\u0dad\u0dd2\u0db5\u0dbd",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "",
         "Searching": "\u0dc3\u0ddc\u0dba\u0db8\u0dd2\u0db1\u0dca...",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/si/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/si/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/si/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/si/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: callkalpa <callkalpa@gmail.com>, 2013\n"
 "Language-Team: Sinhala (http://www.transifex.com/sphinx-doc/sphinx-1/language/si/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: si\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "ඊළඟ"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "පෙර"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s ලේඛණය"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "නිකුත් කිරීම"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "කේත ලේඛක:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "ලේඛක:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,414 +1865,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "පරාමිතීන්"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "සාමාජික"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "විචල්‍යය"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "ක්‍රියාව"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "මැක්‍රෝ"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "වර්ගය"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "%s වෙළුමේ අලුත්"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s වෙළුමේ වෙනස් කල"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "දත්ත"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "වස්තුව"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "විචල්‍ය"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "සෙවුම් පිටුව"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2285,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "%s බලන්න"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "%s ද බලන්න"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "සංකේත"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graph: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graph"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s හි%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "source"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "කිරීමට තිබෙන"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "දෝෂය"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "හැඟවීම"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "සටහන"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "මෙයද බලන්න"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "අනතුරු ඇඟවීම"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "සොයන්න"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "ගමන් කිරීම"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "මෙම ලේඛණ ගැන"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "සොයන්න"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "සෙවුම් ප්‍රතිඵල"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr "වෙනත් වෙනස්කම්"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "සොයමින්..."
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "සෙවුම සූදානම් කරමින්...."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "අන්තර්ගතය"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "image: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "image"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sk/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sk/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u010eal\u0161ia t\u00e9ma",
         "Other changes": "Ostatn\u00e9 zmeny",
         "Overview": "Preh\u013ead",
-        "Permalink to this definition": "Trval\u00fd odkaz na t\u00fato defin\u00edciu",
-        "Permalink to this headline": "Trval\u00fd odkaz na tento nadpis",
         "Please activate JavaScript to enable the search\n    functionality.": "Pros\u00edm, na zapnutie funkcie h\u013eadania,aktivujte\nJavaScript .",
         "Preparing search...": "Pr\u00edprava h\u013eadania...",
         "Previous topic": "Predo\u0161l\u00e1 t\u00e9ma",
@@ -39,7 +37,7 @@
         "Search": "H\u013eada\u0165",
         "Search Page": "Str\u00e1nka h\u013eadania",
         "Search Results": "V\u00fdsledky h\u013eadania",
-        "Search finished, found %s page(s) matching the search query.": "H\u013eadanie dokon\u010den\u00e9, n\u00e1jden\u00e9 %s strana(y), ktor\u00e9 vyhovuj\u00fa h\u013eadan\u00e9mu v\u00fdrazu.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "H\u013eada\u0165 v %(docstitle)s",
         "Searching": "H\u013eadanie",
         "Searching for multiple words only shows matches that contain\n    all words.": "H\u013eadanie viacer\u00fdch slov vracia len zhody, ktor\u00e9 obsahuj\u00fa\n    v\u0161etky slov\u00e1.",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sk/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sk/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sk/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sk/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -10,134 +10,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Slavko <linux@slavino.sk>, 2013-2019,2021\n"
 "Language-Team: Slovak (http://www.transifex.com/sphinx-doc/sphinx-1/language/sk/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sk\n"
 "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n == 1 ? 0 : n % 1 == 0 && n >= 2 && n <= 4 ? 1 : n % 1 != 0 ? 2: 3);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Nemožno nájsť zdrojový priečinok (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "Výstupný adresár (%s) nie je adresár"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Zdrojový a cieľový priečinok nemôžu byť rovnaké"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Spúšťanie Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Tento projekt vyžaduje aspoň Sphinx v%s a preto s touto verziou nemôže byť zostavený."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "vytváranie výstupnej zložky"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "pri nastavovaní rozšírenia %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' definovaný v conf.py nie je funkciou. Prosím, upravte jeho definíciu tak, aby to bola funkcia. Je to potrebné, aby sa conf.py mohol správať ako rozšírenie Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "načítanie prekladov %s…"
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "hotovo"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "nedostupné pre zabudované správy"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "načítanie uloženého prostredia "
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "zlyhalo: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Nebol zvolený builder, bude použitý predvolený: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "úspešné"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "dokončené sproblémami"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "zostavenie %s, %s upozornenia/a (upozornenia považované za chyby)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "zostavenie %s, %s upozornenia/a (upozornenia považované za chyby)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "zostavenie %s, %s upozornenie."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "zostavenie %s, %s upozornenie/a."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "zostavenie %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "trieda uzla %r už je registrovaná, jej metódy (visitors) budú prepísané"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "direktíva %r už je registrovaná, bude prepísaná"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "rola %r už je registrovaná, bude prepísaná"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -145,12 +145,12 @@
 "explicit"
 msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladá sa, že nie - prosím, požiadajte autora aby to skontroloval a explicitne to nastavil"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -158,64 +158,70 @@
 "explicit"
 msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladáme, že nie je – prosím, požiadajte autora aby to skontroloval a explicitne to nastavil"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "sériové spracovanie %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "konfiguračný priečinok neobsahuje súbor conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "nemožno prepísať slovník nastavenia %r, ignorované (použite %r na nastavenie jednotlivých prvkov)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "neplatný počet %r pre konfiguračnú hodnotu %r, ignorované"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "nemožno prepísať konfiguračné nastavenie %r s nepodporovaným typom, ignorované"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "neznáma konfiguračná hodnota %r v prepísaní, ignorované"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Neznáma konfiguračná hodnota: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Konfiguračná hodnota %r už existuje"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Vo svojom konfiguračnom súbore máte chybu: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Konfiguračný súbor (alebo jeden z modulov, ktoré importuje) volal sys.exit()"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -223,898 +229,894 @@
 "%s"
 msgstr "V konfiguračnom súbore je programová chyba:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Konfiguračná hodnota „source_suffix” očakáva reťazec, zoznam reťazcov alebo slovník, ale zadali ste „%r”."
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Sekcia %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Obr. %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabuľka %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Výpis %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Konfiguračná hodnota `{name}` má byť jedno z {candidates}, ale je zadané `{current}`."
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}'; očakávané {permitted}."
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}', predvolene `{default.__name__}'."
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r nenájdená, ignorované."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "Od v2.0 Sphinx predvolene používa „index” ako root_doc. Prosím, pridajte „root_doc = 'contents'” do svojho conf.py."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Udalosť %r už existuje"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Neznáme meno udalosti %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "Obsluha %r udalosti %r vyvolala výnimku"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Rozšírenie %s je vyžadované nastavením needs_extensions, ale nie je načítané."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Tento projekt vyžaduje rozšírenie %s s verziou minimálne %s, a teda ho nemožno zostaviť s načítanou verziou (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Neznáme meno lexera Pygments %r"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "Nemožno spracovať literal_block ako \"%s\". Zvýraznenie syntaxe preskočené."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "nájdených viacero súborov pre dokument \"%s\": %r\nNa zostavenie použite %r."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "dokument nie je čitateľný. Ignorované."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Trieda builder %s nemá atribút „name”"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r už existuje (v module %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder s menom %s nie je registrovaný ani dostupný cez vstupný bod"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder s menom %s nie je registrovaný"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "doména %s už je zaregistrovaná"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "doména %s ešte nie je zaregistrovaná"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Direktíva %r už je registrovaná v doméne %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Rola %r už je registrovaná v doméne %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Index %r už je registrovaný v doméne %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr " object_type %r už je registrovaný"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "crossref_type %r už je registrovaný"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r  už je registrovaný"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser pre %r už je registrovaný"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Analyzátor pre %s nie je registrovaný"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Translator pre %r už existuje"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r  už je registrovaný"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "rozšírenie %r bolo zlúčené so Sphinx od verzie %s; toto rozšírenie je ignorované."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Pôvodná výnimka:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "Nemožno importovať rozšírenie %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "rozšírenie %r nemá funkciu setup(); je to naozaj modul rozšírenia Sphinx?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Rozšírenie %s použité týmto projektom vyžaduje aspoň Sphinx v%s; takže ho nemožno zostaviť s touto verziou."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "rozšírenie %r vrátilo so svojej funkcie setup() nepodporovaný objekt; musí vrátiť None alebo slovník metadát"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "téma %r nemá nastavenie „theme”"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "téma %r nemá nastavenie „inherit”"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "nebola nájdená téma s menom %r, dedená v %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "nastavenie %s.%s nenájdené v žiadnom z nastavení témy"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "zadaná nepodporovaná voľba témy %r"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "súbor %r v ceste témy nie je platný súbor ZIP alebo neobsahuje tému"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "nájdená sphinx_rtd_theme (< 0.3.0). Táto nebude dostupná od Sphinx-6.0"
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "nebola nájdená téma  smenom %r (chýbajúci theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "zostavenie mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "zápis výstupu…"
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "všetky z %d súborov po"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "ciele pre %d po súborov, ktoré boli zadané"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "ciele pre %d po súborov, ktoré sú zastarané"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "všetky zdrojové súbory"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "súbor %r zadaný v príkazovom riadku nie je v zdrojovom adresári, ignorujem"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "súbor %r zadaný v príkazovom riadku neexistuje, ignorujem"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "%d zdrojové súbory zadané v príkazovom riadku"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "ciele pre %d zdrojových súborov, ktoré sú zastarané"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "zostavovanie %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "hľadanie zastaraných súborov…"
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d nájdené"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "nenájdené"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "ukladanie prostredia"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "kontrolovanie konzistencie"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "žiadne ciele nie sú zastarané."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "aktualizácia prostredia:"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s pridané, %s zmenené, %s odstránené"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "čítanie zdrojov…"
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "čakanie na procesy…"
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "mená dokumentov na zapísanie: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "príprava dokumentov"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "nájdená duplicitná položka Obsahu: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "kopírovanie obrázkov…"
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "nemožno čítať súbor obrázku %r: jeho kopírovanie namiesto toho"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "nemožno kopírovať súbor obrázka %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "nemožno zapísať súbor obrázka %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Pillow nenájdené – kopírovanie súborov obrázkov"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "zapisovanie súboru mimetype…"
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "zapisovanie súboru META-INF/container.xml…"
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "zapisovanie súboru content.opf..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "neznámy typ MIME pre %s, ignorovaný"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "zapisovanie súboru toc.ncx..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "zapisovanie súboru %s…"
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Súbor prehľadu je v %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "žiadne zmeny vo verzii %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "zapisovanie súboru prehľadu…"
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Zabudované funkcie"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Úroveň modulu"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "kopírovanie zdrojových súborov…"
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "nemožno čítať %r na vytvorenie položky záznamu zmien"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "Zostavovač dummy negeneruje žiadne súbory."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Súbory ePub sú v %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "zapisovanie súboru nav.xhtml..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_language” (alebo „language”) nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "konfiguračná hodnota „epub_uid” má byť XML NAME pre EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_title” (alebo „html_title”) nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_author” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_contributor” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_description” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_publisher” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_copyright” (alebo „copyright”) nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „epub_identifier” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "konfiguračná hodnota „version” nesmie byť prázdna pri EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "neplatný css_file: %r, ignorovaný"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Katalógy správ sú v %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "čítanie šablón… "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "zapisovanie katalógov správ…"
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Hľadajte akékoľvek chyby v predošlom výstupe alebo v %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "poškodený odkaz: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Kotva „%s” nenájdená"
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Manuálové stránky sú v %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "nebola nájdená konfiguračná voľba „man_pages”; manuálové stránky nebudú zapísané"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "zapisovanie"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "konfiguračná voľba „man_pages” odkazuje na neznámy dokument %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Stránky HTML sú v %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "zostavovanie spoločného dokumentu"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "zapisovanie dodatočných súborov"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Súbory Texinfo sú v %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou makeinfo\n(použite tu 'make info' aby to bolo spustené automaticky)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "nebola nájdená konfiguračná voľba „texinfo_documents”; dokumenty nebudú zapísané"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "konfiguračná voľba „texinfo_documents” odkazuje na neznámy dokument %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "spracovanie %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "riešenie odkazov…"
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(v"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "kopírovanie podporných súborov Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "chyba zápisu súboru Makefile: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Textové súbory sú  v %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "chyba zápisu súboru %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Súbory XML sú v %(outdir)s."
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Súbory pseudo-XML sú v %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "súbor info zostavenia je poškodený: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Stránky HTML sú v %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "Čítanie súboru zostavenia info zlyhalo: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d. %b  %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Všeobecný index"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "ďalší"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "predošlý"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "generovanie indexov"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "zapisovanie dodatočných stránok"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "kopírovanie súborov na stiahnutie…"
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "nemožno kopírovať súbor na stiahnutie %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "Kopírovanie súboru v html_static_file zlyhalo: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr "kopírovanie statických súborov"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "nemožno kopírovať statický súbor %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "kopírovanie extra súborov"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "nemožno kopírovať extra súbor %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "Zápis súboru zostavenia info zlyhal: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "index hľadania nemožno načítať, ale nebudú zostavované všetky dokumenty, takže index nebude kompletný."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "stránka %s vyhovuje dvom vzorom v html_sidebars: %r a %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, 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 "pri spracovaní stránky %s nastala chyba Unicode. Prosím, zaistite, že všetky konfiguračné hodnoty, ktoré obsahujú nieASCII hodnotu sú reťazce Unicode."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Nastala chyba pri spracovaní stránky %s.\nPríčina: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "generovanie inventára objektov…"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "generovanie indexu hľadania v %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "neplatné js_file: %r, ignorované"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Zaregistrovaných je viac math_renderer, ale žiadny nie je zvolený."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Zdaný neznámy math_renderer %r."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "položka „html_extra_path entry” %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "položka html_extra_path %r je umiestnené vo vnútri výstupného adresára"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "položka „html_static_path” %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "položka html_static_path %r je umiestnené vo vnútri výstupného adresára"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "súbor loga %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "súbor favicon %r neexistuje"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr "html_add_permalinks bolo označené za zastarané od v3.5.0. Prosím, použite namiesto toho html_permalinks a html_permalinks_icon."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentácia %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Súbory LaTeX sú v %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou  (pdf)latex\n(použite tu 'make latexpdf' aby to bolo spustené automaticky)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "nebola nájdená konfiguračná voľba „latex_documents”; dokmenty nebudú zapísané"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "konfiguračná voľba „latex_documents” odkazuje na neznámy dokument %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Vydanie"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "žiadna známa voľba Babel pre jazyk %r"
@@ -1123,94 +1125,94 @@
 msgid "copying TeX support files"
 msgstr "kopírovanie podporných súborov Tex"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "kopírovanie podporných súborov Tex…"
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "kopírovanie dodatočných súborov"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "Neznámy konfiguračný kľúč: latex_elements%r, ignorovaný."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr "Neznáma voľba témy: latex_theme_options%r, ignorovaná."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r nemá nastavenia „theme”"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "téma %r nemá nastavenie „1%s”"
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Počas zostavenia sa vyskytla výnimka, spúšťam ladenie:"
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "Prerušené!"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "Chyba značky reST:"
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Chyba kódovania:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Úplný záznam chýb bol zapísaný v  %s, ak chcete nahlásiť problém vývojárom."
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Chyba rekurzie:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "Toto môže nastať s veľmi veľkými alebo príliš hlboko vnáranými zdrojovými súbormi. môžete opatrne zvýšiť predvolenú hodnotu limitu rekurzie Python z 1000 v conf.py, napr.:"
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Nastala výnimka:"
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Prosím, nahláste to, i keď to bola chyba používateľa, aby mohla byť nabudúce poskytnutá lepšia chybová správa."
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Hlásenie o chybe možno vyplniť na <https://github.com/sphinx-doc/sphinx/issues>. Ďakujeme!"
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "počet úloh musí byť kladné číslo"
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1229,35 +1231,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr "\nGeneruje dokumentáciu zo zdrojových súborov.\n\nsphinx-build generuje dokumentáciu zo súborov v SOURCEDIR a umiestni ju\nv OUTPUTDIR. Konfiguračné voľby hľadá v 'conf.py' v SOURCEDIR.\nNa generovanie súborov šablón, vrátane 'conf.py' možno použiť nástroj\n'sphinx-quickstart'\n\nsphinx-build dokáže vytvoriť dokumentáciu v rôznych formátoch. Formát je\nzvolený zadaním mena zostavovača v príkazovom riadku; predvolene\nHTML. Zostavovače môžu vykonávať aj iné úlohy, ktoré súvisia so spracovaním\ndokuemntácie.\n\nPredvolene je zostavené všetko, čo bolo zmenené. Výstup len zvolených súborov\nmôže byť zostavený zadaním jednotlivých mien súborov.\n"
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "cesta k zdrojovým súborom dokumentácie"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "cesta k výstupnej zložke"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "zoznam špecifických súborov na zostavenie, ignorovaný ak je použité -a"
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "všeobecné voľby"
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "použitý zostavovač (predvolený: html)"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "zapísať všetky súbory (predvolene: zapísať len nové a zmenené súbory)"
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "nepoužívať uložené prostredie, vždy čítať všetky súbory"
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1303,7 +1305,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr "zvýšiť rozvláčnosť (možno opakovať)"
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "žiadny výstup, len upozornenia na stderr"
 
@@ -1339,161 +1341,156 @@
 msgid "run Pdb on exception"
 msgstr "pri výnimke spustiť Pdb"
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "nemožno nájsť súbory %r"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "nemožno kombinovať voľbu -a a mená súborov"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "nemožno otvoriť súbor varovaní %r: %s"
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "argument voľby -D musí byť v tvare meno=hodnota"
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "argument voľby -A musí byť v tvare meno=hodnota"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "automaticky vložiť dokumentačné reťazce z modulov"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "automaticky testovať kúsky kódu v blokoch dokumentačných reťazcov"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "prepojenie medzi dokumentáciou Sphinx rôznych modulov"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "písať položky „todo”, ktoré môžu byť zobrazené alebo skryté pri zostavení"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "zahrnúť math, spracované ako obrázky PNG alebo SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "zahrnúť math, spracované prehliadačom pomocou MathJax"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "podmienečné zahrnutie obsahu na základe konfiguračných volieb"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "zahrnúť odkazy na zdrojový kód dokumentovaných objektov Python"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "vytvoriť súbor .nojekyll na publikovanie dokumentu na GitHub"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Prosím, zadajte platnú cestu."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Prosím, zadajte nejaký text."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Prosím, zadajte jedno z 1%s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Prosím, zadajte buď 'y' alebo 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Prosím, zadajte príponu súboru, napr. '.rst' alebo '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Vitajte v nástroji Sphinx %s quickstart."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Zvolená cesta koreňa: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Zadajte cestu koreňa tejto dokumentácie."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Cesta koreňa dokumentácie"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Chyba: nájdený existujúci conf.py v zadanej ceste koreňa."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart neprepíše existujúce projekty Sphinx."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Prosím, zadajte novú cestu koreňa (alebo len Enter na skončenie)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 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 "Sú dve možnosti umiestnenia adresára zostavenia s výstupom Sphinx.\nMôžete použiť buď adresár „_build” v koreni alebo môžete mať oddelené\nadresáre „source” a „build” v ceste koreňa."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Oddeliť zdrojový a výstupný adresár (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 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 "V koreňovom adresári budú vytvorená dva ďalšie adresáre; \"_templates\"\npre vlastné šablóny HTML a \"_static\" pre vlastné CSS a iné statické súbory\nMôžete zadať inú predponu (napr. „.”), ktorá nahradí podčiarkovník."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Predpona mena adresárov templates a static"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Meno projektu bude na viacerých miestach zostavenej dokumentácie."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Názov projektu"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Meno(á) autora(ov)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1502,15 +1499,15 @@
 "just set both to the same value."
 msgstr "Sphinx má predstavu o \"version\" a \"release\" softvéru. Každá\nverzia môže mať viacero vydaní. Napríklad, pre Python je verzia\nniečo ako 2.5 alebo 3.0, zatiaľčo vydanie je niečo ako 2.5.1\nalebo 3.0a1. Ak nepotrebuje dvojitú štruktúru, jednoducho nastavte\noboje na rovnakú hodnotu."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Verzia projektu"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Vydanie projektu"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1520,21 +1517,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Ak má byť dokumentácia písaná v inom ako Anglickom jazyku,\nmôžete tu zvoliť jazyk pomocou jeho kódu. Sphinx bude potom\nprekladať text, ktorý generuje, do tohoto jazyka.\n\nZoznam podporovaných jazykov nájdete na\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Jazyk projektu"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 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 "Prípona mena zdrojových súborov. Zvyčajne to je buď „.txt”\nalebo „.rst”. Len súbory s touto príponou sú považované za dokumenty."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Prípona zdrojových súborov"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1542,91 +1539,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "Jeden dokument je špeciálny v tom, že je považovaný za vrcholový uzol\n„stromu obsahu”, čiže je to koreň hierarchickej štruktúry dokumentov.\nBežne to je „index”, ale ak je Váš „index” vlastnou šablónou, môžete\npoužiť aj iné meno súboru."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Meno hlavného dokumentu (bez prípony)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Chyba: nájdený existujúci hlavný súbor %s v zadanej ceste koreňa."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart neprepíše existujúci súbor."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Prosím, zadajte nové meno súboru alebo premenujte existujúci súbor a stlačte Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Informuje, ktoré z nasledujúcich rozšírení Sphinx majú byť zapnuté:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Pozor: imgmath a mathjax nemožno zapnúť naraz. výber imgmath bol zrušený."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 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 "Súbory Makefile a príkazový súbor Windows môže byť pre Vás vygenerovaný\ntakže stačí spustiť napr. len `make html' namiesto priameho spúšťania sphinx-build."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Vytvoriť Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Vytvoriť príkazový súbor Windows? (y/n) "
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Vytváranie súboru %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Súbor %s už existuje, preskočené."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Dokončené: Počiatočná štruktúra adresára bola vytvorená."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Teraz môže vyplniť svoj hlavný súbor %s a vytvoriť ostatné zdrojové súbory\ndokumentácie. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Na zostavenie dokumentácie použite Makefile, napr.:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Na zostavenie dokumentácie použite príkaz sphinx-build, napr.:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "kde „builder” je jeden z podporovaných formátov, napr. html, latex alebo linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1636,230 +1633,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nGenereuje požadované súbory projektu Sphinx.\n\nsphinx-quickstart je interaktívny nástroj, ktorý kladie niekoľko otázok o  Vašom\nprojekte a potom generuje kompletný adresár dokumentácie a vzorový\nMakefile, na použitie so sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "tichý režim"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "koreň projektu"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Voľby štruktúry"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "ak je zadané, oddeliť zdrojový a výstupný adresár"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "ak je zadané, vytvoriť výstupný adresár v zdrojovom"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "náhrada za bodku v _templates apod."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Základné voľby projektu"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "názov projektu"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "mená autorov"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "verzia projektu"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "vydanie projektu"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "jazyk dokumentácie"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "prípona zdrojových súborov"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "meno hlavného dokumentu"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "použiť epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Voľby rozšírenia"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "zapnúť rozšírenie %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "zapnúť konkrétne rozšírenia"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Vytvorenie Makefile a Batchfile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "vytvoriť makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "nevytvoriť makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "vytvoriť batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "nevytvoriť batchfile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "použiť režim make pre Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "nepoužiť režim make pre Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Šablóny projektu"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "adresár šablóny pre súbory šablóny"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "definovať premennú šablóny"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "bolo zadané „quiet”, ale nebol zadaný „project” alebo „author”."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Chyba: zadaná cesta nie je adresár alebo súbory sphinx už existujú."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart generuje len do prázdneho adresára. Prosím, zadajte novú cestu koreňa."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Neplatná premenná šablóny: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Neplatný popis: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "špecifikácia čísla riadku je mimo rozsahu (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Nemožno použiť obe voľby „%s” a „%s”"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Súbor na vloženie %r nebol nájdený alebo zlyhalo jeho čítanie"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Kódovanie %r použité pri čítaní vloženého súboru %r vyzerá ako zlé, skúste zadať voľbu :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objekt s menom %r nebol nájdený vo vloženom súbore %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Nemožno použiť „lineno-match” s rozdelenou množinou „lines”"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Riadok %r: žiadne riadky z vloženého súboru %r"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "strom obsahu obsahuje odkaz na vylúčený dokument %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "strom obsahu obsahuje odkaz na neexistujúci dokument %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor sekcie:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor modulu:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autor kódu:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1870,559 +1867,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr "Duplicitná deklarácia C, definovaná aj v %s:%s.\nDeklarácia je '.. c:%s:: %s'."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametre"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Vracia"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Návratový typ"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "člen"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "premenná"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcia"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerátor"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "parameter funkcie"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nové vo verzii %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Zmenené vo verzii %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastarané od verzie %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "duplicitná citácia  %s, ďalší výskyt v %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Citácia %s nie je odkazovaná."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr "Duplicitná deklarácia C++, definovaná aj v %s:%s.\nDeklarácia je '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parametre šablóny"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Vyvoláva"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "trieda"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "parameter šablóny"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (zabudovaná funkcia)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metóda %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (trieda)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (globálna premenná alebo konštanta)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribút %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumenty"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metóda"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dáta"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribút"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "duplicitný %s popis %s, ďalší výskyt%s v %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "duplicitná menovka vzorca %s, ďalší výskyt v %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "neplatný math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "kľúč. slovo"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operátor"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "výnimka"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "príkaz"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "zabudovaná funkcia"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Premenné"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Vyzdvihuje"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (v module %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (v module %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (zabudovaná premenná)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (zabudovaná trieda)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (trieda v %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (metóda triedy %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s (vlastnosť %s)"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (statická metóda %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (vlastnosť %s)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Index modulov Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduly"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Zastarané"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "metóda triedy"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statická metóda"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "vlastnosť"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "duplicitný popis objektu  %s, ďalší výskyt v %s, použite :noindex: pre jeden z nich"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "nájdený viac ako jeden cieľ krížového odkazu %r: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (zastarané)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktíva)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr "%s (voľba direktívy)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rola)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktíva"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rola"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "duplicitný popis %s %s, ďalší výskyt v %s"
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "premenná prostredia; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Nesprávny popis voľby %r, má vyzerať ako „opt”, „-opt argumenty”, „--opt argumenty”, „/opt argumenty” alebo „+opt argumenty”"
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s voľba príkazového riadka"
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "voľba príkazového riadka"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "položke glosára musí predchádzať prázdny riadok"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "položky glosára nesmú byť oddelené prázdnymi riadkami"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "glosár vyzerá byť zle naformátovaný, skontrolujte odsadenie"
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "termín glosára"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "jazykový token"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "menovka odkazu"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "premenná prostredia"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "voľba programu"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Index modulov"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Stránka hľadania"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "duplicitná menovka  %s, ďalší výskyt v %s"
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "duplicitný %s popis %s, ďalší výskyt v %s"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig je vypnutý, :numref: je ignorované."
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "Zlyhalo vytvorenie krížového odkazu. Nie je priradené žiadne číslo: %s"
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "odkaz nemá popisok: %s"
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "neplatný numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "neplatný numfig_format: %s"
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "nedefinovaná menovka: %s"
+msgid "undefined label: %r"
+msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "Zlyhalo vytvorenie krížového odkazu. nenájdení názov alebo titulok: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "nová konfigurácia"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "zmenená konfigurácia"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "zmenené rozšírenie"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "prostredie zostavenia nie je aktuálne"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "zdrojový adresár zmenený"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Toto prostredie nie je kompatibilné zo zvoleným zostavovačom, prosím, zvoľte iný adresár doctree."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "Zlyhalo skenovanie dokumentov v %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Doména %r nie je zaregistrovaná"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "nájdený na seba odkazujúci strom obsahu. Ignorované."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "dokument nie je zahrnutý v žiadnom strome obsahu"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "viď %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "viď aj %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "neznámy typ položky indexu %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Symboly"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "zistený cirkulárny odkaz stromu obsahu, ignorované: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "strom obsahu obsahuje odkaz na dokument %r, ktorý nemá názov, odkaz nebude generovaný"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "súbor obrázku nemožno čítať: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr " Súbor obrázku %s nemožno čítať: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "súbor na stiahnutie nemožno čítať: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s už je priradené číslo sekcie (vnorený číslovaný strom obsahu?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2434,209 +2437,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "cesta k dokumentovanému modulu"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "adresár umiestnenia výstupu"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "maximálna hĺbka submodulov, ktorá má byť zobrazená v obsahu (predvolene: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "prepísať existujúce súbory"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "nasledovať symbolické odkazy. Vhodné v kombinácii s collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "spustí skript bez vytvorenia súborov"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "umiestniť dokumentáciu každého modulu vo vlastnej stránke"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "zahrnúť ”_súkromné” moduly"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "meno súboru obsahu (predvolene: modules)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "nevytvárať súbor obsahu"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "vložiť dokumentáciu modulu pred dokumentáciou submodulu"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpretovať cesty modulov v zmysle implicitnej špecifikácie menných priestorov PEP-0420"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "prípona súboru (predvolene: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "generovať úplný projekt pomocou sphinx-quickstart"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "pripojiť module_path do sys.path, použité pri --full"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "meno projektu (predvolene: meno koreňového modulu)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "autor(i) projektu, použité pri --full"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "verzia projektu, použité pri --full"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "vydanie projektu, použité pri --full, predvolene --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "voľby rozšírenia"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s nie je adresár."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "neplatný regulárny výraz %r v %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "neplatný regulárny výraz %r v coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr "nedokumentované API C: %s %s v súbore %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "modul %s nemožno importovať: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "nedokumentovaná funkcia Python: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "nedokumentovaná trieda Python: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "nedokumentovaná metóda Python: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "chýbajúce „+” alebo „-” vo voľbe „%s”."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' nie je platná voľba."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "„%s” nie je platná voľba pyversion"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "neplatný typ TestCode"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Direktíva graphviz nemôže mať naraz argumenty content a filename"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "Externý súbor Graphviz %r nebol nájdený alebo zlyhalo jeho čítanie"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Ignorovaná direktíva „graphviz” bez obsahu."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2646,14 +2654,14 @@
 "%r"
 msgstr "dot nevytvoril výstupný súbor:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "príkaz dot %r nemožno spustiť (nutný kvôli výstupu graphviz), skontrolujte nastavenie graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2663,33 +2671,35 @@
 "%r"
 msgstr "dot skončil chybou:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format musí byť „png” alebo „svg”, ale je %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "kód dot %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "graf: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "graf"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "príkaz convert %r nemožno spustiť, skontrolujte nastavenia image_converter: 1%s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2699,163 +2709,173 @@
 "%r"
 msgstr "convert skončil chybou:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "príkaz convert %r nemožno spustiť, skontrolujte nastavenie image_converter"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Nemožno spustiť príkaz LaTeX %r (potrebný na zobrazenie math), skontrolujte nastavenia imgmath_latex"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "zobrazený latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "vnorený latex %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Trvalý odkaz na tento vzorec"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "inventár intersphinx bol presunutý: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "načítanie inventára intersphinx z %s..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "nastali problémy s niektorými inventármi, ale boli nájdené funkčné alternatívy:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "nemožno získať žiadne inventáre kvôli týmto problémom:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(v %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(v %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "identifikátor intersphinx %rnie je raťzec, ignorované"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "Zlyhalo čítanie intersphinx_mapping%s, ignorované: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "zdroj"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "ToDo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "Nájdená položka TODO: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<pôvodná položka>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> je umiestnená v %s, riadok %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "pôvodná položka"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "zvýrazňovanie syntaxe kódu modulu... "
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumenty"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Kód modulu"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Zdrojový kód %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Prehľad: kód modulu"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Všetky moduly, pre ktoré je dostupný kód</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "chyba formátovania argumentov %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "chýba atribút %s objektu %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2863,113 +2883,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "„::” v automodule nedáva zmysel"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ má byť zoznam reťazcov, nie %r (v module %s) -- ignorované __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "chýbajúci atribút spomenutý vo voľbe :members: : modul %s, atribút %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Základ: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "chýba atribút %s objektu %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "alias pre %s"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "alias pre TypeVar(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "Neplatné __slots__ nájdené v %s. Ignorované."
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "Zlyhalo spracovanie predvolenej hodnoty argumentu %r: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "Autosummary s popiskom vyžaduje voľbu :toctree: , ignorované."
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2977,46 +2996,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "zlyhalo spracovanie mena %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "zlyhal import objektu %s"
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: súbor nenájdený: %s"
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary interne generuje súbory .rst. Ale Váš source_suffix neobsahuje .rst. Preskočené."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3024,7 +3043,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3039,138 +3058,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "adresár umiestnenia výstupu"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "predvolená prípona súboru (predvolene: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "vlastný adresár šablón (predvolene: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "dokumentovať importovaných členov (predvolene: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumenty kľúčových slov"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Príklad"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Príklady"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Poznámky"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Ostatné parametre"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Varovania"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "neplatná hodnota množiny (chýba koncová zátvorka): %s"
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "neplatná hodnota množiny (chýba začiatočná zátvorka): %s"
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "neplatná textová konštanta (chýba koncová úvodzovka): %s"
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "neplatná textová konštanta (chýba začiatočná úvodzovka): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Výstraha"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Upozornenie"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Nebezpečné"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Chyba"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Rada"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Dôležité"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Poznámka"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Viď aj"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tip"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Varovanie"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "pokračovanie z predošlej strany"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "pokračuje na ďalšej strane"
@@ -3192,7 +3211,7 @@
 msgid "Table of Contents"
 msgstr "Obsah"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Hľadať"
@@ -3273,35 +3292,35 @@
 msgid "Navigation"
 msgstr "Navigácia"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Hľadať v %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "O dokumentácii"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Autorské právo"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Copyright %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Naposledy aktualizované %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3346,12 +3365,12 @@
 msgstr "hľadať"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Výsledky hľadania"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3393,280 +3412,278 @@
 msgid "Other changes"
 msgstr "Ostatné zmeny"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Trvalý odkaz na tento nadpis"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Trvalý odkaz na túto definíciu"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Skryť výsledky hľadania"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Hľadanie"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Príprava hľadania..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Hľadanie dokončené, nájdené %s strana(y), ktoré vyhovujú hľadanému výrazu."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", v "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Rozbaliť bočný panel"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Skryť výsledky hľadania"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Zbaliť bočný panel"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Rozbaliť bočný panel"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Obsah"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Poznámka pod čiarou %s nie je odkazovaná."
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "Poznámka pod čiarou # nie je odkazovaná."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "viac ako jeden cieľ krížového odkazu %r: môže byť %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "%r cieľ odkazu nenájdený: %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "Nemožno získať vzdialený obrázok: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "Nemožno získať vzdialený obrázok: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Neznámy formát obrázku: %s..."
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "nedekódovateľné zdrojové znaky, nahradené „?”: %r"
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "preskočené"
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "zlyhalo"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "neznáma direktíva alebo meno role: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "neznámy typ uzla: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "chyba čítania: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "chyba zápisu: %s: %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Neplatný formát dátumu. Použije jednoduché úvodzovky, ak ho chcete priamo vo výstupe: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "strom obsahu obsahuje neexistujúci súbor %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "predvolená rola  %s nenájdená"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Trvalý odkaz na túto definíciu"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "nie je definovaný numfig_format pre %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Žiadne ID nie je priradené uzlu %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "Trvalý odkaz na tento termín"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Trvalý odkaz na túto tabuľku"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Trvalý odkaz na tento kód"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Trvalý odkaz na tento obrázok"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Trvalý odkaz na tento strom obsahu"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "Nemožno získať veľkosť obrázku. voľba :scale: je ignorovaná."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr "príliš veľké :maxdepth:, ignorované."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "názov dokumentu nie je jeden uzol Text"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Poznámky pod čiarou"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "sú zadané obe, tabularcolumns aj voľba :widths:. :widths: je ignorované."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "obrázok: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "obrázok"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "titulok nie je vo vnútri figure."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "neimplementovaný typ uzla: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sl/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sl/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sl/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sl/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sl/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sl/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Slovenian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sl\n"
 "Plural-Forms: nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Vgrajeni deli"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Nivo modula"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (v "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Splošni abecedni seznam"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "abecedni seznam"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "naprej"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "nazaj"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Abecedni seznam"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Izdaja"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Avtor sekcije: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Avtor modula: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Avtor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametri"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Vrne"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Vrne tip"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "član"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funkcija"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "tip"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Novo v verziji %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Spremenjeno v verziji %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Zastarelo od verzije %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "razred"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (vgrajene funkcije)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metoda)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (razred)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s atribut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "ključna beseda"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "izjema"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "izjava"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "vgrajene funkcije"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Sproži izjemo"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (v modulu %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (v modulu %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (vgrajene spremenljivke)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (vgrajen razred)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (razred v %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statična metoda)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "Moduli"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Zastarelo"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statična metoda"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (zastarelo)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "okoljska spremenljivka; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "okoljska spremenljivka"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Seznam modulov"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Iskalnik"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Pozor"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Previdno"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Nevarno"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Napaka"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Nasvet"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Pomembno"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Opomba"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Poglej Tudi"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Nasvet"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Opozorilo"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "nadaljevanje iz prejšnje strani"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Išči"
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr "Navigacija"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Išči med %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "O dokumentih"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Vse pravice pridržane"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Zadnjič posodobljeno %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr "išči"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Rezultati Iskanja"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr "Ostale spremembe"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Povezava na naslov"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Povezava na to definicijo"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Skrij resultate iskanja"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr ""
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Skrij resultate iskanja"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Povezava na to definicijo"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Opombe"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "slika"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sphinx.pot -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sphinx.pot Changed

@@ -1,139 +1,139 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
-# FIRST AUTHOR <EMAIL@ADDRESS>, 2022.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2023.
 #
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Sphinx 4.4.0\n"
+"Project-Id-Version: Sphinx 6.2.0\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with"
 " this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -141,12 +141,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -154,65 +154,71 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called "
 "sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,904 +226,899 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but "
 "`{current}` is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it"
 " should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since "
-"Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid ""
 "conf value \"epub_language\" (or \"language\") should not be empty for "
 "EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid ""
 "conf value \"epub_title\" (or \"html_title\") should not be empty for "
 "EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid ""
 "conf value \"epub_copyright\" (or \"copyright\")should not be empty for "
 "EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the"
 " index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all"
 " config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1126,94 +1127,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue "
 "to the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1236,236 +1237,231 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\""
 " will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 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 "
@@ -1473,11 +1469,11 @@
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; "
 "\"_templates\"\n"
@@ -1487,23 +1483,23 @@
 "underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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 +1508,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1531,21 +1527,21 @@
 "language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1553,36 +1549,36 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root "
 "path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has"
 " been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that "
 "you\n"
@@ -1590,29 +1586,29 @@
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other "
@@ -1620,26 +1616,26 @@
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1650,231 +1646,231 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid ""
 "\"quiet\" is specified, but any of \"project\" or \"author\" is not "
 "specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a "
 "new root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try "
 "giving an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path"
 " as a relative path from source directory. Please update your document."
@@ -1885,414 +1881,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: "
 "for one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\","
 " \"--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2302,142 +2299,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose"
 " another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no "
 "link will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and "
@@ -2452,206 +2454,211 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2661,14 +2668,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2678,32 +2685,37 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
-msgid "convert command %r cannot be run, check the image_converter setting: %s"
+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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2713,156 +2725,166 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the "
 "imgmath_%s setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had "
 "working alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following "
@@ -2870,7 +2892,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2878,112 +2900,111 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of "
-"\"alphabetic\". Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2991,29 +3012,29 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does "
 "not contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following "
@@ -3021,17 +3042,17 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3039,7 +3060,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3056,138 +3077,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3209,7 +3230,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3290,35 +3311,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3363,12 +3384,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words "
 "are spelled correctly and that you've selected enough categories."
@@ -3410,277 +3431,274 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid "Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated:"
 " {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a"
 " bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role "
 "is not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to "
 "output it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sq/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sq/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Subjekti pasues",
         "Other changes": "Ndryshime t\u00eb tjera",
         "Overview": "P\u00ebrmbledhje",
-        "Permalink to this definition": "Permalidhje p\u00ebr te ky p\u00ebrkufizim",
-        "Permalink to this headline": "Permalidhje te ky titull",
         "Please activate JavaScript to enable the search\n    functionality.": "Q\u00eb t\u00eb aktivizohet funksioni i k\u00ebrkimit, ju lutemi, aktivizoni\n    JavaScript-in.",
         "Preparing search...": "Po p\u00ebrgatitet k\u00ebrkim...",
         "Previous topic": "Subjekti i m\u00ebparsh\u00ebm",
@@ -39,7 +37,7 @@
         "Search": "K\u0113rko",
         "Search Page": "Faqe K\u00ebrkimesh",
         "Search Results": "P\u00ebrfundime K\u00ebrkimi",
-        "Search finished, found %s page(s) matching the search query.": "K\u00ebrkimi p\u00ebrfundoi, u gjet\u00ebn %s page(s) me p\u00ebrputhje me shprehjen e k\u00ebrkuar.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "K\u00ebrkimi p\u00ebrfundoi, u gjet\u00ebn ${resultCount} faqe me p\u00ebrputhje me vargun e k\u00ebrkimit.",
         "Search within %(docstitle)s": "K\u00ebrkoni brenda %(docstitle)s",
         "Searching": "K\u00ebrkim",
         "Searching for multiple words only shows matches that contain\n    all words.": "K\u00ebrkimi p\u00ebr disa fjal\u00eb nj\u00ebher\u00ebsh shfaq vet\u00ebm p\u00ebrputhje q\u00eb\n    p\u00ebrmbajn\u00eb krejt fjal\u00ebt.",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sq/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sq/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sq/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sq/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 15:07+0000\n"
-"Last-Translator: Besnik Bleta <besnik@programeshqip.org>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Besnik Bleta <besnik@programeshqip.org>, 2021-2022\n"
 "Language-Team: Albanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sq/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sq\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "S’gjendet dot drejtori burim (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "Drejtoria e përfundimeve (%s) s’është drejtori"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Drejtoria burim dhe drejtoria vendmbërritje s’mund të jenë identike"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Po xhirohet Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Ky projekt lyp të paktën Sphinx v%s, ndaj s’mund të montohet me këtë version."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "po krijohet drejtori përfundimesh"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "teksa ujdiset zgjerimi %s:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "'setup' siç është përcaktuar aktualisht te conf.py s’është funksion Python që mund të thirret. Ju lutemi, ndryshojeni përcaktimin e tij që ta bëni një funksion që mund të thirret. Kjo është e nevojshme që conf.py të sillet si një zgjerim Sphinx."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "po ngarkohen përkthime %s… "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "u bë"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "s’është i passhëm për mesazhe të brendshëm"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "dështoi: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "S’u përzgjodh montues, po përdoret parazgjedhja: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "doli me sukses"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "u përfundua me probleme"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "montimi %s, % sinjalizim (me sinjalizime të trajtuara si gabime)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "montimi %s, %s sinjalizime (me sinjalizime të trajtuara si gabime)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "build %s, %s warning."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "montimi %s, %s sinjalizime."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "montimi %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "klasa %r e nyjeve është e regjistruar tashmë, vizitorët e saj do të anashkalohen"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "direktiva %r është e regjistruar tashmë, do të anashkalohet"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "roli %r është e regjistruar tashmë, do të anashkalohet"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për lexim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "zgjerimi %s s’është i sigurt për lexim paralel"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për shkrim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "zgjerimi %s s’është i sigurt për shkrim paralel"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "drejtoria e formësimeve nuk përmban një kartelë conf.py (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "U gjet vlerë e pavlefshme formësimi: 'language = Asnjë'. Përditësojeni formësimin tuaj me një kod të vlefshëm gjuhe. Përkohësisht po përdoret 'en' (anglisht)."
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "s’mund të anashkalohet rregullim formësimi fjalorthi %r, po shpërfillet (për të ujdisur elemente individuale, përdorni %r)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "numër %r i pavlefshëm për vlerë formësimi %r, po shpërfillet"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "s’mund të anashkalohet rregullim formësimi %r me një lloj të pambuluar, po shpërfillet"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "vlerë e panjohur formësimi %r te anashkalimi, po shpërfillet"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "S’ka vlerë të tillë formësimi: %s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Vlerë formësimi %r e pranishme tashmë"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Ka një gabim sintakse te kartela juaj e formësimit: %s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Kartela e formësimit (ose një nga modulet që ajo importon) thirri sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr "Ka një gabim të programueshëm te kartela juaj e formësimit:\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "Vlera e formësimit `source_suffix' pret një varg, një listë vargjesh, ose një fjalor. Por është dhënë `%r'."
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Ndarja %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Figura %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tabela %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "Vlera e formësimit `{name}` duhet të jetë një nga {candidates}, por është dhënë `{current}`."
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}'; pritej {permitted}."
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}', si parazgjedhje merr `{default.__name__}'."
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "s’u gjet primary_domain %r, po shpërfillet."
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "Që prej v2.0, Sphinx përdor \"index\" për root_doc, si parazgjedhje. Ju lutemi, shtoni \"root_doc = 'contents'\" te conf.py juaj."
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Vlerë formësimi %r e pranishme tashmë"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Emër i panjohur akti: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "Trajtuesi %r për aktin %r u përgjigj me një përjashtim"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "Zgjerimi %s është i domosdoshëm për needs_extensions settings, por s’është ngarkuar."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Ky projekt lyp zgjerimin %s të paktën nën versionin %s dhe prandaj s’mund të montohet me versionin e ngarkuar (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "u gjetën shumë kartela për dokumentin \"%s\": %r\nPërdorni %r për montimin."
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "dokument i palexueshëm. U shpërfill."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Klasa %s e montuesit nuk ka atribut \"name\""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Montuesi %r ekziston tashmë (te moduli %s)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Emër %s montuesi jo i regjistruar ose i passhëm përmes pike hyrjeje"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Emër montuesi %s jo i regjistruar"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "përkatësi %s e regjistruar tashmë"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "përkatësi %s ende e paregjistruar"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "Direktiva %r është e regjistruar tashmë te përkatësia %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "Roli %r është i regjistruar tashmë te përkatësia %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "Treguesi %r është i regjistruar tashmë te përkatësia %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "object_type %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "crossref_type %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "source_parser për %r është i regjistruar tashmë"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "Përtypës burimesh për %s jo i regjistruar"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Përkthyesi për %r ekziston tashmë"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "kwargs për add_node() duhet të jetë një çift funksioni (visit, depart): %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r tashmë i regjistruar"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "vizatuesi i formulave matematikore %s është i regjistruar tashmë"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "zgjerimi %r qe shkrirë me Sphinx-in që me versionin %s; ky zgjerim është shpërfillur."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Përjashtimi origjinal:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "S’u importua dot zgjerimi %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "zgjerimi %r s’ka funksion setup(); a është vërtet një modul zgjerimi Sphinx-i?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Zgjerimi %s i përdorur nga ky projekt lyp të paktën Sphinx v%s; prandaj s’mund të montohet me këtë version."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "zgjerimi %r u përgjigj me një objekt të pambuluar prej funksionit të vet setup(); duhet të përgjigjet me Asnjë ose një fjalorth tejtëdhënash"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr "numër PEP i pavlefshëm %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr "numër RFC i pavlefshëm %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "tema %r s’ka rregullimin \"theme\""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "tema %r s’ka rregullimin \"inherit\""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "s’u gjet temë e emërtuar %r, u trashëgua nga %r"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "rregullimi %s.%s nuk haset në asnjë prej formësimeve temash ku u kërkua"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "është dhënë mundësi teme %r e pambuluar"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "kartela %r te shteg teme s’është kartelë zip e vlefshme ose nuk përmban temë"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "U gjet sphinx_rtd_theme (< 0.3.0). S’do të jetë e passhme që prej Sphinx-6.0"
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "s’u gjet temë e emërtuar %r (mos mungon theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "po montohet mo: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "po shkruhet përfundim… "
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "krejt kartelat po %d"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "objektiva për kartela po %d që janë specifikuar"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "objektiva për kartela po %d që janë të papërditësuara"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "krejt kartelat burim"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "kartela %r e dhënë te rresht urdhrash s’gjendet te drejtori burim, po shpërfillet"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "kartela %r e dhënë te rresht urdhrash s’ekziston, po shpërfillet"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "kartela burim %d dhënë te rresht urdhrash"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "objektiva për kartela burim %d që janë të papërditësuara"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "po montohet %s: "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "po shihet për kartela të sapovjetruara… "
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "U gjet %d"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "s’u gjet gjë"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "po kontrollohet njëtrajtshmëria"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "s’ka objektiva të vjetruar."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "po përditësohet mjedisi: "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s të shtuar, %s të ndryshuar, %s të hequr"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "po lexohen burime… "
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "po pritet për workers…"
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "emra dokumentesh për shkrim: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "po përgatiten dokumente"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "u gjet zë TeL i përsëdytur: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "po kopjohen figura… "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "s’lexohet dot kartelë figure %r: në vend të tij, po kopjohet"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "s’kopjohet dot kartelë figure %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "s’shkruhet dot kartelë figure %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "S’u gjet Pillow - po kopjohen kartela figurë"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "po shkruhet kartelë llojesh MIME…"
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "po shkruhet kartelë META-INF/container.xml…"
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "po shkruhet kartelë content.opf…"
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "lloj MIME i panjohur për %s, po shpërfillet"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "po shkruhet kartelë toc.ncx…"
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "po shkruhet kartelë %s…"
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Kartela përmbledhje gjendet te %(outdir)s."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "s’ka ndryshime në version %s."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "po shkruhet kartelë përmbledhje…"
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Të brendshme"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Shkallë moduli"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "po kopjohen kartela burim…"
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "s’u lexua dot %r për krijim regjistrimi ndryshimesh"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "Montuesi provë nuk prodhon kartela."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "Kartela ePub gjendet te %(outdir)s."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "po shkruhet kartelë nav.xhtml…"
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_language\" (ose \"language\") s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "vlera e formësimit \"epub_uid\" duhet të jetë XML NAME për EPUB3"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_title\" (ose \"html_title\") s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_author\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_contributor\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_description\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_publisher\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_copyright\" (ose \"copyright\") s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"epub_identifier\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "vlera e formësimit \"version\" s’duhet të jetë e zbrazët për EPUB3"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "css_file e pavlefshme: %r, u shpërfill"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "Katalogët e mesazheve gjenden te %(outdir)s."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "objektiva për kartela gjedhe %d"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "po lexohen gjedhe… "
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "po shkruhen katalogë mesazhesh… "
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Shihni për çfarëdo gabimesh te përfundimi më sipër ose te %(outdir)s/output.txt"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "lidhje e dëmtuar: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "S’u gjet spirancë '%s'"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr "S’u arrit të përpilohet shprehje e rregullt te linkcheck_allowed_redirects: %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Faqet e doracakut gjenden në %(outdir)s."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "s’u gjet vlerë formësimi \"man_pages\"; s’do të shkruhet ndonjë faqe doracaku"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "po shkruhet"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "vlera e formësimit \"man_pages\" i referohet një dokumenti të panjohur %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "Faqja HTML gjenden në %(outdir)s."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "po montohet dokument njësh"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "po shkruhen kartela shtesë"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Kartelat Texinfo gjenden në %(outdir)s."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nXhironi 'make' te ajo drejtori, që të xhirohen këto përmes makeinfo-s\n(përdorni këtu 'make info' që kjo të kryhet automatikisht)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "po përpunohet %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "po shquhen referencat…"
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (në "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "po kopjohen kartela mbulimi Texinfo"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "gabim në shkrim kartele Makefile: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Kartelat tekst gjenden në %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "gabim në shkrim kartele %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "Kartelat XML gjenden në %(outdir)s."
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Kartelat pseudo-XML gjenden në %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "kartela e të dhënave të montimit është e dëmtuar: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "Faqet HTML gjenden në %(outdir)s."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "S’u arrit të lexohet kartelë të dhënash montimi: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Tregues i Përgjithshëm"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "tregues"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "pasuesi"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "i mëparshmi"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "po prodhohen tregues"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "po shkruhen faqe shtesë"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "po kopjohen kartela të shkarkueshme… "
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "s’kopjohet dot kartelë e shkarkueshme %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr "S’u arrit të kopjohet një kartelë te html_static_file: %s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr "po kopjohen kartela statike"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "s’kopjohet dot kartelë statike %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "po kopjohen kartela ekstra"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "s’kopjohet dot kartelë ekstra %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "S’u arrit të shkruhet kartelë të dhënash montimi: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "treguesi i kërkimi s’u ngarkua dot, por jo krejt dokumentet do të montohen: treguesi do të jetë i paplotë."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "faqja %s ka përputhje me dy rregullsi te html_sidebars: %r dhe %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "ndodhi një gabim Unikod, kur vizatohej faqja %s. Ju lutemi, siguroni që krejt vlerat e formësimit që përmbajnë lëndë jo-ASCII të jenë vargje Unikod."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "Ndodhi një gabim gjatë vizatimit të faqes %s.\nArsye: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "po shkruhet lënda e treguesit të kërkimeve në %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "js_file e pavlefshme: %r, u shpërfill"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Janë të regjistruar plot math_renderers. Por s’u përzgjodh math_renderer."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "U dha math_renderer %r i panjohur."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "zëri html_extra_path %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "zëri %r i html_extra_path entry është vendosur jashtë outdir-it"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "zëri html_static_path %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "zëri %r i html_extra_path entry është vendosur brenda outdir-it"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "kartela stemë %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "kartela favikonë %r s’ekziston"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr "html_add_permalinks është nxjerrë nga përdorimi që me v3.5.0. Ju lutemi, në vend të tyre përdorni html_permalinks dhe html_permalinks_icon."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr "Mbulimi për prodhim përfundimi në HTML 4 është nxjerrë nga përdorim dhe do të hiqet me Sphinx 7. (\"html4_writer=True pikasur te mundësi formësimi)"
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "Dokumentim i %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "Kartelat LaTeX gjenden në %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nXhironi 'make' te ajo drejtori që të xhirohen këto përmes (pdf)latex\n(që të bëhet kjo automatikisht, përdorni `make latexpdf' këtu)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Tregues"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Hedhje Në Qarkullim"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "s’ka mundësi Babel të njohur për gjuhën %r"
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr "po kopjohen kartela mbulimi TeX"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "po kopjohen kartela mbulimi TeX…"
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "po kopjohen kartela shtesë"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "Kyç i panjohur formësimi: latex_elements%r, u shpërfill."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr "Mundësi e panjohur teme: latex_theme_options%r, u shpërfill."
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r s’ka rregullimin \"theme\""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r s’ka rregullimin \"%s\""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Ndodhi një përjashtim gjatë montimit, po niset diagnostikuesi:"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "U ndërpre!"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "Gabim markup-i reST:"
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Gabim kodimi:"
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Traceback-u i plotë është ruajtur te %s, nëse doni t’ua raportoni problemin zhvilluesve."
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Gabim përsëritje:"
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr "Kjo mund të ndodhë me kartela burim shumë të mëdha ose të futura thellë brenda njëra-tjetrës. Mund të rrisni me kujdes kufirin parazgjedhje për ripërsëritje Python prej 1000, te conf.py, me p.sh.:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Ndodhi një përjashtim:"
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Ju lutemi, njoftojeni nëse qe një gabim përdoruesi, që kështu herës tjetër të mund të furnizohet një mesazh më i mirë gabimi."
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Një njoftim të mete mund të depozitohet te gjurmuesi në <https://github.com/sphinx-doc/sphinx/issues>. Faleminderit!"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "numri i aktit duhet të jetë një numër pozitiv"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr "Për më tepër hollësi, vizitoni <https://www.sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr "\nProdhoni dokumentim nga kartela burim.\n\nsphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos\nte OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi.\nMjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe,\npërfshi 'conf.py'\n\nsphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format\npërzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja,\nsi parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura\nme përpunim dokumentimi.\n\nSi parazgjedhje, gjithçka që është e papërditësuar, montohet. Nëse doni\nmontim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke\nspecifikuar emra kartelash individuale.\n"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "shteg për te kartela burimi dokumentimi"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "shteg për te drejtori përfundimesh"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "një listë kartelash specifike për rimontim. E shpërfillur, nëse jepet -a"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "mundësi të përgjithshme"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "montues për t’u përdorur (parazgjedhje: html)"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "shkruaj krejt kartelat (parazgjedhje: shkruaj vetëm kartela të reja dhe ato të ndryshuara)"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "mos përdor një mjedis të ruajtur, lexo përherë krejt kartelat"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr "shteg për mjedis të ruajtur në fshehtinë dhe kartela doctree (parazgjedhje: OUTPUTDIR/.doctrees)"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "montoje në paralel me N procese, kur është e mundur (vlera speciale “auto”\" do ta vërë N-në sa cpu-count)"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "shteg ku gjendet kartelë formësimi (conf.py) (parazgjedhje: i njëjtë me SOURCEDIR)"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr "mos përdor fare kartelë formësimesh, vetëm mundësitë -D"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "anashkalo një rregullim te kartelë formësimi"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "jep një vlerë te gjedhe HTML"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr "përcaktoni etiketë: përfshi blloqe “only” me TAG"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr "mënyrë gërricëse, sinjalizo mbi krejt referencat që mungojnë"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "mundësi për ç’prodhon konsola"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "pa output në stdout, thjesht sinjalizime në stderr"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr "pa output fare, madje as sinjalizime"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr "shkruaj sinjalizime (dhe gabime) te kartela e dhënë"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "shndërroji sinjalizimet në gabime"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr "me -W, vazhdo punën, kur merren sinjalizime"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "xhiro Pdb, në rast përjashtimesh"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "s’gjenden dot kartela %r"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "s’mund të ndërthuret një mundësi -a dhe emra kartelash"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "s’hapet dot kartelë sinjalizimesh %r: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "argumenti i mundësisë -D duhet të jetë në formën emër=vlerë"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "argumenti i mundësisë -A duhet të jetë në formën emër=vlerë"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "fut automatikisht docstrings prej modulesh"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "testo automatikisht copëza kodi te blloqe doctest"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "lidhje mes dokumentimi Sphinx projektesh të ndryshëm"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "shkruaj zëra \"todo\" që mund të shfaqen ose fshihen te montimi"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "kontrolle për mbulim dokumentimi"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "përfshi formula matematikore, të vizatuara si figura PNG ose SVG"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "përfshi formula matematikore, të vizatuara te shfletuesi nga MathJax"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "përfshirje e kushtëzuar lënde, bazuar në vlera formësimi"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "përfshi lidhje te kodi burim i objekteve Python të dokumentuara"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "krijo kartelë .nojekyll për të botuar dokumentin në faqe GitHub"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Ju lutemi, jepni një emër shtegu të vlefshëm."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Ju lutemi, jepni ca tekst."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Ju lutemi, jepni një nga %s."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Ju lutemi, jepni 'y' ose 'n'."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Ju lutemi, jepni një prapashtesë kartele, për shembull, '.rst' ose '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Mirë se vini te mjeti për fillim të shpejtë me Sphinx %s."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Ju lutemi, jepni vlera për rregullimet vijuese (thjesht shtypni tastin\nEnter që të pranohet një vlerë parazgjedhje, nëse është një e tillë\nbrenda kllapave)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Shteg rrënjë i përzgjedhur: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Jepni shtegun rrënjë për te dokumenti."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Shteg rrënje për te dokumenti"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Gabim: te shtegu rrënjë i përzgjedhur u gjet një conf.py ekzistues."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart s’do të mbishkruajë projekte ekzistuese Sphinx."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Ju lutemi, jepni një shteg të ri rrënjë (ose thjesht shtypni tastin Enter, që të dilet)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Keni dy mundësi për vendosjen e drejtorisë së montimeve për çka prodhon Sphinx-i.\nPërdorni një drejtori \"_build\" brenda shtegut rrënjë, ose i ndani\ndrejtoritë \"burim\" dhe \"montim\" brenda shtegut rrënjë."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Nda veçmas drejtoritë burim dhe montim (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Brenda drejtorisë rrënjë do të krijohen dy drejtori të tjera; \"_templates\" për\ngjedhe vetjake HTML, dhe \"_static\" për fletëstile vetjakë dhe kartela të tjera statike.\nMund të krijoni një tjetër parashtesë (bie fjala, \".\") në vend të nënvijës."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Parashtesë emrash për drejtori gjedhesh dhe statikesh"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Emri i projektit do të shfaqet në disa vende te dokumentimi i montuar."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Emër projekti"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Emër(a) autori(ësh)"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr "Sphinx-i përdor nocionet e “versionit” dhe “hedhjes në qarkullim” për\nsoftware-in. Çdo version mund të ketë hedhje të shumta në qarkullim.\nBie fjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja\nnë qarkullim ngjan me 2.5.1 ose 3.0a1.  Nëse kjo strukturë duale s’ju\nhyn në punë, thjesht vëruni të dyjave të njëjtën vlerë."
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Version projekti"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Hedhje në qarkullim e projektit"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Nëse dokumentet janë shkruan në gjuhë tjetër nga anglishtja,\nmund të përzgjidhni një gjuhë këtu, përmes kodit të asaj gjuhe. Sphinx-i mandej\ndo të përkthejë në atë gjuhë tekstin që prodhon.\n\nPër një listë kodesh të mbuluar, shihni\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Gjuhë projekti"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr "Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo\nështë ose \".txt\", ose \".rst\".  Vetëm kartelat me këtë prapashtesë\nmerren si dokumente."
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Prapashtesë kartele burim"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "Një dokument është i veçantë, për faktin se konsiderohet si nyja e epërme\ne  \"pemës së lëndës\", domethënë, është rrënja e strukturës hierarkike\ntë dokumenteve. Zakonisht, ky është \"index\", por nëse dokumenti juaj \"index\"\nështë një gjedhe vetjake, si të tillë mund të caktoni një tjetër emër kartele."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Emër i dokumentit tuaj kryesor (pa prapashtesë)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Gabim: kartela master %s është gjetur tashmë një herë në shtegun rrënjë të përzgjedhur."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart s’do të mbishkruajë kartelën ekzistuese."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Ju lutemi, jepni një emër të ri kartele, ose riemërtojeni kartelën ekzistuese dhe shtypni tastin Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Përcaktoni se cilët nga zgjerimet vijuese Sphinx duhen aktivizuar:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Shënim: imgmath dhe mathjax s’mund të aktivizohen në të njëjtën kohë. U hoqë përzgjedhja e imgmath-it."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Për ju mund të prodhohen një kartelë makefile dhe një urdhrash Windows, që\nkështu t’ju duhet vetëm të xhironi, për shembull, `make html', në vend se\ntë thirret drejtpërsëdrejti sphinx-build."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Të krijohet Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Të krijohet kartelë urdhrash Windows? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "Po krijohet kartela %s."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "Ka tashmë një kartelë %s, po anashkalohet."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Përfundoi: U krijua një strukturë fillestare drejtorish."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Tani duhet të populloni kartelën tuaj master file %s dhe të krijoni kartela të tjera\nburim të dokumentimit. "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Përdorni Makefile-in që të montohen dokumentet, kështu:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Përodrni urdhrin sphinx-build që të montohen dokumentet, kështu:\n   sphinx-build -b montues %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "ku montues është një nga montuesin e mbuluar, p.sh., html, latex ose linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nProdho kartelat e domosdoshme për një projekt Sphinx.\n\nsphinx-quickstart është një mjet ndërveprues që bën disa pyetje rreth projektit\ntuaj dhe mandej prodhon një drejtori të plotë dokumentimi dhe një shembull\nMakefile për t’u përdorur me sphinx-build.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "mënyra pa zhurmë"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "rrënjë e projektit"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Mundësi strukture"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "nëse është kërkuar, nda veçmas drejtoritë burim dhe montim"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "në u përcaktoftë, krijo drejtori montimi nën drejtorinë burim"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "zëvendësim për pikën te _templates, etj."
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Mundësi bazë të projektit"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "emër projekti"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "emra autorësh"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "version i projektit"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "hedhje në qarkullim e projektit"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "gjuhë dokumenti"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "prapashtesë kartele burim"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "emër dokumenti bazë"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "përdor epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Mundësi zgjerimi"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "aktivizo zgjerimin %s"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "aktivizo zgjerime arbitrare"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Krijim makefile-i dhe batchfile-i"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "krijo makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "mos krijo makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "krijo batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "mos krijo batchfile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "përdor make-mode për Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "mos përdor make-mode për Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Gjedhe projekti"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "drejtori gjedhesh për kartela gjedhe"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "përkufizoni një ndryshore gjedheje"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" është specifikuar, por s’është specifikuar ndonjë \"projekt\" ose \"autor\"."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Gabim:shtegu i dhënë s’është drejtori, ose kartelat sphinx ekzistojnë tashmë."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart prodhon vetëm te një drejtori e zbrazët. Ju lutemi, specifikoni një shteg rrënjë të ri."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Ndryshore e pavlefshme gjedheje: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Titull i pavlefshëm: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "numri i specifikuar për rreshtin është jashtë intervali (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "S’mund të përdoren në të njëjtën kohë të dyja mundësitë \"%s\" \"%s\""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "S’u gjet kartelë “include” %r, ose leximi i saj dështoi"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "Kodimi %r i përdorur për lexim të kartelës “include” %r duket të jetë i gabuar, provoni të jepni një mundësi :encoding:"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "Objekti i emërtuar %r s’u gjet te kartelë include %r"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree përmban referencë ndaj dokumenti %r të përjashtuar"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree përmban referencë ndaj dokumenti %r që s’ekziston"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr "zë i përsëdytur, gjetur te toctree: %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Autor ndarjeje: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Autor moduli: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Autor kodi: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Autor: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,414 +1865,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr "Deklarim C i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. c:%s:: %s'."
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametra"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Kthime"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Lloj kthimi"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "anëtar"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "ndryshore"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funksion"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "bashkim"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "lloj"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "parametër funksioni"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Të reja në versionin %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Ndryshuar në versionin %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Nxjerrë nga përdorimi që me versionin %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "citim i përsëdytur %s, tjetër instancë te %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Përmendja %s s’është në referencë."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr "Deklarim C++ i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. cpp:%s:: %s'."
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Parametra Gjedhesh"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klasë"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "koncept"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "parametër gjedheje"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (funksion i brendshëm)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (metodë %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klasë)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s ( ndryshore globale ose konstante)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (atribut %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argumente"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metodë"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "të dhëna"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "atribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "përshkrim %s i përsëdytur i %s, tjetër %s në %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "etiketë e përsëdytur ekuacioni %s, instancë tjetër te %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "math_eqref_format i pavlefshëm: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "fjalëkyç"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "përjashtim"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "deklarim"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "funksion i brendshëm"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Ndryshore"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (te moduli %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (te moduli %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (ndryshore e brendshme)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (klasë e brendshme)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klasë te %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (metodë klase %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s (veti %s)"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (metodë statike %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (veti %s)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Tregues Modulesh Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "module"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Nxjerrë nga përdorimi"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "metodë klase"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "metodë statike"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "veti"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "përshkrim i përsëdytur objekti për %s, instancë tjetër te %s, përdorni :noindex: për një prej tyre"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "për ndërreferencën %r u gjet më shumë se një objektiv: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (nxjerrë nga përdorimi)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktivë)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (mundësi direktive)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktivë"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rol"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "përshkrim i përsëdytur %s %s, instancë tjetër te %s"
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "ndryshore mjedisi; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Përshkrim i keqformuar mundësie %r, duhet të duket si \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" ose \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "Mundësi për rresht urdhrash %s"
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "mundësi për rresht urdhrash"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "termi i fjalorthit duhet të paraprihet nga një rresht i zbrazët"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "termat e fjalorthit s’duhet të paraprihet nga rreshta të zbrazët"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "fjalorthi duket të jetë i keformatuar, kontrolloni shmangie kryeradhe"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "term fjalorthi"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "etiketë reference"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "ndryshore mjedisi"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "mundësi programi"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "dokument"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Tregues Modulesh"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Faqe Kërkimesh"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "etiketë %s e përsëdytur, tjetër instancë te %s"
@@ -2285,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "përshkrim %s i përsëdytur për %s, tjetër instancë te %s"
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig është i çaktivizuar. :numref: është shpërfillur."
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "S’u arrit të krijohej një ndërreferencë. S’u caktua ndonjë numër: %s"
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "lidhja s’ka titull: %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "numfig_format i pavlefshëm: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "numfig_format i pavlefshëm: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "etiketë e papërcaktuar: %s"
+msgid "undefined label: %r"
+msgstr "etiketë e papërkufizuar: %r"
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "S’u arrit të krijohej një ndërreferencë. S’u gjet titull ose legjendë: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr "S’u arrit të krijohet ndërreferencë. S’u gjet një titull, ose një përshkrim: %r"
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "formësim i ri"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "formësimi ndryshoi"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "zgjerimet u ndryshuan"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "version jo i tanishëm i mjedisit të montimit"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "drejtoria burim ka ndryshuar"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Ky mjedis është i papërputhshëm me montuesin e përzgjedhur, ju lutemi, zgjidhni një tjetër drejtori doctree."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "S’u arrit të skanohen dokumente te %s: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Përkatësia %r s’është e regjistruar"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "U gjet “toctree” që i referohet vetes. U shpërfill."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "dokumenti s’është i përfshirë në ndonjë toctree"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "shihni %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "shihni edhe %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "lloj i panjohur zëri treguesi: %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Simbole"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "u pikasën referenca rrethore toctree-je, po shpërfllen: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree përmban referencë ndaj dokumenti %r që s’ka titull: s’do të prodhohet ndonjë lidhje"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "kartelë figure jo e lexueshme: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "kartelë figure %s jo e lexueshme: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "kartelë shkarkimi jo e lexueshme: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "Do të krijonte kartelë %s."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nShih në mënyrë rekursive te <MODULE_PATH> për module dhe\npaketa Python dhe krijo një kartelë reST me direktiva\nautomodulesh për paketë te <OUTPUT_PATH>.\n\n<EXCLUDE_PATTERN>s mund të jetë shprehje kartelash dhe/ose\ndrejtorish që mund të përjashtohen nga prodhimi.\n\nShënim: Si parazgjedhje, ky programth s’do të anashkalojë\nkartela të krijuara tashmë."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "shteg për te modul për te dokumenti"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "kartelë fnmatch-style dhe/ose rregullsi drejtorish për t’u përjashtuar prej prodhimit"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "drejtori ku të vendosen krejt përfundimet"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "thellësi maksimum nënmodulesh për shfaqje te TEL (parazgjedhje: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "mbishkruaj kartela ekzistuese"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "ndiq lidhje simbolike. E fuqishme, kur ndërthuret me collective.recipe.omelette."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "xhiroje programthin pa krijuar kartela"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "vendose dokumentim për çdo modul në faqe më vete"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "përfshi modulet \"_private\""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "emër kartele për tryezën e lëndës (parazgjedhje: modules)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "mos krijo një kartelë tryeze lënde"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "mos krijo krye për paketat modul/paketë (për shembull, kur ato i përmban tashmë docstrings)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "vendose dokumentimin e modulit përpara dokumentimit të nënmodulit"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "interpreto shtigje modulesh sipas specifikimeve impicite PEP-0420 për emërhapësira"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "prapashtesë kartele (parazgjedhje: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "prodho me sphinx-quickstart një projekt të plotë"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "shto module_path pas sys.path, e përdorur kur është dhënë --full"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "emër projekti (parazgjedhje: emër moduli rrënjë)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "autor(ë) projekti, e përdorur kur është dhënë --full"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "version projekti, e përdorur kur është dhënë --full"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "hedhje në qarkullim e projektit, e përdorur kur është dhënë --full, si parazgjedhje merr --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "mundësi zgjatimi"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s s’është drejtori."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr "shprehje e rregullt e pavlefshme %r te %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr "Testimi i mbulimit te burimet përfundoi, shihni te përfundimet në %(outdir)spython.txt."
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "shprehje e rregullt %r e pavlefshme te coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr "API C e padokumentuar: %s %s te kartela %s"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "moduli %s s’u importua dot: %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr "funksion python i padokumentuar: %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr "klasë python e padokumentuar: %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr "metodë python e padokumentuar: %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr "mungon '+' ose '-' te mundësia '%s'."
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr "'%s' s’është mundësi e vlefshme."
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr "'%s' s’është mundësi pyversion e vlefshme"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "lloj TestCode i pavlefshëm"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr "Testimi i doctests-eve te burimet përfundoi, shihni te përfundimet në %(outdir)s/output.txt."
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr "s’ka kod/dhënie te blloku %s në %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr "po shpërfillet kod “doctest” i pavlefshëm: %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr "=================== kohëzgjatjet më të ngadalta të leximit ==================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr "Një direktivë Graphviz s’mund të ketë edhe lëndë, edhe argument emri kartelash"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "S’u gjet kartelë e jashtme Graphviz %r, ose dështoi leximi i saj"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr "Po shpërfillet direktivë “graphviz” pa lëndë."
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr "dot s’prodhoi kartelë përfundim:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr "urdhri dot %r s’mund të xhirohet (i nevojshëm për çka prodhon graphviz), kontrolloni rregullimin graphviz_dot"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr "dot përfundoi me gabim:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr "graphviz_output_format duhet të jetë një nga 'png', 'svg', por është %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "kod dot %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "grafik: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "grafik"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
-msgstr "s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter: %s"
+"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"
+"\n"
+"Traceback: %s"
+msgstr "S’arrihet të xhirohet urdhri %r. për shndërrim figure. Si parazgjedhje, 'sphinx.ext.imgconverter' lyp ImageMagick. Sigurohuni se është i instaluar, ose për mundësinë 'image_converter' caktoni një urdhër vetjak shndërrimi .\n\nTraceback: %s"
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr "shndërrimi përfundoi me gabimin:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "Urdhri LaTeX %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_late"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "Urdhri %s %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_%s"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "shfaq latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "latex brendazi %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Permalidhje te ky ekuacion"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "inventari intersphinx është lëvizur: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "po ngarkohet inventari intersphinx prej %s…"
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr "u hasën disa probleme me disa nga inventare, por kishin alternativa funksionale:"
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "s’u arrit të kapej ndonjë inventar me problemet vijuese:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(te %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(te %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "s’u gjet objektiv reference të jashtme %s:%s: %s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "identifikuesi intersphinx %r s’është varg. U shpërfill"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "S’u arrit të lexohej intersphinx_mapping%s, u shpërfill: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "burim"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Për T’u Bërë"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "U gjet zë Për T’u Bërë: %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<zëri origjinal>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> gjendet te %s, rreshti %d.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "zëri origjinal"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "po theksohet kod moduli… "
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "dokumente"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Kod moduli"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Kod burim për %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Përmbledhje: kod moduli"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Krejt modulet për të cilët ka kod të gatshëm</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "vlerë e pavlefshme mundësie për member-order: %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "vlerë e pavlefshme për mundësinë class-doc-from: %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "nënshkrim i pavlefshëm për auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr "gabim gjatë formatimi argumentesh për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "atribut %s që mungon te objekt %s"
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc: s’u arrit të përcaktohet %s.%s (%r) për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr "s’dihet cili modul të importohet për vetëdokumentim të %r (provoni të vendosni te dokumenti një direktivë \"module\" ose \"currentmodule\", ose të jepni shprehimisht një emër moduli)"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "gabim gjatë formatimi nënshkrimesh për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" në emër automoduli nuk ka kuptim"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__ should duhet të jetë një listë vargjesh, jo %r (në module %s) -- ignoring __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "u përmend atribut që mungon në :members: mundësi: modul %s, atributi %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "S’u arrit të merret një nënshkrim funksioni për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "S’u arrit të merrej nënshkrim konstruktori për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "Baza: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "atribut %s që mungon te objekt %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "alias për %s"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "alias për TypeVar(%s)"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "S’u arrit të merre një nënshkrim metode për %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "U gjet __slots__ i pavlefshëm në %s. U shpërfill."
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr "autodoc_member_order tani pranon \"alphabetical\", në vend se \"alphabetic\". Ju lutemi, përditësoni rregullimin tuaj."
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "S’u arrit të përtypej një vlerë parazgjedhje argumenti për %r: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "S’u arrit të përditësohet nënshkrim për %r: s’u gjet parametër: %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "S’u arrit të përtypet type_comment për %r: %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "referenca vetëpërmbledhjeje përjashtuan dokumentin %r. U shpërfill."
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "vetëpërmbledhje: s’u gjet kartelë stub %r. Kontrolloni rregullimin tuaj autosummary_generate."
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "s’u arrit të përtypej emri %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "s’u arrit të importohej objekti %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: s’u gjet kartelë: %s"
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "vetëpërmbledhja prodhon së brendshmi kartela .rst. Por source_suffix juaj s’përmban .rst. U anashkalua."
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "vetëpërmbledhje: s’u arrit të përcaktohet %r për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "vetëpërmbledhje prodhim vetëpërmbledhje për: %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "vetëpërmbledhje po shkruhet te %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\nProdhoni ReStructuredText duke përdorur direktiva vetëpërmbledhje.\n\nsphinx-autogen është një ndërfaqe pamore për sphinx.ext.autosummary.generate. Prodhon\nkartela reStructuredText nga direktiva vetëpërmbledhjeje që përmbahen te\nkartelat e dhëna.\n\nFormati i direktivës vetëpërmbledhje dokumentohet te\nmoduli Python ``sphinx.ext.autosummary`` dhe mund të lexohet duke përdorur::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "kartela burim për të cilat të krijohen kartela rST"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "drejtori ku të vendosen krejt përfundimet"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "prapashtesë parazgjedhje për kartela (parazgjedhje: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "drejtori gjedhesh vetjake (parazgjedhje: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "pjesë të importuara të dokumentit (parazgjedhje: %(default)s)"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "Argumente Fjalëkyçi"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Shembull"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Shembuj"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Shënime"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Parametra të Tjerë"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Referenca"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Sinjalizime"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "u caktua vlerë e pavlefshme (mungon kllapë mbyllëse): %s"
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "u caktua vlerë e pavlefshme (mungon kllapë hapëse): %s"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "shprehje vargu e keqformuar (mungon thonjëz mbyllëse): %s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "shprehje vargu e keqformuar (mungon thonjëz hapëse): %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Vëmendje"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Kujdes"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Rrezik"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Gabim"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Ndihmëz"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "E rëndësishme"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Shënim"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Shihni edhe"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Ndihmëz"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Sinjalizim"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "vazhduar nga faqja e mëparshme"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "vazhdon në faqen pasuese"
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr "Tryeza e Lëndës"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Kērko"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "Lëvizje"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Kërkoni brenda %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Mbi këto dokumente"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Të drejta kopjimi"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Të drejta kopjimi</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Të drejta kopjimi %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Përditësuar së fundi më %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "kërko"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Përfundime Kërkimi"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr "Ndryshime të tjera"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Permalidhje te ky titull"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Permalidhje për te ky përkufizim"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Fshih Përputhje Kërkimi"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "Kërkimi përfundoi, u gjetën ${resultCount} faqe me përputhje me vargun e kërkimit."
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Kërkim"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Po përgatitet kërkim..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Kërkimi përfundoi, u gjetën %s page(s) me përputhje me shprehjen e kërkuar."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", në "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Zgjeroje anështyllën"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Fshih Përputhje Kërkimi"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Tkurre anështyllën"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Zgjeroje anështyllën"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Lëndë"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "U gjet tregues me bazë 4 shtylla. Mund të jetë një e metë e zgjerimeve që përdorni: %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "Poshtëshënimi %s s’është në referencë."
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "Poshtëshënimi # s’është në referencë."
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referenca pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "referenca pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referenca citimi pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "referenca citimi pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "u gjet më shumë se një objektiv për ndërreferencën 'any' %r: mund të ishte %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr "s’u gjet objektiv reference %s:%s: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "s’u gjet objektiv reference %r: %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "S’u pru dot figurë e largët: %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "S’u soll dot figurë e largët: %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Format i panjohur figure: %s…"
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "shenja burimi të padeshifrueshme, po zëvendësohen me \"?\": %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "e anashkaluar"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "e dështuar"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
-msgstr ""
+msgstr "Problem në përkatësinë %s: fusha supozohet të përdorë rol '%s', por ai rol s’gjendet te përkatësia."
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "emër direktive ose roli të panjohur: %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "lloj i panjohur nyjeje: %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "gabim leximi: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "gabim shkrimi: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "locale_dir %s s’ekziston"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "Format i pavlefshëm datash. Quote the string by single quote Nëse doni të jepet drejtpërsëdrejti, përdorni për vargun thonjëza njëshe: %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "“toctree” përmban referencë për te një kartelë joekzistuese %r"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "përjashtim teksa vlerësohej vetëm shprehje direktive: %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "s’u gjet rol parazgjedhje %s"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Permalidhje për te ky përkufizim"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format s’është i përcaktuar për %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "Çfarëdo ID-sh jo të përshoqëruara për nyjën %s"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "Permalidhje për te ky term"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "Permalidhje për te kjo krye"
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Permalidhje te kjo tabelë"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Permalidhje te ky kod"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Permalidhje te kjo figurë"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Permalidhje te kjo toctree"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "S’u mor dot madhësi figure. Mundësia :scale: u shpërfill."
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "toplevel_sectioning %r i panjohur për klasën %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: shumë i madh, u shpërfill."
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "titulli i dokumentit s’është nyje njëshe Teksti"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "u has nyje titulli jo në ndarje, temë, tabelë, paralajmërim ose anështyllë"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Poshtëshënime"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "janë dhënë që të dyja mundësitë, “tabularcolumns” dhe “:widths:”. shpërfillet :widths:."
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "njësia e përmasave %s është e pavlefshme. U shpërfill."
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "u gjet lloj i panjohur %s zërash treguesi"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "figurë: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "figurë"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "titull jo brenda një figure."
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "lloj nyjeje i pasendërtuar: %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u0421\u043b\u0435\u0434\u0435\u045b\u0438 \u043e\u0434\u0435\u0459\u0430\u043a",
         "Other changes": "\u0414\u0440\u0443\u0433\u0435 \u0438\u0437\u043c\u0435\u043d\u0435",
         "Overview": "\u041f\u0440\u0435\u0433\u043b\u0435\u0434",
-        "Permalink to this definition": "",
-        "Permalink to this headline": "",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "\u041f\u0440\u0438\u043f\u0440\u0435\u043c\u0430 \u043f\u0440\u0435\u0442\u0440\u0430\u0433\u0435...",
         "Previous topic": "\u041f\u0440\u0435\u0442\u0445\u043e\u0434\u043d\u0438 \u043e\u0434\u0435\u0459\u0430\u043a",
@@ -39,7 +37,7 @@
         "Search": "\u041f\u0440\u0435\u0442\u0440\u0430\u0433\u0430",
         "Search Page": "",
         "Search Results": "\u0420\u0435\u0437\u0443\u043b\u0442\u0430\u0442\u0438 \u043f\u0440\u0435\u0442\u0440\u0430\u0433\u0435",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "",
         "Searching": "\u041f\u0440\u0435\u0442\u0440\u0430\u0436\u0443\u0458\u0435 \u0441\u0435",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -9,134 +9,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Vladimir Milovanović <vmilovanovic@gmail.com>, 2020\n"
 "Language-Team: Serbian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sr\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Нема изворног директоријума (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Изворни и одредишни директоријум не могу бити једнаки"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Покрећем Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Овај пројекат захтева верзију Sphinx v%s или већу, не може се изградити инсталираном верзијом."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "учитавање превода %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "готово"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "Неуспешно: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "успешно"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "са грешкама"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,64 +157,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "Конфигурациони директоријум не садржи conf.py датотеку (%s)."
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -222,898 +228,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Одељак %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Сл. %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Табела %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Списак %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Догађај %r већ постоји"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Непознат догађај: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "Преводилац за %r већ постоји"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "све изворне датотеке"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "ажурирање окружења: "
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "припремање докумената"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "пребацивање слика... "
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "пребацивање изворних датотека..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (у "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "индекс"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "напред"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "назад"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "документација %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeX датотеке су у %(outdir)s."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\nПокрените 'make' у том директоријуму да бисте их пропустили кроз (pdf)latex\n(или употребите `make latexpdf' овде да се то одради аутоматски)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Индекс"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Издање"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1122,94 +1124,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1228,35 +1230,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1302,7 +1304,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1338,161 +1340,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Име пројекта"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Име(на) аутора"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1501,15 +1498,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Верзија пројекта"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Издање пројекта"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1519,21 +1516,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Језик пројекта"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Суфикс изворне датотеке"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1541,91 +1538,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1635,230 +1632,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "име пројекта"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "имена аутора"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "верзија пројекта"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "издање пројекта"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "језик пројекта"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "суфикс изворне датотеке"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "користи epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Аутор одељка: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Аутор модула: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Аутор кода: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Аутор: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1869,559 +1866,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Параметри"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Резултат"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Тип резултата"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "променљива"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "функција"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "тип"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Додато у верзији %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Измењено у верзији %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Застарело почевши од верзије %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "класа"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (уграђена функција)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s метода)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (класа)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (глобална променљива или константа)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (атрибут %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Аргументи"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (модул)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "метода"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "атрибут"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "модул"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "кључна реч"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "оператор"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "објекат"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "изузетак"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "наредба"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "уграђена функција"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Променљиве"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (у модулу %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (у модулу %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (уграђена променљива)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (уграђена класа)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (класа у %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (метода класе %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (статичка метода %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "модули"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Застарело"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "метода класе"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "статичка метода"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "директива"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "променљива окружења; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "документ"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "погледајте %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "такође погледајте %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Симболи"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2433,209 +2436,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "суфикс датотеке (подразумевани: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2645,14 +2653,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2662,33 +2670,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2698,163 +2708,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(у %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(у %s)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "изворни код"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "План"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "документација"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Код модула"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Изворни код %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Преглед: код модула"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2862,113 +2882,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2976,46 +2995,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3023,7 +3042,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3038,138 +3057,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Пример"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Примери"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Белешке"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Упозорења"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Пажња"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Грешка"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Путоказ"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Важно"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Белешка"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Савет"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Упозорење"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "настављено са претходне стране"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "наставак на следећој страни"
@@ -3191,7 +3210,7 @@
 msgid "Table of Contents"
 msgstr "Садржај"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Претрага"
@@ -3272,35 +3291,35 @@
 msgid "Navigation"
 msgstr "Навигација"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3345,12 +3364,12 @@
 msgstr "тражи"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Резултати претраге"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3392,280 +3411,278 @@
 msgid "Other changes"
 msgstr "Друге измене"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Претражује се"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Припрема претраге..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", у "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Садржај"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "слика: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "слика"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.js Changed

@@ -1,5 +1,5 @@
 Documentation.addTranslations({
-    "locale": "sr",
+    "locale": "sr@latin",
     "messages": {
         "%(filename)s &#8212; %(docstitle)s": "",
         "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "",
@@ -30,8 +30,6 @@
         "Next topic": "",
         "Other changes": "",
         "Overview": "",
-        "Permalink to this definition": "",
-        "Permalink to this headline": "",
         "Please activate JavaScript to enable the search\n    functionality.": "",
         "Preparing search...": "",
         "Previous topic": "",
@@ -39,7 +37,7 @@
         "Search": "",
         "Search Page": "",
         "Search Results": "",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Serbian (Latin) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr@latin/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sr@latin\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Serbian (Serbia) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr_RS/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sr_RS\n"
 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sv/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sv/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "N\u00e4sta titel",
         "Other changes": "\u00d6vriga f\u00f6r\u00e4ndringar",
         "Overview": "\u00d6versikt",
-        "Permalink to this definition": "Permalink till denna definition",
-        "Permalink to this headline": "Permalink till denna rubrik",
         "Please activate JavaScript to enable the search\n    functionality.": "Var god aktivera JavaScript f\u00f6r s\u00f6kfunktionalitet.",
         "Preparing search...": "",
         "Previous topic": "F\u00f6reg\u00e5ende titel",
@@ -39,7 +37,7 @@
         "Search": "S\u00f6k",
         "Search Page": "S\u00f6ksida",
         "Search Results": "S\u00f6kresultat",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "S\u00f6k bland %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sv/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sv/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/sv/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/sv/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Swedish (http://www.transifex.com/sphinx-doc/sphinx-1/language/sv/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: sv\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Inbyggda"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Modulnivå"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(i "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Huvudindex"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "index"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "nästa"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "föregående"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Index"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Utgåva"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Sektionsförfattare"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Modulförfattare"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Källkodsförfattare"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Upphovsman:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametrar"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Returnerar"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Returtyp"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "medlem"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "variabel"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "funktion"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "typ"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Nyheter i version %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Förändrat i version %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Ersatt sedan version %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Kastar"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "klass"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (inbyggd funktion)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s metod)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (klass)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (global variabel eller konstant)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s attribut)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Argument"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modul)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "metod"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "data"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "attribut"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modul"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "nyckelord"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "operator"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "objekt"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "undantag"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "uttryck"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "inbyggda funktioner"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Variabler"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Väcker"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (i modul %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (i modul %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (inbyggd variabel)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (inbyggd klass)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (klass i %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s klassmetod)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s statisk metod)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python Modulindex"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "moduler"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Ersatt"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "klassmetod"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "statisk metod"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (direktiv)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (roll)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "direktiv"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "roll"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "miljövariabel; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "ordlista"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "grammatisk token"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "referensetikett"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "miljövariabel"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "programväxel"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Modulindex"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Söksida"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "se %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "se även %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "source"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Att göra"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "ursprungsvärde"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "docs"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Modulkällkod"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>Källkod för %s</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Översikt: modulkällkod"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Alla moduler där källkod finns</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Uppmärksamma"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Varning"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Risk"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Fel"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Råd"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Viktigt"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Observera"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Se även"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tips"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Varning"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "fortsättning från föregående sida"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Sök"
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr "Navigation"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Sök bland %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Om dessa dokument"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Copyright"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Senast uppdaterad %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr "sök"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Sökresultat"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr "Övriga förändringar"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Permalink till denna rubrik"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Permalink till denna definition"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Dölj Sökresultat"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Expandera sidolist"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Dölj Sökresultat"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Dölj sidolist"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Expandera sidolist"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Innehåll"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Permalink till denna definition"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Fotnoter"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "image"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ta/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ta/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ta/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ta/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ta/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ta/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Julien Malard <julien.malard@mail.mcgill.ca>, 2019\n"
 "Language-Team: Tamil (http://www.transifex.com/sphinx-doc/sphinx-1/language/ta/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ta\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d கண்டு ப்பிடித்த விட்டது"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "அடுத்த"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,35 +1229,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1301,7 +1303,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1337,161 +1339,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,559 +1865,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/te/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/te/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/te/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/te/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/te/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/te/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Telugu (http://www.transifex.com/sphinx-doc/sphinx-1/language/te/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: te\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/tr/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/tr/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "Sonraki konu",
         "Other changes": "Di\u011fer de\u011fi\u015fiklikler",
         "Overview": "Genel Bak\u0131\u015f",
-        "Permalink to this definition": "Bu tan\u0131m i\u00e7in kal\u0131c\u0131 ba\u011flant\u0131",
-        "Permalink to this headline": "Bu ba\u015fl\u0131k i\u00e7in kal\u0131c\u0131 ba\u011flant\u0131",
         "Please activate JavaScript to enable the search\n    functionality.": "Arama i\u015flevini kullanabilmek i\u00e7in l\u00fctfen JavaScript'i\n    etkinle\u015ftirin.",
         "Preparing search...": "Aramaya haz\u0131rlan\u0131yor...",
         "Previous topic": "\u00d6nceki konu",
@@ -39,7 +37,7 @@
         "Search": "Ara",
         "Search Page": "Arama Sayfas\u0131",
         "Search Results": "Arama Sonu\u00e7lar\u0131",
-        "Search finished, found %s page(s) matching the search query.": "Arama tamamland\u0131. Sorguyu i\u00e7eren %s sayfa bulundu.",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "%(docstitle)s i\u00e7inde ara",
         "Searching": "Aran\u0131yor",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/tr/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/tr/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/tr/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/tr/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -11,134 +11,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: BouRock, 2020\n"
 "Language-Team: Turkish (http://www.transifex.com/sphinx-doc/sphinx-1/language/tr/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: tr\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "Kaynak dizin bulunamıyor (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "Kaynak dizin ve hedef dizin aynı olamaz"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "Sphinx s%s çalışıyor"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "Bu proje en az Sphinx s%s gerektirir ve bu nedenle bu sürüm ile oluşturulamaz."
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "çıktı dizini yapılıyor"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "%s uzantısı ayarlanırken:"
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "Şu anda conf.py dosyasında tanımlanan 'kurulum' çağrılabilir bir Python değil. Lütfen tanımını çağrılabilir bir işlev yapmak için değiştirin. Bunun, Sphinx uzantısı gibi davranması için conf.py dosyasına ihtiyacı vardır."
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "çeviriler yükleniyor %s... "
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "bitti"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "yerleşik iletiler için kullanılamaz"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "derin temizlenen ortam yükleniyor"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "başarısız olan: %s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "Seçilen oluşturucu yok, varsayılan kullanılıyor: html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "başarılı oldu"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "sorunlarla tamamlandı"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "yapım %s, %s uyarı (hata olarak kabul edilen uyarılarla)."
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "yapım %s, %s uyarı (hatalar olarak kabul edilen uyarılarla)."
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "yapım %s, %s uyarı."
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "yapım %s, %s uyarı."
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "yapım %s."
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "düğüm sınıfı %r zaten kayıtlı, ziyaretçileri geçersiz kılınacaktır"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "yönerge %r zaten kayıtlı, geçersiz kılınacaktır"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "rol %r zaten kayıtlı, geçersiz kılınacaktır"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -146,12 +146,12 @@
 "explicit"
 msgstr "%s uzantısı paralel okuma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "%s uzantısı paralel okuma için güvenli değil"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -159,64 +159,70 @@
 "explicit"
 msgstr "%s uzantısı paralel yazma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "%s uzantısı paralel yazma için güvenli değil"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "%s seri nosu yapılıyor"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "config dizini bir conf.py dosyası içermiyor (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "sözlük yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor (tek tek öğeleri ayarlamak için %r kullanın)"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "geçersiz sayı %r; yapılandırma değeri %r için; yoksayılıyor"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "desteklenmeyen tür ile yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "geçersiz kılmada bilinmeyen yapılandırma değeri %r, yoksayılıyor"
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "Böyle bir yapılandırma değeri yok: %s"
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "Yapılandırma değeri %r zaten mevcut"
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "Yapılandırma dosyanızda bir sözdizimi hatası var: %s\n"
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "Yapılandırma dosyası (veya içe aktarılan modüllerden biri) sys.exit() olarak adlandırılır"
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -224,898 +230,894 @@
 "%s"
 msgstr "Yapılandırma dosyanızda programlanabilir bir hata var:\n\n%s"
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "'source_suffix' yapılandırma değeri bir dizgi, dizgiler listesi ya da sözlük bekler. Ama '%r' verilir."
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "Bölüm %s"
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "Şekil %s"
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "Tablo %s"
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "Listeleme %s"
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "`{name}` yapılandırma değeri, {candidates} geğerlrinden biri olmak zorundadır, ancak `{current}` değeridir."
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip; beklenen {permitted}."
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip, vassayılanları `{default.__name__}'."
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r bulunamadı, yoksayıldı."
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "Olay %r zaten mevcut"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "Bilinmeyen olay adı: %s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "%s uzantısı needs_extensions ayarları tarafından gereklidir, ancak yüklü değildir."
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "Bu projenin %s uzantısına ve en az %s sürümüne ihtiyacı vardır ve bu nedenle yüklenen sürümle oluşturulamaz (%s)."
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments lexer adı %r bilinmiyor"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "\"%s\" olarak literal_block lex yapılamadı. Vurgulama atlandı."
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "belge okunabilir değil. Yoksayıldı."
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Oluşturucu sınıfı %s \"ad\" özniteliğine sahip değil"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Oluşturucu %r zaten mevcut (%s modülünde)"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Oluşturucu adı %s kayıtlı veya giriş noktası aracılığıyla kullanılabilir değil"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Oluşturucu adı %s kayıtlı değil"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "etki alanı %s zaten kayıtlı"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "etki alanı %s henüz kayıtlı değil"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r yönergesi zaten %s etki alanına kayıtlı"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r rolü zaten %s etki alanına kayıtlı"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r dizini zaten %s etki alanına kayıtlı"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type zaten kayıtlı"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type zaten kayıtlı"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r zaten kayıtlı"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "%r için source_parser zaten kayıtlı"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "%s için kaynak ayrıştırıcı kayıtlı değil"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "%r için çevirmen zaten mevcut"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() için kwargs bir (visit, depart) tanımlama grubu işlevi olmak zorundadır: %r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r zaten kayıtlı"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr "%r uzantısı zaten %s sürümünden bu yana Sphinx ile birleştirildi; bu uzantı yoksayıldı."
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "Özgün özel durumu:\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr " %s uzantısı içe aktarılamadı"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "%r uzantısı setup() işlevine sahip değil; bu gerçekten bir Sphinx uzantısı modülü mü?"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "Bu proje tarafından kullanılan %s uzantısının en az Sphinx s%s sürümüne ihtiyacı var; bu nedenle bu sürümle oluşturulamaz."
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "%r uzantısı, setup() işlevinden desteklenmeyen bir nesne döndürdü; Hiçbir şey veya üstveri sözlüğü döndürmeli"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Geliştirme Önerileri; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "%r temasının \"theme\" ayarı yok"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "%r temasının \"inherit\" ayarı yok"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "%r adında bulunan tema yok, %r tarafından devralındı"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "%s.%s ayarı, aranan tema yapılandırmalarının hiçbirinde meydana gelmiyor"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "desteklenmeyen tema seçeneği %r verildi"
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "tema yolundaki %r dosyası geçerli bir zip dosyası değil ya da hiç tema içermiyor"
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "%r adında bulunan tema yok (eksik theme.conf?)"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "mo oluşturuluyor: "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "çıktı yazılıyor..."
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "%d po dosyasının tümü"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "belirtilen %d po dosyası için hedefler"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "güncel olmayan %d po dosyası için hedefler"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "tüm kaynak dosyaları"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "komut satırında verilen %r dosyası kaynak dizinin altında değil, yoksayılıyor"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "komut satırında verilen %r dosyası mevcut değil, yoksayılıyor"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "komut satırında verilen %d kaynak dosyası"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "güncel olmayan %d kaynak dosyası için hedefler"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "%s oluşturuluyor:"
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "şimdi güncel olmayan dosyalar aranıyor..."
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "%d tane bulundu"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "hiç bulunamadı"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "ortam derin temizleniyor"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "tutarlılık denetleniyor"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "hiçbir hedef güncel değil."
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "güncellenen ortam:"
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s eklendi, %s değiştirildi, %s kaldırıldı"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "kaynaklar okunuyor..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "çalışanlar için bekleniyor..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "yazmak için belge adları: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "belgeler hazırlanıyor"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "kopyalanmış ToC girişi bulundu: %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "resimler kopyalanıyor..."
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "resim dosyası %r okunamıyor: bunun yerine kopyalanıyor"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "resim dosyası %r kopyalanamıyor: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "resim dosyası %r yazılamıyor: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "Yastık bulunamadı - resim dosyaları kopyalanıyor"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "%s için bilinmeyen mime türü, yoksayılıyor"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "%s dosyası yazılıyor..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "Genel bakış dosyası %(outdir)s içinde."
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "%s sürümünde değişiklik yok."
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "özet dosyası yazılıyor..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Yerleşikler"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Modül seviyesi"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "kaynak dosyalar kopyalanıyor..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "değişiklikler günlüğü oluşturma için %r okunamadı"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "Taklit oluşturucu hiçbir dosya oluşturmaz."
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePub dosyası %(outdir)s içinde."
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_language\" (veya \"language\"), EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "yapılandırma değeri \"epub_uid\", EPUB3 için XML NAME olmalıdır"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_title\" (veya \"html_title\"), EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_author\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_contributor\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_description\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_publisher\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_copyright\" (veya \"copyright\"), EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"epub_identifier\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "yapılandırma değeri \"version\", EPUB3 için boş olmamalıdır"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "geçersiz css_file: %r, yoksayıldı"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "İleti katalogları %(outdir)s içinde."
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d şablon dosyası için hedefler"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr "şablonlar okunuyor..."
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr "ileti katalogları yazılıyor..."
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr "Yukarıdaki çıktıda veya %(outdir)s/output.txt içinde herhangi bir hata arayın"
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr "bozuk bağlantı: %s (%s)"
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr "Bağlayıcı '%s' bulunamadı"
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "Rehber sayfaları %(outdir)s içinde."
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "hiçbir \"man_pages\" yapılandırma değeri bulunamadı; hiçbir rehber sayfası yazılmayacaktır"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "yazılıyor"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr "\"man_pages\" yapılandırma değeri bilinmeyen %s belgesine başvurur"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML sayfası %(outdir)s içinde."
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr "tek bir belgede toplanıyor"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr "ilave dosyalar yazılıyor"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr "\nMakeinfo aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make info' komutunu kullanın)."
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "hiçbir \"texinfo_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr "\"texinfo_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "%s işleniyor"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "başvurular çözümleniyor..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (şurada:  "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr "Texinfo destek dosyaları kopyalanıyor..."
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr "Makefile dosyası yazılırken hata oldu: %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "Metin dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "%s dosyası yazılırken hata oldu: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "Pseudo-XML dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "oluşturma bilgisi dosyası bozuldu: %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML sayfaları %(outdir)s içinde."
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "oluşturma bilgisi dosyasını okuma başarısız: %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d %b %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Genel Dizin"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "dizin"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "sonraki"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "önceki"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "dizinler oluşturuluyor"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "ilave sayfalar yazılıyor"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr "indirilebilir dosyalar kopyalanıyor..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "indirilebilir dosya %r kopyalanamıyor: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "sabit dosya %r kopyalanamıyor"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "fazladan dosyalar kopyalanıyor"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "fazladan dosya %r kopyalanamıyor..."
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "oluşturma bilgisi dosyasını yazma başarısız: %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "arama dizini yüklenemedi, ancak tüm belgeler oluşturulmayacaktır: dizin tamamlanmamış olacaktır."
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr "sayfa %s html_sidebars içinde iki şekille eşleşiyor: %r ve %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr "%s sayfasını işlerken bir Evrensel kod hatası meydana geldi. Lütfen ASCII olmayan içerik içeren tüm yapılandırma değerlerinin Evrensel kod dizgiler olduğundan emin olun."
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "%s sayfasını işlerken bir hata oldu.\nSebep: %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "nesne envanteri dökümleniyor"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "%s içinde arama dizini dökümleniyor"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "geçersiz js_file: %r, yoksayıldı"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr "Birçok math_renderers kayıtlı. Ama hiç math_renderer seçilmedi."
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr "Bilinmeyen math_renderer %r verildi."
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr "html_extra_path girişi %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr "html_extra_path girişi %r, çıktı dizini içine yerleştirildi"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr "html_static_path girişi %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path girişi %r, çıktı dizini içine yerleştirildi"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "logo dosyası %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "favicon dosyası %r mevcut değil"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s belgelendirmesi"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTeX dosyaları %(outdir)s içinde."
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr "\n(pdf)latex aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make latexpdf' komutunu kullanın)."
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "hiçbir \"latex_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr "\"latex_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Dizin"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Yayım"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "%r dili için bilinen hiç Babel seçeneği yok"
@@ -1124,94 +1126,94 @@
 msgid "copying TeX support files"
 msgstr "TeX destek dosyaları kopyalanıyor"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr "TeX destek dosyaları kopyalanıyor..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr "ilave dosyalar kopyalanıyor"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "Bilinmeyen yapılandırma anahtarı: latex_elements%r, yoksayıldı."
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr "%r, \"theme\" ayarına sahip değil"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr "%r, \"%s\" ayarına sahip değil"
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr "Oluşturulurken meydana gelen özel durum, hata ayıklayıcı başlatılıyor:"
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "Yarıda kesildi!"
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "reST biçimlendirme hatası:"
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "Kodlama hatası:"
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "Sorunu geliştiricilere bildirmek istiyorsanız, tam geri izleme %s içine kaydedildi."
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "Tekrarlama hatası:"
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "Özel durum meydana geldi:"
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr "Bir dahaki sefere daha iyi bir hata iletisi sağlanabilmesi için lütfen bunu bir kullanıcı hatasıysa da bildirin."
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr "Bir hata raporu <https://github.com/sphinx-doc/sphinx/issues> adresindeki izleyicide dosyalanabilir. Teşekkürler!"
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr "iş numarası pozitif bir sayı olmalıdır"
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1230,35 +1232,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "belgelendirme kaynak dosyaları için yol"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "çıktı dizini için yol"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "yeniden oluşturmak için belirli dosyaların listesi. Belirtildiyse yoksayıldı"
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "genel seçenekler"
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "kullanmak için oluşturucu (varsayılan: html)"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "tüm dosyaları yaz (varsayılan: sadece yeni ve değiştirilmiş dosyaları yaz)"
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "kaydedilmiş bir ortam kullanma, her zaman tüm dosyaları oku"
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1304,7 +1306,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr "ayrıntı seviyesini artır (tekrarlanabilir)"
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr "stdout üzerinde çıktı yok, stderr üzerinde sadece uyarılar"
 
@@ -1340,161 +1342,156 @@
 msgid "run Pdb on exception"
 msgstr "özel durumda Pdb çalıştır"
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr "%r dosyaları bulunamıyor"
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "-a seçeneği ve dosya adları birleştirilemiyor"
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr "uyarı dosyası %r açılamıyor: %s"
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "-D seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır"
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "-A seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr "modüllerden otomatik olarak docstrings ekle"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr "doctest bloklarında kod parçacıklarını otomatik olarak dene"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "farklı projelerin Sphinx begelendirmeleri arasında bağlantıla"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "oluşturmada gösterilebilen veya gizlenebilen \"yapılacaklar\" girişlerini yaz"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "belgelendirme kapsamı için denetlemeler"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "PNG veya SVG resimleri olarak işleneni, matematiği dahil et"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "MathJax ile tarayıcıda işleneni, matematiği dahil et"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr "yapılandırma değerlerine dayalı içeriğin koşullu olarak eklenmesi"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr "belgelenmiş Python nesnelerinin kaynak koduna bağlantıları dahil et"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "belgeyi GitHub sayfalarında yayımlamak için .nojekyll dosyası oluştur"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "Lütfen geçerli bir yol adı girin."
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "Lütfen biraz metin girin."
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "Lütfen %s seçeneklerinden birini girin."
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "Lütfen ya 'y' ya da 'n' girin."
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "Lütfen bir dosya soneki girin, örn. '.rst' veya '.txt'."
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "Sphinx %s hızlı başlangıç yardımcı uygulamasına hoş geldiniz."
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr "Lütfen aşağıdaki ayarlar için değerleri girin (parantez içinde verilirse\nvarsayılan değeri kabul etmek için yalnızca Enter tuşuna basın)."
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "Seçilen kök dizin yolu: %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "Belgelendirme için kök dizin yolunu girin."
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "Belgelendirme için kök dizin yolu"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "Hata: seçilen kök dizin yolunda varolan bir conf.py bulundu."
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sfenks-quickstart varolan Sphinx projelerinin üzerine yazmayacak."
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "Lütfen yeni bir kök dizin yolu girin (ya da çıkmak için yalnızca Enter'a basın)"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr "Sphinx çıktısının oluşturma dizinini yerleştirmek için iki seçeneğiniz var.\nYa, kök dizin yolu içinde bir \"_build\" dizini kullanın, ya da kök dizin yolu\niçinde \"source\" ve \"build\" dizinlerini ayırın."
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "Source ve build dizinlerini ayır (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr "Kök dizinin içinde, iki dizin daha oluşturulacaktır; özel HTML şablonları için \"_templates\"\nve özel stil sayfaları ve diğer sabit dosyalar için \"_static\".\nAlt çizgi yerine başka bir önek (\".\" gibi) girebilirsiniz."
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr "Templates ve static dizinleri için ad öneki"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "Proje adı, oluşturulan belgelendirmedeki çeşitli yerlerde oluşacak."
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "Proje adı"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "Hazırlayan ad(ları)ı"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1503,15 +1500,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "Proje sürümü"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "Proje yayımı"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1521,21 +1518,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr "Eğer belgeler İngilizce dışında bir dilde yazıldıysa, bunun dil koduna\ngöre burada bir dil seçebilirsiniz. Sphinx daha sonra, ürettiği metni o\ndile çevirecektir.\n\nDesteklenen kodların listesi için\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language adresine bakın."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "Proje dili"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "Kaynak dosya soneki"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1543,91 +1540,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr "Bir belge, \"içindekiler ağacı\"nın üst düğümü olarak kabul edilmesi, yani\nbelgelerin hiyerarşik yapısının kökü olması açısından özeldir.\nNormalde bu \"dizin\"dir, ancak \"dizin\" belgeniz özel bir şablonsa,\nbunu başka bir dosya adına da ayarlayabilirsiniz."
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "Asıl belgenizin adı (sonek olmadan)"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "Hata: %s asıl dosyası zaten seçilen kök dizin yolunda bulundu."
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sfenks-quickstart varolan dosyanın üzerine yazmayacak."
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "Lütfen yeni bir dosya adı girin ya da varolan dosyayı yeniden adlandırın ve Enter tuşuna basın"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr "Aşağıdaki Sphinx uzantılarından hangisinin etkinleştirilmesi gerektiğini gösterir:"
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "Not: imgmath ve mathjax aynı anda etkinleştirilemez. imgmath seçimi kaldırıldı."
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "Makefile ve Windows komut dosyası sizin için oluşturulabilir,\nböylece doğrudan örn. sphinx-build çağırmak yerine sadece\n`make html' komutu çalıştırılmak zorundadır."
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr "Makefile oluşturulsun mu? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr "Windows komut satırı oluşturulsun mu? (y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr "%s dosyası oluşturuluyor."
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr "%s dosyası zaten var, atlanıyor."
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "Tamamlandı: İlk dizin yapısı oluşturuldu."
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr "Artık %s asıl dosyanızı doldurmalı ve diğer belgelendirme kaynak dosyalarını\noluşturmalısınız."
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr "Belgeleri oluşturmak için Makefile'ı kullanın, aşağıdaki gibi:\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr "Belgeleri oluşturmak için sphinx-build komutunu kullanın, aşağıdaki gibi:\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr "\"builder\" burada desteklenen oluşturuculardan biridir, örn. html, latex veya linkcheck."
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1637,230 +1634,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\nBir Sphinx projesi için gerekli dosyaları oluşturun.\n\nsphinx-quickstart, projeniz hakkında bazı sorular soran ve ardından tam bir\nbelgelendirme dizini ve örnek oluşturan etkileşimli bir araçtır\nMakefile, sphinx-build ile kullanılır.\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "sessiz kipi"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "proje kök dizini"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "Yapı seçenekleri"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "eğer belirtildiyse, kaynak ve oluşturma dizinlerini ayırın"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "_templates vb. içinde nokta için değiştirme"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "Proje temel seçenekleri"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "proje adı"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "hazırlayan adları"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "projenin sürümü"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "projenin yayımı"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "belge dili"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "kaynak dosya soneki"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "asıl belge adı"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "epub kullan"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "Uzantı seçenekleri"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "%s uzantısını etkinleştir"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "rasgele uzantıları etkinleştir"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile ve Batchfile oluşturma"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "makefile oluştur"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "makefile oluşturma"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "batchfile oluştur"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "batchfile oluşturma"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat için make-mode kullan"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "Makefile/make.bat için make-mode kullanma"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "Proje şablonlama"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "şablon dosyaları için şablon dizini"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "bir şablon değişkeni tanımla"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"sessiz\" belirtilmiş, ancak herhangi bir \"proje\" veya \"hazırlayan\" belirtilmemiş."
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "Hata: belirtilen yol bir dizin değil ya da sphinx dosyaları zaten var."
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sfenks-quickstart sadece boş bir dizin içine oluşturur. Lütfen yeni bir kök dizin yolu belirtin."
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "Geçersiz şablon değişkeni: %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "Geçersiz resim yazısı: %s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "satır numarası özellikleri aralık dışında (1-%d): %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr "Hem \"%s\" hem de \"%s\" seçeneği kullanılamıyor"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr "Dahil edilen %r dosyası bulunamadı ya da dosyayı okuma başarısız oldu"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "%r kodlamasının kullanıldığı, dahil edilen %r dosyasını okuma yanlış gibi görünüyor, bir :encoding: seçeneği vermeyi deneyin"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr "%r adlı nesne, dahil edilen %r dosyasında bulunamadı"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr "Ayrık bir \"satır\" kümesiyle \"lineno-match\" kullanılamıyor"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr "Satır özelliği %r: dahil edilen %r dosyasından çekilen hiç satır yok"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr "toctree, hariç tutulan %r belgesine başvuru içeriyor"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr "toctree, varolmayan %r belgesine başvuru içeriyor"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Bölümü hazırlayan: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Modülü hazırlayan: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Kodu hazırlayan: "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Hazırlayan: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1871,559 +1868,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Parametreler"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Dönüşler"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Dönüş türü"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "üyesi"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "değişkeni"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "işlevi"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "makrosu"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "birliği"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "numaralandırıcı"
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "türü"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "%s sürümünde geldi"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "%s sürümünde değişti"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "%s sürümünden beri kullanım dışı"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "%s kopya alıntısı, %s içindeki diğer örnek"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "Alıntı %s kaynak gösterilmedi."
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "Şablon Parametreleri"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Şunu verir: "
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "sınıfı"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "kavramı"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (yerleşik işlev)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s yöntemi)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (sınıf)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (genel değişken veya sabit)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s özniteliği)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Bağımsız Değişkenler"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (modül)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "yöntemi"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "verisi"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "özniteliği"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "modülü"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "kopya %s açıklamasına ait %s, diğer %s, %s içinde"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "%s denkleminin kopya etiketi, %s içindeki diğer örnek"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "Geçersiz math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "anahtar kelime"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "işleç"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "nesne"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "özel durum"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "ifade"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "yerleşik işlev"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Değişkenler"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Harekete geçirir"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (%s modülü içinde)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (%s modülü içinde)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (yerleşik değişken)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (yerleşik sınıf)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s içindeki sınıf)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s sınıf yöntemi)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s sabit yöntemi)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python Modül Dizini"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "modülleri"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Kullanım dışı"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "sınıf yöntemi"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "sabit yöntemi"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "%s kopya nesne açıklaması, %s içindeki diğer örnek, bunlardan biri için :noindex: kullanın"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "çapraz referans %r için birden fazla hedef bulundu: %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (kullanım dışı)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (yönerge)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: (yönerge seçeneği)"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (rol)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "yönergesi"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "yönerge seçeneği"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "rolü"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "%s %s kopya açıklaması, %s içindeki diğer örnek"
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "ortam değişkeni; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "Hatalı biçimlendirilmiş seçenek açıklaması %r, \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" veya \"+opt args\" şeklinde görünmelidir"
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s komut satırı seçeneği"
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "komut satırı seçeneği"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "sözlük teriminden önce boş satır gelmek zorundadır"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "sözlük terimleri boş satırlarla ayrılmamak zorundadır"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "sözlük yanlış biçimlendirilmiş gibi görünüyor, girintiyi gözden geçirin"
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "sözlük terimi"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "dilbilgisi belirteci"
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "başvuru etiketi"
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "ortam değişkeni"
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "program seçeneği"
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "belge"
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Modül Dizini"
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Arama Sayfası"
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "%s kopya etiketi, %s içindeki diğer örnek"
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "kopya %s açıklamasına ait %s, %s içindeki diğer örnek "
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig etkisizleştirildi. :numref: yoksayıldı."
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "bağlantının resim yazısı yok: %s"
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "geçersiz numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "geçersiz numfig_format: %s"
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "yeni yapılandırma"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "yapılandırma değişti"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "uzantılar değişti"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "yapım ortamı sürümü şu anki değil"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "kaynak dizin değişti"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "Bu ortam seçilen oluşturucuyla uyumsuzdur, lütfen başka bir belge ağacı dizini seçin."
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "%s içinde belgeleri tarama başarısız oldu: %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Etki alanı %r kayıtlı değil"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "kendinden kaynaklı toctree bulundu. Yoksayıldı."
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "belge herhangi bir toctree içine dahil değil"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "bakınız %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "ayrıca bakınız %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "bilinmeyen dizin girişi türü %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Semboller"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "dairesel toctree kaynakları algılandı, yoksayılan: %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "toctree, başlığı olmayan %r belgesine başvuru içeriyor: hiç bağlantı oluşturulmayacaktır"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "resim dosyası okunabilir değil: %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "%s resim dosyası okunabilir değil: %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "indirme dosyası okunabilir değil: %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "%s zaten atanmış bölüm numaralarıdır (iç içe numaralı toctree mi?)"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "%s dosyası oluşturur."
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2435,209 +2438,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\nPython modülleri ve paketleri için <MODULE_PATH> içine art arda bakın ve <OUTPUT_PATH> içindeki\npaket başına otomodül talimatlarını içeren bir reST dosyası oluşturun.\n\n<EXCLUDE_PATTERN>'ler, nesilden hariç tutulacak olan dosya ve/veya dizin şekilleri olabilir.\n\nNot: Varsayılan olarak bu betik zaten oluşturulmuş dosyaların üzerine yazmayacak."
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr "belge için modüle giden yol"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr "nesilden hariç tutmak için fnmatch-style dosyası ve/veya dizin şekilleri"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr "tüm çıktıların yerleştirileceği dizin"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr "TOC'da gösterilecek alt modüllerin en fazla derinliği (varsayılan: 4)"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "varolan dosyaların üzerine yaz"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "sembolik bağlantıları takip edin. Collective.recipe.omelette ile birleştirildiğinde güçlü."
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "dosyaları oluşturmadan betiği çalıştır"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr "her modül için belgelendirmeyi kendi sayfasına koy"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "\"_private\" modülleri dahil"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr "içindekiler dosyası adı (varsayılan: modüller)"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "içindekiler tablosu oluşturma"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr "modül/paket paketleri için başlıklar oluşturma (örn. docstrings zaten bunları içerdiğinde)"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr "modül belgelerini alt modül belgelerinin önüne koyun"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "modül yollarını PEP-0420 kapalı ad alanları özelliklerine göre yorumla"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "dosya soneki (varsayılan: rst)"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "sphinx-quickstart ile tam bir proje oluştur"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "--full yazıldığında, append module_path to sys.path, kullanılır"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "proje adı (varsayılan: kök modül adı)"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "--full yazıldığında, proje hazırlayan(lar)ı kullanılır"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "--full yazıldığında, proje sürümü kullanılır"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr "--full yazıldığında, varsayılanı to --doc-version, proje yayımı kullanılır"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "uzantı seçenekleri"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s bir dizin değil."
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2647,14 +2655,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2664,33 +2672,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr "nokta kodu %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "grafik: %s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "grafik"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2700,163 +2710,173 @@
 "%r"
 msgstr "dönüştürmeden hata ile çıkıldı:\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr "dönüştürme komutu %r çalıştırılamaz, image_converter ayarını gözden geçirin"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr "LaTeX komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_latex ayarını gözden geçirin"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr "%s komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_%s ayarını gözden geçirin"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "görüntü latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "satır içi latex %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "Bu denklem için kalıcı bağlantı"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr "intersphinx envanteri taşındı: %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr "%s konumundan intersphinx envanteri yükleniyor..."
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr "aşağıdaki sorunlardan dolayı envanterlerden herhangi birine ulaşılamadı:"
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(%s v%s içinde)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr "(%s içinde)"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "kaynak"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Yapılacaklar"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>>, %s içinde, %d. satırda bulunur.)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "özgün giriş"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "belgeler"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "Modül kodu"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s öğesinin kaynak kodu</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "Genel bakış: modül kodu"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>Kodları mevcut bütün modüller</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2864,113 +2884,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2978,46 +2997,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3025,7 +3044,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3040,138 +3059,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "Örnek"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Örnekler"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "Notlar"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "Diğer Parametreler"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "Kaynaklar"
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "Uyarılar"
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "Getiriler"
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Dikkat"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Uyarı"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Tehlike"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Hata"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "İpucu"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Önemli"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Not"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Ayrıca bakınız"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Tüyo"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Uyarı"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "önceki sayfadan devam"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "sonraki sayfaya devam"
@@ -3193,7 +3212,7 @@
 msgid "Table of Contents"
 msgstr "İçindekiler"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Ara"
@@ -3274,35 +3293,35 @@
 msgid "Navigation"
 msgstr "Gezinti"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "%(docstitle)s içinde ara"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Bu belgeler hakkında"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Telif hakkı"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">Telif hakkı</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; Telif hakkı %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Son güncelleme: %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3347,12 +3366,12 @@
 msgstr "ara"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Arama Sonuçları"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3394,280 +3413,278 @@
 msgid "Other changes"
 msgstr "Diğer değişiklikler"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Bu başlık için kalıcı bağlantı"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Bu tanım için kalıcı bağlantı"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Arama Eşleşmelerini Gizle"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "Aranıyor"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "Aramaya hazırlanıyor..."
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "Arama tamamlandı. Sorguyu içeren %s sayfa bulundu."
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ", şunun içinde:"
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "Yan çubuğu genişlet"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Arama Eşleşmelerini Gizle"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "Yan çubuğu daralt"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "Yan çubuğu genişlet"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "İçindekiler"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "Bilinmeyen resim biçimi: %s..."
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "atlandı"
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "başarısız oldu"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "okuma hatası: %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "yazma hatası: %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "varsayılan rol %s bulunamadı"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Bu tanım için kalıcı bağlantı"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "Bu tablonun kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "Bu kodun kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "Bu resmin kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "Bu içindekiler tablosunun kalıcı bağlantısı"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "Dipnotlar"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "resim: %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "resim"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js Changed

@@ -30,8 +30,6 @@
         "Next topic": "\u041d\u0430\u0441\u0442\u0443\u043f\u043d\u0430 \u0442\u0435\u043c\u0430",
         "Other changes": "\u0406\u043d\u0448\u0456 \u0437\u043c\u0456\u043d\u0438",
         "Overview": "\u041e\u0433\u043b\u044f\u0434",
-        "Permalink to this definition": "\u041f\u043e\u0441\u0442\u0456\u0439\u043d\u0435 \u043f\u043e\u0441\u0438\u043b\u0430\u043d\u043d\u044f \u043d\u0430 \u0446\u0435 \u0432\u0438\u0437\u043d\u0430\u0447\u0435\u043d\u043d\u044f",
-        "Permalink to this headline": "\u041f\u043e\u0441\u0442\u0456\u0439\u043d\u0435 \u043f\u043e\u0441\u0438\u043b\u0430\u043d\u043d\u044f \u043d\u0430 \u0446\u0435\u0439 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a",
         "Please activate JavaScript to enable the search\n    functionality.": "\u0411\u0443\u0434\u044c-\u043b\u0430\u0441\u043a\u0430 \u0432\u0456\u043c\u043a\u043d\u0456\u0442\u044c \u043f\u0456\u0434\u0442\u0440\u0438\u043c\u043a\u0443 JavaScript, \u0449\u043e\u0431 \u0432\u0432\u0456\u043a\u043d\u0443\u0442\u0438\n\"\n\"    \u043f\u043e\u0448\u0443\u043a.",
         "Preparing search...": "",
         "Previous topic": "\u041f\u043e\u043f\u0435\u0440\u0435\u0434\u043d\u0456\u0439 \u0440\u043e\u0437\u0434\u0456\u043b",
@@ -39,7 +37,7 @@
         "Search": "\u041f\u043e\u0448\u0443\u043a",
         "Search Page": "\u0421\u0442\u043e\u0440\u0456\u043d\u043a\u0430 \u043f\u043e\u0448\u0443\u043a\u0443",
         "Search Results": "\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0438 \u043f\u043e\u0448\u0443\u043a\u0443",
-        "Search finished, found %s page(s) matching the search query.": "",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "",
         "Search within %(docstitle)s": "\u0428\u0443\u043a\u0430\u0442\u0438 \u0432 %(docstitle)s",
         "Searching": "",
         "Searching for multiple words only shows matches that contain\n    all words.": "",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Petro Sasnyk <petro@sasnyk.name>, 2009\n"
 "Language-Team: Ukrainian (Ukraine) (http://www.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: uk_UA\n"
 "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Вбудовані елементи"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Рівень модуля"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (в "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%b %d, %Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Загальний індекс"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "індекс"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "наступний"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "попередній"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "Індекс"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "Реліз"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,271 +1229,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Автор секції: "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Автор модуля: "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Автор: "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,414 +1865,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Параметри"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Повертає"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Тип повернення"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "член"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "функція"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "макрос"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "тип"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Нове в версії %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Змінено в версії %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Застаріло починаючи з версії %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "клас"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (вбудована функція)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s метод)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (клас)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s атрибут)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (модуль)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "атрибут"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "модуль"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "ключове слово"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "оператор"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "об'єкт"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "виняткова ситуація"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "вираз"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "вбудована функція"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Викликає"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (в модулі %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (в модулі %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (вбудована змінна)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (вбудований клас)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (клас в %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s статичний метод)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "модулі"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Застарілий"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "статичний метод"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr " (застарілий)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "змінна оточення; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "змінна оточення"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "Індекс модулів"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "Сторінка пошуку"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2285,142 +2283,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Доробити"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Увага"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Застереження"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Небезпека"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Помилка"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Підказка"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Важливо"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Примітка"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Дивись також"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Порада"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Попередження"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Пошук"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "Навігація"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Шукати в %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Про ці документи"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Авторські права"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Востаннє оновлено %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr "пошук"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "Результати пошуку"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr "Інші зміни"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "Постійне посилання на цей заголовок"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "Постійне посилання на це визначення"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "Приховати співпадіння пошуку"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr ""
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "Приховати співпадіння пошуку"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "Постійне посилання на це визначення"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ur/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ur/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ur/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ur/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/ur/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/ur/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Urdu (http://www.transifex.com/sphinx-doc/sphinx-1/language/ur/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: ur\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/vi/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/vi/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/vi/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/vi/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/vi/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/vi/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -8,134 +8,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Hoat Le Van <hoatlevan@gmail.com>, 2014\n"
 "Language-Team: Vietnamese (http://www.transifex.com/sphinx-doc/sphinx-1/language/vi/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: vi\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -143,12 +143,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -156,64 +156,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -221,898 +227,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Các đề nghị nâng cao Python; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "Dựng sẵn"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "Mức mô-đun"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr "(trong"
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%d/%m/%Y"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "Chỉ mục chung"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "chỉ mục"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "xem tiếp"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "xem lại"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "Tài liệu %s %s"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1121,94 +1123,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1227,35 +1229,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1301,7 +1303,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1337,161 +1339,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1500,15 +1497,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1518,21 +1515,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1540,91 +1537,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1634,230 +1631,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "Tác giả mục:"
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "Tác giả mô-đun:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "Tác giả mã lệnh:"
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "Tác giả:"
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1868,559 +1865,565 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "Tham số"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "Trả về"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "Kiểu trả về"
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "thuộc tính"
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "biến"
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "hàm"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "macro"
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "kiểu"
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr "Mới từ phiên bản %s"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr "Thay đổi trong phiên bản %s"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr "Sắp loại bỏ từ phiên bản %s"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "Ném"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "lớp"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (hàm dựng sẵn)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (phương thức %s)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (lớp)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (biến toàn cục hoặc hằng số)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (thuộc tính %s)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "Đối số"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (mô-đun)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "phương thức"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "dữ liệu"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "thuộc tính"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "mô-đun"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "từ khoá"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "toán tử"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "đối tượng"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "ngoại lệ"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "câu lệnh"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "hàm dựng sẵn"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "Các biến"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "Đưa ra"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (trong mô-đun %s)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (trong mô-đun %s)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (biến dựng sẵn)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (lớp dựng sẵn)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (lớp trong %s)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (phương thức lớp %s)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr ""
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (phương thức tĩnh %s)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr ""
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Chỉ Mục Mô-đun Python"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "các mô-đun"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "Sắp loại bỏ"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "phương thức lớp"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "phương thức tĩnh"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr "(sắp loại bỏ)"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s (chỉ thị)"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s (vai trò)"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "chỉ thị"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "vai trò"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "các biến môi trường; %s"
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "chú giải thuật ngữ"
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "xem %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "nên xem %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "Biểu tượng"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2432,209 +2435,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2644,14 +2652,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,33 +2669,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2697,163 +2707,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2861,113 +2881,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2975,46 +2994,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3022,7 +3041,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3037,138 +3056,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "Các ví dụ"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "Chú ý"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "Cảnh báo"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "Nguy hiểm"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "Lỗi"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "Gợi ý"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "Quan trọng"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "Ghi chú"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "Xem thêm"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "Mẹo"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "Cảnh báo"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3190,7 +3209,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "Tìm Kiếm"
@@ -3271,35 +3290,35 @@
 msgid "Navigation"
 msgstr "Điều hướng"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "Tìm kiếm trong %(docstitle)s"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "Về các tài liệu này"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "Bản quyền"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "Cập nhật mới nhất vào %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3344,12 +3363,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3391,280 +3410,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "Nội dung"
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/yue/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/yue/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/yue/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/yue/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/yue/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/yue/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-09 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Cantonese (http://www.transifex.com/sphinx-doc/sphinx-1/language/yue/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: yue\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:539
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:258
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:282
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:331
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:334
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:341
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:367
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:386
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:387
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:388
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:426
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:444
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:457
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:467
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:479
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:243
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:248
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:119
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:257
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:456
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:701
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:91
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:103
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:38
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:48
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:56
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:63
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:66
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:71
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:77
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:80
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:96
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:105
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,35 +1228,35 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:126
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:133
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:136
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:141
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:144
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
@@ -1300,7 +1302,7 @@
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
@@ -1336,161 +1338,156 @@
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:223
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:226
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:245
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,559 +1864,565 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3756 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3757
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3758 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3760
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3764 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3766 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2071
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:101 sphinx/domains/std.py:118
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:192
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:243
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:245
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:563
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:564
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:565
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:567
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:568
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:569
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:605
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:655 sphinx/domains/std.py:764
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:674
+#: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:880
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:892
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:906
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:909
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1122
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1124
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:817
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:825
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:801
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:805
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:973
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:224
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:263
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:269
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:284
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:532
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:537
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js Changed

@@ -4,52 +4,50 @@
         "%(filename)s &#8212; %(docstitle)s": "%(filename)s &#8212; %(docstitle)s",
         "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "&#169; <a href=\"%(path)s\"> \u7248\u6743\u6240\u6709</a> %(copyright)s.",
         "&#169; Copyright %(copyright)s.": "&#169; \u7248\u6743\u6240\u6709 %(copyright)s.",
-        ", in ": "\uff0c \u5728 ",
-        "About these documents": "\u5173\u4e8e\u8fd9\u4e9b\u6587\u6863",
-        "Automatically generated list of changes in version %(version)s": "\u81ea\u52a8\u751f\u6210\u7684 %(version)s \u7248\u672c\u4e2d\u7684\u66f4\u6539\u5217\u8868",
-        "C API changes": "C API \u66f4\u6539",
-        "Changes in Version %(version)s &#8212; %(docstitle)s": "\u66f4\u6539\u53d1\u751f\u5728\u7248\u672c %(version)s&#8212; %(docstitle)s",
+        ", in ": "\uff0c\u5728 ",
+        "About these documents": "\u5173\u4e8e\u6b64\u6587\u6863",
+        "Automatically generated list of changes in version %(version)s": "\u81ea\u52a8\u751f\u6210\u7684 %(version)s \u7248\u672c\u53d8\u66f4\u5217\u8868",
+        "C API changes": "C API \u7684\u53d8\u66f4",
+        "Changes in Version %(version)s &#8212; %(docstitle)s": "\u4e8e\u7248\u672c %(version)s&#8212; %(docstitle)s \u53d8\u66f4",
         "Collapse sidebar": "\u6298\u53e0\u8fb9\u680f",
-        "Complete Table of Contents": "\u5b8c\u6574\u7684\u5185\u5bb9\u8868",
+        "Complete Table of Contents": "\u5b8c\u6574\u76ee\u5f55",
         "Contents": "\u76ee\u5f55",
         "Copyright": "\u7248\u6743\u6240\u6709",
-        "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "",
+        "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "\u7531 <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s\u521b\u5efa\u3002",
         "Expand sidebar": "\u5c55\u5f00\u8fb9\u680f",
-        "Full index on one page": "\u4e00\u9875\u7684\u5168\u90e8\u7d22\u5f15",
-        "General Index": "\u603b\u76ee\u5f55",
+        "Full index on one page": "\u5355\u9875\u5168\u7d22\u5f15",
+        "General Index": "\u603b\u7d22\u5f15",
         "Global Module Index": "\u5168\u5c40\u6a21\u5757\u7d22\u5f15",
-        "Go": "\u8f6c\u5411",
+        "Go": "\u63d0\u4ea4",
         "Hide Search Matches": "\u9690\u85cf\u641c\u7d22\u7ed3\u679c",
         "Index": "\u7d22\u5f15",
         "Index &ndash; %(key)s": "\u7d22\u5f15 &ndash; %(key)s",
-        "Index pages by letter": "\u6309\u7167\u5b57\u6bcd\u7684\u7d22\u5f15\u9875",
+        "Index pages by letter": "\u5b57\u6bcd\u7d22\u5f15",
         "Indices and tables:": "\u7d22\u5f15\u548c\u8868\u683c\uff1a",
         "Last updated on %(last_updated)s.": "\u6700\u540e\u66f4\u65b0\u4e8e %(last_updated)s.",
-        "Library changes": "\u5e93\u66f4\u6539",
+        "Library changes": "\u5e93\u7684\u53d8\u66f4",
         "Navigation": "\u5bfc\u822a",
-        "Next topic": "\u4e0b\u4e00\u4e2a\u4e3b\u9898",
-        "Other changes": "\u5176\u4ed6\u66f4\u6539",
+        "Next topic": "\u4e0b\u4e00\u4e3b\u9898",
+        "Other changes": "\u5176\u4ed6\u53d8\u66f4",
         "Overview": "\u6982\u8ff0",
-        "Permalink to this definition": "\u6c38\u4e45\u94fe\u63a5\u81f3\u76ee\u6807",
-        "Permalink to this headline": "\u6c38\u4e45\u94fe\u63a5\u81f3\u6807\u9898",
         "Please activate JavaScript to enable the search\n    functionality.": "\u8bf7\u6fc0\u6d3b JavaScript \u4ee5\u5f00\u542f\u641c\u7d22\u529f\u80fd\u3002",
-        "Preparing search...": "\u51c6\u5907\u641c\u7d22\u2026\u2026",
-        "Previous topic": "\u4e0a\u4e00\u4e2a\u4e3b\u9898",
+        "Preparing search...": "\u6b63\u5728\u51c6\u5907\u641c\u7d22\u2026\u2026",
+        "Previous topic": "\u4e0a\u4e00\u4e3b\u9898",
         "Quick search": "\u5feb\u901f\u641c\u7d22",
         "Search": "\u641c\u7d22",
         "Search Page": "\u641c\u7d22\u9875\u9762",
         "Search Results": "\u641c\u7d22\u7ed3\u679c",
-        "Search finished, found %s page(s) matching the search query.": "\u641c\u7d22\u5b8c\u6210\uff0c\u6709 %s \u4e2a\u9875\u9762\u5339\u914d\u3002",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "\u641c\u7d22\u5b8c\u6210\uff0c\u5339\u914d\u5230 ${resultCount} \u9875\u3002",
         "Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u7d22",
-        "Searching": "\u641c\u7d22\u4e2d",
-        "Searching for multiple words only shows matches that contain\n    all words.": "\u641c\u5bfb\u5305\u542b\u591a\u4e2a\u5b57\u7684\u8bcd\u6c47\u65f6\uff0c\n    \u53ea\u6709\u6240\u542b\u6240\u6709\u5185\u5bb9\u90fd\u5339\u914d\u65f6\u624d\u4f1a\u51fa\u73b0\u3002",
+        "Searching": "\u6b63\u5728\u641c\u7d22\u4e2d",
+        "Searching for multiple words only shows matches that contain\n    all words.": "\u5f53\u641c\u7d22\u591a\u4e2a\u5173\u952e\u8bcd\u65f6\uff0c\u53ea\u4f1a\u663e\u793a\u540c\u65f6\u5305\u542b\u6240\u6709\u5173\u952e\u8bcd\u7684\u5185\u5bb9\u3002",
         "Show Source": "\u663e\u793a\u6e90\u4ee3\u7801",
         "Table of Contents": "\u76ee\u5f55",
         "This Page": "\u672c\u9875",
-        "Welcome! This is": "\u6b22\u8fce\uff01\u8fd9\u662f",
-        "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u6ca1\u6709\u4efb\u4f55\u6587\u6863\u5339\u914d\u60a8\u7684\u641c\u7d22\u3002\u8bf7\u786e\u4fdd\u4f60\u8f93\u5165\u7684\u8bcd\u62fc\u5199\u6b63\u786e\u5e76\u9009\u62e9\u4e86\u5408\u9002\u7684\u5206\u7c7b\u3002",
-        "all functions, classes, terms": "\u6240\u7684\u51fd\u6570\uff0c\u7c7b\uff0c\u672f\u8bed",
-        "can be huge": "\u53ef\u80fd\u4f1a\u5f88\u591a",
+        "Welcome! This is": "\u6b22\u8fce\uff01",
+        "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u60a8\u7684\u641c\u7d22\u6ca1\u6709\u5339\u914d\u5230\u6587\u6863\u3002\u8bf7\u786e\u4fdd\u5173\u952e\u8bcd\u62fc\u5199\u6b63\u786e\uff0c\u5e76\u4e14\u9009\u62e9\u4e86\u5408\u9002\u7684\u5206\u7c7b\u3002",
+        "all functions, classes, terms": "\u6240\u6709\u51fd\u6570\u3001\u7c7b\u3001\u672f\u8bed\u8bcd\u6c47",
+        "can be huge": "\u53ef\u80fd\u4f1a\u5927",
         "last updated": "\u6700\u540e\u66f4\u65b0\u4e8e",
         "lists all sections and subsections": "\u5217\u51fa\u6240\u6709\u7684\u7ae0\u8282\u548c\u90e8\u5206",
         "next chapter": "\u4e0b\u4e00\u7ae0",
@@ -57,7 +55,7 @@
         "quick access to all modules": "\u5feb\u901f\u67e5\u770b\u6240\u6709\u7684\u6a21\u5757",
         "search": "\u641c\u7d22",
         "search this documentation": "\u641c\u7d22\u6587\u6863",
-        "the documentation for": "\u8fd9\u4efd\u6587\u6863\u662f"
+        "the documentation for": "\u672c\u6587\u6863\u5c5e\u4e8e"
     },
     "plural_expr": "0"
 });
\ No newline at end of file

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -12,223 +12,230 @@
 # Nomaka <nomakacyx@gmail.com>, 2018
 # Lenville Leo <lenville@gmail.com>, 2013
 # Lenville Leo <lenville@gmail.com>, 2013
-# Nomaka <nomakacyx@gmail.com>, 2018
+# Lu <lu2github@gmail.com>, 2022-2023
+# Nomaka <nomakacyx@gmail.com>, 2018,2022
 # Ryekee Zhong <ryekee@gmail.com>, 2013
-# Komiya Takeshi <i.tkomiya@gmail.com>, 2019,2021
+# Komiya Takeshi <i.tkomiya@gmail.com>, 2019,2021-2022
 # Tower Joo<zhutao.iscas@gmail.com>, 2009
 # wendi cao <651645601@qq.com>, 2020
-# Yinian Chin <yinian1992@live.com>, 2013,2018,2020
+# Yinian Chin <yinian1992@live.com>, 2013,2018,2020,2022
 # Yinian Chin <yinian1992@live.com>, 2013
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-10 05:20+0000\n"
-"Last-Translator: JY3\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Lu <lu2github@gmail.com>, 2022-2023\n"
 "Language-Team: Chinese (China) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: zh_CN\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
-msgstr "无法找到源码目录 (%s)"
+msgstr "无法找到源文件目录（%s）"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
-msgstr ""
+msgstr "输出目录（%s）不是一个目录"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "源文件目录和目标目录不能是同一目录"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "正在运行 Sphinx v%s"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
-msgstr "该项目需要 Sphinx v%s 及以上版本，使用现有版本不能构建文档。"
+msgstr "该项目需要 Sphinx v%s 及以上版本，当前使用版本不能构建此文档。"
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
-msgstr "创建输出目录"
+msgstr "正在创建输出目录"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
-msgstr "同时设置扩展名 %s:"
+msgstr "在设置扩展名 %s 时："
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
-msgstr "当前 conf.py 中定义的 'setup' 不是一个可调用的 Python 对象。请把其定义改为一个可调用的函数。Sphinx 扩展的 conf.py 必须这样配置。"
+msgstr "当前 conf.py 中定义的 'setup' 不是一个 Python 的可调用对象。请修改其定义为一个可调用的函数。当 conf.py 作为 Sphinx 扩展时，必须依此配置。"
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
-msgstr "正在加载翻译 %s... "
+msgstr "正在加载翻译 %s…"
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "完成"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
-msgstr "没有内置信息的翻译"
+msgstr "没有找到内置信息的译文"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
-msgstr "加载 pickled环境"
+msgstr "正在加载 Pickle 序列化的环境"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "失败：%s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
-msgstr "未选择构建程序，默认使用：html"
+msgstr "未选择构建器，默认使用：html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "成功"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "完成但存在问题"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
-msgstr "构建 %s，%s 警告（将警告视为错误）。"
+msgstr "构建%s，%s 条警告（将警告视为错误）。"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
-msgstr "构建 %s，%s 警告（将警告视为错误）。"
+msgstr "构建%s，%s 条警告（将警告视为错误）。"
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
-msgstr "构建 %s, %s 警告。"
+msgstr "构建%s, %s 条警告。"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
-msgstr "构建 %s，%s 警告。"
+msgstr "构建%s，%s 条警告。"
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
-msgstr "构建 %s."
+msgstr "构建%s。"
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
-msgstr "节点类 %r 已注册，其访问者将被覆盖"
+msgstr "节点类 %r 已经注册过了，其访问者将被覆盖"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
-msgstr "指令 %r 已注册，将被覆盖"
+msgstr "指令 %r 已经注册过了，将被覆盖"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
-msgstr "角色 %r 已注册，将被覆盖"
+msgstr "角色 %r 已经注册过了，将被覆盖"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr "扩展 %s 没有声明是否并行读取安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明"
+msgstr "扩展 %s 没有声明是否并行读取安全，默认假定为否—请联系扩展作者检查是否支持该特性并显式声明"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "扩展 %s 不是并行读取安全的"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
 "assuming it isn't - please ask the extension author to check and make it "
 "explicit"
-msgstr "%s 扩展没有声明是否并行写入安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明"
+msgstr "%s 扩展没有声明是否并行写入安全，默认假定为否—请联系扩展作者检查是否支持该特性并显式声明"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "扩展 %s 不是并行写入安全的"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
-msgstr "执行顺序 %s"
+msgstr "执行串行 %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
-msgstr "配置目录中缺少 conf.py 文件 (%s)"
+msgstr "配置目录中缺少 conf.py 文件（%s）"
+
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "发现无效的配置值：“language = None”。请修改为有效的语言代码。回退至“en”（英语）。"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
-msgstr "不能覆盖字典配置项 %r，已忽略 (请用 %r 设置单个字典元素)"
+msgstr "不能覆盖字典配置项 %r，已忽略 （请用 %r 方式逐一修改字典成员）"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
-msgstr "无效的数值 %r 用于配置项 %r，已忽略"
+msgstr "%r 不是有效整数，配置项 %r 的值只能是整数，已忽略"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
-msgstr "配置项 %r 覆盖值类型不支持，已忽略"
+msgstr "无法用不支持的类型覆盖配置项 %r，已忽略"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
-msgstr "覆盖中包含未知配置项 %r ，已忽略"
+msgstr "配置覆盖中包含未知的配置项 %r，已忽略"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
-msgstr "不存在的配置项：%s"
+msgstr "不存在此配置项：%s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "配置项 %r 已存在"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
-msgstr "配置文件中存在语法错误: %s\n"
+msgstr "配置文件中存在语法错误：%s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "配置文件（或配置文件导入的模块）调用了 sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -236,994 +243,990 @@
 "%s"
 msgstr "配置文件中有程序上的错误：\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
-msgstr "配置值\"source_后缀\"需要字符串、字符串列表或字典。但给出\"%r\"。"
+msgstr "配置项“source_suffix”的值应为字符串、字符串列表或字典。但给定的值是“%r”。"
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "节 %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "图 %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "表 %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "列表 %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
-msgstr "配置项 `{name}` 必须设置为 {candidates} 之一，但现在是 `{current}` 。"
+msgstr "配置项“{name}”的值只能在“{candidates}”中选取，而当前给定的值是“{current}”。"
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
-msgstr "配置值\"name\"的类型为\"当前._name;但\"当前\"为\"当前\"。\"当前\"为\"当前\"。\"当前\"为\"当前\"。=================================预期 允许。"
+msgstr "配置项“{name}”的值被配置成“{current.__name__}”类型，应为{permitted}。"
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
-msgstr "配置项 `{name}' 的类型是 `{current.__name__}'，默认为 `{default.__name__}'。"
+msgstr "配置项“{name}”的值被配置成“{current.__name__}”类型，默认为“{default.__name__}”。"
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
-msgstr "未找到 primary_domain %r，已忽略。"
+msgstr "primary_domain %r 不存在，已忽略。"
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
-msgstr ""
+msgstr "自 v2.0 起，Sphinx 采用“index”作为 root_doc 的默认值。请在你的 conf.py 中添加“root_doc = 'contents'”。"
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "事件 %r 已存在"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
-msgstr "未知事件名称：%s"
+msgstr "未知的事件名称：%s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
-msgstr ""
+msgstr "事件处理函数 %r 在处理事件 %r 时抛出了异常"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
-msgstr "未能加载 needs_extensions 配置项所需的 %s。"
+msgstr "未能加载 needs_extensions 配置项指定的 %s 扩展。"
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
-msgstr "该项目所需扩展 %s 最低要求版本 %s ，当前加载版本 (%s) 无法构建文档。"
+msgstr "该项目要求扩展 %s 至少是 %s 版本，当前加载版本（%s）无法构建文档。"
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "未知的 Pygments 词法分析器 %r"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
-msgstr "无法按照“%s”语言的词法解析代码块，跳过语法高亮。"
+msgstr "无法按照“%s”语言的词法解析代码块，跳过该代码块的语法高亮。"
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
-msgstr ""
+msgstr "发现多个文件对应文档“%s”：%r\n将采用 %r 用于构建。"
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
-msgstr "无法读取文档，已忽略。"
+msgstr "无法读取文档源文件，已忽略。"
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
-msgstr "构建程序类 %s 未包含 \"name\" 属性"
+msgstr "构建器 %s 未包含“name”属性"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
-msgstr "构建程序 %r 已存在 (见模块 %s)"
+msgstr "构建器 %r 已存在（见模块 %s）"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
-msgstr "构建程序 %s 未注册或在入口点不可用"
+msgstr "构建器 %s 未注册或在入口点不可用"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
-msgstr "构建程序 %s 未注册"
+msgstr "构建器 %s 未注册"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
-msgstr "域 %s 已注册"
+msgstr "域 %s 已经注册过了"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
-msgstr "域 %s 尚未注册"
+msgstr "域 %s 未注册"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
-msgstr "%r 指令已注册到域 %s"
+msgstr "指令 %r 已经在域 %s 上注册过了"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
-msgstr "%r 角色已注册到域 %s"
+msgstr "角色 %r 已经在域 %s 上注册过了"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
-msgstr "%r 索引已注册到域 %s"
+msgstr "索引 %r 已经在域 %s 上注册过了"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
-msgstr "对象类型 %r 已注册"
+msgstr "对象类型 %r 已经注册过了"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
-msgstr "交叉引用类型 %r 已注册"
+msgstr "交叉引用类型 %r 已经注册过了"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
-msgstr "源文件扩展名 %r 已注册"
+msgstr "源文件扩展名 %r 已经注册过了"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
-msgstr "%r 的 source_parser 已注册"
+msgstr "%r 的源文件解析器已经注册过了"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "未注册 %s 的源代码语法分析器"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
-msgstr "翻译已存在 %r"
+msgstr "翻译器已存在 %r"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "add_node() 的关键字参数必须是 (visit, depart) 形式的函数元组：%r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
-msgstr "可数节点 %r 已注册"
+msgstr "可枚举节点 %r 已经注册过了"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
-msgstr ""
+msgstr "公式渲染器 %s 已经注册过了"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
-msgstr "扩展 %r 已合并至 Sphinx (自版本 %s 开始)；该扩展被忽略。"
+msgstr "扩展 %r 自 Sphinx %s 版本起合并至 Sphinx；因此，该扩展被忽略。"
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "原始异常：\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "无法导入扩展 %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
-msgstr "扩展 %r 未包含setup() 函数；它确实是一个 Sphinx 扩展模块吗？"
+msgstr "扩展 %r 缺少 setup() 函数；它确实是一个 Sphinx 扩展模块吗？"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
-msgstr "该项目所用扩展 %s 需要 Sphinx 版本 %s 以上；当前版本无法构建文档。"
+msgstr "该项目所用扩展 %s 需要 Sphinx %s 或以上版本；当前版本无法构建文档。"
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "扩展 %r 在其 setup() 函数中返回了一个不支持的对象；该函数应返回 None 或一个元数据字典"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
-msgstr "Python 提高建议; PEP %s"
+msgstr "Python 增强建议；PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
-msgstr ""
+msgstr "无效的 PEP 编号%s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
-msgstr ""
+msgstr "无效的 RFC 编号 %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
-msgstr "主题 %r 未包含 \"theme\" 配置"
+msgstr "主题 %r 未包含“theme”配置项"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
-msgstr "主题 %r 未包含 \"inherit\" 配置"
+msgstr "主题 %r 未包含“inherit”配置项"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
-msgstr "未找到主题 %r，则从 %r 继承"
+msgstr "未找到主题 %r；由于 %r 继承了它，无法继续。"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
-msgstr "配置项 %s.%s 在所有已找到主题配置中均未出现"
+msgstr "所有已找到的主题配置均未包含配置项 %s.%s"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "不支持的主题选项 %r"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
-msgstr "主题路径指定的文件 %r 是一个无效的或不包含主题的  zip 文件"
+msgstr "主题路径对应的文件 %r 是一个无效的或不包含主题的 zip 文件"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
-msgstr "主题 %r 未找到 (缺少 theme.conf？)"
+msgstr "未找到主题 %r（可能是因为缺少 theme.conf）"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
-msgstr "没有找到适合 %s 构建器的图像：%s (%s)"
+msgstr "没有找到适合 %s 构建器的图像：%s（%s）"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "没有找到适合 %s 构建器的图像：%s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
-msgstr "构建 mo： "
+msgstr "正在构建 mo： "
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
-msgstr "写入输出... "
+msgstr "正在写入输出……"
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "所有的 %d po 文件"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "指定了 %d 个 po 文件的目标文件"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "%d 个 po 文件的目标文件已过期"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "所有源文件"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr "命令行给定的文件 %r 不存在"
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
-msgstr "源文件目录下没有命令行给出的 %r 文件，将被忽略"
+msgstr "命令行给定的 %r 文件不再源文件目录中，将被忽略"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "命令行给出的 %r 文件不存在，将被忽略"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr "命令行给定的文件 %r 不是有效文件，将被忽略"
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
-msgstr "命令行给出了 %d 个源文件"
+msgstr "命令行给定了 %d 个源文件"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d 个源文件的目标文件已过期"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
-msgstr "构建 %s： "
+msgstr "正在构建 %s： "
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
-msgstr "查找当前已过期的文件... "
+msgstr "正在查找当前已过期的文件……"
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
-msgstr "找到 %d 个"
+msgstr "找到 %d 个已过期文件"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
-msgstr "没有找到"
+msgstr "没有找到已过期文件"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
-msgstr "pickling环境"
+msgstr "正在 Pickle 序列化环境"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
-msgstr "检查一致性"
+msgstr "正在校验一致性"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "没有过期的目标文件。"
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
-msgstr "更新环境: "
+msgstr "正在更新环境："
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
-msgstr "已添加 %s，%s 已更改，%s 已移除"
+msgstr "有 %s 个新增文件，有 %s 个文件已被修改，有 %s 个文件已被移除"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
-msgstr "阅读源... "
-
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "等待工作线程……"
+msgstr "正在读取源文件……"
 
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
-msgstr "写入文档：%s"
+msgstr "待写入文档：%s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
-msgstr "准备文件"
+msgstr "正在准备写入文档"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
-msgstr "找到重复的ToC条目: %s"
+msgstr "发现重复的目录条目：%s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
-msgstr "复制图像... "
+msgstr "正在复制图像文件……"
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
-msgstr "无法读取图像文件 %r：直接复制"
+msgstr "无法读取图像文件 %r：改为直接复制"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "无法复制图像文件 %r：%s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "无法写入图像文件 %r：%s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
-msgstr "未找到Pillow - 复制图像文件"
+msgstr "未找到 Pillow - 正在复制图像文件"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
-msgstr ""
+msgstr "正在写入 mimetype 文件……"
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
-msgstr ""
+msgstr "正在写入 META-INF/container.xml 文件……"
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
-msgstr ""
+msgstr "正在写入 content.opf 文件……"
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
-msgstr "%s 的 MIME 类型未知，将被忽略"
+msgstr "%s 的 MIME 类型未知，已忽略"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
-msgstr ""
+msgstr "正在写入 toc.ncx 文件……"
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "正在写入 %s 文件……"
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "概览文件保存在 %(outdir)s 目录 。"
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr "%s 版本中没有做出修改。"
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
-msgstr "写入摘要文件..."
+msgstr "正在写入摘要文件……"
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
-msgstr "内置"
+msgstr "内置模块"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
-msgstr "模块级别"
+msgstr "模块级"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
-msgstr "复制源文件……"
+msgstr "正在复制源文件……"
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
-msgstr "创建变更记录时无法读取 %r"
+msgstr "无法读取用于创建变更记录的 %r"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "伪构建器不生成文件。"
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
-msgstr "ePub文件保存在 %(outdir)s。"
+msgstr "ePub 文件保存在 %(outdir)s。"
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
-msgstr ""
+msgstr "正在写入 nav.xhtml 文件……"
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_language”（或“language”）不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_language”（或“language”）的值不能为空"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_uid”应为 XML 名称"
+msgstr "对于 EPUB3 格式，配置项“epub_uid”的值应为 XML 名称格式的字符串"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_title”（或“html_title”）不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_title”（或“html_title”）的值不能为空"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_author”不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_author”的值不能为空"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_contributor”不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_contributor”的值不能为空"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_description”不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_description”的值不能为空"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_publisher”不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_publisher”的值不能为空"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "对于 EPUB3 格式，配置项“epub_copyright”（或“copyright”）不能为空"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“epub_identifier”不能为空"
+msgstr "对于 EPUB3 格式，配置项“epub_identifier”的值不能为空"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
-msgstr "对于 EPUB3 格式，配置项“version”不能为空"
+msgstr "对于 EPUB3 格式，配置项“version”的值不能为空"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "无效的 css_file：%r，已忽略"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr "消息目录保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr "%d 个模板文件的目标文件"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
-msgstr "读取模板... "
+msgstr "正在读取模板……"
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
-msgstr "写入消息目录... "
+msgstr "正在写入消息目录... "
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
-msgstr "在上述输出或 %(outdir)s/output.txt 中检查错误"
+msgstr "请在上述输出或 %(outdir)s/output.txt 中查找错误"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
-msgstr "损坏的链接：%s(%s)"
+msgstr "损坏的链接：%s（%s）"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
-msgstr "锚点“%s”未找到"
+msgstr "未找到锚点“%s”"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
-msgstr ""
+msgstr "无法编译 linkcheck_allowed_redirects 配置项中的正则表达式：%r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr "手册页保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr "未找到“man_pages”配置项，不会写入手册页"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
-msgstr "写作"
+msgstr "正在写入"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
-msgstr "\"man_pages\"配置值引用未知文档 %s"
+msgstr "配置项“man_pages”引用的文档 %s 不存在"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "HTML 页面保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
-msgstr "组装单一文档"
+msgstr "正在装配成单页面文档"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
-msgstr "写入其他文件"
+msgstr "正在写入附加文件"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr "Texinfo 文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
-msgstr "\n在该目录下运行“make”命令以通过 makeinfo 运行这些 Texinfo文件\n（在此处用“make info”即可自动执行）。"
+msgstr "\n在该目录下运行“make”命令以通过 makeinfo 处理这些 Texinfo 文件\n（在此处用“make info”即可自动执行上述操作）。"
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr "未找到“texinfo_documents”配置项，不会写入文档"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
-msgstr "配置项“texinfo_documents”引用了未知文档 %s"
+msgstr "配置项“texinfo_documents”引用了文档 %s 不存在"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
-msgstr "处理 %s"
+msgstr "正在处理 %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
-msgstr "解析引用……"
+msgstr "正在解析引用……"
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (在 "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
-msgstr "复制 Texinfo 支持文件"
+msgstr "正在复制 Texinfo 支持文件"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
-msgstr "错误写入文件 Makefile： %s"
+msgstr "写入 Makefile 文件时出错：%s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr "文本文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr "写入文件 %s 时发生错误：%s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "XML 文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr "伪 XML 文件保存在 %(outdir)s。"
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr "构建信息文件损坏：%r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "HTML 页面保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr "读取构建信息文件失败：%r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y 年 %m 月 %d 日"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
-msgstr "总目录"
+msgstr "总索引"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "索引"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "下一页"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "上一页"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "正在生成索引"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr "正在写入附加页面"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
-msgstr "复制可下载文件... "
+msgstr "正在复制可下载文件……"
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "无法复制可下载文件 %r：%s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
-msgstr ""
+msgstr "无法复制 html_static_file 中的文件：%s: %r"
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
-msgstr ""
+msgstr "正在复制静态文件"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "无法复制静态文件 %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr "正在复制额外文件"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "无法复制额外文件 %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr "写入构建信息文件失败：%r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr "无法加载搜索索引，不会构建所有文档：索引将不完整。"
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr "页面 %s 匹配了 html_sidebars 中的两条规则：%r 和 %r"
+msgstr "页面 %s 同时符合两条 html_sidebars 规则：%r 和 %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
-msgstr "渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项是 Unicode 字符串。"
+msgstr "在渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项均为 Unicode 字符串。"
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr "渲染页面 %s 时发生了错误。\n原因：%r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr "正在导出对象清单"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr "正在导出 %s 的搜索索引"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "无效的 js_file：%r，已忽略"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
-msgstr "注册了多个 math_renderers。但没有选择任何 math_renderer。"
+msgstr "注册了多个 math_renderer，但没有选择 math_renderer。"
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
-msgstr "给定了未知的 math_renderer %r。"
+msgstr "给定的 math_renderer %r 不存在。"
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
-msgstr "html_extra_path 指向的 %r 不存在"
+msgstr "html_extra_path 入口 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr "html_extra_path 入口 %r 置于输出目录内"
+msgstr "html_extra_path 入口 %r 被置于输出目录内"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
-msgstr "html_static_path 指向的 %r 不存在"
+msgstr "html_static_path 入口 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr "html_static_path 入口 %r 置于输出目录内"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
-msgstr "logo文件 %r 不存在"
+msgstr "logo 文件 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
-msgstr "网站图标 文件 %r 不存在"
+msgstr "favicon 文件 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr "输出 HTML 4 的特性已弃用，将在 Sphinx 7 中删除（在配置选项中检测到 \"html4_writer=True）。"
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s 文档"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr "LaTex 文件保存在 %(outdir)s 目录。"
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
-msgstr "\n在该目录下运行“make”以通过 (pdf)latex 运行这些 LaTex 文件\n（在此处用“make latexpdf”即可自动执行）。"
+msgstr "\n在该目录下运行“make”以通过 (pdf)latex 处理这些 LaTex 文件\n（在此处用“make latexpdf”即可自动执行上述操作）。"
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr "未找到“latex_documents”配置项，不会写入文档"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
-msgstr "配置项“latex_documents”引用了未知文档 %s"
+msgstr "配置项“latex_documents”引用的文档 %s 不存在"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "索引"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
-msgstr "发布"
+msgstr "发行版本"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr "没有语种 %r 的 Babel 选项"
 
 #: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
-msgstr "复制 TeX 支持文件"
+msgstr "正在复制 TeX 支持文件"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
-msgstr "复制 TeX 支持文件……"
+msgstr "正在复制 TeX 支持文件……"
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
-msgstr "复制其他文件"
+msgstr "正在复制附加文件"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr "未知配置项：latex_elements%r，已忽略。"
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
-msgstr ""
+msgstr "未知主题选项：latex_theme_options%r，已忽略。"
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr "%r 未包含 \"theme\" 配置"
+msgstr "%r 中缺少“theme”配置项"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr "%r 未包含 \"%s\" 配置"
+msgstr "%r 中缺少“%s”配置项"
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
-msgstr "构建时抛出异常，启动调试器："
+msgstr "构建时抛出异常，正在启动调试器："
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr "已中断！"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr "reST 标记错误："
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr "编码错误："
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr "如果你想向开发者报告问题，可以查阅已经保存在 %s 的完整 Traceback 信息 。"
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr "递归错误："
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr ""
+msgstr "Python 中默认递归层数上限为 1000，可以像这样在 conf.py 中增大这一上限，请谨慎修改:"
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr "抛出异常："
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
-msgstr "如果此处抛出了用户的错误，也请向我们报告，这样以后可以显示更友好、更详细的错误信息。"
+msgstr "即便抛出的错误时是用户导致的，也请向我们投递报告，以便将来可以提示更友好、更详细的错误信息。"
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
-msgstr "请向 Bug 追踪系统 <https://github.com/sphinx-doc/sphinx/issues> 投递 Bug 报告。谢谢！"
+msgstr "Bug 报告可以在 Bug 追踪系统 <https://github.com/sphinx-doc/sphinx/issues> 处投递。谢谢！"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
-msgstr "工作编号应为正值"
+msgstr "并发任务数应为正值"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
-msgstr ""
+msgstr "想要了解更多信息，请访问 <https://www.sphinx-doc.org/>。"
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1240,290 +1243,285 @@
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\n从源文件生成文档。\n\nsphinx-build 从 SOURCEDIR 中的文件生成文档，并保存在 OUTPUTDIR。\n它从 SOURCEDIR 的“conf.py”中读取配置。“sphinx-quickstart”工具可以生\n成包括“conf.py”在内的模板文件。\n\nsphinx-build 可以生成多种格式的文档。在命令行中指定构建器名称即可\n选择文档格式，默认是 HTML。构建器也可以执行文档处理相关的其他\n任务。\n\n默认只会重新构建过期内容。如果指定了文件名，那么只会产生这些文件\n的输出。\n"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr "文档源文件的路径"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr "输出目录的路径"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr "指定重新构建的文件列表。如果指定了 -a 参数，则忽略此项"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr "通用选项"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr "构建器（默认：html）"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "写入所有文件（默认：只写入新文件和修改过的文件）"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr "不使用已保存的环境，始终读取全部文件"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
-msgstr "缓存环境和 doctree 文件路径（默认：OUTPUTDIR/.doctrees）"
+msgstr "已缓存的环境和 doctree 文件路径（默认：OUTPUTDIR/.doctrees）"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr "如果可能，用 N 个进程并行构建文档（如果指定为“auto”，则 N 为 CPU 数量）"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr "配置文件（conf.py）所在目录路径（默认：与 SOURCEDIR 相同）"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
-msgstr "只用 -D 选项时，不会采用任何配置文件"
+msgstr "不应用配置文件中的配置，只让 -D 选项中的配置项生效。"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr "覆盖配置文件中的配置项"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr "向 HTML 模板传值"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
-msgstr "定义标签，用于把涉及此 TAG 的“only”块的内容包含进来"
+msgstr "定义标签，把涉及标签 TAG 的“only”块纳入到构建中"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
-msgstr "挑刺模式，在引用失败时报警"
+msgstr "挑刺模式，在引用了不存在的内容时发出警告"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr "控制台输出选项"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr "输出更详细的日志（甚至可能重复）"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
-msgstr "不输出到 stdout，只在 stderr 上输出报警"
+msgstr "不输出到 stdout，只在 stderr 上输出警告"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
-msgstr "无任何输出，报警也不会输出"
+msgstr "无任何输出，甚至不会输出警告"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr "着色输出（默认：自动检测）"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr "不着色输出（默认：自动检测）"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
-msgstr "把警告（包含错误）信息写入给定的文件"
+msgstr "把警告（以及错误）信息写入给定的文件"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr "把警告视为错误"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr "与 -W 配合使用，在警告时继续运行"
+msgstr "与 -W 配合使用，在发出警告时继续运行"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr "发生异常时显示完整回溯信息"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr "发生异常时运行 Pdb"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr "无法找到文件 %r"
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr "-a 选项和文件名不能同时使用"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
-msgstr "无法打开警告信息文件 %r：%s"
+msgstr "无法打开用于保存警告信息的文件 %r：%s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr "-D 选项的参数必须是 name=value 形式"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr "-A 选项的参数必须是 name=value 形式"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
-msgstr "自动插入模块中的 Docstring"
+msgstr "自动插入模块中的文档字符串"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
-msgstr "自动测试 doctest 块中的测试代码片段"
+msgstr "自动运行 doctest 块中的测试代码片段"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr "链接不同项目的 Sphinx 文档"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr "编写在构建时可以选择显示、隐藏的“todo”条目"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr "检查文档覆盖率"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr "支持数学公式，渲染成 PNG 或 SVG 图像"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr "支持数学公式，用 MathJax 在浏览器中渲染"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
-msgstr "基于配置值控制是否在构建中包含文档内容"
+msgstr "基于配置值控制构建中包含哪些文档内容"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
-msgstr "支持链接到文档涉及的 Python 对象的源码"
+msgstr "支持链接到文档涉及的 Python 对象源码"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr "创建 .nojekyll 文件，用于在 GitHub Pages 服务发布文档"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr "请输入有效的路径名。"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr "请输入文本。"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr "请输入 %s 之一。"
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr "请输入“y”或“n”。"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "请输入文件后缀，例如：“.rst”或者“.txt”。"
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr "欢迎使用 Sphinx %s 快速配置工具。"
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr "请输入接下来各项设置的值（如果方括号中指定了默认值，直接\n按回车即可使用默认值）。"
+msgstr "请输入接下来各项设定的值（如果方括号中指定了默认值，直接\n按回车即可使用默认值）。"
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr "已选择根路径：%s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr "输入文档的根路径。"
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr "文档的根路径"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr "错误：选择的根路径中已存在 conf.py 文件。"
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr "sphinx-quickstart 不会覆盖已有的 Sphinx 项目。"
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr "请输入新的根路径（或按回车退出）"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr "有两种方式来设置 Sphinx 输出的创建目录：\n一是在根路径下创建“_build”目录，二是在根路径下创建“source”\n和“build”两个独立的目录。"
+msgstr "有两种方式来设置用于放置 Sphinx 输出的构建目录：\n一是在根路径下创建“_build”目录，二是在根路径下创建“source”\n和“build”两个独立的目录。"
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr "独立的源文件和构建目录（y/n）"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 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 "这个选项将在根目录中创建两个文件夹：“_templates”用于自定义 HTML 模板文件，“_static”用于自定义样式表及其他静态文件。您可以输入其它的前缀（比如“.”）代替下划线。"
+msgstr "这个选项将在根目录中创建两个新目录：\n“_templates”用于放置自定义 HTML 模板文件，“_static”用于自定义样\n式表及其他静态文件。您可以输入其他的前缀（比如“.”）代替下划线。"
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
-msgstr "模板目录名和静态目录名的前缀"
+msgstr "模板目录和静态目录的名称前缀"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr "项目名称将会出现在文档的许多地方。"
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr "项目名称"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr "作者名称"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "在 Sphinx 中，会区分“版本”和“发行版本”两个概念。同一版本可以\n有多个发行版本。例如，Python 版本可以是 2.5 或 3.0，而发行版\n本则是 2.5.1 或 3.0a1。如果你不需要这样的双重版本结构，请把这\n两个选项设置为相同值。"
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr "项目版本"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr "项目发行版本"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1531,115 +1529,115 @@
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr "如果用英语以外的语言编写文档，\n你可以在此按语言代码选择语种。\nSphinx 会把内置文本翻译成相应语言的版本。\n\n支持的语言代码列表见：\nhttp://sphinx-doc.org/config.html#confval-language。"
+msgstr "如果用英语以外的语言编写文档，\n你可以在此按语言代码选择语种。\nSphinx 会把内置文本翻译成相应语言的版本。\n\n支持的语言代码列表见：\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language。"
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr "项目语种"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr ""
+msgstr "源文件的文件名后缀。一般是“.txt”或“.rst”。只有此后缀的文件才会\n被视为文档的源文件。"
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr "源文件后缀"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr "这其中有一种特殊的文档被视作“目录树”的树顶节点，即文档层级\n结构的根。通常情况下，这个文档是“index”，但是如果你的“index”文\n档使用了自定义模板，你也可以使用其它文件名。"
+msgstr "有一种特殊的文档被视作“目录树”的树顶节点，即文档层级结构的\n根。通常情况下，这个文档是“index”，但是如果你的“index”文档\n使用了自定义模板，你也可以使用其它文件名。"
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr "主文档文件名（不含后缀）"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr "错误：选择的根目录下已存在主文档文件 %s。"
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr "sphinx-quickstart 不会覆盖已有的文件。"
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr "请输入新文件名，若要重命名现有文件请按回车"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
-msgstr "启用 Sphinx 扩展："
+msgstr "指出下列 Sphinx 扩展中，需要启用的有哪些："
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr "注意：imgmath 和 mathjax 不能同时启用。已取消选择 imgmath。"
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr "生成 Makefile 和 Windows 批处理文件，可以直接像“make html”这样\n运行，而不需要直接调用 sphinx-build。"
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
-msgstr "创建 Makefile？（y/n）"
+msgstr "是否创建 Makefile？（y/n）"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
-msgstr "创建 Windows 批处理文件？（y/n）"
+msgstr "是否创建 Windows 批处理文件？（y/n）"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
-msgstr "创建文件 %s。"
+msgstr "正在创建文件 %s。"
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
-msgstr "文件 %s 已存在，跳过。"
+msgstr "文件 %s 已存在，已跳过。"
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr "完成：已创建初始目录结构。"
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr "你现在可以填写主文档文件 %s 并创建其他文档源文件了。 "
+msgstr "你现在可以填写主文档文件 %s 然后创建其他文档源文件了。 "
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr "用 Makefile 构建文档，例如：\n make builder"
+msgstr "像这样用 Makefile 构建文档：\n  make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr "用 sphinx-build 命令构建文档，像这样：\n sphinx-build -b builder %s %s"
+msgstr "像这样用 sphinx-build 命令构建文档：\n  sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr "此处的“builder”是支持的构建器名，比如 html、latex 或 linkcheck。"
+msgstr "此处的“builder”代指支持的构建器名称，比如 html、latex 或 linkcheck。"
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1649,793 +1647,799 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr "\n生成 Sphinx 项目的必需文件。\n\nsphinx-quickstart 是一个交互式工具，询问一些关于项目的问题，生成\n完整的文档目录和用于 sphinx-build 的示例 Makefile。\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "静默模式"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "项目根目录"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
-msgstr "文档结构参数"
+msgstr "目录结构选项"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
-msgstr "如果指定了此选项，将使用独立的源文件目录和构建目录"
+msgstr "如果指定了此选项，将分别建立源文件目录和构建目录"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
-msgstr ""
+msgstr "如果指定了此选项，在源文件目录下创建构建目录"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
-msgstr "用点替代下划线，“ _templates”。"
+msgstr "用句点替代“ _templates”等文件夹名称中的下划线。"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "项目基本参数"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "项目名称"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "作者名称"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "项目版本"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "项目发行版本"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "项目语种"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "源文件后缀"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "主文档名"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "启用 ePub 支持"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "扩展程序选项"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "启用 %s 扩展"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "启用多个扩展"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "创建 Makefile 和批处理文件"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "创建 Makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "不创建 Makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "创建批处理文件"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "不创建批处理文件"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
-msgstr "使用用于 Makefile/make.bat 的 Make 模式"
+msgstr "Makefile/make.bat 采用 Sphinx 的 make 模式"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
-msgstr "不使用用于 Makefile/make.bat 的 Make 模式"
+msgstr "Makefile/make.bat 不采用 Sphinx 的 make 模式"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "项目模板"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "放置模板文件的模板目录"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "定义一个模板变量"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "指定了“quiet”，但是没有指定“project”和“author”。"
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr "错误：指定的路径不是一个目录，或是 Sphinx 文件已存在。"
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr "sphinx-quickstart 只会在空目录中生成文件。请指定一个新的根路径。"
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "无效模板变量：%s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
-msgstr ""
+msgstr "取消缩进操作清除了空白字符"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "无效的标题：%s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr "指定的行号超出范围（1-%d）：%r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
-msgstr "\"%s\" 和 \"%s\" 选项不能同时使用"
+msgstr "“%s”和“%s”选项不可联用"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
-msgstr "包含的文件 %r 不存在或读取失败"
+msgstr "要包含的文件 %r 不存在或读取失败"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr "用于读取包含文件 %r 的编码 %r 不正确，请重新给定 encoding: 选项"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
-msgstr "对象 %r 在包含文件 %r 中不存在"
+msgstr "对象 %r 未出现在包含文件 %r 中"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
-msgstr "不能在互斥的 \"lines\" 集合上使用 \"lineno-match\" 选项"
+msgstr "不能在不连续的“lines”上使用“lineno-match”选项"
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
-msgstr "行规范 %r：未能从包含文件 %r 中拉取行"
+msgstr "指定的行 %r：未能从包含文件 %r 中拉取指定的行"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
-msgstr ""
+msgstr "目录树 glob 规则 %r 未能匹配到文档"
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
-msgstr "toctree已包含对排除文档的引用 %r"
+msgstr "目录树中引用了已排除的文档 %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
-msgstr "目录树引用的文档 %r 不存在"
+msgstr "目录树中引用的文档 %r 不存在"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
-msgstr ""
+msgstr "目录树中存在重复的条目：%s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "节作者： "
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "模块作者： "
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "代码作者： "
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "作者： "
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
-msgstr ""
+msgstr ".. acks 的内容不是列表"
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
-msgstr ""
+msgstr ".. hlist 的内容不是列表"
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
-msgstr ""
+msgstr "csv-table 指令的“:file”选项现在会将绝对路径视为源文件目录的相对路径。请更新你的文档内容。"
 
 #: sphinx/domains/__init__.py:394
 #, python-format
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
-msgstr ""
+msgstr "重复的 C 声明，已经在 %s:%s 处声明。\n声明为“.. c:%s:: %s”。"
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
-msgstr ""
+msgstr "%s（C %s）"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "参数"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
-msgstr ""
+msgstr "返回值"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "返回"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "返回类型"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "成员"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "变量"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "函数"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "宏"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
-msgstr ""
+msgstr "结构体"
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "联合体"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "枚举"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
-msgstr "枚举子"
+msgstr "枚举成员"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "类型"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
-msgstr ""
+msgstr "函数参数"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
-msgstr "%s 新版功能"
+msgstr "在 %s 版本加入"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
-msgstr "在 %s 版更改"
+msgstr "在 %s 版本发生变更"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
-msgstr "%s 版后已移除"
+msgstr "自 %s 版本弃用"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
-msgstr "重复的引文 %s，已有引文出现在 %s"
+msgstr "重复的引文 %s，另一引文出现在 %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "引文 %s 没有被引用过。"
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
-msgstr ""
+msgstr "重复的 C++ 声明，已经在 %s:%s 处声明。\n声明为“.. cpp:%s:: %s”。"
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "模板参数"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
-msgstr "%s (C++ %s)"
+msgstr "%s（C++ %s）"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "抛出"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "类"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "概念"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
-msgstr ""
+msgstr "模板参数"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
-msgstr "%s() (內置函数)"
+msgstr "%s() （内置函数）"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
-msgstr "%s() (%s 方法)"
+msgstr "%s() （%s 方法）"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
-msgstr "%s() (类)"
+msgstr "%s()（类）"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
-msgstr "%s (全局变量或常量)"
+msgstr "%s（全局变量或常量）"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
-msgstr "%s (%s 属性)"
+msgstr "%s（%s 属性）"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "参数"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
-msgstr "%s (模块)"
+msgstr "%s（模块）"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "方法"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "数据"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "属性"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "模块"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
-msgstr "对%s重复的描述 %s，其它的%s出现在 %s"
+msgstr "重复的 %s描述 %s，其他的 %s 描述出现在 %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
-msgstr "重复的公式标签 %s，另一实例出现在 %s"
+msgstr "重复的公式标签 %s，另一公式出现在 %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "无效的 math_eqref_format：%r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "关键字"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "运算符"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "对象"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
-msgstr "例外"
+msgstr "异常"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "语句"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
-msgstr "內置函数"
+msgstr "内置函数"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "变量"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
-msgstr "引发"
+msgstr "抛出"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
-msgstr "%s() (在 %s 模块中)"
+msgstr "%s()（在 %s 模块中）"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
-msgstr "%s() (在 %s 模块中)"
+msgstr "%s()（在 %s 模块中）"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
-msgstr "%s (內置变量)"
+msgstr "%s（内置变量）"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
-msgstr "%s (內置类)"
+msgstr "%s（内置类）"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
-msgstr "%s (%s 中的类)"
+msgstr "%s（%s 中的类）"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
-msgstr "%s() (%s 类方法)"
+msgstr "%s()（%s 类方法）"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
-msgstr ""
+msgid "%s() (%s static method)"
+msgstr "%s()（%s 静态方法）"
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
-msgstr "%s() (%s 静态方法)"
+msgid "%s (%s property)"
+msgstr "%s（%s 属性）"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python 模块索引"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "模块"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
-msgstr "已移除"
+msgstr "已弃用"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "类方法"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "静态方法"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
-msgstr ""
+msgstr "托管属性"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
-msgstr "重复的对象描述%s ，另一实例出现在使用 noindex 中：对它们其中的一个 %s"
+msgstr "重复的 %s 对象描述，另一对象描述出现在 %s，请向二者之一添加 :noindex: 标记。"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "交叉引用 %r 找到了多个目标：%s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
-msgstr " (已移除)"
+msgstr "（已弃用）"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
-msgstr "%s (指令)"
+msgstr "%s（指令）"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
-msgstr "%s (指令选项)"
+msgstr ":%s:（指令选项）"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
-msgstr "%s (角色)"
+msgstr "%s（角色）"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "指令"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "指令-选项"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "角色"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
-msgstr "重复的引文 %s%s，已有引文出现在 %s"
+msgstr "重复的 %s %s 描述，另一描述出现在 %s"
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "环境变量; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "畸形的选项描述 %r，应是“opt”、“-opt args”、“--opt args”、“/opt args”或“+opt args”形式"
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s命令行选项"
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "命令行选项"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
-msgstr "词汇必须在空行之前"
+msgstr "术语词汇前必须有空行"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
-msgstr "词汇必须用空行分隔"
+msgstr "术语词汇不能用空行分隔"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
-msgstr "看起来形式不对的词汇建议检查缩进"
+msgstr "术语词汇格式不正确，请检查缩进"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
-msgstr "术语"
+msgstr "术语词汇"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "语法记号"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "引用标签"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "环境变量"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "程序选项"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "文档"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "模块索引"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "搜索页面"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
-msgstr "重复的标签 %s，已有标签出现在 %s"
+msgstr "重复的标签 %s，另一标签出现在 %s"
 
 #: sphinx/domains/std.py:666
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
-msgstr "对 %s的重复描述%s，其它实例出现在 %s"
+msgstr "重复的 %s 描述 %s，另一描述出现在 %s"
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig 已禁用，忽略 :numref:。"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
-msgstr ""
+msgstr "无法创建交叉引用。未指定题图数字：%s"
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "链接没有标题：%s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
-msgstr "无效的 numfig_format：%s (%r)"
+msgstr "无效的 numfig_format：%s（%r）"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "无效的 numfig_format：%s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr ""
+msgid "undefined label: %r"
+msgstr "标签未定义：%r"
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr ""
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr "无法创建交叉引用，缺少标题或图题：%r"
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "新配置"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
-msgstr "配置有变化"
+msgstr "配置发生了变化"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
-msgstr "扩展有变化"
+msgstr "扩展发生了变化"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "构建环境版本与当前环境不符"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
-msgstr "源文件目录已变化"
+msgstr "源文件目录发生了变化"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "本环境与选择的构建器不兼容，请选择其他的文档树目录。"
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
-msgstr "在 %s 中扫描文档失败：%r"
+msgstr "无法在 %s 中扫描文档：%r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
-msgstr "没有注册 %r 域"
+msgstr "未注册的域 %r"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "目录树存在自引用，已忽略。"
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "文档没有加入到任何目录树中"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "见 %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
-msgstr "参见 %s"
+msgstr "另请参见 %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "未知的索引条目类型 %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "符号"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr "在文档树中检测到循环引用，已忽略：%s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr "目录树引用的文档 %r 缺少标题：不会生成链接"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr "toctree 引用了未包含的文档 %r"
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr "无法读取图像文件：%s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr "无法读取图像文件 %s：%s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr "无法读取下载文件：%s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr "已经给 %s 分配了章节编号（嵌套的带编号文档树？）"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr "将会创建文件 %s。"
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2447,209 +2451,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr "\n在 <MODULE_PATH> 中递归查找 Python 模块和包，然后在 <OUTPUT_PATH> 中为每个使用了\nautomodule 指令的包创建一个 reST 文件。\n\n<EXCLUDE_PATTERN> 可以排除生成符合规则的文件/目录的文档。\n\n提示：本脚本默认不会覆盖已有文件。"
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
-msgstr "要生成文档的模块路径"
+msgstr "指定模块的路径，用于生成该模块的文档"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
-msgstr "排除的文件/目录，fnmatch 风格的规则"
+msgstr "以 fnmatch 风格的文件/目录规则，不生成与该规则匹配的文档"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
-msgstr "输出的目录"
+msgstr "存放输出内容的目录"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
-msgstr "在目录树中显示的子模块最大深度（默认：4）"
+msgstr "在目录树中展示子模块的最大深度（默认：4）"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr "覆盖已有文件"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr "遵循符号链接。配合 collective.recipe.omelette 使用尤其奏效。"
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr "运行脚本，但不创建文件"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
-msgstr "模块有各自的文档页"
+msgstr "给模块创建各自的文档页"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr "包含“_private”模块"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
-msgstr "目录文件名 (默认: 模块)"
+msgstr "目录的文件名（默认：modules）"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr "不创建目录文件"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
-msgstr "不创建模块/包的标题（比如当 Docstring 中已经有标题时，可以使用这个选项）"
+msgstr "不创建模块/包的标题（比如当 docstring 中已经有标题时，可以使用这个选项）"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
-msgstr "模块文档先于子模块文档"
+msgstr "把模块文档放置在子模块文档之前"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr "根据 PEP-0420 隐式命名空间规范解释模块路径"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr "文件后缀（默认：rst）"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr "用 sphinx-quickstart 生成完整项目"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr "当指定了 --full 选项，把 module_path 附加到 sys.path"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr "项目名称（默认：根模块名）"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr "项目作者，指定了 --full 选项时使用"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr "项目版本，指定了 --full 选项时使用"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
-msgstr "项目发行版本，指定了 --full 选项时使用，默认与 --doc-version 等同"
+msgstr "项目发行版本，指定了 --full 选项时使用，默认为 --doc-version 的值"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr "扩展选项"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s 不是一个目录。"
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr "为\"%s\"一节增加标签\"%s\""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
-msgstr "无效的正则表达式 %r 在 %s"
+msgstr "无效的正则表达式 %r 出现在 %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
-msgstr "已完成源文件的覆盖率测试，请在 %(outdir)s/python.txt 中查看结果。"
+msgstr "已完成源文件的覆盖率测试，结果保存在 %(outdir)s/python.txt 中，请查阅。"
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr "coverage_c_regexes 中有无效的正则表达式 %r"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
-msgstr ""
+msgstr "缺少文档的 C API：%s %s 在 %s 文件中"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr "无法导入模块 %s：%s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
-msgstr ""
+msgstr "缺少文档的 Python 函数： %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
-msgstr ""
+msgstr "缺少文档的 Python 类：%s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
-msgstr ""
+msgstr "缺少文档的 Python 方法：%s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
-msgstr "'%s' 选项中缺少 '+' 或 '-'。"
+msgstr "“%s”选项中缺少“+”或“-”。"
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
-msgstr "'%s' 不是一个有效选项。"
+msgstr "无效的选项“%s”。"
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
-msgstr "'%s' 不是一个有效的 pyversion 选项"
+msgstr "无效的 pyversion 选项“%s”"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr "无效的 TestCode 类型"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
-msgstr "已完成源文件的文档测试，请在 %(outdir)s/output.txt 中查看结果。"
+msgstr "已完成源文件的文档测试，结果保存在 %(outdir)s/output.txt 中，请查阅。"
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
-msgstr "块 %s 没有代码或没有输出，出现在 %s:%s"
+msgstr "块 %s 没有代码或没有输出，该块出现在 %s:%s"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
-msgstr "y已忽略无效的文档代码：%r"
+msgstr "已忽略无效的文档代码：%r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
-msgstr "====================== 最长阅读时长 ======================="
+msgstr "====================== 最长读取耗时 ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
-msgstr ""
+msgstr "可以用 extlink 替换硬编码链接 %r（请尝试改用 %r）"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
-msgstr "Graphviz 指令不能同时指定内容和文件名参数"
+msgstr "不能同时指定 Graphviz 指令的内容和文件名参数"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr "外部 Graphviz 文件 %r 不存在或读取失败"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
-msgstr "已忽略无内容的 \"graphviz 指令。"
+msgstr "已忽略无内容的“graphviz”指令。"
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2657,16 +2666,16 @@
 "%r\n"
 "stdout\n"
 "%r"
-msgstr "dot没有生成输出文件:\nstderr\n%r\nstdout\n%r"
+msgstr "dot 未生成输出文件：\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
-msgstr "无法运行 Dot 命令 %r (Graphviz 输出所需)，请检查 graphviz_dot 配置"
+msgstr "无法运行 dot 命令 %r（为输出 graphviz 所必需），请检查 graphviz_dot 的设置"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2674,35 +2683,37 @@
 "%r\n"
 "stdout\n"
 "%r"
-msgstr "点退出错误:\nstderr\n%r\nstdout\n%r"
+msgstr "dot 发生错误并退出：\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr "graphviz_output_format 必须是 'png' 或 'svg' 中之一，现为 %r"
+msgstr "graphviz_output_format 的值只能是“png”或“svg”，但现在给定的是 %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
-msgstr "点 代码 %r: %s"
+msgstr "dot 代码 %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "图表：%s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "图表"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %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"
+"\n"
+"Traceback: %s"
+msgstr "无法运行图像转换命令 %r。“sphinx.ext.imgconverter”默认依赖于 ImageMagick。请确保已安装了它，或者可以自定义“image_converter”选项，设置一个其他的转换命令。\n\n回溯信息：%s"
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2710,334 +2721,343 @@
 "%r\n"
 "stdout\n"
 "%r"
-msgstr "转换退出时出错:\nstderr\n%r\nstdout\n%r"
+msgstr "格式转换发生错误并退出：\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr "格式转换命令 %r 不能执行。请检查 image_converter 设置"
+msgstr "无法运行格式转换命令 %r，请检查 image_converter 的设置"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
-msgstr "无法运行 LaTeX 命令 %r （数学公式显示必需），请检查 imgmath_latex 设置"
+msgstr "无法运行 LaTeX 命令 %r （显示数学公式所必需），请检查 imgmath_latex 的设置"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
-msgstr "无法运行 %s 命令 %r （数学公式显示必需），请检查 imgmath_%s 设置"
+msgstr "无法运行 %s 命令 %r （显示数学公式所必需），请检查 imgmath_%s 的设置"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr "显示 LaTeX %r：%s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr "内联 LaTeX %r：%s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
-msgstr "公式的永久链接"
+msgstr "此公式的永久链接"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
-msgstr "intersphinx库存已被移动: %s -> %s"
+msgstr "intersphinx 清单被移动过：%s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr "从中加载intersphinx库存 %s..."
+msgstr "正在从 %s 加载 intersphinx 清单……"
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
-msgstr "遇到了一些库存问题，但他们有其他工作方式："
+msgstr "在读取这些清单时遇到了一些问题，但已找到可用替代："
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
-msgstr "访问对象清单时报错："
+msgstr "无法访问任何清单，问题如下："
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
-msgstr "(在 %s v%s)"
+msgstr "（在 %s v%s）"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
-msgstr "(在 %s)"
+msgstr "（在 %s）"
+
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr "未找到用于外部交叉引用的清单：%s"
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr "未找到用于外部交叉引用的角色：%s"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "未找到外部 %s:%s 引用目标：%s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
-msgstr "跨 Sphinx 标识 %r 不是字符串，已忽略"
+msgstr "intersphinx 标识符 %r 不是字符串，已忽略"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
-msgstr "无法读取intersphinx_mapping%s，忽略：%r"
+msgstr "无法读取 intersphinx_mapping%s，已忽略：%r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "源代码"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "待处理"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
-msgstr "已发现 TODO 条目：%s"
+msgstr "发现待处理条目：%s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> 见 %s，第 %d 行。)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
-msgstr "原始记录"
+msgstr "原始条目"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
-msgstr "突出显示模块代码... "
+msgstr "正在高亮模块代码……"
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "文档"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "模块代码"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s 源代码</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "概览：模块代码"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>代码可用的所有模块</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
-msgstr ""
+msgstr "无效的 member-order 选项值：%s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
-msgstr ""
+msgstr "无效的 class-doc-from 选项值：%s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr "无效的 auto%s 签名（%r）"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
-msgstr "格式化 %s 参数时报错：%s"
-
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr "属性 %s 不存在，在对象 %s 上"
+msgstr "在格式化 %s 的参数时报错：%s"
 
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc：无法确定是否生成 %s.%s (%r) 的文档，抛出了下列异常：\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
 "\"module\" or \"currentmodule\" directive in the document, or giving an "
 "explicit module name)"
-msgstr "无法判断导入哪个模块来自动生成文档 %r（尝试在文档中使用“module”或“currentmodule”指令，或者显式给定模块名）"
+msgstr "无法判断导入哪个模块以自动生成文档 %r（尝试在文档中使用“module”或“currentmodule”指令，或者显式给定模块名）"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
-msgstr ""
+msgstr "检测到仿制的对象：%r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
-msgstr ""
+msgstr "在格式化 %s 的签名时发生错误：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "automodule 名中的“::”无意义"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "automodule %s 给定了函数签名参数或返回类型标注"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__  应是一个字符串列表，而不是 %r （出现在模块 %s 中） -- 已忽略__all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
-msgstr ""
+msgstr ":members: 选项中涉及的属性不存在：模块 %s，属性%s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
-msgstr ""
+msgstr "无法获取函数 %s 的签名：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
-msgstr ""
+msgstr "无法获取构造函数 %s 的签名：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "基类：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "指定了 %s 属性，但对象 %s 缺少该属性"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
-msgstr ""
+msgstr "%s 的别名"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
-msgstr ""
+msgstr "TypeVar(%s) 的别名"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
-msgstr ""
+msgstr "无法获取方法 %s 的签名：%s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
-msgstr ""
+msgstr "%s 上有无效的 __slots__，已忽略。"
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
-msgstr ""
+msgstr "无法解析 %r 的默认参数值：%s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
-msgstr ""
+msgstr "无法更新 %r 的签名：未找到参数：%s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
-msgstr ""
+msgstr "无法解析 %r 的类型注释：%s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
-msgstr "autosummary 引用了排除的文档 %r。已忽略。"
+msgstr "自动摘要引用了排除的文档 %r，已忽略。"
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
-msgstr "autosummary：无法找到根文件 %r。检查你的 autosummary_generate 设置。"
+msgstr "自动摘要：无法找到存根文件 %r。请检查你的 autosummary_generate 设置。"
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
-msgstr ""
+msgstr "在自动摘要中指定标题时也需要指定 :toctree: 选项，已忽略。"
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "自动摘要：无法导入 %s。\n可能原因：\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "无法解析名称 %s"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "无法导入对象 %s"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
-msgstr "autosummary_generate：无法找到文件 %s"
+msgstr "autosummary_generate 配置项：文件 %s 不存在"
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
-msgstr "autosummary 内部生成 .rst 文件，但是 source_suffix 中不包含 .rst，已跳过。"
+msgstr "自动摘要内部会生成 .rst 文件，但是 source_suffix 中未包含 .rst，已跳过。"
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
-msgstr "autosummary：无法判断是否生成 %r 的文档。出现了下列异常：\n%s"
+msgstr "自动摘要：无法判断是否生成 %r 的文档。抛出了下列异常：\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
-msgstr "autosummary 生成 autosummary：%s"
+msgstr "自动摘要 正在生成自动摘要：%s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
-msgstr "autosummary 写入 %s"
+msgstr "自动摘要 正在写入 %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "自动摘要无法导入 %s。\n可能原因：\n%s"
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3050,143 +3070,143 @@
 "``sphinx.ext.autosummary`` Python module and can be read using::\n"
 "\n"
 "  pydoc sphinx.ext.autosummary\n"
-msgstr "\n用 autosummary 指令生成 ReStructuredText\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的前端，它根据给定\n的输入文件中的 autosummary 指令生成 reStructuredText  文件\n\nautosummary 指令的格式见 Python 模块 ``sphinx.ext.autosummary`` 的文\n档，并且可以这样调出文档阅读::\n\n  pydoc sphinx.ext.autosummary\n"
+msgstr "\n用 autosummary 指令生成 ReStructuredText\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的前端，它根据\n给定输入文件中的 autosummary 指令生成 reStructuredText 文件。\n\nautosummary 指令的格式见 Python 模块 ``sphinx.ext.autosummary`` 的\n文档。可以这样调出文档以供阅读::\n\n  pydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
-msgstr "用于生成 rST 文件的源文件"
+msgstr "用于生成 rst 文件的源文件"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
-msgstr "输出目录"
+msgstr "存放输出内容的目录"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "默认的文件名后缀（默认：%(default)s）"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "自定义模板目录（默认：%(default)s）"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "文档导入的成员（默认：%(default)s）"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
-msgstr ""
+msgstr "仅生成模块中 __all__ 属性成员的文档。（默认值：%(default)s）"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "关键字参数"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "示例"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
-msgstr "实际案例"
+msgstr "示例"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
-msgstr "提示"
+msgstr "备注"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "其他参数"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
-msgstr ""
+msgstr "接受"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "引用"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "警告"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "生成器"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
-msgstr ""
+msgstr "无效的值集合（缺少右括号）：%s"
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
-msgstr ""
+msgstr "无效的值集合（缺少左括号）：%s"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
-msgstr ""
+msgstr "异常的字符串字面量（缺少右引号）：%s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
-msgstr ""
+msgstr "异常的字符串字面量（缺少左引号）：%s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "小心"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "危险"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "错误"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "提示"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "重要"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "备注"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "参见"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "小技巧"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "警告"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
-msgstr "续上页"
+msgstr "接上页"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
-msgstr "下页继续"
+msgstr "续下页"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:10
 msgid "Non-alphabetical"
@@ -3194,7 +3214,7 @@
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:12
 msgid "Numbers"
-msgstr "数值"
+msgstr "数字"
 
 #: sphinx/templates/latex/sphinxmessages.sty_t:13
 msgid "page"
@@ -3205,14 +3225,14 @@
 msgid "Table of Contents"
 msgstr "目录"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "搜索"
 
 #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16
 msgid "Go"
-msgstr "转向"
+msgstr "提交"
 
 #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15
 msgid "Show Source"
@@ -3224,11 +3244,11 @@
 
 #: sphinx/themes/basic/defindex.html:15
 msgid "Welcome! This is"
-msgstr "欢迎！这是"
+msgstr "欢迎！"
 
 #: sphinx/themes/basic/defindex.html:16
 msgid "the documentation for"
-msgstr "这份文档是"
+msgstr "本文档属于"
 
 #: sphinx/themes/basic/defindex.html:17
 msgid "last updated"
@@ -3240,7 +3260,7 @@
 
 #: sphinx/themes/basic/defindex.html:23
 msgid "Complete Table of Contents"
-msgstr "完整的内容表"
+msgstr "完整目录"
 
 #: sphinx/themes/basic/defindex.html:24
 msgid "lists all sections and subsections"
@@ -3260,7 +3280,7 @@
 
 #: sphinx/themes/basic/defindex.html:31
 msgid "all functions, classes, terms"
-msgstr "所的函数，类，术语"
+msgstr "所有函数、类、术语词汇"
 
 #: sphinx/themes/basic/genindex-single.html:33
 #, python-format
@@ -3272,54 +3292,54 @@
 #: sphinx/themes/basic/genindex-split.html:38
 #: sphinx/themes/basic/genindex.html:73
 msgid "Full index on one page"
-msgstr "一页的全部索引"
+msgstr "单页全索引"
 
 #: sphinx/themes/basic/genindex-split.html:16
 msgid "Index pages by letter"
-msgstr "按照字母的索引页"
+msgstr "字母索引"
 
 #: sphinx/themes/basic/genindex-split.html:25
 msgid "can be huge"
-msgstr "可能会很多"
+msgstr "可能会大"
 
 #: sphinx/themes/basic/layout.html:29
 msgid "Navigation"
 msgstr "导航"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "在 %(docstitle)s 中搜索"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
-msgstr "关于这些文档"
+msgstr "关于此文档"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "版权所有"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\"> 版权所有</a> %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; 版权所有 %(copyright)s."
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "最后更新于 %(last_updated)s."
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
 "%(sphinx_version)s."
-msgstr ""
+msgstr "由 <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s创建。"
 
 #: sphinx/themes/basic/opensearch.xml:4
 #, python-format
@@ -3328,7 +3348,7 @@
 
 #: sphinx/themes/basic/relations.html:12
 msgid "Previous topic"
-msgstr "上一个主题"
+msgstr "上一主题"
 
 #: sphinx/themes/basic/relations.html:14
 msgid "previous chapter"
@@ -3336,7 +3356,7 @@
 
 #: sphinx/themes/basic/relations.html:19
 msgid "Next topic"
-msgstr "下一个主题"
+msgstr "下一主题"
 
 #: sphinx/themes/basic/relations.html:21
 msgid "next chapter"
@@ -3352,23 +3372,23 @@
 msgid ""
 "Searching for multiple words only shows matches that contain\n"
 "    all words."
-msgstr "搜寻包含多个字的词汇时，\n    只有所含所有内容都匹配时才会出现。"
+msgstr "当搜索多个关键词时，只会显示同时包含所有关键词的内容。"
 
 #: sphinx/themes/basic/search.html:42
 msgid "search"
 msgstr "搜索"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "搜索结果"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
-msgstr "没有任何文档匹配您的搜索。请确保你输入的词拼写正确并选择了合适的分类。"
+msgstr "您的搜索没有匹配到文档。请确保关键词拼写正确，并且选择了合适的分类。"
 
 #: sphinx/themes/basic/searchbox.html:12
 msgid "Quick search"
@@ -3382,7 +3402,7 @@
 #: sphinx/themes/basic/changes/versionchanges.html:12
 #, python-format
 msgid "Changes in Version %(version)s &#8212; %(docstitle)s"
-msgstr "更改发生在版本 %(version)s&#8212; %(docstitle)s"
+msgstr "于版本 %(version)s&#8212; %(docstitle)s 变更"
 
 #: sphinx/themes/basic/changes/rstsource.html:5
 #, python-format
@@ -3392,294 +3412,292 @@
 #: sphinx/themes/basic/changes/versionchanges.html:17
 #, python-format
 msgid "Automatically generated list of changes in version %(version)s"
-msgstr "自动生成的 %(version)s 版本中的更改列表"
+msgstr "自动生成的 %(version)s 版本变更列表"
 
 #: sphinx/themes/basic/changes/versionchanges.html:18
 msgid "Library changes"
-msgstr "库更改"
+msgstr "库的变更"
 
 #: sphinx/themes/basic/changes/versionchanges.html:23
 msgid "C API changes"
-msgstr "C API 更改"
+msgstr "C API 的变更"
 
 #: sphinx/themes/basic/changes/versionchanges.html:25
 msgid "Other changes"
-msgstr "其他更改"
+msgstr "其他变更"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "永久链接至标题"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "永久链接至目标"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "隐藏搜索结果"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "搜索完成，匹配到 ${resultCount} 页。"
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
-msgstr "搜索中"
+msgstr "正在搜索中"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
-msgstr "准备搜索……"
-
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "搜索完成，有 %s 个页面匹配。"
+msgstr "正在准备搜索……"
 
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
-msgstr "， 在 "
+msgstr "，在 "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "展开边栏"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "隐藏搜索结果"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "折叠边栏"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "展开边栏"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "目录"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
-msgstr "发现使用了 4 列布局的索引页。可能是你所用的扩展出现了 Bug：%r"
+msgstr "索引页使用了 4 列布局，可能是你所用的扩展出现了 Bug：%r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "脚注 %s 没有被引用过。"
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "脚注 # 没有被引用过。"
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
-msgstr "译文中的脚注引用与原文不一致。原始为：{0}，翻译后为：{1}"
+msgstr "译文中的脚注引用与原文不一致。原文中为：{0}，翻文中为：{1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
-msgstr "译文中的引用与原文不一致。原始为：{0}，翻译后为：{1}"
+msgstr "译文中的引用与原文不一致。原文中为：{0}，译文中为：{1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
-msgstr "译文中的引文引用与原文不一致。原始为：{0}，翻译后为：{1}"
+msgstr "译文中的引文引用与原文不一致。原文中为：{0}，译文中为：{1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
-msgstr "译文中的术语引用与原文不一致。原始为：{0}，翻译后为：{1}"
+msgstr "译文中的术语引用与原文不一致。原文中为：{0}，译文中为：{1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
-msgstr ""
+msgstr "无法确定交叉引用的回退文本。可能是 Bug。"
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
-msgstr "找到了多个目标 'any' 交叉引用的目标不唯一 %r: 可能是 %s"
+msgstr "“any”交叉引用 %r 的目标不唯一：可能是 %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
-msgstr ""
+msgstr "未找到 %s:%s 的引用目标: %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
-msgstr ""
+msgstr "未找到 %r 的引用目标：%s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
-msgstr "无法获取远程图像：%s %d"
+msgstr "无法拉取远程图像：%s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
-msgstr "无法获取远程图像：%s %s"
+msgstr "无法拉取远程图像：%s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "未知的图像格式：%s……"
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "源码中存在编码无法识别的字符，已经替换为“?”：%r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
-msgstr "跳过"
+msgstr "已跳过"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "失败"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
-msgstr ""
+msgstr "%s 域中的问题：字段应采用“%s”角色，但域中并不包含该角色。"
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
-msgstr ""
+msgstr "未知的指令或角色名称：%s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "未知节点类型：%r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "读取时发生错误：%s，%s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "写入时发生错误：%s，%s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
-msgstr ""
+msgstr "locale_dir %s不存在 "
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
-msgstr "无效的日期格式。如果你想直接输出日期字符串，请用单引号：%s"
+msgstr "无效的日期格式。如果你想直接输出日期字符串，请用单引号包裹该字符串：%s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "目录树引用的文件 %r 不存在"
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
-msgstr "only 指令表达式求值时抛出异常：%s"
+msgstr "only 指令的表达式求值时抛出异常：%s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
-msgstr "默认角色 %s 未找到"
+msgstr "未找到默认角色 %s"
+
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "永久链接至目标"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "未定义 %s 的 numfig_format"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "没有给 %s 节点分配 ID"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
-msgstr ""
+msgstr "此术语词汇的永久链接"
+
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "此标题的永久链接"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
-msgstr "永久链接至表格"
+msgstr "此表格的永久链接"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
-msgstr "永久链接至代码"
+msgstr "此代码块的永久链接"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
-msgstr "永久链接至图片"
+msgstr "此图像的永久链接"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
-msgstr "永久链接至目录树"
+msgstr "此目录树的永久链接"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "无法获取图像尺寸，已忽略 :scale: 选项。"
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
-msgstr "未知的 %r toplevel_sectioning，用于 %r 类"
+msgstr "未知的 %r toplevel_sectioning 被用于 %r 类"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
-msgstr "过大的 :mathdepth:，已忽略。"
+msgstr ":mathdepth: 值过大，已忽略。"
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "文档标题不是一个单纯文本节点"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "在节、话题、表格、警示或边栏以外的位置发现标题节点"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "脚注"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
-msgstr "给出了表格列和 ：width：选项。：宽度：被忽略。"
+msgstr "同时指定了 tabularcolumns 和 :widths: 选项，已忽略 :widths:。"
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "无效的量纲单位 %s，已忽略。"
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "发现未知的索引条目类型 %s"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "图片： %s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "图片"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
-msgstr "在图示之外发现了图示标题。"
+msgstr "在图示之外发现了图题。"
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "未实现的节点类型：%r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Chinese (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_HK/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: zh_HK\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.js Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po Changed

@@ -1,5 +1,5 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
@@ -7,134 +7,134 @@
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: Chinese (Taiwan) (Big5)  (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW.Big5/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: zh_TW.Big5\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr ""
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr ""
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr ""
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr ""
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr ""
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr ""
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr ""
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr ""
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr ""
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr ""
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr ""
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr ""
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr ""
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -142,12 +142,12 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -155,64 +155,70 @@
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr ""
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr ""
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -220,898 +226,894 @@
 "%s"
 msgstr ""
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr ""
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr ""
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr ""
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr ""
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr ""
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr ""
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr ""
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr ""
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr ""
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr ""
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
+msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr ""
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr ""
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr ""
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
 msgstr ""
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
@@ -1120,94 +1122,94 @@
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1226,271 +1228,266 @@
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 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"
@@ -1499,15 +1496,15 @@
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1517,21 +1514,21 @@
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 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"
@@ -1539,91 +1536,91 @@
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1633,230 +1630,230 @@
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr ""
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr ""
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
 msgstr ""
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1867,414 +1864,415 @@
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr ""
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr ""
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr ""
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr ""
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr ""
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr ""
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr ""
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr ""
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
+#: sphinx/domains/python.py:869
 #, python-format
-msgid "%s (%s property)"
+msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:1007
 #, python-format
-msgid "%s() (%s static method)"
+msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr ""
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr ""
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
@@ -2284,142 +2282,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
+msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr ""
+
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2431,209 +2434,214 @@
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
 msgstr ""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr ""
+
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2643,14 +2651,14 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2660,33 +2668,35 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %s"
+"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"
+"\n"
+"Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2696,163 +2706,173 @@
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr ""
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr ""
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
@@ -2860,113 +2880,112 @@
 "explicit module name)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr ""
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr ""
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2974,46 +2993,46 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
@@ -3021,7 +3040,7 @@
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3036,138 +3055,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr ""
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr ""
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr ""
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr ""
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr ""
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr ""
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr ""
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr ""
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr ""
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr ""
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr ""
@@ -3189,7 +3208,7 @@
 msgid "Table of Contents"
 msgstr ""
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr ""
@@ -3270,35 +3289,35 @@
 msgid "Navigation"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr ""
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3343,12 +3362,12 @@
 msgstr ""
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr ""
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3390,280 +3409,278 @@
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr ""
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr ""
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
 msgstr ""
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr ""
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr ""
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr ""
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr ""
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr ""
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr ""
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr ""
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr ""
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr ""
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr ""
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr ""
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr ""
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js Changed

@@ -6,9 +6,9 @@
         "&#169; Copyright %(copyright)s.": "&#169; \u7248\u6b0a\u6240\u6709 %(copyright)s\u3002",
         ", in ": "\uff0c\u65bc ",
         "About these documents": "\u95dc\u65bc\u9019\u4e9b\u6587\u4ef6",
-        "Automatically generated list of changes in version %(version)s": "\u81ea\u52d5\u7522\u751f\u7684 %(version)s \u7248\u672c\u8b8a\u66f4\u5217\u8868",
+        "Automatically generated list of changes in version %(version)s": "\u81ea\u52d5\u7522\u751f\u7684 %(version)s \u7248\u8b8a\u66f4\u5217\u8868",
         "C API changes": "C API \u7684\u8b8a\u66f4",
-        "Changes in Version %(version)s &#8212; %(docstitle)s": "\u65bc %(version)s \u7248\u672c\u4e2d\u7684\u6240\u6709\u8b8a\u66f4 &#8212; %(docstitle)s",
+        "Changes in Version %(version)s &#8212; %(docstitle)s": "\u65bc %(version)s \u7248\u4e2d\u7684\u6240\u6709\u8b8a\u66f4 &#8212; %(docstitle)s",
         "Collapse sidebar": "\u6536\u5408\u5074\u908a\u6b04",
         "Complete Table of Contents": "\u5b8c\u6574\u76ee\u9304",
         "Contents": "\u5167\u5bb9",
@@ -30,8 +30,6 @@
         "Next topic": "\u4e0b\u500b\u4e3b\u984c",
         "Other changes": "\u5176\u4ed6\u8b8a\u66f4",
         "Overview": "\u6982\u8981",
-        "Permalink to this definition": "\u672c\u5b9a\u7fa9\u7684\u6c38\u4e45\u9023\u7d50",
-        "Permalink to this headline": "\u672c\u6a19\u984c\u7684\u6c38\u4e45\u9023\u7d50",
         "Please activate JavaScript to enable the search\n    functionality.": "\u8acb\u555f\u7528 Javascript \u4ee5\u958b\u555f\u641c\u5c0b\u529f\u80fd\u3002",
         "Preparing search...": "\u6e96\u5099\u641c\u5c0b\u4e2d\u2026",
         "Previous topic": "\u4e0a\u500b\u4e3b\u984c",
@@ -39,7 +37,7 @@
         "Search": "\u641c\u5c0b",
         "Search Page": "\u641c\u5c0b\u9801\u9762",
         "Search Results": "\u641c\u5c0b\u7d50\u679c",
-        "Search finished, found %s page(s) matching the search query.": "\u641c\u5c0b\u5b8c\u6210\uff0c\u5171\u627e\u5230 %s \u9801\u9762\u7b26\u5408\u641c\u5c0b\u689d\u4ef6\u3002",
+        "Search finished, found ${resultCount} page(s) matching the search query.": "\u641c\u5c0b\u7d50\u675f\uff0c\u5171\u627e\u5230 ${resultCount} \u500b\u9801\u9762\u7b26\u5408\u641c\u5c0b\u689d\u4ef6\u3002",
         "Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u5c0b",
         "Searching": "\u641c\u5c0b\u4e2d",
         "Searching for multiple words only shows matches that contain\n    all words.": "\u641c\u5c0b\u591a\u500b\u95dc\u9375\u5b57\u6642\uff0c\u53ea\u6703\u986f\u793a\u5305\u542b\u6240\u6709\u95dc\u9375\u5b57\u7684\u7d50\u679c\u3002",

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po Changed

@@ -1,148 +1,148 @@
 # Translations template for Sphinx.
-# Copyright (C) 2022 ORGANIZATION
+# Copyright (C) 2023 ORGANIZATION
 # This file is distributed under the same license as the Sphinx project.
 # 
 # Translators:
 # Wey-Han Liaw <adrianliaw2000@gmail.com>, 2018
-# Alvin Wong <alvin@alvinhc.com>, 2021
+# alvinhochun <alvin@alvinhc.com>, 2021
 # Fred Lin <gasolin@gmail.com>, 2008
 # Game Arming <fleasw@yahoo.com.tw>, 2017
 # Hsiaoming Yang <me@lepture.com>, 2018
 # Liang-Bo Wang <me@liang2.tw>, 2016
 # Liang-Bo Wang <me@liang2.tw>, 2016-2017
-# Steven Hsu <hsuhaochun@gmail.com>, 2021
+# Steven Hsu <hsuhaochun@gmail.com>, 2021-2022
 msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2022-01-16 00:12+0000\n"
-"PO-Revision-Date: 2022-01-02 00:12+0000\n"
-"Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n"
+"POT-Creation-Date: 2023-03-15 15:48+0000\n"
+"PO-Revision-Date: 2013-04-02 08:44+0000\n"
+"Last-Translator: Steven Hsu <hsuhaochun@gmail.com>, 2021-2022\n"
 "Language-Team: Chinese (Taiwan) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.9.1\n"
+"Generated-By: Babel 2.12.1\n"
 "Language: zh_TW\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
-#: sphinx/application.py:156
+#: sphinx/application.py:148
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "找不到來源資料夾 (%s)"
 
-#: sphinx/application.py:160
+#: sphinx/application.py:152
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr "輸出資料夾 (%s) 不是一個資料夾"
 
-#: sphinx/application.py:164
+#: sphinx/application.py:156
 msgid "Source directory and destination directory cannot be identical"
 msgstr "來源資料夾與目的資料夾不能為相同"
 
-#: sphinx/application.py:195
+#: sphinx/application.py:188
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "正在執行 Sphinx v%s 版本"
 
-#: sphinx/application.py:221
+#: sphinx/application.py:214
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
-msgstr "本專案需要 Sphinx v%s 版本或以上，故無法以現版本編譯。"
+msgstr "本專案需要 Sphinx v%s 版或以上，故無法以現版本編譯。"
 
-#: sphinx/application.py:236
+#: sphinx/application.py:229
 msgid "making output directory"
 msgstr "正在建立輸出目錄"
 
-#: sphinx/application.py:241 sphinx/registry.py:430
+#: sphinx/application.py:234 sphinx/registry.py:438
 #, python-format
 msgid "while setting up extension %s:"
 msgstr "正在設置擴充套件 %s 時："
 
-#: sphinx/application.py:247
+#: sphinx/application.py:240
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr "目前在 conf.py 裡定義的 'setup' 並非一個 Python 的可呼叫物件。請將其定義修改為一個可呼叫的函式。若要使 conf.py 以 Sphinx 擴充套件的方式運作，這個修改是必須的。"
 
-#: sphinx/application.py:272
+#: sphinx/application.py:271
 #, python-format
 msgid "loading translations %s... "
 msgstr "正在載入翻譯 %s..."
 
-#: sphinx/application.py:290 sphinx/util/__init__.py:540
+#: sphinx/application.py:288 sphinx/util/display.py:77
 msgid "done"
 msgstr "完成"
 
-#: sphinx/application.py:292
+#: sphinx/application.py:290
 msgid "not available for built-in messages"
 msgstr "不是有效的內建訊息"
 
-#: sphinx/application.py:301
+#: sphinx/application.py:306
 msgid "loading pickled environment"
 msgstr "正在載入已 pickle 的環境"
 
-#: sphinx/application.py:306
+#: sphinx/application.py:312
 #, python-format
 msgid "failed: %s"
 msgstr "失敗：%s"
 
-#: sphinx/application.py:314
+#: sphinx/application.py:326
 msgid "No builder selected, using default: html"
 msgstr "沒有指定 builder，使用預設：html"
 
-#: sphinx/application.py:342
+#: sphinx/application.py:361
 msgid "succeeded"
 msgstr "成功"
 
-#: sphinx/application.py:343
+#: sphinx/application.py:362
 msgid "finished with problems"
 msgstr "完成但有問題"
 
-#: sphinx/application.py:347
+#: sphinx/application.py:366
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr "建立 %s，%s 警告（警告被視為錯誤）。"
 
-#: sphinx/application.py:349
+#: sphinx/application.py:368
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr "建立 %s，%s 警告（警告被視為錯誤）。"
 
-#: sphinx/application.py:352
+#: sphinx/application.py:371
 #, python-format
 msgid "build %s, %s warning."
 msgstr "建立 %s，%s 警告。"
 
-#: sphinx/application.py:354
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warnings."
 msgstr "建立 %s，%s 警告。"
 
-#: sphinx/application.py:358
+#: sphinx/application.py:377
 #, python-format
 msgid "build %s."
 msgstr "建立 %s。"
 
-#: sphinx/application.py:588
+#: sphinx/application.py:599
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr "node class %r 已經被註冊，它的訪客將會被覆寫"
 
-#: sphinx/application.py:666
+#: sphinx/application.py:678
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr "指令 %r 已經被註冊，它將會被覆寫"
 
-#: sphinx/application.py:687 sphinx/application.py:708
+#: sphinx/application.py:700 sphinx/application.py:722
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr "role %r 已經被註冊，它將會被覆寫"
 
-#: sphinx/application.py:1256
+#: sphinx/application.py:1264
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -150,12 +150,12 @@
 "explicit"
 msgstr "%s 擴充套件並未宣告平行讀取是否安全，假設為否 - 請尋求擴充套件作者以檢查並明確表示"
 
-#: sphinx/application.py:1260
+#: sphinx/application.py:1268
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr "%s 擴充套件對於平行讀取是不安全的"
 
-#: sphinx/application.py:1263
+#: sphinx/application.py:1271
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -163,64 +163,70 @@
 "explicit"
 msgstr "%s 擴充套件並未宣告平行寫入是否安全，假設為否 - 請尋求擴充套件作者以檢查並明確表示"
 
-#: sphinx/application.py:1267
+#: sphinx/application.py:1275
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr "%s 擴充套件對於平行寫入是不安全的"
 
-#: sphinx/application.py:1275 sphinx/application.py:1279
+#: sphinx/application.py:1283 sphinx/application.py:1287
 #, python-format
 msgid "doing serial %s"
 msgstr "執行串列 %s"
 
-#: sphinx/config.py:171
+#: sphinx/config.py:175
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "config 資料夾沒有包含 conf.py 檔案 (%s)"
 
-#: sphinx/config.py:198
+#: sphinx/config.py:184
+msgid ""
+"Invalid configuration value found: 'language = None'. Update your "
+"configuration to a valid language code. Falling back to 'en' (English)."
+msgstr "找到無效的組態值： 'language = None' 。請以一個有效的語言碼更新您的配置。跳回 'en' （英語）。"
+
+#: sphinx/config.py:213
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr "無法覆寫資料夾組態設定 %r，忽略中（使用 %r 來設定個別元素）"
 
-#: sphinx/config.py:207
+#: sphinx/config.py:222
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr "無效的數字 %r 於組態值 %r，忽略中"
 
-#: sphinx/config.py:212
+#: sphinx/config.py:227
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr "無法以未支援的型別覆寫組態設定 %r，忽略中"
 
-#: sphinx/config.py:241
+#: sphinx/config.py:256
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr "覆寫未知的組態值 %r，忽略中"
 
-#: sphinx/config.py:269
+#: sphinx/config.py:284
 #, python-format
 msgid "No such config value: %s"
 msgstr "無此類組態值：%s"
 
-#: sphinx/config.py:293
+#: sphinx/config.py:308
 #, python-format
 msgid "Config value %r already present"
 msgstr "組態值 %r 已經存在"
 
-#: sphinx/config.py:342
+#: sphinx/config.py:356
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr "在您的組態檔中有一個語法錯誤：%s\n"
 
-#: sphinx/config.py:345
+#: sphinx/config.py:359
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr "組態檔（或它 import 的其中一個模組）呼叫了 sys.exit()"
 
-#: sphinx/config.py:352
+#: sphinx/config.py:366
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -228,994 +234,990 @@
 "%s"
 msgstr "在您的組態檔中有一個程式化錯誤：\n\n%s"
 
-#: sphinx/config.py:378
+#: sphinx/config.py:389
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr "組態值 `source_suffix' 預期是一個字串、一組字串，或字典。但是 `%r' 被給予。"
 
-#: sphinx/config.py:397
+#: sphinx/config.py:408
 #, python-format
 msgid "Section %s"
 msgstr "章節 %s"
 
-#: sphinx/config.py:398
+#: sphinx/config.py:409
 #, python-format
 msgid "Fig. %s"
 msgstr "圖 %s"
 
-#: sphinx/config.py:399
+#: sphinx/config.py:410
 #, python-format
 msgid "Table %s"
 msgstr "表格 %s"
 
-#: sphinx/config.py:400
+#: sphinx/config.py:411
 #, python-format
 msgid "Listing %s"
 msgstr "列表 %s"
 
-#: sphinx/config.py:437
+#: sphinx/config.py:448
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr "組態值 `{name}` 必須是 {candidates} 的其中之一，但 `{current}` 被給予。"
 
-#: sphinx/config.py:455
+#: sphinx/config.py:466
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr "組態值 `{name}' 有 `{current.__name__}' 型別；預期 {permitted} 。"
 
-#: sphinx/config.py:468
+#: sphinx/config.py:478
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr "組態值 `{name}' 有 `{current.__name__}' 型別；預設為 `{default.__name__}' 。"
 
-#: sphinx/config.py:478
+#: sphinx/config.py:488
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "找不到 primary_domain %r，已略過。"
 
-#: sphinx/config.py:490
+#: sphinx/config.py:500
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr "從 v2.0 開始，Sphinx 預設使用 \"index\" 作為 root_doc。請在您的 conf.py 加上 \"root_doc = 'contents'\"。"
 
-#: sphinx/events.py:67
+#: sphinx/events.py:62
 #, python-format
 msgid "Event %r already present"
 msgstr "事件 %r 已經存在"
 
-#: sphinx/events.py:73
+#: sphinx/events.py:68
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "未知的事件名稱：%s"
 
-#: sphinx/events.py:109
+#: sphinx/events.py:107
 #, python-format
 msgid "Handler %r for event %r threw an exception"
 msgstr "對於事件 %r 的 handler %r 拋出了一個例外"
 
-#: sphinx/extension.py:52
+#: sphinx/extension.py:53
 #, python-format
 msgid ""
 "The %s extension is required by needs_extensions settings, but it is not "
 "loaded."
 msgstr "擴充套件 %s 被 needs_extensions 的設定所要求，但它沒有被載入。"
 
-#: sphinx/extension.py:68
+#: sphinx/extension.py:69
 #, python-format
 msgid ""
 "This project needs the extension %s at least in version %s and therefore "
 "cannot be built with the loaded version (%s)."
 msgstr "這個專案需要擴充套件 %s 的最低版本是 %s，所以無法以載入的版本 (%s) 被建立。"
 
-#: sphinx/highlighting.py:135
+#: sphinx/highlighting.py:147
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr "Pygments lexer 名稱 %r 不是已知的"
 
-#: sphinx/highlighting.py:161
+#: sphinx/highlighting.py:173
 #, python-format
 msgid "Could not lex literal_block as \"%s\". Highlighting skipped."
 msgstr "無法將 literal_block 分析為 \"%s\"。Highlighting 已省略。"
 
-#: sphinx/project.py:53
+#: sphinx/project.py:51
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr "為文件 \"%s\" 找到多個檔案： %r\n使用 %r 來建立。"
 
-#: sphinx/project.py:59
+#: sphinx/project.py:57
 msgid "document not readable. Ignored."
 msgstr "文件無法讀取。已略過。"
 
-#: sphinx/registry.py:139
+#: sphinx/registry.py:133
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr "Builder class %s 沒有 \"name\" 屬性"
 
-#: sphinx/registry.py:141
+#: sphinx/registry.py:135
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr "Builder %r 已存在（於 %s 模組）"
 
-#: sphinx/registry.py:154
+#: sphinx/registry.py:148
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr "Builder 名稱 %s 未註冊或無法從 entry point 取得"
 
-#: sphinx/registry.py:161
+#: sphinx/registry.py:156
 #, python-format
 msgid "Builder name %s not registered"
 msgstr "Builder 名稱 %s 未註冊"
 
-#: sphinx/registry.py:168
+#: sphinx/registry.py:174
 #, python-format
 msgid "domain %s already registered"
 msgstr "domain %s 已註冊"
 
-#: sphinx/registry.py:191 sphinx/registry.py:204 sphinx/registry.py:215
+#: sphinx/registry.py:197 sphinx/registry.py:210 sphinx/registry.py:221
 #, python-format
 msgid "domain %s not yet registered"
 msgstr "domain %s 尚未被註冊"
 
-#: sphinx/registry.py:195
+#: sphinx/registry.py:201
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr "%r 指令已註冊給 domain %s"
 
-#: sphinx/registry.py:207
+#: sphinx/registry.py:213
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr "%r 角色已註冊給 domain %s"
 
-#: sphinx/registry.py:218
+#: sphinx/registry.py:224
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr "%r 索引已註冊給 domain %s"
 
-#: sphinx/registry.py:242
+#: sphinx/registry.py:255
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr "%r object_type 已註冊"
 
-#: sphinx/registry.py:262
+#: sphinx/registry.py:281
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr "%r crossref_type 已註冊"
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr "source_suffix %r 已註冊"
 
-#: sphinx/registry.py:279
+#: sphinx/registry.py:297
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr "對於 %r 的 source_parser 已註冊"
 
-#: sphinx/registry.py:288
+#: sphinx/registry.py:305
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr "對於 %s 的源碼剖析器未註冊"
 
-#: sphinx/registry.py:317
+#: sphinx/registry.py:321
 #, python-format
 msgid "Translator for %r already exists"
 msgstr "對於 %r 的翻譯器已經存在"
 
-#: sphinx/registry.py:330
+#: sphinx/registry.py:334
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr "對於 add_node() 的 kwargs 必須是一個 (visit, depart) 函式值組：%r=%r"
 
-#: sphinx/registry.py:402
+#: sphinx/registry.py:410
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr "enumerable_node %r 已註冊"
 
-#: sphinx/registry.py:411
+#: sphinx/registry.py:419
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr "數學描繪器 %s 已註冊"
 
-#: sphinx/registry.py:424
+#: sphinx/registry.py:432
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
-msgstr "擴充套件 %r 已被併入版本 %s 以上的 Sphinx：此擴充套件已略過。"
+msgstr "擴充套件 %r 已被併入 %s 版以上的 Sphinx：此擴充套件已略過。"
 
-#: sphinx/registry.py:435
+#: sphinx/registry.py:443
 msgid "Original exception:\n"
 msgstr "原始的例外：\n"
 
-#: sphinx/registry.py:436
+#: sphinx/registry.py:444
 #, python-format
 msgid "Could not import extension %s"
 msgstr "無法引入擴充套件 %s"
 
-#: sphinx/registry.py:441
+#: sphinx/registry.py:449
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr "擴充套件 %r 沒有 setup() 函式；它真的是 Sphinx 擴充套件模組嗎？"
 
-#: sphinx/registry.py:450
+#: sphinx/registry.py:458
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr "此專案使用的 %s 擴充套件需要 Sphinx v%s 以上的版本；所以它無法以此版本被建立。"
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:466
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr "擴充套件 %r 從它的 setup() 函式回傳一個未支援物件；它應該回傳 None 或一個元數據資料夾"
 
-#: sphinx/roles.py:177
+#: sphinx/roles.py:175
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr "Python Enhancement Proposals; PEP %s"
 
-#: sphinx/roles.py:193
+#: sphinx/roles.py:191
 #, python-format
 msgid "invalid PEP number %s"
-msgstr ""
+msgstr "無效的 PEP 號碼 %s"
 
-#: sphinx/roles.py:227
+#: sphinx/roles.py:225
 #, python-format
 msgid "invalid RFC number %s"
-msgstr ""
+msgstr "無效的 RFC 號碼 %s"
 
-#: sphinx/theming.py:80
+#: sphinx/theming.py:74
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "主題 %r 沒有 \"theme\" 設定"
 
-#: sphinx/theming.py:82
+#: sphinx/theming.py:76
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr "主題 %r 沒有 \"inherit\" 設定"
 
-#: sphinx/theming.py:88
+#: sphinx/theming.py:82
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr "未找到名為 %r 的主題，被 %r 繼承"
 
-#: sphinx/theming.py:111
+#: sphinx/theming.py:105
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr "設定 %s。%s 不在已被搜尋的主題組態中出現"
 
-#: sphinx/theming.py:130
+#: sphinx/theming.py:123
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr "未支援的主題選項 %r 被給予"
 
-#: sphinx/theming.py:229
+#: sphinx/theming.py:213
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr "主題路徑中的檔案 %r 不是有效的 zipfile 或未包含主題"
 
-#: sphinx/theming.py:244
-msgid ""
-"sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0"
-msgstr "找到 sphinx_rtd_theme (< 0.3.0)。從 Sphinx-6.0 之後將無法使用。"
-
-#: sphinx/theming.py:249
+#: sphinx/theming.py:227
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr "未找到名為 %r 的主題（缺少 theme.conf？）"
 
-#: sphinx/builders/__init__.py:192
+#: sphinx/builders/__init__.py:201
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr "未找到對於 %s builder 適用的圖片：%s (%s)"
 
-#: sphinx/builders/__init__.py:196
+#: sphinx/builders/__init__.py:205
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr "未找到對於 %s builder 適用的圖片：%s"
 
-#: sphinx/builders/__init__.py:216
+#: sphinx/builders/__init__.py:225
 msgid "building mo: "
 msgstr "建立 mo："
 
-#: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:536
-#: sphinx/builders/__init__.py:562
+#: sphinx/builders/__init__.py:226 sphinx/builders/__init__.py:583
+#: sphinx/builders/__init__.py:610
 msgid "writing output... "
 msgstr "編寫輸出..."
 
-#: sphinx/builders/__init__.py:226
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "all of %d po files"
 msgstr "所有的 %d po 檔"
 
-#: sphinx/builders/__init__.py:244
+#: sphinx/builders/__init__.py:253
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr "對於指定的 po 檔 %d 的目標"
 
-#: sphinx/builders/__init__.py:251
+#: sphinx/builders/__init__.py:261
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr "對於已過期 po 檔 %d 的目標"
 
-#: sphinx/builders/__init__.py:258
+#: sphinx/builders/__init__.py:270
 msgid "all source files"
 msgstr "所有原始檔案"
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:280
+#, python-format
+msgid "file %r given on command line does not exist, "
+msgstr "在命令列給的檔案 %r 不存在，"
+
+#: sphinx/builders/__init__.py:285
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr "在命令列給的檔案 %r 不在來源資料夾下，忽略中"
 
-#: sphinx/builders/__init__.py:274
+#: sphinx/builders/__init__.py:291
 #, python-format
-msgid "file %r given on command line does not exist, ignoring"
-msgstr "在命令列給的檔案 %r 不存在，忽略中"
+msgid "file %r given on command line is not a valid document, ignoring"
+msgstr "在命令列給的檔案 %r 不是有效的文件，忽略中"
 
-#: sphinx/builders/__init__.py:285
+#: sphinx/builders/__init__.py:300
 #, python-format
 msgid "%d source files given on command line"
 msgstr "在命令列給了 %d 個原始檔案"
 
-#: sphinx/builders/__init__.py:295
+#: sphinx/builders/__init__.py:312
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr "%d 個過時原始檔案的目標"
 
-#: sphinx/builders/__init__.py:304 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:323 sphinx/builders/gettext.py:243
 #, python-format
 msgid "building %s: "
 msgstr "正在建立 %s："
 
-#: sphinx/builders/__init__.py:311
+#: sphinx/builders/__init__.py:330
 msgid "looking for now-outdated files... "
 msgstr "正在尋找目前已過期的檔案..."
 
-#: sphinx/builders/__init__.py:316
+#: sphinx/builders/__init__.py:335
 #, python-format
 msgid "%d found"
 msgstr "已找到 %d"
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:337
 msgid "none found"
 msgstr "找不到任何結果"
 
-#: sphinx/builders/__init__.py:323
+#: sphinx/builders/__init__.py:342
 msgid "pickling environment"
 msgstr "正在 pickle 環境"
 
-#: sphinx/builders/__init__.py:329
+#: sphinx/builders/__init__.py:348
 msgid "checking consistency"
 msgstr "正在檢查一致性"
 
-#: sphinx/builders/__init__.py:333
+#: sphinx/builders/__init__.py:352
 msgid "no targets are out of date."
 msgstr "沒有過時的目標。"
 
-#: sphinx/builders/__init__.py:372
+#: sphinx/builders/__init__.py:391
 msgid "updating environment: "
 msgstr "正在更新環境："
 
-#: sphinx/builders/__init__.py:393
+#: sphinx/builders/__init__.py:412
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr "%s 已新增， %s 已變更， %s 已移除"
 
-#: sphinx/builders/__init__.py:431 sphinx/builders/__init__.py:458
+#: sphinx/builders/__init__.py:450 sphinx/builders/__init__.py:462
 msgid "reading sources... "
 msgstr "正在讀取來源..."
 
-#: sphinx/builders/__init__.py:463 sphinx/builders/__init__.py:572
-msgid "waiting for workers..."
-msgstr "正在等待工作者..."
-
-#: sphinx/builders/__init__.py:514
+#: sphinx/builders/__init__.py:561
 #, python-format
 msgid "docnames to write: %s"
 msgstr "待寫入的 docname: %s"
 
-#: sphinx/builders/__init__.py:523 sphinx/builders/singlehtml.py:153
+#: sphinx/builders/__init__.py:570 sphinx/builders/singlehtml.py:148
 msgid "preparing documents"
 msgstr "正在準備文件"
 
-#: sphinx/builders/_epub_base.py:216
+#: sphinx/builders/_epub_base.py:214
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr "找到了重複的 ToC 項目： %s"
 
-#: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730
-#: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176
+#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
+#: sphinx/builders/latex/__init__.py:417 sphinx/builders/texinfo.py:177
 msgid "copying images... "
 msgstr "正在複製圖片..."
 
-#: sphinx/builders/_epub_base.py:412
+#: sphinx/builders/_epub_base.py:409
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr "無法讀取圖片檔 %r: 正在複製它做為替代"
 
-#: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738
-#: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186
+#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:187
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr "無法複製圖片檔 %r: %s"
 
-#: sphinx/builders/_epub_base.py:435
+#: sphinx/builders/_epub_base.py:432
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr "無法寫入圖片檔 %r: %s"
 
-#: sphinx/builders/_epub_base.py:445
+#: sphinx/builders/_epub_base.py:442
 msgid "Pillow not found - copying image files"
 msgstr "未找到 Pillow - 正在複製圖片檔"
 
-#: sphinx/builders/_epub_base.py:471
+#: sphinx/builders/_epub_base.py:468
 msgid "writing mimetype file..."
 msgstr "正在寫入 mimetype 檔案..."
 
-#: sphinx/builders/_epub_base.py:476
+#: sphinx/builders/_epub_base.py:473
 msgid "writing META-INF/container.xml file..."
 msgstr "正在寫入 META-INF/container.xml 檔案..."
 
-#: sphinx/builders/_epub_base.py:504
+#: sphinx/builders/_epub_base.py:501
 msgid "writing content.opf file..."
 msgstr "正在寫入 content.opf 檔案..."
 
-#: sphinx/builders/_epub_base.py:530
+#: sphinx/builders/_epub_base.py:527
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr "對於 %s 未知的 mimetype，忽略中"
 
-#: sphinx/builders/_epub_base.py:677
+#: sphinx/builders/_epub_base.py:674
 msgid "writing toc.ncx file..."
 msgstr "正在寫入 toc.ncx 檔案..."
 
-#: sphinx/builders/_epub_base.py:702
+#: sphinx/builders/_epub_base.py:699
 #, python-format
 msgid "writing %s file..."
 msgstr "正在寫入 %s 檔案..."
 
-#: sphinx/builders/changes.py:34
+#: sphinx/builders/changes.py:28
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr "概觀檔案是在 %(outdir)s 。"
 
-#: sphinx/builders/changes.py:60
+#: sphinx/builders/changes.py:54
 #, python-format
 msgid "no changes in version %s."
-msgstr "在版本 %s 中無變更"
+msgstr "在 %s 版中無變更"
 
-#: sphinx/builders/changes.py:62
+#: sphinx/builders/changes.py:56
 msgid "writing summary file..."
 msgstr "正在寫入摘要檔案..."
 
-#: sphinx/builders/changes.py:78
+#: sphinx/builders/changes.py:71
 msgid "Builtins"
 msgstr "內建"
 
-#: sphinx/builders/changes.py:80
+#: sphinx/builders/changes.py:73
 msgid "Module level"
 msgstr "模組層次"
 
-#: sphinx/builders/changes.py:124
+#: sphinx/builders/changes.py:116
 msgid "copying source files..."
 msgstr "正在複製原始檔案..."
 
-#: sphinx/builders/changes.py:131
+#: sphinx/builders/changes.py:123
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr "在變更日誌建立時無法讀取 %r"
 
-#: sphinx/builders/dummy.py:22
+#: sphinx/builders/dummy.py:16
 msgid "The dummy builder generates no files."
 msgstr "虛擬建立器未產生任何檔案。"
 
-#: sphinx/builders/epub3.py:67
+#: sphinx/builders/epub3.py:77
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr "ePub 檔案是在 %(outdir)s 。"
 
-#: sphinx/builders/epub3.py:165
+#: sphinx/builders/epub3.py:175
 msgid "writing nav.xhtml file..."
 msgstr "正在寫入 nav.xhtml 檔案..."
 
-#: sphinx/builders/epub3.py:191
+#: sphinx/builders/epub3.py:201
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr "conf 值 \"epub_language\" (或 \"language\") 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:195
+#: sphinx/builders/epub3.py:205
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr "conf 值  \"epub_uid\" 在 EPUB3 應該是 XML NAME"
 
-#: sphinx/builders/epub3.py:198
+#: sphinx/builders/epub3.py:208
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr "conf 值 \"epub_title\" (或 \"html_title\") 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:202
+#: sphinx/builders/epub3.py:212
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr "conf 值  \"epub_author\" 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:215
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr "conf 值 \"epub_contributor\" 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:218
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr "conf 值  \"epub_description\" 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:211
+#: sphinx/builders/epub3.py:221
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr "conf 值 \"epub_publisher\" 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:214
+#: sphinx/builders/epub3.py:224
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr "conf 值 \"epub_copyright\" (或 \"copyright\") 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:228
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr "conf 值 \"epub_identifier\" 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:231
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr "conf 值 \"version\" 在 EPUB3 不應該為空"
 
-#: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121
+#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr "無效的 css_file: %r, 已略過"
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:222
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
-msgstr ""
+msgstr "訊息目錄是在 %(outdir)s"
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:244
 #, python-format
 msgid "targets for %d template files"
-msgstr ""
+msgstr "模板檔 %d 的目標"
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:248
 msgid "reading templates... "
-msgstr ""
+msgstr "正在讀取模板..."
 
-#: sphinx/builders/gettext.py:273
+#: sphinx/builders/gettext.py:278
 msgid "writing message catalogs... "
-msgstr ""
+msgstr "正在寫入訊息目錄..."
 
-#: sphinx/builders/linkcheck.py:132
+#: sphinx/builders/linkcheck.py:113
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
-msgstr ""
+msgstr "尋找以上輸出或 %(outdir)s/output.txt 中的任何錯誤"
 
-#: sphinx/builders/linkcheck.py:270
+#: sphinx/builders/linkcheck.py:148
 #, python-format
 msgid "broken link: %s (%s)"
-msgstr ""
+msgstr "錯誤連結： %s (%s)"
 
-#: sphinx/builders/linkcheck.py:469
+#: sphinx/builders/linkcheck.py:325
 #, python-format
 msgid "Anchor '%s' not found"
-msgstr ""
+msgstr "未找到錨 '%s'"
 
-#: sphinx/builders/linkcheck.py:714
+#: sphinx/builders/linkcheck.py:561
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
-msgstr ""
+msgstr "在 linkcheck_allowed_redirects 編譯 regex 失敗： %r %s"
 
-#: sphinx/builders/manpage.py:38
+#: sphinx/builders/manpage.py:33
 #, python-format
 msgid "The manual pages are in %(outdir)s."
-msgstr ""
+msgstr "手冊頁面在 %(outdir)s"
 
-#: sphinx/builders/manpage.py:45
+#: sphinx/builders/manpage.py:40
 msgid "no \"man_pages\" config value found; no manual pages will be written"
-msgstr ""
+msgstr "未找到 \"man_pages\" 組態值：不會編寫任何手冊頁面"
 
-#: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56
-#: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109
+#: sphinx/builders/latex/__init__.py:297 sphinx/builders/manpage.py:49
+#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:104
 msgid "writing"
 msgstr "編寫中"
 
-#: sphinx/builders/manpage.py:67
+#: sphinx/builders/manpage.py:64
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
-msgstr ""
+msgstr "\"man_pages\" 組態值引用未知的文件 %s"
 
-#: sphinx/builders/singlehtml.py:34
+#: sphinx/builders/singlehtml.py:29
 #, python-format
 msgid "The HTML page is in %(outdir)s."
-msgstr ""
+msgstr "HTML 頁面在 %(outdir)s 。"
 
-#: sphinx/builders/singlehtml.py:156
+#: sphinx/builders/singlehtml.py:151
 msgid "assembling single document"
-msgstr ""
+msgstr "正在組合單一文件"
 
-#: sphinx/builders/singlehtml.py:174
+#: sphinx/builders/singlehtml.py:169
 msgid "writing additional files"
-msgstr ""
+msgstr "正在寫入附加檔案"
 
-#: sphinx/builders/texinfo.py:45
+#: sphinx/builders/texinfo.py:41
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
-msgstr ""
+msgstr "Texinfo 檔案在 %(outdir)s 。"
 
-#: sphinx/builders/texinfo.py:47
+#: sphinx/builders/texinfo.py:43
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
-msgstr ""
+msgstr "\n在該目錄中執行 'make' 以透過 makeinfo 執行這些\n（在此使用 'make info' 以自動執行）"
 
-#: sphinx/builders/texinfo.py:75
+#: sphinx/builders/texinfo.py:70
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "未找到 \"texinfo_documents\" 組態值；不會編寫任何文件"
 
-#: sphinx/builders/texinfo.py:83
+#: sphinx/builders/texinfo.py:78
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
-msgstr ""
+msgstr "\"texinfo_documents\" 組態值引用未知的文件 %s"
 
-#: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:279 sphinx/builders/texinfo.py:100
 #, python-format
 msgid "processing %s"
 msgstr "正在處理 %s"
 
-#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152
+#: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:153
 msgid "resolving references..."
 msgstr "正在解析參照..."
 
-#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161
+#: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:162
 msgid " (in "
 msgstr " (於 "
 
-#: sphinx/builders/texinfo.py:191
+#: sphinx/builders/texinfo.py:192
 msgid "copying Texinfo support files"
-msgstr ""
+msgstr "正在複製 Texinfo 支援檔案"
 
-#: sphinx/builders/texinfo.py:195
+#: sphinx/builders/texinfo.py:196
 #, python-format
 msgid "error writing file Makefile: %s"
-msgstr ""
+msgstr "錯誤寫入檔案 Makefile： %s"
 
-#: sphinx/builders/text.py:30
+#: sphinx/builders/text.py:24
 #, python-format
 msgid "The text files are in %(outdir)s."
-msgstr ""
+msgstr "文字檔案在 %(outdir)s 。"
 
-#: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77
-#: sphinx/builders/xml.py:94
+#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
+#: sphinx/builders/xml.py:88
 #, python-format
 msgid "error writing file %s: %s"
-msgstr ""
+msgstr "錯誤寫入檔案 %s: %s"
 
-#: sphinx/builders/xml.py:35
+#: sphinx/builders/xml.py:29
 #, python-format
 msgid "The XML files are in %(outdir)s."
-msgstr ""
+msgstr "XML 檔案在 %(outdir)s 。"
 
-#: sphinx/builders/xml.py:106
+#: sphinx/builders/xml.py:100
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
-msgstr ""
+msgstr "pseudo-XML 檔案在 %(outdir)s 。"
 
-#: sphinx/builders/html/__init__.py:145
+#: sphinx/builders/html/__init__.py:160
 #, python-format
 msgid "build info file is broken: %r"
-msgstr ""
+msgstr "build info 檔案已失效： %r"
 
-#: sphinx/builders/html/__init__.py:177
+#: sphinx/builders/html/__init__.py:194
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
-msgstr ""
+msgstr "HTML 頁面在 %(outdir)s 。"
 
-#: sphinx/builders/html/__init__.py:375
+#: sphinx/builders/html/__init__.py:412
 #, python-format
 msgid "Failed to read build info file: %r"
-msgstr ""
+msgstr "讀取 build info 檔失敗： %r"
 
-#: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187
-#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:102
-#: sphinx/writers/texinfo.py:234
+#: sphinx/builders/html/__init__.py:505 sphinx/builders/latex/__init__.py:182
+#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
+#: sphinx/writers/texinfo.py:223
 #, python-format
 msgid "%b %d, %Y"
 msgstr "%Y 年 %m 月 %d 日"
 
-#: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:524 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "總索引"
 
-#: sphinx/builders/html/__init__.py:488
+#: sphinx/builders/html/__init__.py:524
 msgid "index"
 msgstr "索引"
 
-#: sphinx/builders/html/__init__.py:551
+#: sphinx/builders/html/__init__.py:591
 msgid "next"
 msgstr "下一頁"
 
-#: sphinx/builders/html/__init__.py:560
+#: sphinx/builders/html/__init__.py:600
 msgid "previous"
 msgstr "上一頁"
 
-#: sphinx/builders/html/__init__.py:654
+#: sphinx/builders/html/__init__.py:694
 msgid "generating indices"
 msgstr "正在產生索引"
 
-#: sphinx/builders/html/__init__.py:669
+#: sphinx/builders/html/__init__.py:709
 msgid "writing additional pages"
-msgstr ""
+msgstr "正在編寫附加頁面"
 
-#: sphinx/builders/html/__init__.py:748
+#: sphinx/builders/html/__init__.py:788
 msgid "copying downloadable files... "
-msgstr ""
+msgstr "正在複製可下載的檔案..."
 
-#: sphinx/builders/html/__init__.py:756
+#: sphinx/builders/html/__init__.py:796
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
-msgstr ""
+msgstr "無法複製可下載的檔案 %r: %s"
 
-#: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800
+#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
-msgstr ""
+msgstr "在 html_static_file 中複製一個檔案失敗： %s: %r "
 
-#: sphinx/builders/html/__init__.py:821
+#: sphinx/builders/html/__init__.py:862
 msgid "copying static files"
-msgstr ""
+msgstr "正在複製靜態檔案"
 
-#: sphinx/builders/html/__init__.py:837
+#: sphinx/builders/html/__init__.py:878
 #, python-format
 msgid "cannot copy static file %r"
-msgstr ""
+msgstr "無法複製靜態檔案 %r"
 
-#: sphinx/builders/html/__init__.py:842
+#: sphinx/builders/html/__init__.py:883
 msgid "copying extra files"
-msgstr ""
+msgstr "正在複製額外檔案"
 
-#: sphinx/builders/html/__init__.py:848
+#: sphinx/builders/html/__init__.py:889
 #, python-format
 msgid "cannot copy extra file %r"
-msgstr ""
+msgstr "無法複製額外檔案 %r"
 
-#: sphinx/builders/html/__init__.py:855
+#: sphinx/builders/html/__init__.py:896
 #, python-format
 msgid "Failed to write build info file: %r"
-msgstr ""
+msgstr "寫入 build info 檔失敗： %r"
 
-#: sphinx/builders/html/__init__.py:903
+#: sphinx/builders/html/__init__.py:944
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
-msgstr ""
+msgstr "搜尋索引無法被載入，但不是所有的文件都會被建置：索引將會是不完全的。"
 
-#: sphinx/builders/html/__init__.py:964
+#: sphinx/builders/html/__init__.py:1005
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
-msgstr ""
+msgstr "頁面 %s 在 html_sidebars 中符合兩個型樣： %r 和 %r"
 
-#: sphinx/builders/html/__init__.py:1057
+#: sphinx/builders/html/__init__.py:1100
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
-msgstr ""
+msgstr "在呈現頁面 %s 時發生了一個 Unicode 錯誤。請確認所有包含 non-ASCII 內容的組態值都是 Unicode 字串。"
 
-#: sphinx/builders/html/__init__.py:1062
+#: sphinx/builders/html/__init__.py:1105
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
-msgstr ""
+msgstr "在呈現頁面 %s 時發生了一個錯誤。\n原因： %r"
 
-#: sphinx/builders/html/__init__.py:1091
+#: sphinx/builders/html/__init__.py:1134
 msgid "dumping object inventory"
-msgstr ""
+msgstr "正在傾印物件庫存"
 
-#: sphinx/builders/html/__init__.py:1096
+#: sphinx/builders/html/__init__.py:1139
 #, python-format
 msgid "dumping search index in %s"
-msgstr ""
+msgstr "正在傾印搜尋索引於 %s"
 
-#: sphinx/builders/html/__init__.py:1138
+#: sphinx/builders/html/__init__.py:1181
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr "無效的  js_file: %r, 已略過"
 
-#: sphinx/builders/html/__init__.py:1225
+#: sphinx/builders/html/__init__.py:1264
 msgid "Many math_renderers are registered. But no math_renderer is selected."
-msgstr ""
+msgstr "多個 math_renderer 已被註冊。但是沒有 math_renderer 被選擇。"
 
-#: sphinx/builders/html/__init__.py:1228
+#: sphinx/builders/html/__init__.py:1267
 #, python-format
 msgid "Unknown math_renderer %r is given."
-msgstr ""
+msgstr "未知的 math_renderer %r 被給予。"
 
-#: sphinx/builders/html/__init__.py:1236
+#: sphinx/builders/html/__init__.py:1275
 #, python-format
 msgid "html_extra_path entry %r does not exist"
-msgstr ""
+msgstr "html_extra_path 項目 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1240
+#: sphinx/builders/html/__init__.py:1279
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_extra_path 項目 %r 被放入 outdir"
 
-#: sphinx/builders/html/__init__.py:1249
+#: sphinx/builders/html/__init__.py:1288
 #, python-format
 msgid "html_static_path entry %r does not exist"
-msgstr ""
+msgstr "html_static_path 項目 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1253
+#: sphinx/builders/html/__init__.py:1292
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
-msgstr ""
+msgstr "html_static_path 項目 %r 被放入 outdir"
 
-#: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433
+#: sphinx/builders/html/__init__.py:1301 sphinx/builders/latex/__init__.py:429
 #, python-format
 msgid "logo file %r does not exist"
-msgstr ""
+msgstr "標誌檔案 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1271
+#: sphinx/builders/html/__init__.py:1310
 #, python-format
 msgid "favicon file %r does not exist"
-msgstr ""
+msgstr "favicon 檔案 %r 不存在"
 
-#: sphinx/builders/html/__init__.py:1291
+#: sphinx/builders/html/__init__.py:1318
 msgid ""
-"html_add_permalinks has been deprecated since v3.5.0. Please use "
-"html_permalinks and html_permalinks_icon instead."
-msgstr ""
+"Support for emitting HTML 4 output is deprecated and will be removed in "
+"Sphinx 7. (\"html4_writer=True detected in configuration options)"
+msgstr "編排 HTML 4 輸出的支援已不適用，且將在 Sphinx 7 中被移除。（在組態選項中偵測到 \"html4_writer=True）"
 
-#: sphinx/builders/html/__init__.py:1317
+#: sphinx/builders/html/__init__.py:1339
 #, python-format
 msgid "%s %s documentation"
 msgstr "%s %s 說明文件"
 
-#: sphinx/builders/latex/__init__.py:114
+#: sphinx/builders/latex/__init__.py:108
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
-msgstr ""
+msgstr "LaTeX 檔案在 %(outdir)s 。"
 
-#: sphinx/builders/latex/__init__.py:116
+#: sphinx/builders/latex/__init__.py:110
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
-msgstr ""
+msgstr "\n在該目錄中執行 'make' 以透過 (pdf)latex 執行這些\n（在此使用 'make latexpdf' 以自動執行）"
 
-#: sphinx/builders/latex/__init__.py:152
+#: sphinx/builders/latex/__init__.py:145
 msgid "no \"latex_documents\" config value found; no documents will be written"
-msgstr ""
+msgstr "未找到 \"latex_documents\" 組態值；不會編寫任何文件"
 
-#: sphinx/builders/latex/__init__.py:160
+#: sphinx/builders/latex/__init__.py:153
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
-msgstr ""
+msgstr "\"latex_documents\" 組態值引用未知的文件 %s"
 
-#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:596
-#: sphinx/templates/latex/latex.tex_t:97
+#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:590
+#: sphinx/domains/std.py:602 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:147
-#: sphinx/writers/texinfo.py:499
+#: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:148
+#: sphinx/writers/texinfo.py:491
 msgid "Index"
 msgstr "索引"
 
-#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82
+#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr "發佈"
 
-#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382
+#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:368
 #, python-format
 msgid "no Babel option known for language %r"
-msgstr ""
+msgstr "沒有語言 %r 已知的 Babel 選項"
 
 #: sphinx/builders/latex/__init__.py:379
 msgid "copying TeX support files"
-msgstr ""
+msgstr "正在複製 TeX 支援檔案"
 
-#: sphinx/builders/latex/__init__.py:399
+#: sphinx/builders/latex/__init__.py:395
 msgid "copying TeX support files..."
-msgstr ""
+msgstr "正在複製 TeX 支援檔案..."
 
-#: sphinx/builders/latex/__init__.py:412
+#: sphinx/builders/latex/__init__.py:408
 msgid "copying additional files"
-msgstr ""
+msgstr "正在複製附加檔案"
 
-#: sphinx/builders/latex/__init__.py:468
+#: sphinx/builders/latex/__init__.py:451
 #, python-format
 msgid "Unknown configure key: latex_elements%r, ignored."
-msgstr ""
+msgstr "未知的配置鍵： latex_elements%r，已略過。"
 
-#: sphinx/builders/latex/__init__.py:476
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown theme option: latex_theme_options%r, ignored."
-msgstr ""
+msgstr "未知的主題選項： latex_theme_options%r,，已略過。"
 
-#: sphinx/builders/latex/theming.py:91
+#: sphinx/builders/latex/theming.py:84
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
-msgstr ""
+msgstr "%r 沒有「主題」設定"
 
-#: sphinx/builders/latex/theming.py:94
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
-msgstr ""
+msgstr "%r 沒有 \"%s\" 設定"
 
-#: sphinx/cmd/build.py:40
+#: sphinx/cmd/build.py:37
 msgid "Exception occurred while building, starting debugger:"
-msgstr ""
+msgstr "在建立時發生例外，正在啟動除錯器："
 
-#: sphinx/cmd/build.py:50
+#: sphinx/cmd/build.py:47
 msgid "Interrupted!"
-msgstr ""
+msgstr "已中斷！"
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:49
 msgid "reST markup error:"
-msgstr ""
+msgstr "reST 標示錯誤："
 
-#: sphinx/cmd/build.py:58
+#: sphinx/cmd/build.py:55
 msgid "Encoding error:"
-msgstr ""
+msgstr "編碼錯誤："
 
-#: sphinx/cmd/build.py:61 sphinx/cmd/build.py:76
+#: sphinx/cmd/build.py:58 sphinx/cmd/build.py:73
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
-msgstr ""
+msgstr "若您想要回報問題給開發者，完整的回溯已被儲存在 %s 中。"
 
-#: sphinx/cmd/build.py:65
+#: sphinx/cmd/build.py:62
 msgid "Recursion error:"
-msgstr ""
+msgstr "遞迴錯誤："
 
-#: sphinx/cmd/build.py:68
+#: sphinx/cmd/build.py:65
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
-msgstr ""
+msgstr "這會發生在非常大或是巢套較深的原始檔案。您可以在 conf.py 中謹慎地增加 Python 的預設 1000 次遞迴上限，例如："
 
-#: sphinx/cmd/build.py:73
+#: sphinx/cmd/build.py:70
 msgid "Exception occurred:"
-msgstr ""
+msgstr "發生例外："
 
-#: sphinx/cmd/build.py:79
+#: sphinx/cmd/build.py:76
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
-msgstr ""
+msgstr "如果這是一個使用者錯誤，請一併回報，如此下次才能提供較佳的錯誤訊息。"
 
-#: sphinx/cmd/build.py:82
+#: sphinx/cmd/build.py:79
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
-msgstr ""
+msgstr "錯誤回報可被歸檔於追蹤系統中，它是在 <https://github.com/sphinx-doc/sphinx/issues>. 謝謝！"
 
-#: sphinx/cmd/build.py:98
+#: sphinx/cmd/build.py:95
 msgid "job number should be a positive number"
-msgstr ""
+msgstr "工件編號應該是一個正數"
 
-#: sphinx/cmd/build.py:106 sphinx/cmd/quickstart.py:470
-#: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:623
+#: sphinx/cmd/build.py:103 sphinx/cmd/quickstart.py:468
+#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:595
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
-msgstr ""
+msgstr "需要更多資訊，請拜訪 <https://www.sphinx-doc.org/>."
 
-#: sphinx/cmd/build.py:107
+#: sphinx/cmd/build.py:104
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1232,290 +1234,285 @@
 "\n"
 "By default, everything that is outdated is built. Output only for selected\n"
 "files can be built by specifying individual filenames.\n"
-msgstr ""
+msgstr "\n從原始檔案產生說明文件。\n\nsphinx-build 會從 SOURCEDIR 中的檔案來產生說明文件，並\n將它置放於 OUTPUTDIR。它會在 SOURCEDIR 中尋找 'conf.py' \n內的組態設定。'sphinx-quickstart' 工具可以用來產生模板檔案，\n包括 'conf.py'\n\nsphinx-build 能以不同的格式建立說明文件。在命令列指定建立\n器的名稱來選擇一種格式；其預設值為 HTML。建立器也能執行\n與處理說明文件有關的其他任務。\n\n在預設情況，所有舊的文件都已經被建立。指定個別的檔名，\n可以在建立時僅限於輸出所選的檔案。\n"
 
-#: sphinx/cmd/build.py:128
+#: sphinx/cmd/build.py:125
 msgid "path to documentation source files"
-msgstr ""
+msgstr "到說明文件原始檔案的路徑"
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:127
 msgid "path to output directory"
-msgstr ""
+msgstr "到輸出資料夾的路徑"
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:129
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
-msgstr ""
+msgstr "一份要重建的特定檔案列表。如果 -a 被指定則會被略過。"
 
-#: sphinx/cmd/build.py:135
+#: sphinx/cmd/build.py:132
 msgid "general options"
-msgstr ""
+msgstr "一般選項"
 
-#: sphinx/cmd/build.py:138
+#: sphinx/cmd/build.py:135
 msgid "builder to use (default: html)"
-msgstr ""
+msgstr "要使用的建立器（預設值：html）"
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:137
 msgid "write all files (default: only write new and changed files)"
 msgstr "寫入所有檔案（預設：只寫入新增及已變更檔案）"
 
-#: sphinx/cmd/build.py:143
+#: sphinx/cmd/build.py:140
 msgid "don't use a saved environment, always read all files"
-msgstr ""
+msgstr "不要使用已儲存的環境，永遠要讀取全部的檔案"
 
-#: sphinx/cmd/build.py:146
+#: sphinx/cmd/build.py:143
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
-msgstr ""
+msgstr "已存快取環境及 doctree 檔案的路徑（預設值：OUTPUTDIR/.doctrees）"
 
-#: sphinx/cmd/build.py:149
+#: sphinx/cmd/build.py:147
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
-msgstr ""
+msgstr "盡可能以 N 個程序平行建立（特殊值 \"auto\" 會設定 N 為 cpu-count）"
 
-#: sphinx/cmd/build.py:153
+#: sphinx/cmd/build.py:151
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
-msgstr ""
+msgstr "組態檔案 (conf.py) 所在的路徑（預設值：與 SOURCEDIR 相同）"
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:154
 msgid "use no config file at all, only -D options"
-msgstr ""
+msgstr "完全不使用組態檔案，只用 -D 選項"
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:157
 msgid "override a setting in configuration file"
-msgstr ""
+msgstr "在組態檔案中置換一項設定"
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:160
 msgid "pass a value into HTML templates"
-msgstr ""
+msgstr "傳遞一個值進入 HTML 模板"
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:163
 msgid "define tag: include \"only\" blocks with TAG"
-msgstr ""
+msgstr "定義 tag：「只」包含有 TAG 的區塊"
 
-#: sphinx/cmd/build.py:167
+#: sphinx/cmd/build.py:165
 msgid "nit-picky mode, warn about all missing references"
-msgstr ""
+msgstr "nit-picky 模式，對所有遺漏的參照發出警告"
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:168
 msgid "console output options"
-msgstr ""
+msgstr "控制台輸出選項"
 
-#: sphinx/cmd/build.py:172
+#: sphinx/cmd/build.py:170
 msgid "increase verbosity (can be repeated)"
-msgstr ""
+msgstr "增加贅言（可以被重複）"
 
-#: sphinx/cmd/build.py:174 sphinx/ext/apidoc.py:330
+#: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:323
 msgid "no output on stdout, just warnings on stderr"
-msgstr ""
+msgstr "在 stdout 無輸出，只有在 stderr 的警告"
 
-#: sphinx/cmd/build.py:176
+#: sphinx/cmd/build.py:174
 msgid "no output at all, not even warnings"
-msgstr ""
+msgstr "完全沒有輸出，也沒有警告"
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:177
 msgid "do emit colored output (default: auto-detect)"
-msgstr ""
+msgstr "執行 emit 彩色輸出（預設值：auto-detect）"
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:180
 msgid "do not emit colored output (default: auto-detect)"
-msgstr ""
+msgstr "不執行 emit 彩色輸出（預設值：auto-detect）"
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:183
 msgid "write warnings (and errors) to given file"
-msgstr ""
+msgstr "寫入警告（及錯誤）至給定的檔案"
 
-#: sphinx/cmd/build.py:187
+#: sphinx/cmd/build.py:185
 msgid "turn warnings into errors"
-msgstr ""
+msgstr "將警告轉為錯誤"
 
-#: sphinx/cmd/build.py:189
+#: sphinx/cmd/build.py:187
 msgid "with -W, keep going when getting warnings"
-msgstr ""
+msgstr "帶有 -W，在得到警告時會繼續前進"
 
-#: sphinx/cmd/build.py:191
+#: sphinx/cmd/build.py:189
 msgid "show full traceback on exception"
-msgstr ""
+msgstr "在例外中顯示完整的回溯"
 
-#: sphinx/cmd/build.py:193
+#: sphinx/cmd/build.py:191
 msgid "run Pdb on exception"
-msgstr ""
+msgstr "在例外中執行 Pdb"
 
-#: sphinx/cmd/build.py:225
-#, python-format
-msgid "cannot find files %r"
-msgstr ""
-
-#: sphinx/cmd/build.py:228
+#: sphinx/cmd/build.py:215
 msgid "cannot combine -a option and filenames"
-msgstr ""
+msgstr "無法合併 -a 選項及檔名"
 
-#: sphinx/cmd/build.py:249
+#: sphinx/cmd/build.py:236
 #, python-format
 msgid "cannot open warning file %r: %s"
-msgstr ""
+msgstr "無法開啟警告檔案 %r: %s"
 
-#: sphinx/cmd/build.py:259
+#: sphinx/cmd/build.py:250
 msgid "-D option argument must be in the form name=value"
-msgstr ""
+msgstr "-D 選項引數必須是 name=value 的形式"
 
-#: sphinx/cmd/build.py:266
+#: sphinx/cmd/build.py:257
 msgid "-A option argument must be in the form name=value"
-msgstr ""
+msgstr "-A 選項引數必須是 name=value 的形式"
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:39
 msgid "automatically insert docstrings from modules"
-msgstr ""
+msgstr "從模組自動插入說明字串"
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:40
 msgid "automatically test code snippets in doctest blocks"
-msgstr ""
+msgstr "在 doctest 區塊自動測試程式碼片段"
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:41
 msgid "link between Sphinx documentation of different projects"
-msgstr ""
+msgstr "在不同專案的 Sphinx 說明文件中鏈接"
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:42
 msgid "write \"todo\" entries that can be shown or hidden on build"
-msgstr ""
+msgstr "寫入 \"todo\" 項目，它們可以在組建時被顯示或隱藏"
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:43
 msgid "checks for documentation coverage"
-msgstr ""
+msgstr "核對說明文件的涵蓋範圍"
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:44
 msgid "include math, rendered as PNG or SVG images"
-msgstr ""
+msgstr "包含 math，以 PNG 或 SVG 影像被呈現"
 
-#: sphinx/cmd/quickstart.py:49
+#: sphinx/cmd/quickstart.py:45
 msgid "include math, rendered in the browser by MathJax"
-msgstr ""
+msgstr "包含 math，被 MathJax 在瀏覽器中呈現"
 
-#: sphinx/cmd/quickstart.py:50
+#: sphinx/cmd/quickstart.py:46
 msgid "conditional inclusion of content based on config values"
-msgstr ""
+msgstr "根據組態值有條件地包含內容"
 
-#: sphinx/cmd/quickstart.py:51
+#: sphinx/cmd/quickstart.py:47
 msgid "include links to the source code of documented Python objects"
-msgstr ""
+msgstr "包含鏈接至已有說明文件的 Python 物件原始碼"
 
-#: sphinx/cmd/quickstart.py:52
+#: sphinx/cmd/quickstart.py:48
 msgid "create .nojekyll file to publish the document on GitHub pages"
-msgstr ""
+msgstr "建立 .nojekyll 檔案以在 GitHub 頁面發布文件"
 
-#: sphinx/cmd/quickstart.py:94
+#: sphinx/cmd/quickstart.py:90
 msgid "Please enter a valid path name."
-msgstr ""
+msgstr "請輸入有效的路徑名稱。"
 
-#: sphinx/cmd/quickstart.py:110
+#: sphinx/cmd/quickstart.py:106
 msgid "Please enter some text."
-msgstr ""
+msgstr "請輸入一些文字。"
 
-#: sphinx/cmd/quickstart.py:117
+#: sphinx/cmd/quickstart.py:113
 #, python-format
 msgid "Please enter one of %s."
-msgstr ""
+msgstr "請輸入一種 %s 。"
 
-#: sphinx/cmd/quickstart.py:124
+#: sphinx/cmd/quickstart.py:120
 msgid "Please enter either 'y' or 'n'."
-msgstr ""
+msgstr "請輸入 'y' 或 'n'。"
 
-#: sphinx/cmd/quickstart.py:130
+#: sphinx/cmd/quickstart.py:126
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
-msgstr ""
+msgstr "請輸入檔案後綴，例如 '.rst' 或 '.txt'。"
 
-#: sphinx/cmd/quickstart.py:211
+#: sphinx/cmd/quickstart.py:206
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
-msgstr ""
+msgstr "歡迎進入 Sphinx %s 快速入門公用程式。"
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:208
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
-msgstr ""
+msgstr "請輸入以下設定值（如果括號中有給定預設值，請直接\n按下 Enter 以接受它）。"
 
-#: sphinx/cmd/quickstart.py:218
+#: sphinx/cmd/quickstart.py:213
 #, python-format
 msgid "Selected root path: %s"
-msgstr ""
+msgstr "被選的根路徑： %s"
 
-#: sphinx/cmd/quickstart.py:221
+#: sphinx/cmd/quickstart.py:216
 msgid "Enter the root path for documentation."
-msgstr ""
+msgstr "輸入說明文件的根路徑。"
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:217
 msgid "Root path for the documentation"
-msgstr ""
+msgstr "說明文件的根路徑"
 
-#: sphinx/cmd/quickstart.py:227
+#: sphinx/cmd/quickstart.py:222
 msgid "Error: an existing conf.py has been found in the selected root path."
-msgstr ""
+msgstr "錯誤：在被選的根路徑找到一個已存在的 conf.py。"
 
-#: sphinx/cmd/quickstart.py:229
+#: sphinx/cmd/quickstart.py:224
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
-msgstr ""
+msgstr "sphinx-quickstart 不會重寫已存在的 Sphinx 專案。"
 
-#: sphinx/cmd/quickstart.py:231
+#: sphinx/cmd/quickstart.py:226
 msgid "Please enter a new root path (or just Enter to exit)"
-msgstr ""
+msgstr "請輸入一個新的根路徑（或直接按 Enter 離開）"
 
-#: sphinx/cmd/quickstart.py:238
+#: sphinx/cmd/quickstart.py:233
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
-msgstr ""
+msgstr "您有兩個選擇來為 Sphinx 的輸出放置建立資料夾。\n其一，您可以在根路徑中使用資料夾 \"_build\"，或者，\n您可以在根路徑中分離 \"source\" 和 \"build\" 資料夾。"
 
-#: sphinx/cmd/quickstart.py:241
+#: sphinx/cmd/quickstart.py:236
 msgid "Separate source and build directories (y/n)"
-msgstr ""
+msgstr "分離來源並建立資料夾 (y/n)"
 
-#: sphinx/cmd/quickstart.py:245
+#: sphinx/cmd/quickstart.py:240
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
-msgstr ""
+msgstr "在根資料夾內部，另外兩個資料夾會被建立；\"_templates\" \n放置自訂的 HTML 模板，而 \"_static\" 放置自訂的表單及其他\n靜態檔案。您可以輸入另一個前綴（像是 \".\"）來取代底線。"
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:243
 msgid "Name prefix for templates and static dir"
-msgstr ""
+msgstr "用於模板及靜態資料夾的名稱前綴"
 
-#: sphinx/cmd/quickstart.py:252
+#: sphinx/cmd/quickstart.py:247
 msgid ""
 "The project name will occur in several places in the built documentation."
-msgstr ""
+msgstr "專案名稱會在已建立的說明文件中的多個位置出現。"
 
-#: sphinx/cmd/quickstart.py:253
+#: sphinx/cmd/quickstart.py:248
 msgid "Project name"
-msgstr ""
+msgstr "專案名稱"
 
-#: sphinx/cmd/quickstart.py:255
+#: sphinx/cmd/quickstart.py:250
 msgid "Author name(s)"
-msgstr ""
+msgstr "作者姓名"
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:254
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
 "Python the version is something like 2.5 or 3.0, while the release is\n"
 "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n"
 "just set both to the same value."
-msgstr ""
+msgstr "在 Sphinx 中，軟體具有「版本」和「發布版本」的概念。每個\n版本可以有多個發布版本。舉例來說，Python 的版本會像是 2.5 \n或 3.0，而發布版本則像是 2.5.1 或 3.0a1。如果您不需要這個雙\n重的結構，請直接將兩者設為相同的值。"
 
-#: sphinx/cmd/quickstart.py:264
+#: sphinx/cmd/quickstart.py:259
 msgid "Project version"
-msgstr ""
+msgstr "專案版本"
 
-#: sphinx/cmd/quickstart.py:266
+#: sphinx/cmd/quickstart.py:261
 msgid "Project release"
-msgstr ""
+msgstr "專案發布版本"
 
-#: sphinx/cmd/quickstart.py:270
+#: sphinx/cmd/quickstart.py:265
 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"
@@ -1523,115 +1520,115 @@
 "\n"
 "For a list of supported codes, see\n"
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
-msgstr ""
+msgstr "如果文件是被英語以外的語言被編寫，您可以根據它的語言碼\n在此選擇一個語言。Sphinx 會將它產生的文本翻譯為該語言。\n\n要了解可支援的語言碼列表，請參閱\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 
-#: sphinx/cmd/quickstart.py:276
+#: sphinx/cmd/quickstart.py:273
 msgid "Project language"
-msgstr ""
+msgstr "專案語言"
 
-#: sphinx/cmd/quickstart.py:282
+#: sphinx/cmd/quickstart.py:279
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
-msgstr ""
+msgstr "用於原始檔的檔案名稱後綴。通常，這會是 \".txt\" 或 \".rst\"。\n只有具有此後綴的檔案才會被認為是文件。"
 
-#: sphinx/cmd/quickstart.py:284
+#: sphinx/cmd/quickstart.py:281
 msgid "Source file suffix"
-msgstr ""
+msgstr "原始檔案後綴"
 
-#: sphinx/cmd/quickstart.py:288
+#: sphinx/cmd/quickstart.py:285
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
 "of the documents. Normally, this is \"index\", but if your \"index\"\n"
 "document is a custom template, you can also set this to another filename."
-msgstr ""
+msgstr "一份文件的特別之處在於它會被視為 \"contents tree\" 中的頂端\n節點，也就是說，它是文件階層結構中的根。通常，這會是 \n\"index\"，但如果您的 \"index\" 文件是一個自訂的模板，您也可以\n將它設定為另一個檔名。"
 
-#: sphinx/cmd/quickstart.py:292
+#: sphinx/cmd/quickstart.py:289
 msgid "Name of your master document (without suffix)"
-msgstr ""
+msgstr "您的主要文件名稱（不含後綴）"
 
-#: sphinx/cmd/quickstart.py:297
+#: sphinx/cmd/quickstart.py:294
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
-msgstr ""
+msgstr "錯誤：在被選的根路徑中已經找到主檔 %s 。"
 
-#: sphinx/cmd/quickstart.py:299
+#: sphinx/cmd/quickstart.py:296
 msgid "sphinx-quickstart will not overwrite the existing file."
-msgstr ""
+msgstr "sphinx-quickstart 不會重寫已存在的檔案。"
 
-#: sphinx/cmd/quickstart.py:301
+#: sphinx/cmd/quickstart.py:298
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
-msgstr ""
+msgstr "請輸入一個新的檔案名稱，或將已存在的檔案重新命名並按下 Enter"
 
-#: sphinx/cmd/quickstart.py:305
+#: sphinx/cmd/quickstart.py:302
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
-msgstr ""
+msgstr "指示以下哪一個 Sphinx 擴充應該被啟用："
 
-#: sphinx/cmd/quickstart.py:313
+#: sphinx/cmd/quickstart.py:310
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
-msgstr ""
+msgstr "註解：imgmath 和 mathjax 無法同時被啟用。imgmath 已被取消選擇。"
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:316
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
-msgstr ""
+msgstr "會為您產生一個 Makefile 和一個 Windows 命令檔，所以\n您只需要執行像是 `make html' 而不必直接調用 \nsphinx-build。"
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:319
 msgid "Create Makefile? (y/n)"
-msgstr ""
+msgstr "是否建立 Makefile? (y/n)"
 
-#: sphinx/cmd/quickstart.py:325
+#: sphinx/cmd/quickstart.py:322
 msgid "Create Windows command file? (y/n)"
-msgstr ""
+msgstr "是否建立 Windows 命令檔？(y/n)"
 
-#: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90
+#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Creating file %s."
-msgstr ""
+msgstr "正在建立檔案 %s 。"
 
-#: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87
+#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
 #, python-format
 msgid "File %s already exists, skipping."
-msgstr ""
+msgstr "檔案 %s 已存在，正在跳過。"
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:413
 msgid "Finished: An initial directory structure has been created."
-msgstr ""
+msgstr "已結束：一個初始資料夾結構已被建立。"
 
-#: sphinx/cmd/quickstart.py:417
+#: sphinx/cmd/quickstart.py:415
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
-msgstr ""
+msgstr "您現在應該在您的主檔 %s 輸入資料並建立其他說明文件\n原始檔。"
 
-#: sphinx/cmd/quickstart.py:420
+#: sphinx/cmd/quickstart.py:418
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
-msgstr ""
+msgstr "使用 Makefile 來建立文件，像這樣：\n   make builder"
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:421
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
-msgstr ""
+msgstr "使用 sphinx-build 命令來建立文件，像這樣：\n   sphinx-build -b builder %s %s"
 
-#: sphinx/cmd/quickstart.py:425
+#: sphinx/cmd/quickstart.py:423
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
-msgstr ""
+msgstr "在這裡 \"builder\" 是一種被支援的建立器，例如 html，latex 或 linkcheck。"
 
-#: sphinx/cmd/quickstart.py:460
+#: sphinx/cmd/quickstart.py:458
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1639,232 +1636,232 @@
 "sphinx-quickstart is an interactive tool that asks some questions about your\n"
 "project and then generates a complete documentation directory and sample\n"
 "Makefile to be used with sphinx-build.\n"
-msgstr ""
+msgstr "\n為 Sphinx 專案產生需要的檔案。\n\nsphinx-quickstart 是一個互動式工具，它會問一些關於您專案\n的問題，然後產生完整的說明文件資料夾以及用於 sphinx-build \n的 Makefile 樣本。\n"
 
-#: sphinx/cmd/quickstart.py:475
+#: sphinx/cmd/quickstart.py:473
 msgid "quiet mode"
 msgstr "安靜模式"
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:478
 msgid "project root"
 msgstr "專案根"
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:480
 msgid "Structure options"
 msgstr "結構選項"
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:482
 msgid "if specified, separate source and build dirs"
 msgstr "如果有指定，會分離來源資料夾和 build 資料夾"
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:484
 msgid "if specified, create build dir under source dir"
 msgstr "如果有指定，會在來源資料夾下建立 build 資料夾"
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:486
 msgid "replacement for dot in _templates etc."
 msgstr "在 _templates 等處進行句號的取代"
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:488
 msgid "Project basic options"
 msgstr "專案基本選項"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:490
 msgid "project name"
 msgstr "專案名稱"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:492
 msgid "author names"
 msgstr "作者名"
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:494
 msgid "version of project"
 msgstr "專案版本"
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:496
 msgid "release of project"
 msgstr "專案發布"
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:498
 msgid "document language"
 msgstr "文件語言"
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:500
 msgid "source file suffix"
 msgstr "源始檔後綴"
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:502
 msgid "master document name"
 msgstr "主文件名稱"
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:504
 msgid "use epub"
 msgstr "使用 epub"
 
-#: sphinx/cmd/quickstart.py:508
+#: sphinx/cmd/quickstart.py:506
 msgid "Extension options"
 msgstr "擴充套件選項"
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390
+#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
 #, python-format
 msgid "enable %s extension"
 msgstr "啟用 %s 擴充套件"
 
-#: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386
+#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
 msgid "enable arbitrary extensions"
 msgstr "啟用任意的擴充套件"
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:514
 msgid "Makefile and Batchfile creation"
 msgstr "Makefile 及 Batchfile 的建立"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:516
 msgid "create makefile"
 msgstr "建立 makefile"
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:518
 msgid "do not create makefile"
 msgstr "不要建立 makefile"
 
-#: sphinx/cmd/quickstart.py:522
+#: sphinx/cmd/quickstart.py:520
 msgid "create batchfile"
 msgstr "建立 batchfile"
 
-#: sphinx/cmd/quickstart.py:525
+#: sphinx/cmd/quickstart.py:523
 msgid "do not create batchfile"
 msgstr "不要建立 batchfile"
 
-#: sphinx/cmd/quickstart.py:528
+#: sphinx/cmd/quickstart.py:526
 msgid "use make-mode for Makefile/make.bat"
 msgstr "使用 make 模式於 Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:531
+#: sphinx/cmd/quickstart.py:529
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr "不要使用 make 模式於 Makefile/make.bat"
 
-#: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392
+#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
 msgid "Project templating"
 msgstr "專案模板化中"
 
-#: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395
+#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
 msgid "template directory for template files"
 msgstr "用於模板檔案的模板資料夾"
 
-#: sphinx/cmd/quickstart.py:539
+#: sphinx/cmd/quickstart.py:537
 msgid "define a template variable"
 msgstr "定義一個模板變數"
 
-#: sphinx/cmd/quickstart.py:572
+#: sphinx/cmd/quickstart.py:570
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr "\"quiet\" 被指定，但 \"project\" 或 \"author\" 的任一項未被指定。"
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:584
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
-msgstr ""
+msgstr "錯誤：指定的路徑不是資料夾，或是 sphinx 檔案已經存在。"
 
-#: sphinx/cmd/quickstart.py:588
+#: sphinx/cmd/quickstart.py:586
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
-msgstr ""
+msgstr "sphinx-quickstart 只能產生於空白資料夾中。請指定一個新的根路徑。"
 
-#: sphinx/cmd/quickstart.py:603
+#: sphinx/cmd/quickstart.py:601
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr "無效的模板變數： %s"
 
-#: sphinx/directives/code.py:64
+#: sphinx/directives/code.py:60
 msgid "non-whitespace stripped by dedent"
-msgstr ""
+msgstr "非空白字元被凸排去除"
 
-#: sphinx/directives/code.py:83
+#: sphinx/directives/code.py:81
 #, python-format
 msgid "Invalid caption: %s"
 msgstr "無效標題：%s"
 
-#: sphinx/directives/code.py:129 sphinx/directives/code.py:274
-#: sphinx/directives/code.py:440
+#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
+#: sphinx/directives/code.py:452
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
-msgstr ""
+msgstr "列號規格超出範圍 (1-%d)： %r"
 
-#: sphinx/directives/code.py:208
+#: sphinx/directives/code.py:205
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
-msgstr ""
+msgstr "不能使用 \"%s\" 及 \"%s\" 兩個選項"
 
-#: sphinx/directives/code.py:220
+#: sphinx/directives/code.py:219
 #, python-format
 msgid "Include file %r not found or reading it failed"
-msgstr ""
+msgstr "Include 檔案 %r 未找到或是讀取失敗"
 
-#: sphinx/directives/code.py:223
+#: sphinx/directives/code.py:222
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
-msgstr ""
+msgstr "編碼 %r 用以讀取被 include 的檔案 %r 似乎有錯，嘗試給定一個 :encoding: 選項"
 
-#: sphinx/directives/code.py:258
+#: sphinx/directives/code.py:259
 #, python-format
 msgid "Object named %r not found in include file %r"
-msgstr ""
+msgstr "名為 %r 的物件在 include 檔案 %r 中未找到"
 
-#: sphinx/directives/code.py:283
+#: sphinx/directives/code.py:285
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
-msgstr ""
+msgstr "無法以一個 \"lines\" 的互斥集使用 \"lineno-match\" "
 
-#: sphinx/directives/code.py:288
+#: sphinx/directives/code.py:290
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
-msgstr ""
+msgstr "Line spec %r: 從 include 檔案 %r 沒有提取任何一行"
 
-#: sphinx/directives/other.py:110
+#: sphinx/directives/other.py:108
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
-msgstr ""
+msgstr "toctree glob 型樣 %r 未匹配任何文件"
 
-#: sphinx/directives/other.py:131 sphinx/environment/adapters/toctree.py:176
+#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
 #, python-format
 msgid "toctree contains reference to excluded document %r"
-msgstr ""
+msgstr "toctree 包含了指向已排除文件的參照 %r"
 
-#: sphinx/directives/other.py:134 sphinx/environment/adapters/toctree.py:178
+#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
-msgstr ""
+msgstr "toctree 包含了指向不存在文件的參照 %r"
 
-#: sphinx/directives/other.py:144
+#: sphinx/directives/other.py:142
 #, python-format
 msgid "duplicated entry found in toctree: %s"
-msgstr ""
+msgstr "在 toctree 中找到重複的項目： %s"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:174
 msgid "Section author: "
 msgstr "章節作者："
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:176
 msgid "Module author: "
 msgstr "模組作者："
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:178
 msgid "Code author: "
 msgstr "程式作者："
 
-#: sphinx/directives/other.py:182
+#: sphinx/directives/other.py:180
 msgid "Author: "
 msgstr "作者："
 
-#: sphinx/directives/other.py:254
+#: sphinx/directives/other.py:252
 msgid ".. acks content is not a list"
-msgstr ""
+msgstr ".. acks 的內容不是一個列表"
 
-#: sphinx/directives/other.py:279
+#: sphinx/directives/other.py:277
 msgid ".. hlist content is not a list"
-msgstr ""
+msgstr ".. hlist 的內容不是一個列表"
 
-#: sphinx/directives/patches.py:117
+#: sphinx/directives/patches.py:66
 msgid ""
 "\":file:\" option for csv-table directive now recognizes an absolute path as"
 " a relative path from source directory. Please update your document."
@@ -1875,414 +1872,415 @@
 msgid "%s %s"
 msgstr "%s %s"
 
-#: sphinx/domains/c.py:2000 sphinx/domains/c.py:3306
+#: sphinx/domains/c.py:2026 sphinx/domains/c.py:3289
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr "重複的 C 宣告，亦被定義於 %s:%s。\n宣告是 '.. c:%s:: %s'。"
 
-#: sphinx/domains/c.py:3231
+#: sphinx/domains/c.py:3236
 #, python-format
 msgid "%s (C %s)"
 msgstr "%s (C %s)"
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7261
-#: sphinx/domains/python.py:445 sphinx/ext/napoleon/docstring.py:736
+#: sphinx/domains/c.py:3335 sphinx/domains/cpp.py:7424
+#: sphinx/domains/python.py:464 sphinx/ext/napoleon/docstring.py:755
 msgid "Parameters"
 msgstr "參數"
 
-#: sphinx/domains/c.py:3355 sphinx/domains/cpp.py:7267
+#: sphinx/domains/c.py:3338 sphinx/domains/cpp.py:7430
 msgid "Return values"
 msgstr "回傳值"
 
-#: sphinx/domains/c.py:3358 sphinx/domains/cpp.py:7270
-#: sphinx/domains/javascript.py:231 sphinx/domains/python.py:457
+#: sphinx/domains/c.py:3341 sphinx/domains/cpp.py:7433
+#: sphinx/domains/javascript.py:249 sphinx/domains/python.py:476
 msgid "Returns"
 msgstr "回傳"
 
-#: sphinx/domains/c.py:3360 sphinx/domains/javascript.py:233
-#: sphinx/domains/python.py:459
+#: sphinx/domains/c.py:3343 sphinx/domains/javascript.py:251
+#: sphinx/domains/python.py:478
 msgid "Return type"
 msgstr "回傳型別"
 
-#: sphinx/domains/c.py:3755 sphinx/domains/cpp.py:7675
+#: sphinx/domains/c.py:3709 sphinx/domains/cpp.py:7837
 msgid "member"
 msgstr "成員函數"
 
-#: sphinx/domains/c.py:3756
+#: sphinx/domains/c.py:3710
 msgid "variable"
 msgstr "變數"
 
-#: sphinx/domains/c.py:3757 sphinx/domains/cpp.py:7674
-#: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1203
+#: sphinx/domains/c.py:3711 sphinx/domains/cpp.py:7836
+#: sphinx/domains/javascript.py:359 sphinx/domains/python.py:1210
 msgid "function"
 msgstr "函式"
 
-#: sphinx/domains/c.py:3758
+#: sphinx/domains/c.py:3712
 msgid "macro"
 msgstr "巨集"
 
-#: sphinx/domains/c.py:3759
+#: sphinx/domains/c.py:3713
 msgid "struct"
 msgstr "結構"
 
-#: sphinx/domains/c.py:3760 sphinx/domains/cpp.py:7673
+#: sphinx/domains/c.py:3714 sphinx/domains/cpp.py:7835
 msgid "union"
 msgstr "union"
 
-#: sphinx/domains/c.py:3761 sphinx/domains/cpp.py:7678
+#: sphinx/domains/c.py:3715 sphinx/domains/cpp.py:7840
 msgid "enum"
 msgstr "enum"
 
-#: sphinx/domains/c.py:3762 sphinx/domains/cpp.py:7679
+#: sphinx/domains/c.py:3716 sphinx/domains/cpp.py:7841
 msgid "enumerator"
 msgstr "enumerator"
 
-#: sphinx/domains/c.py:3763 sphinx/domains/cpp.py:7676
+#: sphinx/domains/c.py:3717 sphinx/domains/cpp.py:7838
 msgid "type"
 msgstr "型別"
 
-#: sphinx/domains/c.py:3765 sphinx/domains/cpp.py:7681
+#: sphinx/domains/c.py:3719 sphinx/domains/cpp.py:7843
 msgid "function parameter"
 msgstr "函式參數"
 
-#: sphinx/domains/changeset.py:28
+#: sphinx/domains/changeset.py:22
 #, python-format
 msgid "New in version %s"
-msgstr "在 %s 版本新加入"
+msgstr "在 %s 版新加入"
 
-#: sphinx/domains/changeset.py:29
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "Changed in version %s"
-msgstr "在 %s 版本變更"
+msgstr "在 %s 版的變更"
 
-#: sphinx/domains/changeset.py:30
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Deprecated since version %s"
-msgstr "在 %s 版本開始棄用"
+msgstr "在 %s 版之後被棄用"
 
-#: sphinx/domains/citation.py:75
+#: sphinx/domains/citation.py:69
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr "重複的引用 %s，亦出現於 %s"
 
-#: sphinx/domains/citation.py:86
+#: sphinx/domains/citation.py:80
 #, python-format
 msgid "Citation %s is not referenced."
 msgstr "引用 %s 未被參照。"
 
-#: sphinx/domains/cpp.py:4748 sphinx/domains/cpp.py:7216
+#: sphinx/domains/cpp.py:4898 sphinx/domains/cpp.py:7379
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr "重複的 C++ 宣告，亦被定義於 %s:%s。\n宣告是 '.. cpp:%s:: %s'。"
 
-#: sphinx/domains/cpp.py:7022
+#: sphinx/domains/cpp.py:7186
 msgid "Template Parameters"
 msgstr "模板參數"
 
-#: sphinx/domains/cpp.py:7139
+#: sphinx/domains/cpp.py:7304
 #, python-format
 msgid "%s (C++ %s)"
 msgstr "%s (C++ %s)"
 
-#: sphinx/domains/cpp.py:7264 sphinx/domains/javascript.py:228
+#: sphinx/domains/cpp.py:7427 sphinx/domains/javascript.py:246
 msgid "Throws"
 msgstr "拋出"
 
-#: sphinx/domains/cpp.py:7672 sphinx/domains/javascript.py:342
-#: sphinx/domains/python.py:1205
+#: sphinx/domains/cpp.py:7834 sphinx/domains/javascript.py:361
+#: sphinx/domains/python.py:1212
 msgid "class"
 msgstr "類別"
 
-#: sphinx/domains/cpp.py:7677
+#: sphinx/domains/cpp.py:7839
 msgid "concept"
 msgstr "概念"
 
-#: sphinx/domains/cpp.py:7682
+#: sphinx/domains/cpp.py:7844
 msgid "template parameter"
 msgstr "模板參數"
 
-#: sphinx/domains/javascript.py:146
+#: sphinx/domains/javascript.py:145
 #, python-format
 msgid "%s() (built-in function)"
 msgstr "%s() (內建函式)"
 
-#: sphinx/domains/javascript.py:147 sphinx/domains/python.py:842
+#: sphinx/domains/javascript.py:146 sphinx/domains/python.py:871
 #, python-format
 msgid "%s() (%s method)"
 msgstr "%s() (%s 的方法)"
 
-#: sphinx/domains/javascript.py:149
+#: sphinx/domains/javascript.py:148
 #, python-format
 msgid "%s() (class)"
 msgstr "%s() (類別)"
 
-#: sphinx/domains/javascript.py:151
+#: sphinx/domains/javascript.py:150
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr "%s (全域變數或常數)"
 
-#: sphinx/domains/javascript.py:153 sphinx/domains/python.py:927
+#: sphinx/domains/javascript.py:152 sphinx/domains/python.py:956
 #, python-format
 msgid "%s (%s attribute)"
 msgstr "%s (%s 的屬性)"
 
-#: sphinx/domains/javascript.py:225
+#: sphinx/domains/javascript.py:243
 msgid "Arguments"
 msgstr "引數"
 
-#: sphinx/domains/javascript.py:300
+#: sphinx/domains/javascript.py:318
 #, python-format
 msgid "%s (module)"
 msgstr "%s (模組)"
 
-#: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1207
+#: sphinx/domains/javascript.py:360 sphinx/domains/python.py:1214
 msgid "method"
 msgstr "方法"
 
-#: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1204
+#: sphinx/domains/javascript.py:362 sphinx/domains/python.py:1211
 msgid "data"
 msgstr "資料"
 
-#: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1210
+#: sphinx/domains/javascript.py:363 sphinx/domains/python.py:1217
 msgid "attribute"
 msgstr "屬性"
 
-#: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58
-#: sphinx/domains/python.py:1212
+#: sphinx/domains/javascript.py:364 sphinx/domains/python.py:53
+#: sphinx/domains/python.py:1219
 msgid "module"
 msgstr "模組"
 
-#: sphinx/domains/javascript.py:376
+#: sphinx/domains/javascript.py:395
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr "%s 的重複 %s 敘述，其他的 %s 在 %s"
 
-#: sphinx/domains/math.py:65
+#: sphinx/domains/math.py:59
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr "重複公式標籤 %s，亦出現於 %s"
 
-#: sphinx/domains/math.py:119 sphinx/writers/latex.py:2069
+#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2096
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr "無效的 math_eqref_format: %r"
 
-#: sphinx/domains/python.py:59
+#: sphinx/domains/python.py:54
 msgid "keyword"
 msgstr "關鍵字"
 
-#: sphinx/domains/python.py:60
+#: sphinx/domains/python.py:55
 msgid "operator"
 msgstr "運算子"
 
-#: sphinx/domains/python.py:61
+#: sphinx/domains/python.py:56
 msgid "object"
 msgstr "物件"
 
-#: sphinx/domains/python.py:62 sphinx/domains/python.py:1206
+#: sphinx/domains/python.py:57 sphinx/domains/python.py:1213
 msgid "exception"
 msgstr "例外"
 
-#: sphinx/domains/python.py:63
+#: sphinx/domains/python.py:58
 msgid "statement"
 msgstr "陳述式"
 
-#: sphinx/domains/python.py:64
+#: sphinx/domains/python.py:59
 msgid "built-in function"
 msgstr "內建函式"
 
-#: sphinx/domains/python.py:450
+#: sphinx/domains/python.py:469
 msgid "Variables"
 msgstr "變數"
 
-#: sphinx/domains/python.py:454
+#: sphinx/domains/python.py:473
 msgid "Raises"
 msgstr "引發"
 
-#: sphinx/domains/python.py:687 sphinx/domains/python.py:831
+#: sphinx/domains/python.py:725 sphinx/domains/python.py:862
 #, python-format
 msgid "%s() (in module %s)"
 msgstr "%s() (於 %s 模組中)"
 
-#: sphinx/domains/python.py:747 sphinx/domains/python.py:923
-#: sphinx/domains/python.py:974
+#: sphinx/domains/python.py:785 sphinx/domains/python.py:952
+#: sphinx/domains/python.py:1003
 #, python-format
 msgid "%s (in module %s)"
 msgstr "%s (於 %s 模組中)"
 
-#: sphinx/domains/python.py:749
+#: sphinx/domains/python.py:787
 #, python-format
 msgid "%s (built-in variable)"
 msgstr "%s (內建變數)"
 
-#: sphinx/domains/python.py:774
+#: sphinx/domains/python.py:812
 #, python-format
 msgid "%s (built-in class)"
 msgstr "%s (內建類別)"
 
-#: sphinx/domains/python.py:775
+#: sphinx/domains/python.py:813
 #, python-format
 msgid "%s (class in %s)"
 msgstr "%s (%s 中的類別)"
 
-#: sphinx/domains/python.py:836
+#: sphinx/domains/python.py:867
 #, python-format
 msgid "%s() (%s class method)"
 msgstr "%s() (%s 的類別方法)"
 
-#: sphinx/domains/python.py:838 sphinx/domains/python.py:978
-#, python-format
-msgid "%s (%s property)"
-msgstr "%s (%s 的特性)"
-
-#: sphinx/domains/python.py:840
+#: sphinx/domains/python.py:869
 #, python-format
 msgid "%s() (%s static method)"
 msgstr "%s() (%s 的靜態方法)"
 
-#: sphinx/domains/python.py:1132
+#: sphinx/domains/python.py:1007
+#, python-format
+msgid "%s (%s property)"
+msgstr "%s (%s 的特性)"
+
+#: sphinx/domains/python.py:1139
 msgid "Python Module Index"
 msgstr "Python 模組索引"
 
-#: sphinx/domains/python.py:1133
+#: sphinx/domains/python.py:1140
 msgid "modules"
 msgstr "模組"
 
-#: sphinx/domains/python.py:1182
+#: sphinx/domains/python.py:1189
 msgid "Deprecated"
 msgstr "已棄用"
 
-#: sphinx/domains/python.py:1208
+#: sphinx/domains/python.py:1215
 msgid "class method"
 msgstr "類別方法"
 
-#: sphinx/domains/python.py:1209
+#: sphinx/domains/python.py:1216
 msgid "static method"
 msgstr "靜態方法"
 
-#: sphinx/domains/python.py:1211
+#: sphinx/domains/python.py:1218
 msgid "property"
 msgstr "特性"
 
-#: sphinx/domains/python.py:1269
+#: sphinx/domains/python.py:1276
 #, python-format
 msgid ""
 "duplicate object description of %s, other instance in %s, use :noindex: for "
 "one of them"
 msgstr "%s 的重複物件敘述，其他的實例在 %s ，使用 :noindex: 給它們其中之一"
 
-#: sphinx/domains/python.py:1389
+#: sphinx/domains/python.py:1396
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr "為交互參照 %r 找到多於一個目標： %s"
 
-#: sphinx/domains/python.py:1443
+#: sphinx/domains/python.py:1457
 msgid " (deprecated)"
 msgstr "（已棄用）"
 
-#: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165
+#: sphinx/domains/rst.py:124 sphinx/domains/rst.py:180
 #, python-format
 msgid "%s (directive)"
 msgstr "%s （指令）"
 
-#: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170
+#: sphinx/domains/rst.py:181 sphinx/domains/rst.py:185
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ":%s: （指令選項）"
 
-#: sphinx/domains/rst.py:199
+#: sphinx/domains/rst.py:216
 #, python-format
 msgid "%s (role)"
 msgstr "%s （角色）"
 
-#: sphinx/domains/rst.py:208
+#: sphinx/domains/rst.py:225
 msgid "directive"
 msgstr "指令"
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:226
 msgid "directive-option"
 msgstr "指令選項"
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:227
 msgid "role"
 msgstr "角色"
 
-#: sphinx/domains/rst.py:232
+#: sphinx/domains/rst.py:249
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr "%s %s 的重複敘述，其他的實例在 %s"
 
-#: sphinx/domains/std.py:100 sphinx/domains/std.py:117
+#: sphinx/domains/std.py:85 sphinx/domains/std.py:102
 #, python-format
 msgid "environment variable; %s"
 msgstr "環境變數; %s"
 
-#: sphinx/domains/std.py:191
+#: sphinx/domains/std.py:169
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr "異常的選項敘述 %r ，應該要看起來像 \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" 或 \"+opt args\""
 
-#: sphinx/domains/std.py:242
+#: sphinx/domains/std.py:245
 #, python-format
 msgid "%s command line option"
 msgstr "%s 命令列選項"
 
-#: sphinx/domains/std.py:244
+#: sphinx/domains/std.py:247
 msgid "command line option"
 msgstr "命令列選項"
 
-#: sphinx/domains/std.py:371
+#: sphinx/domains/std.py:373
 msgid "glossary term must be preceded by empty line"
 msgstr "術語表項目必須有空白行在前"
 
-#: sphinx/domains/std.py:379
+#: sphinx/domains/std.py:381
 msgid "glossary terms must not be separated by empty lines"
 msgstr "術語表項目不可以被空白行分隔"
 
-#: sphinx/domains/std.py:385 sphinx/domains/std.py:398
+#: sphinx/domains/std.py:387 sphinx/domains/std.py:400
 msgid "glossary seems to be misformatted, check indentation"
 msgstr "術語表似乎有格式錯誤，請檢查縮排"
 
-#: sphinx/domains/std.py:555
+#: sphinx/domains/std.py:549
 msgid "glossary term"
 msgstr "雜項術語"
 
-#: sphinx/domains/std.py:556
+#: sphinx/domains/std.py:550
 msgid "grammar token"
 msgstr "語法單詞"
 
-#: sphinx/domains/std.py:557
+#: sphinx/domains/std.py:551
 msgid "reference label"
 msgstr "參照標籤"
 
-#: sphinx/domains/std.py:559
+#: sphinx/domains/std.py:553
 msgid "environment variable"
 msgstr "環境變數"
 
-#: sphinx/domains/std.py:560
+#: sphinx/domains/std.py:554
 msgid "program option"
 msgstr "程式選項"
 
-#: sphinx/domains/std.py:561
+#: sphinx/domains/std.py:555
 msgid "document"
 msgstr "文件"
 
-#: sphinx/domains/std.py:597
+#: sphinx/domains/std.py:591 sphinx/domains/std.py:603
 msgid "Module Index"
 msgstr "模組索引"
 
-#: sphinx/domains/std.py:598 sphinx/themes/basic/defindex.html:25
+#: sphinx/domains/std.py:592 sphinx/domains/std.py:604
+#: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "搜尋頁面"
 
-#: sphinx/domains/std.py:647 sphinx/domains/std.py:756
-#: sphinx/ext/autosectionlabel.py:51
+#: sphinx/domains/std.py:647 sphinx/domains/std.py:753
+#: sphinx/ext/autosectionlabel.py:49
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr "重複的標籤 %s，亦出現於 %s"
@@ -2292,142 +2290,147 @@
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr "重複 %s 的描述 %s，亦出現於 %s"
 
-#: sphinx/domains/std.py:864
+#: sphinx/domains/std.py:870
 msgid "numfig is disabled. :numref: is ignored."
 msgstr "numfig 已停用。 :numref: 已略過。"
 
-#: sphinx/domains/std.py:872
+#: sphinx/domains/std.py:878
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr "無法建立一個交互參照。任一數字未被指定： %s"
 
-#: sphinx/domains/std.py:884
+#: sphinx/domains/std.py:890
 #, python-format
 msgid "the link has no caption: %s"
 msgstr "這個連結沒有標題： %s"
 
-#: sphinx/domains/std.py:898
+#: sphinx/domains/std.py:904
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr "無效的 numfig_format: %s (%r)"
 
-#: sphinx/domains/std.py:901
+#: sphinx/domains/std.py:907
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr "無效的 numfig_format: %s"
 
-#: sphinx/domains/std.py:1114
+#: sphinx/domains/std.py:1137
 #, python-format
-msgid "undefined label: %s"
-msgstr "未定義的標籤： %s"
+msgid "undefined label: %r"
+msgstr "未定義的標籤： %r"
 
-#: sphinx/domains/std.py:1116
+#: sphinx/domains/std.py:1139
 #, python-format
-msgid "Failed to create a cross reference. A title or caption not found: %s"
-msgstr "無法建立一個交互參照。未找到標題或題目： %s"
+msgid "Failed to create a cross reference. A title or caption not found: %r"
+msgstr "無法建立一個交互參照。未找到標題或說明： %r"
 
-#: sphinx/environment/__init__.py:76
+#: sphinx/environment/__init__.py:67
 msgid "new config"
 msgstr "新的組態"
 
-#: sphinx/environment/__init__.py:77
+#: sphinx/environment/__init__.py:68
 msgid "config changed"
 msgstr "組態已變更"
 
-#: sphinx/environment/__init__.py:78
+#: sphinx/environment/__init__.py:69
 msgid "extensions changed"
 msgstr "擴充套件已變更"
 
-#: sphinx/environment/__init__.py:205
+#: sphinx/environment/__init__.py:271
 msgid "build environment version not current"
 msgstr "建立環境的版本不是目前的"
 
-#: sphinx/environment/__init__.py:207
+#: sphinx/environment/__init__.py:273
 msgid "source directory has changed"
 msgstr "來源資料夾已變更"
 
-#: sphinx/environment/__init__.py:286
+#: sphinx/environment/__init__.py:352
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr "這個環境與所選的 builder 不相容，請選擇另一個 doctree 資料夾。"
 
-#: sphinx/environment/__init__.py:385
+#: sphinx/environment/__init__.py:451
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr "無法掃描 %s 中的文件： %r"
 
-#: sphinx/environment/__init__.py:512
+#: sphinx/environment/__init__.py:580
 #, python-format
 msgid "Domain %r is not registered"
 msgstr "Domain %r 未被註冊"
 
-#: sphinx/environment/__init__.py:593
+#: sphinx/environment/__init__.py:682
 msgid "self referenced toctree found. Ignored."
 msgstr "找到自我參照的 toctree。已略過。"
 
-#: sphinx/environment/__init__.py:635
+#: sphinx/environment/__init__.py:724
 msgid "document isn't included in any toctree"
 msgstr "文件未被包含於任何 toctree"
 
-#: sphinx/environment/adapters/indexentries.py:78
+#: sphinx/environment/adapters/indexentries.py:72
 #, python-format
 msgid "see %s"
 msgstr "參考 %s"
 
-#: sphinx/environment/adapters/indexentries.py:82
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "see also %s"
 msgstr "也參考 %s"
 
-#: sphinx/environment/adapters/indexentries.py:85
+#: sphinx/environment/adapters/indexentries.py:79
 #, python-format
 msgid "unknown index entry type %r"
 msgstr "未知的索引項目型別 %r"
 
-#: sphinx/environment/adapters/indexentries.py:174
+#: sphinx/environment/adapters/indexentries.py:168
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr "符號"
 
-#: sphinx/environment/adapters/toctree.py:151
+#: sphinx/environment/adapters/toctree.py:156
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
-msgstr ""
+msgstr "偵測到循環的 toctree 參照，忽略中： %s <- %s"
 
-#: sphinx/environment/adapters/toctree.py:170
+#: sphinx/environment/adapters/toctree.py:177
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
-msgstr ""
+msgstr "toctree 包含了到文件 %r 的參照，該文件沒有標題：不會產生任何鏈接"
+
+#: sphinx/environment/adapters/toctree.py:185
+#, python-format
+msgid "toctree contains reference to non-included document %r"
+msgstr "toctree 包含了 non-included 文件 %r 的參照"
 
-#: sphinx/environment/collectors/asset.py:90
+#: sphinx/environment/collectors/asset.py:82
 #, python-format
 msgid "image file not readable: %s"
-msgstr ""
+msgstr "影像檔案無法讀取： %s"
 
-#: sphinx/environment/collectors/asset.py:109
+#: sphinx/environment/collectors/asset.py:101
 #, python-format
 msgid "image file %s not readable: %s"
-msgstr ""
+msgstr "影像檔案 %s 無法讀取： %s"
 
-#: sphinx/environment/collectors/asset.py:135
+#: sphinx/environment/collectors/asset.py:127
 #, python-format
 msgid "download file not readable: %s"
-msgstr ""
+msgstr "下載檔案無法讀取： %s"
 
-#: sphinx/environment/collectors/toctree.py:185
+#: sphinx/environment/collectors/toctree.py:219
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
-msgstr ""
+msgstr "%s 已經被指定段落編號（巢狀編號的 toctree？）"
 
-#: sphinx/ext/apidoc.py:83
+#: sphinx/ext/apidoc.py:79
 #, python-format
 msgid "Would create file %s."
-msgstr ""
+msgstr "將會建立檔案 %s 。"
 
-#: sphinx/ext/apidoc.py:308
+#: sphinx/ext/apidoc.py:301
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2437,211 +2440,216 @@
 "excluded from generation.\n"
 "\n"
 "Note: By default this script will not overwrite already created files."
-msgstr ""
+msgstr "\n在 <MODULE_PATH> 中遞迴查找 Python 模組及套件，並在 <OUTPUT_PATH> 中\n為每個套件建立一個帶有 automodule 指令的 reST 檔。\n\n<EXCLUDE_PATTERN> 可以是檔案及/或資料夾型樣，它們將在生成時被\n移除。\n\n備註：在預設情況，此腳本不會重寫已經被建立的檔案。"
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:314
 msgid "path to module to document"
-msgstr ""
+msgstr "要生成文件的模組路徑"
 
-#: sphinx/ext/apidoc.py:323
+#: sphinx/ext/apidoc.py:316
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
-msgstr ""
+msgstr "fnmatch 風格的檔案及/或資料夾模式，將在生成時移除。"
 
-#: sphinx/ext/apidoc.py:328
+#: sphinx/ext/apidoc.py:321
 msgid "directory to place all output"
-msgstr ""
+msgstr "要放置所有輸出的資料夾"
 
-#: sphinx/ext/apidoc.py:333
+#: sphinx/ext/apidoc.py:326
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
-msgstr ""
+msgstr "能顯示 TOC 的子模組最大深度（預設值：4）"
 
-#: sphinx/ext/apidoc.py:336
+#: sphinx/ext/apidoc.py:329
 msgid "overwrite existing files"
-msgstr ""
+msgstr "重寫已存在的檔案"
 
-#: sphinx/ext/apidoc.py:339
+#: sphinx/ext/apidoc.py:332
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
-msgstr ""
+msgstr "跟隨符號鏈接。與 collective.recipe.omelette 結合時很有用。"
 
-#: sphinx/ext/apidoc.py:342
+#: sphinx/ext/apidoc.py:335
 msgid "run the script without creating files"
-msgstr ""
+msgstr "執行腳本而不建立檔案"
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:338
 msgid "put documentation for each module on its own page"
-msgstr ""
+msgstr "為每個模組在它自己的頁面置放說明文件"
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:341
 msgid "include \"_private\" modules"
-msgstr ""
+msgstr "包含 \"_private\" 模組"
 
-#: sphinx/ext/apidoc.py:350
+#: sphinx/ext/apidoc.py:343
 msgid "filename of table of contents (default: modules)"
-msgstr ""
+msgstr "目錄的檔名（預設值：模組）"
 
-#: sphinx/ext/apidoc.py:352
+#: sphinx/ext/apidoc.py:345
 msgid "don't create a table of contents file"
-msgstr ""
+msgstr "不要建立目錄檔案"
 
-#: sphinx/ext/apidoc.py:355
+#: sphinx/ext/apidoc.py:348
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
-msgstr ""
+msgstr "不要為模組/套件建立標頭（例如：當說明字串已經包含它們時）"
 
-#: sphinx/ext/apidoc.py:360
+#: sphinx/ext/apidoc.py:353
 msgid "put module documentation before submodule documentation"
-msgstr ""
+msgstr "在子模組說明文件之前置放模組說明文件"
 
-#: sphinx/ext/apidoc.py:364
+#: sphinx/ext/apidoc.py:357
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
-msgstr ""
+msgstr "根據 PEP-0420 隱式命名空間規範來解譯模組路徑"
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:361
 msgid "file suffix (default: rst)"
-msgstr ""
+msgstr "檔案後綴（預設值：rst）"
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:363
 msgid "generate a full project with sphinx-quickstart"
-msgstr ""
+msgstr "以 sphinx-quickstart 生成一個完全的專案"
 
-#: sphinx/ext/apidoc.py:373
+#: sphinx/ext/apidoc.py:366
 msgid "append module_path to sys.path, used when --full is given"
-msgstr ""
+msgstr "附加 module_path 到 sys.path，在給予 --full 時使用"
 
-#: sphinx/ext/apidoc.py:375
+#: sphinx/ext/apidoc.py:368
 msgid "project name (default: root module name)"
-msgstr ""
+msgstr "專案名稱（預設值：根模組名稱）"
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:370
 msgid "project author(s), used when --full is given"
-msgstr ""
+msgstr "專案作者（們），在給予 --full 時使用"
 
-#: sphinx/ext/apidoc.py:379
+#: sphinx/ext/apidoc.py:372
 msgid "project version, used when --full is given"
-msgstr ""
+msgstr "專案版本，在給予 --full 時使用"
 
-#: sphinx/ext/apidoc.py:381
+#: sphinx/ext/apidoc.py:374
 msgid "project release, used when --full is given, defaults to --doc-version"
-msgstr ""
+msgstr "專案發布，在給予 --full 時使用，預設為 --doc-version"
 
-#: sphinx/ext/apidoc.py:384
+#: sphinx/ext/apidoc.py:377
 msgid "extension options"
-msgstr ""
+msgstr "擴充套件選項"
 
-#: sphinx/ext/apidoc.py:417
+#: sphinx/ext/apidoc.py:410
 #, python-format
 msgid "%s is not a directory."
-msgstr ""
+msgstr "%s 不是資料夾"
+
+#: sphinx/ext/autosectionlabel.py:45
+#, python-format
+msgid "section \"%s\" gets labeled as \"%s\""
+msgstr "段落 \"%s\" 取得標籤 \"%s\""
 
-#: sphinx/ext/coverage.py:43
+#: sphinx/ext/coverage.py:40
 #, python-format
 msgid "invalid regex %r in %s"
-msgstr ""
+msgstr "無效的 regex %r 在 %s"
 
-#: sphinx/ext/coverage.py:52
+#: sphinx/ext/coverage.py:49
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
-msgstr ""
+msgstr "來源的涵蓋測試已結束，在 %(outdir)spython.txt 中查看結果。"
 
-#: sphinx/ext/coverage.py:66
+#: sphinx/ext/coverage.py:63
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
-msgstr ""
+msgstr "無效的 regex %r 在 coverage_c_regexes"
 
-#: sphinx/ext/coverage.py:127
+#: sphinx/ext/coverage.py:124
 #, python-format
 msgid "undocumented c api: %s %s in file %s"
-msgstr ""
+msgstr "未文件化的 c api： %s %s 在檔案 %s 中"
 
-#: sphinx/ext/coverage.py:159
+#: sphinx/ext/coverage.py:156
 #, python-format
 msgid "module %s could not be imported: %s"
-msgstr ""
+msgstr "模組 %s 無法被 import： %s"
 
-#: sphinx/ext/coverage.py:255
+#: sphinx/ext/coverage.py:252
 #, python-format
 msgid "undocumented python function: %s :: %s"
-msgstr ""
+msgstr "未文件化的 python 函式： %s :: %s"
 
-#: sphinx/ext/coverage.py:271
+#: sphinx/ext/coverage.py:268
 #, python-format
 msgid "undocumented python class: %s :: %s"
-msgstr ""
+msgstr "未文件化的 python class： %s :: %s"
 
-#: sphinx/ext/coverage.py:284
+#: sphinx/ext/coverage.py:281
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
-msgstr ""
+msgstr "未文件化的 python method： %s :: %s :: %s"
 
-#: sphinx/ext/doctest.py:123
+#: sphinx/ext/doctest.py:112
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
-msgstr ""
+msgstr "在 '%s' 選項中遺漏 '+' 或 '-'。"
 
-#: sphinx/ext/doctest.py:128
+#: sphinx/ext/doctest.py:117
 #, python-format
 msgid "'%s' is not a valid option."
-msgstr ""
+msgstr "'%s' 不是有效的選項"
 
-#: sphinx/ext/doctest.py:142
+#: sphinx/ext/doctest.py:131
 #, python-format
 msgid "'%s' is not a valid pyversion option"
-msgstr ""
+msgstr "'%s' 不是有效的 pyversion 選項"
 
-#: sphinx/ext/doctest.py:225
+#: sphinx/ext/doctest.py:214
 msgid "invalid TestCode type"
-msgstr ""
+msgstr "無效的 TestCode 型別"
 
-#: sphinx/ext/doctest.py:283
+#: sphinx/ext/doctest.py:272
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
-msgstr ""
+msgstr "來源的 doctests 測試已結束，在 %(outdir)s/output.txt 中查看結果。"
 
-#: sphinx/ext/doctest.py:433
+#: sphinx/ext/doctest.py:422
 #, python-format
 msgid "no code/output in %s block at %s:%s"
-msgstr ""
+msgstr "在 %s 區塊中的 %s:%s 沒有程式碼/輸出"
 
-#: sphinx/ext/doctest.py:519
+#: sphinx/ext/doctest.py:508
 #, python-format
 msgid "ignoring invalid doctest code: %r"
-msgstr ""
+msgstr "正在忽略無效的 doctest 碼： %r"
 
-#: sphinx/ext/duration.py:79
+#: sphinx/ext/duration.py:74
 msgid ""
 "====================== slowest reading durations ======================="
-msgstr ""
+msgstr "====================== 最慢的讀取歷時 ======================="
 
-#: sphinx/ext/extlinks.py:76
+#: sphinx/ext/extlinks.py:77
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
-msgstr ""
+msgstr "hardcoded link %r 可以被一個 extlink 所取代（試試改用 %r）"
 
-#: sphinx/ext/graphviz.py:132
+#: sphinx/ext/graphviz.py:126
 msgid "Graphviz directive cannot have both content and a filename argument"
-msgstr ""
+msgstr "Graphviz 指令不能同時有內容及檔名引數"
 
-#: sphinx/ext/graphviz.py:142
+#: sphinx/ext/graphviz.py:136
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
-msgstr ""
+msgstr "外部的 Graphviz 檔案 %r 未找到或是讀取失敗"
 
-#: sphinx/ext/graphviz.py:149
+#: sphinx/ext/graphviz.py:143
 msgid "Ignoring \"graphviz\" directive without content."
-msgstr ""
+msgstr "正在略過沒有內容的 \"graphviz\" 指令"
 
-#: sphinx/ext/graphviz.py:257
+#: sphinx/ext/graphviz.py:252
 #, python-format
 msgid ""
 "dot did not produce an output file:\n"
@@ -2649,16 +2657,16 @@
 "%r\n"
 "stdout\n"
 "%r"
-msgstr ""
+msgstr "dot 並未製作一個輸出檔案：\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:261
+#: sphinx/ext/graphviz.py:256
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
-msgstr ""
+msgstr "dot 命令 %r 無法被執行（graphviz 輸出所需要），請檢查 graphviz_dot 設定"
 
-#: sphinx/ext/graphviz.py:268
+#: sphinx/ext/graphviz.py:263
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2666,35 +2674,37 @@
 "%r\n"
 "stdout\n"
 "%r"
-msgstr ""
+msgstr "退出 dot，發生錯誤：\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/graphviz.py:278
+#: sphinx/ext/graphviz.py:274
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
-msgstr ""
+msgstr "graphviz_output_format 必須是 'png' 和 'svg' 之一，但卻是 %r"
 
-#: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334
-#: sphinx/ext/graphviz.py:371
+#: sphinx/ext/graphviz.py:278 sphinx/ext/graphviz.py:330
+#: sphinx/ext/graphviz.py:367
 #, python-format
 msgid "dot code %r: %s"
-msgstr ""
+msgstr "點碼 %r: %s"
 
-#: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392
+#: sphinx/ext/graphviz.py:380 sphinx/ext/graphviz.py:388
 #, python-format
 msgid "graph: %s"
 msgstr "圖：%s"
 
-#: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394
+#: sphinx/ext/graphviz.py:382 sphinx/ext/graphviz.py:390
 msgid "graph"
 msgstr "圖"
 
-#: sphinx/ext/imgconverter.py:41
+#: sphinx/ext/imgconverter.py:36
 #, python-format
 msgid ""
-"convert command %r cannot be run, check the image_converter setting: %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"
+"\n"
+"Traceback: %s"
+msgstr "無法執行影像轉換命令 %r。 'sphinx.ext.imgconverter' 預設為需要 ImageMagick。請確認它已被安裝，或是設定 'image_converter' 選項為一個自訂轉換命令。\n\n回溯: %s"
 
-#: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70
+#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2702,334 +2712,343 @@
 "%r\n"
 "stdout\n"
 "%r"
-msgstr ""
+msgstr "退出轉換，發生錯誤：\nstderr\n%r\nstdout\n%r"
 
-#: sphinx/ext/imgconverter.py:65
+#: sphinx/ext/imgconverter.py:64
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
-msgstr ""
+msgstr "轉換命令 %r 無法被執行，請檢查 image_converter 設定"
 
-#: sphinx/ext/imgmath.py:141
+#: sphinx/ext/imgmath.py:139
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
-msgstr ""
+msgstr "LaTeX 命令 %r 無法被執行（數學顯示所需要），請檢查 imgmath_latex 設定"
 
-#: sphinx/ext/imgmath.py:155
+#: sphinx/ext/imgmath.py:153
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
-msgstr ""
+msgstr "%s 命令 %r 無法被執行（數學顯示所需要），請檢查 imgmath_%s 設定"
 
-#: sphinx/ext/imgmath.py:300
+#: sphinx/ext/imgmath.py:309
 #, python-format
 msgid "display latex %r: %s"
-msgstr ""
+msgstr "顯示 latex %r: %s"
 
-#: sphinx/ext/imgmath.py:326
+#: sphinx/ext/imgmath.py:343
 #, python-format
 msgid "inline latex %r: %s"
-msgstr ""
+msgstr "行內 latex %r: %s"
 
-#: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52
+#: sphinx/ext/imgmath.py:350 sphinx/ext/mathjax.py:49
 msgid "Permalink to this equation"
 msgstr "本公式的永久連結"
 
-#: sphinx/ext/intersphinx.py:174
+#: sphinx/ext/intersphinx.py:176
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
-msgstr ""
+msgstr "intersphinx 庫存已移動： %s -> %s"
 
-#: sphinx/ext/intersphinx.py:205
+#: sphinx/ext/intersphinx.py:207
 #, python-format
 msgid "loading intersphinx inventory from %s..."
-msgstr ""
+msgstr "正在從 %s 載入 intersphinx 庫存... "
 
-#: sphinx/ext/intersphinx.py:219
+#: sphinx/ext/intersphinx.py:221
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
-msgstr ""
+msgstr "從一些庫存中遇到一些問題，但他們已在進行替代方案："
 
-#: sphinx/ext/intersphinx.py:225
+#: sphinx/ext/intersphinx.py:227
 msgid "failed to reach any of the inventories with the following issues:"
-msgstr ""
+msgstr "無法到達任何的庫存，遇到以下問題："
 
-#: sphinx/ext/intersphinx.py:270
+#: sphinx/ext/intersphinx.py:272
 #, python-format
 msgid "(in %s v%s)"
 msgstr "(於 %s v%s)"
 
-#: sphinx/ext/intersphinx.py:272
+#: sphinx/ext/intersphinx.py:274
 #, python-format
 msgid "(in %s)"
-msgstr ""
+msgstr "(於 %s)"
+
+#: sphinx/ext/intersphinx.py:499
+#, python-format
+msgid "inventory for external cross-reference not found: %s"
+msgstr "未找到外部交叉參照的清單： %s"
 
-#: sphinx/ext/intersphinx.py:476
+#: sphinx/ext/intersphinx.py:505
+#, python-format
+msgid "role for external cross-reference not found: %s"
+msgstr "未找到外部交叉參照的角色： %s"
+
+#: sphinx/ext/intersphinx.py:589
+#, python-format
+msgid "external %s:%s reference target not found: %s"
+msgstr "未找到外部的 %s:%s 參照目標： %s"
+
+#: sphinx/ext/intersphinx.py:614
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr "intersphinx identifier %r 不是字串。已略過"
 
-#: sphinx/ext/intersphinx.py:489
+#: sphinx/ext/intersphinx.py:627
 #, python-format
 msgid "Failed to read intersphinx_mapping%s, ignored: %r"
 msgstr "無法讀取 intersphinx_mapping%s, 已略過: %r"
 
-#: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188
+#: sphinx/ext/linkcode.py:64 sphinx/ext/viewcode.py:180
 msgid "source"
 msgstr "原始碼"
 
-#: sphinx/ext/todo.py:68
+#: sphinx/ext/todo.py:64
 msgid "Todo"
 msgstr "Todo"
 
-#: sphinx/ext/todo.py:101
+#: sphinx/ext/todo.py:97
 #, python-format
 msgid "TODO entry found: %s"
 msgstr "找到 TODO 項目： %s"
 
-#: sphinx/ext/todo.py:159
+#: sphinx/ext/todo.py:155
 msgid "<<original entry>>"
 msgstr "<<original entry>>"
 
-#: sphinx/ext/todo.py:161
+#: sphinx/ext/todo.py:157
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr "(<<original entry>> 見 %s ，第 %d 行)"
 
-#: sphinx/ext/todo.py:171
+#: sphinx/ext/todo.py:167
 msgid "original entry"
 msgstr "原始記錄"
 
-#: sphinx/ext/viewcode.py:257
+#: sphinx/ext/viewcode.py:237
 msgid "highlighting module code... "
 msgstr "正在 highlight 模組程式碼..."
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:269
 msgid "docs"
 msgstr "文件"
 
-#: sphinx/ext/viewcode.py:303
+#: sphinx/ext/viewcode.py:283
 msgid "Module code"
 msgstr "模組原始碼"
 
-#: sphinx/ext/viewcode.py:309
+#: sphinx/ext/viewcode.py:289
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr "<h1>%s 的原始碼</h1>"
 
-#: sphinx/ext/viewcode.py:336
+#: sphinx/ext/viewcode.py:315
 msgid "Overview: module code"
 msgstr "概要：模組原始碼"
 
-#: sphinx/ext/viewcode.py:337
+#: sphinx/ext/viewcode.py:316
 msgid "<h1>All modules for which code is available</h1>"
 msgstr "<h1>所有可得程式碼的模組</h1>"
 
-#: sphinx/ext/autodoc/__init__.py:132
+#: sphinx/ext/autodoc/__init__.py:133
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr "對於 member-order 選項無效的值： %s"
 
-#: sphinx/ext/autodoc/__init__.py:140
+#: sphinx/ext/autodoc/__init__.py:141
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr "對於 class-doc-from 選項無效的值： %s"
 
-#: sphinx/ext/autodoc/__init__.py:401
+#: sphinx/ext/autodoc/__init__.py:393
 #, python-format
 msgid "invalid signature for auto%s (%r)"
-msgstr ""
+msgstr "無效的簽章給 auto%s (%r)"
 
-#: sphinx/ext/autodoc/__init__.py:518
+#: sphinx/ext/autodoc/__init__.py:509
 #, python-format
 msgid "error while formatting arguments for %s: %s"
-msgstr ""
+msgstr "在為 %s 格式化引數時有錯誤： %s"
 
-#: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1699
-#, python-format
-msgid "missing attribute %s in object %s"
-msgstr ""
-
-#: sphinx/ext/autodoc/__init__.py:815
+#: sphinx/ext/autodoc/__init__.py:776
 #, python-format
 msgid ""
 "autodoc: failed to determine %s.%s (%r) to be documented, the following exception was raised:\n"
 "%s"
-msgstr ""
+msgstr "autodoc: 決定 %s.%s (%r) 被文件化失敗，引發以下的例外：\n%s"
 
-#: sphinx/ext/autodoc/__init__.py:908
+#: sphinx/ext/autodoc/__init__.py:871
 #, python-format
 msgid ""
 "don't know which module to import for autodocumenting %r (try placing a "
 "\"module\" or \"currentmodule\" directive in the document, or giving an "
 "explicit module name)"
-msgstr ""
+msgstr "不清楚要 import 哪個模組來 autodocument %r （試試看在文件中加入 \"module\" 或 \"currentmodule\" 指令，或是給予一個明確的模組名稱）"
 
-#: sphinx/ext/autodoc/__init__.py:952
+#: sphinx/ext/autodoc/__init__.py:915
 #, python-format
 msgid "A mocked object is detected: %r"
 msgstr "一個 mocked 物件被偵測到： %r"
 
-#: sphinx/ext/autodoc/__init__.py:971
+#: sphinx/ext/autodoc/__init__.py:934
 #, python-format
 msgid "error while formatting signature for %s: %s"
 msgstr "正在為 %s 格式化簽名時發生錯誤： %s"
 
-#: sphinx/ext/autodoc/__init__.py:1021
+#: sphinx/ext/autodoc/__init__.py:994
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr "\"::\" 在 automodule 的名稱中並不合理"
 
-#: sphinx/ext/autodoc/__init__.py:1028
+#: sphinx/ext/autodoc/__init__.py:1001
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr "簽名引數或回傳註釋給予 automodule %s"
 
-#: sphinx/ext/autodoc/__init__.py:1041
+#: sphinx/ext/autodoc/__init__.py:1014
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr "__all__  應該是一個字串的列表，不是 %r （在 %s 模組中）-- 正在忽略 __all__"
 
-#: sphinx/ext/autodoc/__init__.py:1107
+#: sphinx/ext/autodoc/__init__.py:1080
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr "缺少 :members: 選項中所述的屬性：模組 %s ，屬性 %s"
 
-#: sphinx/ext/autodoc/__init__.py:1308 sphinx/ext/autodoc/__init__.py:1385
-#: sphinx/ext/autodoc/__init__.py:2791
+#: sphinx/ext/autodoc/__init__.py:1284 sphinx/ext/autodoc/__init__.py:1361
+#: sphinx/ext/autodoc/__init__.py:2743
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr "無法取得一個函式簽名給 %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1578
+#: sphinx/ext/autodoc/__init__.py:1570
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr "無法取得一個 constructor 簽名給 %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:1686
+#: sphinx/ext/autodoc/__init__.py:1696
 #, python-format
 msgid "Bases: %s"
 msgstr "基礎類別：%s"
 
-#: sphinx/ext/autodoc/__init__.py:1784 sphinx/ext/autodoc/__init__.py:1862
-#: sphinx/ext/autodoc/__init__.py:1885
+#: sphinx/ext/autodoc/__init__.py:1710
+#, python-format
+msgid "missing attribute %s in object %s"
+msgstr "遺漏屬性 %s 在物件 %s"
+
+#: sphinx/ext/autodoc/__init__.py:1810 sphinx/ext/autodoc/__init__.py:1847
+#: sphinx/ext/autodoc/__init__.py:1930
 #, python-format
 msgid "alias of %s"
 msgstr "%s 的別名"
 
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1830
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr "TypeVar(%s) 的別名"
 
-#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
+#: sphinx/ext/autodoc/__init__.py:2151 sphinx/ext/autodoc/__init__.py:2248
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr "無法取得一個 method 簽名給 %s: %s"
 
-#: sphinx/ext/autodoc/__init__.py:2395
+#: sphinx/ext/autodoc/__init__.py:2376
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr "在 %s 找到無效的 __slots__。已略過。"
 
-#: sphinx/ext/autodoc/__init__.py:2834
-msgid ""
-"autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"."
-" Please update your setting."
-msgstr "autodoc_member_order 現在接受 \"alphabetical\" 而非 \"alphabetic\"。請更新您的設定。"
-
-#: sphinx/ext/autodoc/preserve_defaults.py:106
+#: sphinx/ext/autodoc/preserve_defaults.py:114
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr "無法為 %r 剖析一個預設引數： %s"
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:122
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr "無法為 %r 更新簽名：未找到參數： %s"
 
-#: sphinx/ext/autodoc/type_comment.py:133
+#: sphinx/ext/autodoc/type_comment.py:125
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr "無法為 %r 剖析 type_comment： %s"
 
-#: sphinx/ext/autosummary/__init__.py:280
+#: sphinx/ext/autosummary/__init__.py:246
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr "autosummary 參照已排除文件 %r 。已略過。"
 
-#: sphinx/ext/autosummary/__init__.py:282
+#: sphinx/ext/autosummary/__init__.py:248
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr "autosummary: 未找到 stub 檔 %r 。請檢查您的 autosummary_generate 設定。"
 
-#: sphinx/ext/autosummary/__init__.py:301
+#: sphinx/ext/autosummary/__init__.py:267
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr "一個有標題的 autosummary 需要 :toctree: 選項。已略過。 "
 
-#: sphinx/ext/autosummary/__init__.py:352
+#: sphinx/ext/autosummary/__init__.py:320
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "autosummary: import %s 失敗。\n可能的提示：\n%s"
 
-#: sphinx/ext/autosummary/__init__.py:366
+#: sphinx/ext/autosummary/__init__.py:334
 #, python-format
 msgid "failed to parse name %s"
 msgstr "剖析名稱 %s 失敗"
 
-#: sphinx/ext/autosummary/__init__.py:371
+#: sphinx/ext/autosummary/__init__.py:339
 #, python-format
 msgid "failed to import object %s"
 msgstr "import 物件 %s 失敗"
 
-#: sphinx/ext/autosummary/__init__.py:815
+#: sphinx/ext/autosummary/__init__.py:792
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr "autosummary_generate: 檔案未找到： %s"
 
-#: sphinx/ext/autosummary/__init__.py:823
+#: sphinx/ext/autosummary/__init__.py:800
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr "autosummary 會在內部產生 .rst 檔案。但是您的 source_suffix 並未包含 .rst。已省略。"
 
-#: sphinx/ext/autosummary/generate.py:190
-#: sphinx/ext/autosummary/generate.py:254
+#: sphinx/ext/autosummary/generate.py:165
+#: sphinx/ext/autosummary/generate.py:238
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr "autosummary: 無法決定 %r 被記錄，以下例外被引發：\n%s"
 
-#: sphinx/ext/autosummary/generate.py:401
+#: sphinx/ext/autosummary/generate.py:376
 #, python-format
 msgid "autosummary generating autosummary for: %s"
 msgstr "autosummary 正在產生 autosummary 給： %s"
 
-#: sphinx/ext/autosummary/generate.py:405
+#: sphinx/ext/autosummary/generate.py:380
 #, python-format
 msgid "autosummary writing to %s"
 msgstr "autosummary 正在寫入 %s"
 
-#: sphinx/ext/autosummary/generate.py:448
+#: sphinx/ext/autosummary/generate.py:423
 #, python-format
 msgid ""
 "autosummary failed to import %s.\n"
 "Possible hints:\n"
 "%s"
-msgstr ""
+msgstr "autosummary import %s 失敗。\n可能的提示：\n%s"
 
-#: sphinx/ext/autosummary/generate.py:624
+#: sphinx/ext/autosummary/generate.py:596
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3044,138 +3063,138 @@
 "  pydoc sphinx.ext.autosummary\n"
 msgstr "\n使用 autosummary 指令產生 ReStructuredText。\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的一個前端。它會從給定的\n輸入檔案中所包含的 autosummary 指令，產生 reStructuredText 檔案。\n\nautosummary 指令的格式被記錄在 ``sphinx.ext.autosummary`` Python 模組中，\n它可以使用此方法來讀取::\n\npydoc sphinx.ext.autosummary\n"
 
-#: sphinx/ext/autosummary/generate.py:641
+#: sphinx/ext/autosummary/generate.py:613
 msgid "source files to generate rST files for"
 msgstr "原始檔案以產生 rST 檔案給"
 
-#: sphinx/ext/autosummary/generate.py:645
+#: sphinx/ext/autosummary/generate.py:617
 msgid "directory to place all output in"
 msgstr "資料夾來放置所有輸出在"
 
-#: sphinx/ext/autosummary/generate.py:648
+#: sphinx/ext/autosummary/generate.py:620
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr "檔案的預設後綴（預設： %(default)s ）"
 
-#: sphinx/ext/autosummary/generate.py:652
+#: sphinx/ext/autosummary/generate.py:624
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr "自訂模板資料夾（預設： %(default)s ）"
 
-#: sphinx/ext/autosummary/generate.py:656
+#: sphinx/ext/autosummary/generate.py:628
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr "文件引入成員（預設： %(default)s ）"
 
-#: sphinx/ext/autosummary/generate.py:660
+#: sphinx/ext/autosummary/generate.py:632
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
-msgstr ""
+msgstr "文件確實是在模組 __all__ 屬性中的成員。（預設值： %(default)s）"
 
-#: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
 msgid "Keyword Arguments"
 msgstr "關鍵字引數"
 
-#: sphinx/ext/napoleon/docstring.py:657
+#: sphinx/ext/napoleon/docstring.py:676
 msgid "Example"
 msgstr "範例"
 
-#: sphinx/ext/napoleon/docstring.py:658
+#: sphinx/ext/napoleon/docstring.py:677
 msgid "Examples"
 msgstr "範例"
 
-#: sphinx/ext/napoleon/docstring.py:718
+#: sphinx/ext/napoleon/docstring.py:737
 msgid "Notes"
 msgstr "備註"
 
-#: sphinx/ext/napoleon/docstring.py:727
+#: sphinx/ext/napoleon/docstring.py:746
 msgid "Other Parameters"
 msgstr "其他參數"
 
-#: sphinx/ext/napoleon/docstring.py:763
+#: sphinx/ext/napoleon/docstring.py:782
 msgid "Receives"
 msgstr "接收"
 
-#: sphinx/ext/napoleon/docstring.py:767
+#: sphinx/ext/napoleon/docstring.py:786
 msgid "References"
 msgstr "參照"
 
-#: sphinx/ext/napoleon/docstring.py:799
+#: sphinx/ext/napoleon/docstring.py:818
 msgid "Warns"
 msgstr "警告"
 
-#: sphinx/ext/napoleon/docstring.py:803
+#: sphinx/ext/napoleon/docstring.py:822
 msgid "Yields"
 msgstr "產出"
 
-#: sphinx/ext/napoleon/docstring.py:971
+#: sphinx/ext/napoleon/docstring.py:980
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr "無效的值集合（缺少右括號）： %s"
 
-#: sphinx/ext/napoleon/docstring.py:978
+#: sphinx/ext/napoleon/docstring.py:987
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr "無效的值集合（缺少左括號）： %s"
 
-#: sphinx/ext/napoleon/docstring.py:985
+#: sphinx/ext/napoleon/docstring.py:994
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr "異常的字串文本（缺少右括號）： %s"
 
-#: sphinx/ext/napoleon/docstring.py:992
+#: sphinx/ext/napoleon/docstring.py:1001
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr "異常的字串文本（缺少左括號）： %s"
 
-#: sphinx/locale/__init__.py:252
+#: sphinx/locale/__init__.py:245
 msgid "Attention"
 msgstr "注意"
 
-#: sphinx/locale/__init__.py:253
+#: sphinx/locale/__init__.py:246
 msgid "Caution"
 msgstr "警示"
 
-#: sphinx/locale/__init__.py:254
+#: sphinx/locale/__init__.py:247
 msgid "Danger"
 msgstr "危險"
 
-#: sphinx/locale/__init__.py:255
+#: sphinx/locale/__init__.py:248
 msgid "Error"
 msgstr "錯誤"
 
-#: sphinx/locale/__init__.py:256
+#: sphinx/locale/__init__.py:249
 msgid "Hint"
 msgstr "提示"
 
-#: sphinx/locale/__init__.py:257
+#: sphinx/locale/__init__.py:250
 msgid "Important"
 msgstr "重要"
 
-#: sphinx/locale/__init__.py:258
+#: sphinx/locale/__init__.py:251
 msgid "Note"
 msgstr "備註"
 
-#: sphinx/locale/__init__.py:259
+#: sphinx/locale/__init__.py:252
 msgid "See also"
 msgstr "也參考"
 
-#: sphinx/locale/__init__.py:260
+#: sphinx/locale/__init__.py:253
 msgid "Tip"
 msgstr "小訣竅"
 
-#: sphinx/locale/__init__.py:261
+#: sphinx/locale/__init__.py:254
 msgid "Warning"
 msgstr "警告"
 
-#: sphinx/templates/latex/longtable.tex_t:23
+#: sphinx/templates/latex/longtable.tex_t:48
 #: sphinx/templates/latex/sphinxmessages.sty_t:8
 msgid "continued from previous page"
 msgstr "繼續上一頁"
 
-#: sphinx/templates/latex/longtable.tex_t:29
+#: sphinx/templates/latex/longtable.tex_t:59
 #: sphinx/templates/latex/sphinxmessages.sty_t:9
 msgid "continues on next page"
 msgstr "繼續下一頁"
@@ -3197,7 +3216,7 @@
 msgid "Table of Contents"
 msgstr "目錄"
 
-#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150
+#: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:151
 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22
 msgid "Search"
 msgstr "搜尋"
@@ -3278,35 +3297,35 @@
 msgid "Navigation"
 msgstr "瀏覽"
 
-#: sphinx/themes/basic/layout.html:135
+#: sphinx/themes/basic/layout.html:136
 #, python-format
 msgid "Search within %(docstitle)s"
 msgstr "在 %(docstitle)s 中搜尋"
 
-#: sphinx/themes/basic/layout.html:144
+#: sphinx/themes/basic/layout.html:145
 msgid "About these documents"
 msgstr "關於這些文件"
 
-#: sphinx/themes/basic/layout.html:153
+#: sphinx/themes/basic/layout.html:154
 msgid "Copyright"
 msgstr "版權所有"
 
-#: sphinx/themes/basic/layout.html:199
+#: sphinx/themes/basic/layout.html:200
 #, python-format
 msgid "&#169; <a href=\"%(path)s\">Copyright</a> %(copyright)s."
 msgstr "&#169; <a href=\"%(path)s\">版權所有</a> %(copyright)s。"
 
-#: sphinx/themes/basic/layout.html:201
+#: sphinx/themes/basic/layout.html:202
 #, python-format
 msgid "&#169; Copyright %(copyright)s."
 msgstr "&#169; 版權所有 %(copyright)s。"
 
-#: sphinx/themes/basic/layout.html:205
+#: sphinx/themes/basic/layout.html:206
 #, python-format
 msgid "Last updated on %(last_updated)s."
 msgstr "最後更新於 %(last_updated)s。"
 
-#: sphinx/themes/basic/layout.html:208
+#: sphinx/themes/basic/layout.html:209
 #, python-format
 msgid ""
 "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
@@ -3351,12 +3370,12 @@
 msgstr "搜尋"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:306
+#: sphinx/themes/basic/static/searchtools.js:105
 msgid "Search Results"
 msgstr "搜尋結果"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:308
+#: sphinx/themes/basic/static/searchtools.js:107
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3374,7 +3393,7 @@
 #: sphinx/themes/basic/changes/versionchanges.html:12
 #, python-format
 msgid "Changes in Version %(version)s &#8212; %(docstitle)s"
-msgstr "於 %(version)s 版本中的所有變更 &#8212; %(docstitle)s"
+msgstr "於 %(version)s 版中的所有變更 &#8212; %(docstitle)s"
 
 #: sphinx/themes/basic/changes/rstsource.html:5
 #, python-format
@@ -3384,7 +3403,7 @@
 #: sphinx/themes/basic/changes/versionchanges.html:17
 #, python-format
 msgid "Automatically generated list of changes in version %(version)s"
-msgstr "自動產生的 %(version)s 版本變更列表"
+msgstr "自動產生的 %(version)s 版變更列表"
 
 #: sphinx/themes/basic/changes/versionchanges.html:18
 msgid "Library changes"
@@ -3398,280 +3417,278 @@
 msgid "Other changes"
 msgstr "其他變更"
 
-#: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437
-#: sphinx/writers/html.py:442 sphinx/writers/html5.py:392
-#: sphinx/writers/html5.py:397
-msgid "Permalink to this headline"
-msgstr "本標題的永久連結"
-
-#: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132
-#: sphinx/writers/html.py:141 sphinx/writers/html5.py:107
-#: sphinx/writers/html5.py:116
-msgid "Permalink to this definition"
-msgstr "本定義的永久連結"
-
-#: sphinx/themes/basic/static/doctools.js:238
-msgid "Hide Search Matches"
-msgstr "隱藏符合搜尋"
+#: sphinx/themes/basic/static/searchtools.js:111
+msgid ""
+"Search finished, found ${resultCount} page(s) matching the search query."
+msgstr "搜尋結束，共找到 ${resultCount} 個頁面符合搜尋條件。"
 
-#: sphinx/themes/basic/static/searchtools.js:136
+#: sphinx/themes/basic/static/searchtools.js:209
 msgid "Searching"
 msgstr "搜尋中"
 
-#: sphinx/themes/basic/static/searchtools.js:141
+#: sphinx/themes/basic/static/searchtools.js:225
 msgid "Preparing search..."
 msgstr "準備搜尋中…"
 
-#: sphinx/themes/basic/static/searchtools.js:310
-#, python-format
-msgid "Search finished, found %s page(s) matching the search query."
-msgstr "搜尋完成，共找到 %s 頁面符合搜尋條件。"
-
-#: sphinx/themes/basic/static/searchtools.js:365
+#: sphinx/themes/basic/static/searchtools.js:413
 msgid ", in "
 msgstr "，於 "
 
-#: sphinx/themes/classic/static/sidebar.js_t:83
-msgid "Expand sidebar"
-msgstr "展開側邊欄"
+#: sphinx/themes/basic/static/sphinx_highlight.js:107
+msgid "Hide Search Matches"
+msgstr "隱藏符合搜尋"
 
-#: sphinx/themes/classic/static/sidebar.js_t:96
-#: sphinx/themes/classic/static/sidebar.js_t:124
+#: sphinx/themes/classic/layout.html:20
+#: sphinx/themes/classic/static/sidebar.js_t:57
 msgid "Collapse sidebar"
 msgstr "收合側邊欄"
 
+#: sphinx/themes/classic/static/sidebar.js_t:48
+msgid "Expand sidebar"
+msgstr "展開側邊欄"
+
 #: sphinx/themes/haiku/layout.html:24
 msgid "Contents"
 msgstr "內容"
 
-#: sphinx/transforms/__init__.py:225
+#: sphinx/transforms/__init__.py:217
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr "找到基於 4 欄位的索引。它可能是您使用的擴充套件的一個錯誤： %r"
 
-#: sphinx/transforms/__init__.py:264
+#: sphinx/transforms/__init__.py:256
 #, python-format
 msgid "Footnote %s is not referenced."
 msgstr "註腳 %s 未被參照。"
 
-#: sphinx/transforms/__init__.py:270
+#: sphinx/transforms/__init__.py:262
 msgid "Footnote # is not referenced."
 msgstr "註腳 # 未被參照。"
 
-#: sphinx/transforms/i18n.py:309 sphinx/transforms/i18n.py:380
+#: sphinx/transforms/i18n.py:325 sphinx/transforms/i18n.py:396
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "被翻譯訊息中有不一致的註腳參照。原文： {0}，譯文： {1}"
 
-#: sphinx/transforms/i18n.py:352
+#: sphinx/transforms/i18n.py:368
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr "被翻譯訊息中有不一致的參照。原文： {0}，譯文： {1}"
 
-#: sphinx/transforms/i18n.py:399
+#: sphinx/transforms/i18n.py:417
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "被翻譯訊息中有不一致的引用。原文： {0}，譯文： {1}"
 
-#: sphinx/transforms/i18n.py:419
+#: sphinx/transforms/i18n.py:437
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr "被翻譯訊息中有不一致的術語參照。原文： {0}，譯文： {1}"
 
-#: sphinx/transforms/post_transforms/__init__.py:118
+#: sphinx/transforms/post_transforms/__init__.py:112
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr "無法為交互參照決定備用文字。可能是個錯誤。"
 
-#: sphinx/transforms/post_transforms/__init__.py:158
+#: sphinx/transforms/post_transforms/__init__.py:154
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr "為「任一個」交互參照 %r 找到多於一個目標：可能是 %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:206
+#: sphinx/transforms/post_transforms/__init__.py:205
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr "%s:%s 參照目標未找到： %s"
 
-#: sphinx/transforms/post_transforms/__init__.py:209
+#: sphinx/transforms/post_transforms/__init__.py:208
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr "%r 參照目標未找到： %s"
 
-#: sphinx/transforms/post_transforms/images.py:83
+#: sphinx/transforms/post_transforms/images.py:77
 #, python-format
 msgid "Could not fetch remote image: %s %d"
 msgstr "無法提取遠端圖片： %s %d"
 
-#: sphinx/transforms/post_transforms/images.py:111
+#: sphinx/transforms/post_transforms/images.py:105
 #, python-format
 msgid "Could not fetch remote image: %s %s"
 msgstr "無法提取遠端圖片： %s %s"
 
-#: sphinx/transforms/post_transforms/images.py:129
+#: sphinx/transforms/post_transforms/images.py:122
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr "未知的圖片格式： %s..."
 
-#: sphinx/util/__init__.py:285
+#: sphinx/util/__init__.py:229
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr "無法解碼的原始字元，以 \"?\" 取代： %r"
 
-#: sphinx/util/__init__.py:533
+#: sphinx/util/display.py:70
 msgid "skipped"
 msgstr "已省略"
 
-#: sphinx/util/__init__.py:538
+#: sphinx/util/display.py:75
 msgid "failed"
 msgstr "失敗"
 
-#: sphinx/util/docfields.py:81
+#: sphinx/util/docfields.py:78
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
-msgstr ""
+msgstr "在 %s domain 中的問題：欄位應該要用角色 '%s' ，但是那個角色並不在該 domain。"
 
-#: sphinx/util/docutils.py:213
+#: sphinx/util/docutils.py:308
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr "未知的指令或角色名稱： %s:%s"
 
-#: sphinx/util/docutils.py:500
+#: sphinx/util/docutils.py:604
 #, python-format
 msgid "unknown node type: %r"
 msgstr "未知的節點型別： %r"
 
-#: sphinx/util/i18n.py:67
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr "讀取錯誤： %s, %s"
 
-#: sphinx/util/i18n.py:74
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr "寫入錯誤： %s, %s"
 
-#: sphinx/util/i18n.py:98
+#: sphinx/util/i18n.py:94
 #, python-format
 msgid "locale_dir %s does not exists"
 msgstr "locale_dir %s 不存在"
 
-#: sphinx/util/i18n.py:192
+#: sphinx/util/i18n.py:190
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr "無效的日期格式。如果您要直接將它輸出，則以單引號引用該字串： %s"
 
-#: sphinx/util/nodes.py:437
+#: sphinx/util/nodes.py:417
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr "toctree 包含了不存在的檔案 %r 的參照 "
 
-#: sphinx/util/nodes.py:623
+#: sphinx/util/nodes.py:604
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr "在評估只有指令的運算式時發生例外： %s"
 
-#: sphinx/util/rst.py:77
+#: sphinx/util/rst.py:71
 #, python-format
 msgid "default role %s not found"
 msgstr "預設角色 %s 未找到"
 
-#: sphinx/writers/html.py:330 sphinx/writers/html5.py:305
+#: sphinx/writers/_html4.py:92 sphinx/writers/_html4.py:101
+#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
+msgid "Permalink to this definition"
+msgstr "本定義的永久連結"
+
+#: sphinx/writers/_html4.py:293 sphinx/writers/html5.py:299
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr "numfig_format 未被定義給 %s"
 
-#: sphinx/writers/html.py:340 sphinx/writers/html5.py:315
+#: sphinx/writers/_html4.py:303 sphinx/writers/html5.py:309
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr "任一個 ID 未被指定給 %s 節點"
 
-#: sphinx/writers/html.py:414 sphinx/writers/html5.py:369
+#: sphinx/writers/_html4.py:377 sphinx/writers/html5.py:363
 msgid "Permalink to this term"
 msgstr "本術語的永久連結"
 
-#: sphinx/writers/html.py:446 sphinx/writers/html5.py:401
+#: sphinx/writers/_html4.py:400 sphinx/writers/_html4.py:405
+#: sphinx/writers/html5.py:386 sphinx/writers/html5.py:391
+msgid "Permalink to this heading"
+msgstr "本標頭的永久連結"
+
+#: sphinx/writers/_html4.py:409 sphinx/writers/html5.py:395
 msgid "Permalink to this table"
 msgstr "本表格的永久連結"
 
-#: sphinx/writers/html.py:489 sphinx/writers/html5.py:444
+#: sphinx/writers/_html4.py:452 sphinx/writers/html5.py:438
 msgid "Permalink to this code"
 msgstr "本原始碼的永久連結"
 
-#: sphinx/writers/html.py:491 sphinx/writers/html5.py:446
+#: sphinx/writers/_html4.py:454 sphinx/writers/html5.py:440
 msgid "Permalink to this image"
 msgstr "本圖片的永久連結"
 
-#: sphinx/writers/html.py:493 sphinx/writers/html5.py:448
+#: sphinx/writers/_html4.py:456 sphinx/writers/html5.py:442
 msgid "Permalink to this toctree"
 msgstr "本目錄的永久連結"
 
-#: sphinx/writers/html.py:625 sphinx/writers/html5.py:569
+#: sphinx/writers/_html4.py:604 sphinx/writers/html5.py:579
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr "無法取得圖片大小。 :scale: 選項已略過。"
 
-#: sphinx/writers/latex.py:347
+#: sphinx/writers/latex.py:333
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr "未知的 %r toplevel_sectioning 對於 class %r"
 
-#: sphinx/writers/latex.py:398
+#: sphinx/writers/latex.py:384
 msgid "too large :maxdepth:, ignored."
 msgstr ":maxdepth: 太大，已略過。"
 
-#: sphinx/writers/latex.py:644
+#: sphinx/writers/latex.py:623
 msgid "document title is not a single Text node"
 msgstr "文件標題不是單一的 Text 節點"
 
-#: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:626
+#: sphinx/writers/latex.py:654 sphinx/writers/texinfo.py:620
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr "遇到的標題節點不是在段落、主題、表格、警告或側邊欄"
 
-#: sphinx/writers/latex.py:846 sphinx/writers/manpage.py:247
-#: sphinx/writers/texinfo.py:641
+#: sphinx/writers/latex.py:831 sphinx/writers/manpage.py:241
+#: sphinx/writers/texinfo.py:635
 msgid "Footnotes"
 msgstr "註腳"
 
-#: sphinx/writers/latex.py:905
+#: sphinx/writers/latex.py:898
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr "同時被給予 tabularcolumns 及 :widths: 選項。 :widths: 已略過。"
 
-#: sphinx/writers/latex.py:1236
+#: sphinx/writers/latex.py:1247
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr "維度單位 %s 是無效的。已略過。"
 
-#: sphinx/writers/latex.py:1549
+#: sphinx/writers/latex.py:1566
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr "找到了未知的索引條目型別 %s"
 
-#: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803
+#: sphinx/writers/manpage.py:289 sphinx/writers/text.py:794
 #, python-format
 msgid "image: %s"
 msgstr "圖片：%s"
 
-#: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804
+#: sphinx/writers/manpage.py:290 sphinx/writers/text.py:795
 msgid "image"
 msgstr "圖片"
 
-#: sphinx/writers/texinfo.py:1193
+#: sphinx/writers/texinfo.py:1191
 msgid "caption not inside a figure."
 msgstr "標題不在圖之內。"
 
-#: sphinx/writers/texinfo.py:1281
+#: sphinx/writers/texinfo.py:1278
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr "未實作的節點型別： %r"

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/parsers.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/parsers.py Changed

@@ -1,15 +1,8 @@
-"""
-    sphinx.parsers
-    ~~~~~~~~~~~~~~
+"""A Base class for additional parsers."""
 
-    A Base class for additional parsers.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import warnings
-from typing import TYPE_CHECKING, Any, Dict, List, Type, Union
+from typing import TYPE_CHECKING, Any
 
 import docutils.parsers
 import docutils.parsers.rst
@@ -19,7 +12,8 @@
 from docutils.transforms import Transform
 from docutils.transforms.universal import SmartQuotes
 
-from sphinx.deprecation import RemovedInSphinx50Warning
+from sphinx.config import Config
+from sphinx.environment import BuildEnvironment
 from sphinx.util.rst import append_epilog, prepend_prolog
 
 if TYPE_CHECKING:
@@ -32,26 +26,16 @@
     of ``docutils.parsers.Parser``.  Compared with ``docutils.parsers.Parser``, this class
     improves accessibility to Sphinx APIs.
 
-    The subclasses can access the following objects and functions:
-
-    self.app
-        The application object (:class:`sphinx.application.Sphinx`)
-    self.config
-        The config object (:class:`sphinx.config.Config`)
-    self.env
-        The environment object (:class:`sphinx.environment.BuildEnvironment`)
-    self.warn()
-        Emit a warning. (Same as :meth:`sphinx.application.Sphinx.warn()`)
-    self.info()
-        Emit an info message. (Same as :meth:`sphinx.application.Sphinx.info()`)
-
-    .. deprecated:: 1.6
-       ``warn()`` and ``info()`` is deprecated.  Use :mod:`sphinx.util.logging` instead.
-    .. deprecated:: 3.0
-       parser.app is deprecated.
+    The subclasses can access sphinx core runtime objects (app, config and env).
     """
 
-    def set_application(self, app: "Sphinx") -> None:
+    #: The config object
+    config: Config
+
+    #: The environment object
+    env: BuildEnvironment
+
+    def set_application(self, app: Sphinx) -> None:
         """set_application will be called from Sphinx to set app and other instance variables
 
         :param sphinx.application.Sphinx app: Sphinx application object
@@ -60,16 +44,11 @@
         self.config = app.config
         self.env = app.env
 
-    @property
-    def app(self) -> "Sphinx":
-        warnings.warn('parser.app is deprecated.', RemovedInSphinx50Warning, stacklevel=2)
-        return self._app
-
 
 class RSTParser(docutils.parsers.rst.Parser, Parser):
     """A reST parser for Sphinx."""
 
-    def get_transforms(self) -> ListTypeTransform:
+    def get_transforms(self) -> listtypeTransform:
         """
         Sphinx's reST parser replaces a transform class for smart-quotes by its own
 
@@ -79,7 +58,7 @@
         transforms.remove(SmartQuotes)
         return transforms
 
-    def parse(self, inputstring: Unionstr, StringList, document: nodes.document) -> None:
+    def parse(self, inputstring: str | StringList, document: nodes.document) -> None:
         """Parse text and generate a document tree."""
         self.setup_parse(inputstring, document)  # type: ignore
         self.statemachine = states.RSTStateMachine(
@@ -107,7 +86,7 @@
         append_epilog(content, self.config.rst_epilog)
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_source_parser(RSTParser)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/project.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/project.py Changed

@@ -1,21 +1,15 @@
-"""
-    sphinx.project
-    ~~~~~~~~~~~~~~
+"""Utility function and classes for Sphinx projects."""
 
-    Utility function and classes for Sphinx projects.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 from glob import glob
-from typing import Dict, List, Optional, Set
+from typing import Iterable
 
 from sphinx.locale import __
-from sphinx.util import get_matching_files, logging, path_stabilize
-from sphinx.util.matching import compile_matchers
-from sphinx.util.osutil import SEP, relpath
+from sphinx.util import logging
+from sphinx.util.matching import get_matching_files
+from sphinx.util.osutil import SEP, path_stabilize, relpath
 
 logger = logging.getLogger(__name__)
 EXCLUDE_PATHS = '**/_sources', '.#*', '**/.#*', '*.lproj/**'
@@ -24,7 +18,7 @@
 class Project:
     """A project is the source code set of the Sphinx document(s)."""
 
-    def __init__(self, srcdir: str, source_suffix: Dictstr, str) -> None:
+    def __init__(self, srcdir: str, source_suffix: dictstr, str) -> None:
         #: Source directory.
         self.srcdir = srcdir
 
@@ -32,19 +26,23 @@
         self.source_suffix = source_suffix
 
         #: The name of documents belongs to this project.
-        self.docnames: Setstr = set()
+        self.docnames: setstr = set()
 
-    def restore(self, other: "Project") -> None:
+    def restore(self, other: Project) -> None:
         """Take over a result of last build."""
         self.docnames = other.docnames
 
-    def discover(self, exclude_paths: Liststr = ) -> Setstr:
+    def discover(self, exclude_paths: Iterablestr = (),
+                 include_paths: Iterablestr = ("**",)) -> setstr:
         """Find all document files in the source directory and put them in
         :attr:`docnames`.
         """
         self.docnames = set()
-        excludes = compile_matchers(exclude_paths + EXCLUDE_PATHS)
-        for filename in get_matching_files(self.srcdir, excludes):  # type: ignore
+        for filename in get_matching_files(
+            self.srcdir,
+            include_paths,
+            *exclude_paths + EXCLUDE_PATHS,
+        ):
             docname = self.path2doc(filename)
             if docname:
                 if docname in self.docnames:
@@ -60,7 +58,7 @@
 
         return self.docnames
 
-    def path2doc(self, filename: str) -> Optionalstr:
+    def path2doc(self, filename: str) -> str | None:
         """Return the docname for the filename if the file is a document.
 
         *filename* should be absolute or relative to the source directory.

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/pycode/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/pycode/__init__.py Changed

@@ -1,42 +1,32 @@
-"""
-    sphinx.pycode
-    ~~~~~~~~~~~~~
+"""Utilities parsing and analyzing Python code."""
 
-    Utilities parsing and analyzing Python code.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import re
 import tokenize
-import warnings
-from collections import OrderedDict
 from importlib import import_module
-from inspect import Signature
-from io import StringIO
 from os import path
-from typing import IO, Any, Dict, List, Optional, Tuple
-from zipfile import ZipFile
+from typing import TYPE_CHECKING, Any
 
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.errors import PycodeError
 from sphinx.pycode.parser import Parser
 
+if TYPE_CHECKING:
+    from inspect import Signature
+
 
 class ModuleAnalyzer:
-    annotations: DictTuplestr, str, str
-    attr_docs: DictTuplestr, str, Liststr
-    finals: Liststr
-    overloads: Dictstr, ListSignature
-    tagorder: Dictstr, int
-    tags: Dictstr, Tuplestr, int, int
+    annotations: dicttuplestr, str, str
+    attr_docs: dicttuplestr, str, liststr
+    finals: liststr
+    overloads: dictstr, listSignature
+    tagorder: dictstr, int
+    tags: dictstr, tuplestr, int, int
 
     # cache for analyzer objects -- caches both by module and file name
-    cache: DictTuplestr, str, Any = {}
+    cache: dicttuplestr, str, Any = {}
 
     @staticmethod
-    def get_module_source(modname: str) -> TupleOptionalstr, Optionalstr:
+    def get_module_source(modname: str) -> tuplestr | None, str | None:
         """Try to find the source code for a module.
 
         Returns ('filename', 'source'). One of it can be None if
@@ -73,49 +63,31 @@
                 filename += 'w'
         elif not filename.lower().endswith(('.py', '.pyw')):
             raise PycodeError('source is not a .py file: %r' % filename)
-        elif ('.egg' + path.sep) in filename:
-            pat = '(?<=\\.egg)' + re.escape(path.sep)
-            eggpath, _ = re.split(pat, filename, 1)
-            if path.isfile(eggpath):
-                return filename, None
 
         if not path.isfile(filename):
             raise PycodeError('source file is not present: %r' % filename)
         return filename, None
 
     @classmethod
-    def for_string(cls, string: str, modname: str, srcname: str = '<string>'
-                   ) -> "ModuleAnalyzer":
-        return cls(StringIO(string), modname, srcname)
+    def for_string(cls, string: str, modname: str, srcname: str = '<string>',
+                   ) -> ModuleAnalyzer:
+        return cls(string, modname, srcname)
 
     @classmethod
-    def for_file(cls, filename: str, modname: str) -> "ModuleAnalyzer":
+    def for_file(cls, filename: str, modname: str) -> ModuleAnalyzer:
         if ('file', filename) in cls.cache:
             return cls.cache'file', filename
         try:
             with tokenize.open(filename) as f:
-                obj = cls(f, modname, filename)
-                cls.cache'file', filename = obj
+                string = f.read()
+            obj = cls(string, modname, filename)
+            cls.cache'file', filename = obj
         except Exception as err:
-            if '.egg' + path.sep in filename:
-                obj = cls.cache'file', filename = cls.for_egg(filename, modname)
-            else:
-                raise PycodeError('error opening %r' % filename, err) from err
+            raise PycodeError('error opening %r' % filename, err) from err
         return obj
 
     @classmethod
-    def for_egg(cls, filename: str, modname: str) -> "ModuleAnalyzer":
-        SEP = re.escape(path.sep)
-        eggpath, relpath = re.split('(?<=\\.egg)' + SEP, filename)
-        try:
-            with ZipFile(eggpath) as egg:
-                code = egg.read(relpath).decode()
-                return cls.for_string(code, modname, filename)
-        except Exception as exc:
-            raise PycodeError('error opening %r' % filename, exc) from exc
-
-    @classmethod
-    def for_module(cls, modname: str) -> "ModuleAnalyzer":
+    def for_module(cls, modname: str) -> ModuleAnalyzer:
         if ('module', modname) in cls.cache:
             entry = cls.cache'module', modname
             if isinstance(entry, PycodeError):
@@ -134,31 +106,25 @@
         cls.cache'module', modname = obj
         return obj
 
-    def __init__(self, source: IO, modname: str, srcname: str) -> None:
+    def __init__(self, source: str, modname: str, srcname: str) -> None:
         self.modname = modname  # name of the module
         self.srcname = srcname  # name of the source file
 
         # cache the source code as well
-        self.code = source.read()
+        self.code = source
 
         self._analyzed = False
 
-    def parse(self) -> None:
-        """Parse the source code."""
-        warnings.warn('ModuleAnalyzer.parse() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        self.analyze()
-
     def analyze(self) -> None:
         """Analyze the source code."""
         if self._analyzed:
-            return None
+            return
 
         try:
             parser = Parser(self.code)
             parser.parse()
 
-            self.attr_docs = OrderedDict()
+            self.attr_docs = {}
             for (scope, comment) in parser.comments.items():
                 if comment:
                     self.attr_docsscope = comment.splitlines() + ''
@@ -172,14 +138,14 @@
             self.tagorder = parser.deforders
             self._analyzed = True
         except Exception as exc:
-            raise PycodeError('parsing %r failed: %r' % (self.srcname, exc)) from exc
+            raise PycodeError(f'parsing {self.srcname!r} failed: {exc!r}') from exc
 
-    def find_attr_docs(self) -> DictTuplestr, str, Liststr:
+    def find_attr_docs(self) -> dicttuplestr, str, liststr:
         """Find class and module-level attributes and their documentation."""
         self.analyze()
         return self.attr_docs
 
-    def find_tags(self) -> Dictstr, Tuplestr, int, int:
+    def find_tags(self) -> dictstr, tuplestr, int, int:
         """Find class, function and method definitions and their location."""
         self.analyze()
         return self.tags

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/pycode/ast.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/pycode/ast.py Changed

@@ -1,27 +1,11 @@
-"""
-    sphinx.pycode.ast
-    ~~~~~~~~~~~~~~~~~
+"""Helpers for AST (Abstract Syntax Tree)."""
 
-    Helpers for AST (Abstract Syntax Tree).
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+import ast
+from typing import overload
 
-import sys
-from typing import Dict, List, Optional, Type, overload
-
-if sys.version_info > (3, 8):
-    import ast
-else:
-    try:
-        # use typed_ast module if installed
-        from typed_ast import ast3 as ast
-    except ImportError:
-        import ast  # type: ignore
-
-
-OPERATORS: DictTypeast.AST, str = {
+OPERATORS: dicttypeast.AST, str = {
     ast.Add: "+",
     ast.And: "and",
     ast.BitAnd: "&",
@@ -44,24 +28,6 @@
 }
 
 
-def parse(code: str, mode: str = 'exec') -> "ast.AST":
-    """Parse the *code* using the built-in ast or typed_ast libraries.
-
-    This enables "type_comments" feature if possible.
-    """
-    try:
-        # type_comments parameter is available on py38+
-        return ast.parse(code, mode=mode, type_comments=True)  # type: ignore
-    except SyntaxError:
-        # Some syntax error found. To ignore invalid type comments, retry parsing without
-        # type_comments parameter (refs: https://github.com/sphinx-doc/sphinx/issues/8652).
-        return ast.parse(code, mode=mode)
-    except TypeError:
-        # fallback to ast module.
-        # typed_ast is used to parse type_comments if installed.
-        return ast.parse(code, mode=mode)
-
-
 @overload
 def unparse(node: None, code: str = '') -> None:
     ...
@@ -72,7 +38,7 @@
     ...
 
 
-def unparse(node: Optionalast.AST, code: str = '') -> Optionalstr:
+def unparse(node: ast.AST | None, code: str = '') -> str | None:
     """Unparse an AST to string."""
     if node is None:
         return None
@@ -89,15 +55,15 @@
     def _visit_op(self, node: ast.AST) -> str:
         return OPERATORSnode.__class__
     for _op in OPERATORS:
-        locals()'visit_{}'.format(_op.__name__) = _visit_op
+        locals()f'visit_{_op.__name__}' = _visit_op
 
     def visit_arg(self, node: ast.arg) -> str:
         if node.annotation:
-            return "%s: %s" % (node.arg, self.visit(node.annotation))
+            return f"{node.arg}: {self.visit(node.annotation)}"
         else:
             return node.arg
 
-    def _visit_arg_with_default(self, arg: ast.arg, default: Optionalast.AST) -> str:
+    def _visit_arg_with_default(self, arg: ast.arg, default: ast.AST | None) -> str:
         """Unparse a single argument to a string."""
         name = self.visit(arg)
         if default:
@@ -108,26 +74,23 @@
         return name
 
     def visit_arguments(self, node: ast.arguments) -> str:
-        defaults: ListOptionalast.expr = list(node.defaults)
+        defaults: listast.expr | None = list(node.defaults)
         positionals = len(node.args)
-        posonlyargs = 0
-        if hasattr(node, "posonlyargs"):  # for py38+
-            posonlyargs += len(node.posonlyargs)  # type:ignore
-            positionals += posonlyargs
+        posonlyargs = len(node.posonlyargs)
+        positionals += posonlyargs
         for _ in range(len(defaults), positionals):
             defaults.insert(0, None)
 
-        kw_defaults: ListOptionalast.expr = list(node.kw_defaults)
+        kw_defaults: listast.expr | None = list(node.kw_defaults)
         for _ in range(len(kw_defaults), len(node.kwonlyargs)):
             kw_defaults.insert(0, None)
 
-        args: Liststr = 
-        if hasattr(node, "posonlyargs"):  # for py38+
-            for i, arg in enumerate(node.posonlyargs):  # type: ignore
-                args.append(self._visit_arg_with_default(arg, defaultsi))
+        args: liststr = 
+        for i, arg in enumerate(node.posonlyargs):
+            args.append(self._visit_arg_with_default(arg, defaultsi))
 
-            if node.posonlyargs:  # type: ignore
-                args.append('/')
+        if node.posonlyargs:
+            args.append('/')
 
         for i, arg in enumerate(node.args):
             args.append(self._visit_arg_with_default(arg, defaultsi + posonlyargs))
@@ -146,9 +109,12 @@
         return ", ".join(args)
 
     def visit_Attribute(self, node: ast.Attribute) -> str:
-        return "%s.%s" % (self.visit(node.value), node.attr)
+        return f"{self.visit(node.value)}.{node.attr}"
 
     def visit_BinOp(self, node: ast.BinOp) -> str:
+        # Special case ``**`` to not have surrounding spaces.
+        if isinstance(node.op, ast.Pow):
+            return "".join(map(self.visit, (node.left, node.op, node.right)))
         return " ".join(self.visit(e) for e in node.left, node.op, node.right)
 
     def visit_BoolOp(self, node: ast.BoolOp) -> str:
@@ -156,23 +122,23 @@
         return op.join(self.visit(e) for e in node.values)
 
     def visit_Call(self, node: ast.Call) -> str:
-        args = (self.visit(e) for e in node.args +
-                "%s=%s" % (k.arg, self.visit(k.value)) for k in node.keywords)
-        return "%s(%s)" % (self.visit(node.func), ", ".join(args))
+        args = ', '.join(self.visit(e) for e in node.args
+                         + f"{k.arg}={self.visit(k.value)}" for k in node.keywords)
+        return f"{self.visit(node.func)}({args})"
 
-    def visit_Constant(self, node: ast.Constant) -> str:  # type: ignore
+    def visit_Constant(self, node: ast.Constant) -> str:
         if node.value is Ellipsis:
             return "..."
         elif isinstance(node.value, (int, float, complex)):
-            if self.code and sys.version_info > (3, 8):
-                return ast.get_source_segment(self.code, node)  # type: ignore
+            if self.code:
+                return ast.get_source_segment(self.code, node) or repr(node.value)
             else:
                 return repr(node.value)
         else:
             return repr(node.value)
 
     def visit_Dict(self, node: ast.Dict) -> str:
-        keys = (self.visit(k) for k in node.keys)
+        keys = (self.visit(k) for k in node.keys if k is not None)
         values = (self.visit(v) for v in node.values)
         items = (k + ": " + v for k, v in zip(keys, values))
         return "{" + ", ".join(items) + "}"
@@ -202,15 +168,19 @@
 
         if is_simple_tuple(node.slice):
             elts = ", ".join(self.visit(e) for e in node.slice.elts)  # type: ignore
-            return "%s%s" % (self.visit(node.value), elts)
+            return f"{self.visit(node.value)}{elts}"
         elif isinstance(node.slice, ast.Index) and is_simple_tuple(node.slice.value):
             elts = ", ".join(self.visit(e) for e in node.slice.value.elts)  # type: ignore
-            return "%s%s" % (self.visit(node.value), elts)
+            return f"{self.visit(node.value)}{elts}"
         else:
-            return "%s%s" % (self.visit(node.value), self.visit(node.slice))
+            return f"{self.visit(node.value)}{self.visit(node.slice)}"
 
     def visit_UnaryOp(self, node: ast.UnaryOp) -> str:
-        return "%s %s" % (self.visit(node.op), self.visit(node.operand))
+        # UnaryOp is one of {UAdd, USub, Invert, Not}, which refer to ``+x``,
+        # ``-x``, ``~x``, and ``not x``. Only Not needs a space.
+        if isinstance(node.op, ast.Not):
+            return f"{self.visit(node.op)} {self.visit(node.operand)}"
+        return f"{self.visit(node.op)}{self.visit(node.operand)}"
 
     def visit_Tuple(self, node: ast.Tuple) -> str:
         if len(node.elts) == 0:
@@ -220,22 +190,5 @@
         else:
             return "(" + ", ".join(self.visit(e) for e in node.elts) + ")"
 
-    if sys.version_info < (3, 8):
-        # these ast nodes were deprecated in python 3.8
-        def visit_Bytes(self, node: ast.Bytes) -> str:
-            return repr(node.s)
-
-        def visit_Ellipsis(self, node: ast.Ellipsis) -> str:
-            return "..."
-
-        def visit_NameConstant(self, node: ast.NameConstant) -> str:
-            return repr(node.value)
-
-        def visit_Num(self, node: ast.Num) -> str:
-            return repr(node.n)
-
-        def visit_Str(self, node: ast.Str) -> str:
-            return repr(node.s)
-
     def generic_visit(self, node):
         raise NotImplementedError('Unable to parse %s object' % type(node).__name__)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/pycode/parser.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/pycode/parser.py Changed

@@ -1,24 +1,18 @@
-"""
-    sphinx.pycode.parser
-    ~~~~~~~~~~~~~~~~~~~~
+"""Utilities parsing and analyzing Python code."""
 
-    Utilities parsing and analyzing Python code.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+import ast
 import inspect
 import itertools
 import re
 import tokenize
-from collections import OrderedDict
 from inspect import Signature
 from token import DEDENT, INDENT, NAME, NEWLINE, NUMBER, OP, STRING
 from tokenize import COMMENT, NL
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
-from sphinx.pycode.ast import ast  # for py37 or older
-from sphinx.pycode.ast import parse, unparse
+from sphinx.pycode.ast import unparse as ast_unparse
 
 comment_re = re.compile('^\\s*#: ?(.*)\r?\n?$')
 indent_re = re.compile('^\\s*$')
@@ -29,7 +23,7 @@
     return code.replace('\f', ' ')  # replace FF (form feed) with whitespace
 
 
-def get_assign_targets(node: ast.AST) -> Listast.expr:
+def get_assign_targets(node: ast.AST) -> listast.expr:
     """Get list of targets from Assign and AnnAssign node."""
     if isinstance(node, ast.Assign):
         return node.targets
@@ -37,7 +31,7 @@
         return node.target  # type: ignore
 
 
-def get_lvar_names(node: ast.AST, self: ast.arg = None) -> Liststr:
+def get_lvar_names(node: ast.AST, self: ast.arg | None = None) -> liststr:
     """Convert assignment-AST to variable names.
 
     This raises `TypeError` if the assignment does not create new variable::
@@ -52,7 +46,7 @@
     node_name = node.__class__.__name__
     if node_name in ('Index', 'Num', 'Slice', 'Str', 'Subscript'):
         raise TypeError('%r does not create new variable' % node)
-    elif node_name == 'Name':
+    if node_name == 'Name':
         if self is None or node.id == self_id:  # type: ignore
             return node.id  # type: ignore
         else:
@@ -66,7 +60,10 @@
                 pass
         return members
     elif node_name == 'Attribute':
-        if node.value.__class__.__name__ == 'Name' and self and node.value.id == self_id:  # type: ignore  # NOQA
+        if (
+            node.value.__class__.__name__ == 'Name' and  # type: ignoreattr-defined
+            self and node.value.id == self_id  # type: ignoreattr-defined
+        ):
             # instance variable
             return "%s" % get_lvar_names(node.attr, self)0  # type: ignore
         else:
@@ -96,7 +93,7 @@
 class Token:
     """Better token wrapper for tokenize module."""
 
-    def __init__(self, kind: int, value: Any, start: Tupleint, int, end: Tupleint, int,
+    def __init__(self, kind: int, value: Any, start: tupleint, int, end: tupleint, int,
                  source: str) -> None:
         self.kind = kind
         self.value = value
@@ -120,23 +117,22 @@
         return any(self == candidate for candidate in conditions)
 
     def __repr__(self) -> str:
-        return '<Token kind=%r value=%r>' % (tokenize.tok_nameself.kind,
-                                             self.value.strip())
+        return f'<Token kind={tokenize.tok_nameself.kind!r} value={self.value.strip()!r}>'
 
 
 class TokenProcessor:
-    def __init__(self, buffers: Liststr) -> None:
+    def __init__(self, buffers: liststr) -> None:
         lines = iter(buffers)
         self.buffers = buffers
         self.tokens = tokenize.generate_tokens(lambda: next(lines))
-        self.current: OptionalToken = None
-        self.previous: OptionalToken = None
+        self.current: Token | None = None
+        self.previous: Token | None = None
 
     def get_line(self, lineno: int) -> str:
         """Returns specified line."""
         return self.bufferslineno - 1
 
-    def fetch_token(self) -> Token:
+    def fetch_token(self) -> Token | None:
         """Fetch the next token from source code.
 
         Returns ``None`` if sequence finished.
@@ -149,7 +145,7 @@
 
         return self.current
 
-    def fetch_until(self, condition: Any) -> ListToken:
+    def fetch_until(self, condition: Any) -> listToken:
         """Fetch tokens until specified token appeared.
 
         .. note:: This also handles parenthesis well.
@@ -159,7 +155,7 @@
             tokens.append(self.current)
             if self.current == condition:
                 break
-            elif self.current == OP, '(':
+            if self.current == OP, '(':
                 tokens += self.fetch_until(OP, ')')
             elif self.current == OP, '{':
                 tokens += self.fetch_until(OP, '}')
@@ -176,11 +172,11 @@
     and returns the comment for the variable if one exists.
     """
 
-    def __init__(self, lines: Liststr) -> None:
+    def __init__(self, lines: liststr) -> None:
         super().__init__(lines)
-        self.comment: Optionalstr = None
+        self.comment: str | None = None
 
-    def fetch_rvalue(self) -> ListToken:
+    def fetch_rvalue(self) -> listToken:
         """Fetch right-hand value of assignment."""
         tokens = 
         while self.fetch_token():
@@ -193,7 +189,7 @@
                 tokens += self.fetch_until(OP, '')
             elif self.current == INDENT:
                 tokens += self.fetch_until(DEDENT)
-            elif self.current == OP, ';':
+            elif self.current == OP, ';':  # NoQA: SIM114
                 break
             elif self.current.kind not in (OP, NAME, NUMBER, STRING):
                 break
@@ -217,25 +213,25 @@
 class VariableCommentPicker(ast.NodeVisitor):
     """Python source code parser to pick up variable comments."""
 
-    def __init__(self, buffers: Liststr, encoding: str) -> None:
+    def __init__(self, buffers: liststr, encoding: str) -> None:
         self.counter = itertools.count()
         self.buffers = buffers
         self.encoding = encoding
-        self.context: Liststr = 
-        self.current_classes: Liststr = 
-        self.current_function: Optionalast.FunctionDef = None
-        self.comments: DictTuplestr, str, str = OrderedDict()
-        self.annotations: DictTuplestr, str, str = {}
-        self.previous: Optionalast.AST = None
-        self.deforders: Dictstr, int = {}
-        self.finals: Liststr = 
-        self.overloads: Dictstr, ListSignature = {}
-        self.typing: Optionalstr = None
-        self.typing_final: Optionalstr = None
-        self.typing_overload: Optionalstr = None
+        self.context: liststr = 
+        self.current_classes: liststr = 
+        self.current_function: ast.FunctionDef | None = None
+        self.comments: dicttuplestr, str, str = {}
+        self.annotations: dicttuplestr, str, str = {}
+        self.previous: ast.AST | None = None
+        self.deforders: dictstr, int = {}
+        self.finals: liststr = 
+        self.overloads: dictstr, listSignature = {}
+        self.typing: str | None = None
+        self.typing_final: str | None = None
+        self.typing_overload: str | None = None
         super().__init__()
 
-    def get_qualname_for(self, name: str) -> OptionalListstr:
+    def get_qualname_for(self, name: str) -> liststr | None:
         """Get qualified name for given object as a list of string(s)."""
         if self.current_function:
             if self.current_classes and self.context-1 == "__init__":
@@ -274,9 +270,9 @@
         qualname = self.get_qualname_for(name)
         if qualname:
             basename = ".".join(qualname:-1)
-            self.annotations(basename, name) = unparse(annotation)
+            self.annotations(basename, name) = ast_unparse(annotation)
 
-    def is_final(self, decorators: Listast.expr) -> bool:
+    def is_final(self, decorators: listast.expr) -> bool:
         final = 
         if self.typing:
             final.append('%s.final' % self.typing)
@@ -285,14 +281,14 @@
 
         for decorator in decorators:
             try:
-                if unparse(decorator) in final:
+                if ast_unparse(decorator) in final:
                     return True
             except NotImplementedError:
                 pass
 
         return False
 
-    def is_overload(self, decorators: Listast.expr) -> bool:
+    def is_overload(self, decorators: listast.expr) -> bool:
         overload = 
         if self.typing:
             overload.append('%s.overload' % self.typing)
@@ -301,23 +297,20 @@
 
         for decorator in decorators:
             try:
-                if unparse(decorator) in overload:
+                if ast_unparse(decorator) in overload:
                     return True
             except NotImplementedError:
                 pass
 
         return False
 
-    def get_self(self) -> Optionalast.arg:
+    def get_self(self) -> ast.arg | None:
         """Returns the name of the first argument if in a function."""
         if self.current_function and self.current_function.args.args:
             return self.current_function.args.args0
-        elif (self.current_function and
-              getattr(self.current_function.args, 'posonlyargs', None)):
-            # for py38+
-            return self.current_function.args.posonlyargs0  # type: ignore
-        else:
-            return None
+        if self.current_function and self.current_function.args.posonlyargs:
+            return self.current_function.args.posonlyargs0
+        return None
 
     def get_line(self, lineno: int) -> str:
         """Returns specified line."""
@@ -354,15 +347,17 @@
         """Handles Assign node and pick up a variable comment."""
         try:
             targets = get_assign_targets(node)
-            varnames: Liststr = sum(get_lvar_names(t, self=self.get_self()) for t in targets, )  # NOQA
+            varnames: liststr = sum(
+                get_lvar_names(t, self=self.get_self()) for t in targets, ,
+            )
             current_line = self.get_line(node.lineno)
         except TypeError:
             return  # this assignment is not new definition!
 
         # record annotation
-        if hasattr(node, 'annotation') and node.annotation:  # type: ignore
+        if hasattr(node, 'annotation') and node.annotation:
             for varname in varnames:
-                self.add_variable_annotation(varname, node.annotation)  # type: ignore
+                self.add_variable_annotation(varname, node.annotation)
         elif hasattr(node, 'type_comment') and node.type_comment:
             for varname in varnames:
                 self.add_variable_annotation(varname, node.type_comment)  # type: ignore
@@ -468,14 +463,14 @@
     classes and methods.
     """
 
-    def __init__(self, lines: Liststr) -> None:
+    def __init__(self, lines: liststr) -> None:
         super().__init__(lines)
-        self.decorator: OptionalToken = None
-        self.context: Liststr = 
-        self.indents: List = 
-        self.definitions: Dictstr, Tuplestr, int, int = {}
+        self.decorator: Token | None = None
+        self.context: liststr = 
+        self.indents: listtuplestr, str | None, int | None = 
+        self.definitions: dictstr, tuplestr, int, int = {}
 
-    def add_definition(self, name: str, entry: Tuplestr, int, int) -> None:
+    def add_definition(self, name: str, entry: tuplestr, int, int) -> None:
         """Add a location of definition."""
         if self.indents and self.indents-10 == 'def' and entry0 == 'def':
             # ignore definition of inner function
@@ -489,7 +484,7 @@
             token = self.fetch_token()
             if token is None:
                 break
-            elif token == COMMENT:
+            if token == COMMENT:
                 pass
             elif token == OP, '@' and (self.previous is None or
                                          self.previous.match(NEWLINE, NL, INDENT, DEDENT)):
@@ -547,12 +542,12 @@
     def __init__(self, code: str, encoding: str = 'utf-8') -> None:
         self.code = filter_whitespace(code)
         self.encoding = encoding
-        self.annotations: DictTuplestr, str, str = {}
-        self.comments: DictTuplestr, str, str = {}
-        self.deforders: Dictstr, int = {}
-        self.definitions: Dictstr, Tuplestr, int, int = {}
-        self.finals: Liststr = 
-        self.overloads: Dictstr, ListSignature = {}
+        self.annotations: dicttuplestr, str, str = {}
+        self.comments: dicttuplestr, str, str = {}
+        self.deforders: dictstr, int = {}
+        self.definitions: dictstr, tuplestr, int, int = {}
+        self.finals: liststr = 
+        self.overloads: dictstr, listSignature = {}
 
     def parse(self) -> None:
         """Parse the source code."""
@@ -561,7 +556,7 @@
 
     def parse_comments(self) -> None:
         """Parse the code and pick up comments."""
-        tree = parse(self.code)
+        tree = ast.parse(self.code, type_comments=True)
         picker = VariableCommentPicker(self.code.splitlines(True), self.encoding)
         picker.visit(tree)
         self.annotations = picker.annotations

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/pygments_styles.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/pygments_styles.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/registry.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/registry.py Changed

@@ -1,40 +1,33 @@
-"""
-    sphinx.registry
-    ~~~~~~~~~~~~~~~
+"""Sphinx component registry."""
 
-    Sphinx component registry.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import sys
 import traceback
-import warnings
 from importlib import import_module
 from types import MethodType
-from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Optional, Tuple, Type,
-                    Union)
+from typing import TYPE_CHECKING, Any, Callable, Iterator
 
 from docutils import nodes
-from docutils.io import Input
+from docutils.core import Publisher
 from docutils.nodes import Element, Node, TextElement
 from docutils.parsers import Parser
 from docutils.parsers.rst import Directive
 from docutils.transforms import Transform
 
-try:  # Python < 3.10 (backport)
-    from importlib_metadata import entry_points
-except ImportError:
+if sys.version_info >= (3, 10):
     from importlib.metadata import entry_points
+else:
+    from importlib_metadata import entry_points
 
 from sphinx.builders import Builder
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.domains import Domain, Index, ObjType
 from sphinx.domains.std import GenericObject, Target
 from sphinx.environment import BuildEnvironment
 from sphinx.errors import ExtensionError, SphinxError, VersionRequirementError
 from sphinx.extension import Extension
+from sphinx.io import create_publisher
 from sphinx.locale import __
 from sphinx.parsers import Parser as SphinxParser
 from sphinx.roles import XRefRole
@@ -51,89 +44,89 @@
 # list of deprecated extensions. Keys are extension name.
 # Values are Sphinx version that merge the extension.
 EXTENSION_BLACKLIST = {
-    "sphinxjp.themecore": "1.2"
+    "sphinxjp.themecore": "1.2",
 }
 
 
 class SphinxComponentRegistry:
     def __init__(self) -> None:
         #: special attrgetter for autodoc; class object -> attrgetter
-        self.autodoc_attrgettrs: DictType, CallableAny, str, Any, Any = {}
+        self.autodoc_attrgettrs: dicttype, CallableAny, str, Any, Any = {}
 
         #: builders; a dict of builder name -> bulider class
-        self.builders: Dictstr, TypeBuilder = {}
+        self.builders: dictstr, typeBuilder = {}
 
         #: autodoc documenters; a dict of documenter name -> documenter class
-        self.documenters: Dictstr, TypeDocumenter = {}
+        self.documenters: dictstr, typeDocumenter = {}
 
         #: css_files; a list of tuple of filename and attributes
-        self.css_files: ListTuplestr, Dictstr, Any = 
+        self.css_files: listtuplestr, dictstr, Any = 
 
         #: domains; a dict of domain name -> domain class
-        self.domains: Dictstr, TypeDomain = {}
+        self.domains: dictstr, typeDomain = {}
 
         #: additional directives for domains
         #: a dict of domain name -> dict of directive name -> directive
-        self.domain_directives: Dictstr, Dictstr, Any = {}
+        self.domain_directives: dictstr, dictstr, typeDirective = {}
 
         #: additional indices for domains
         #: a dict of domain name -> list of index class
-        self.domain_indices: Dictstr, ListTypeIndex = {}
+        self.domain_indices: dictstr, listtypeIndex = {}
 
         #: additional object types for domains
         #: a dict of domain name -> dict of objtype name -> objtype
-        self.domain_object_types: Dictstr, Dictstr, ObjType = {}
+        self.domain_object_types: dictstr, dictstr, ObjType = {}
 
         #: additional roles for domains
         #: a dict of domain name -> dict of role name -> role impl.
-        self.domain_roles: Dictstr, Dictstr, UnionRoleFunction, XRefRole = {}
+        self.domain_roles: dictstr, dictstr, RoleFunction | XRefRole = {}
 
         #: additional enumerable nodes
         #: a dict of node class -> tuple of figtype and title_getter function
-        self.enumerable_nodes: DictTypeNode, Tuplestr, TitleGetter = {}
+        self.enumerable_nodes: dicttypeNode, tuplestr, TitleGetter = {}
 
         #: HTML inline and block math renderers
         #: a dict of name -> tuple of visit function and depart function
-        self.html_inline_math_renderers: Dictstr, TupleCallable, Callable = {}
-        self.html_block_math_renderers: Dictstr, TupleCallable, Callable = {}
+        self.html_inline_math_renderers: dictstr, tupleCallable, Callable = {}
+        self.html_block_math_renderers: dictstr, tupleCallable, Callable = {}
 
         #: HTML assets
         self.html_assets_policy: str = 'per_page'
 
         #: HTML themes
-        self.html_themes: Dictstr, str = {}
+        self.html_themes: dictstr, str = {}
 
         #: js_files; list of JS paths or URLs
-        self.js_files: ListTuplestr, Dictstr, Any = 
+        self.js_files: listtuplestr, dictstr, Any = 
 
         #: LaTeX packages; list of package names and its options
-        self.latex_packages: ListTuplestr, str = 
+        self.latex_packages: listtuplestr, str = 
 
-        self.latex_packages_after_hyperref: ListTuplestr, str = 
+        self.latex_packages_after_hyperref: listtuplestr, str = 
 
         #: post transforms; list of transforms
-        self.post_transforms: ListTypeTransform = 
+        self.post_transforms: listtypeTransform = 
 
         #: source paresrs; file type -> parser class
-        self.source_parsers: Dictstr, TypeParser = {}
-
-        #: source inputs; file type -> input class
-        self.source_inputs: Dictstr, TypeInput = {}
+        self.source_parsers: dictstr, typeParser = {}
 
         #: source suffix: suffix -> file type
-        self.source_suffix: Dictstr, str = {}
+        self.source_suffix: dictstr, str = {}
 
         #: custom translators; builder name -> translator class
-        self.translators: Dictstr, Typenodes.NodeVisitor = {}
+        self.translators: dictstr, typenodes.NodeVisitor = {}
 
         #: custom handlers for translators
         #: a dict of builder name -> dict of node name -> visitor and departure functions
-        self.translation_handlers: Dictstr, Dictstr, TupleCallable, Callable = {}
+        self.translation_handlers: dictstr, dictstr, tupleCallable, Callable = {}
 
         #: additional transforms; list of transforms
-        self.transforms: ListTypeTransform = 
+        self.transforms: listtypeTransform = 
 
-    def add_builder(self, builder: TypeBuilder, override: bool = False) -> None:
+        # private cache of Docutils Publishers (file type -> publisher object)
+        self.publishers: dictstr, Publisher = {}
+
+    def add_builder(self, builder: typeBuilder, override: bool = False) -> None:
         logger.debug('app adding builder: %r', builder)
         if not hasattr(builder, 'name'):
             raise ExtensionError(__('Builder class %s has no "name" attribute') % builder)
@@ -142,7 +135,7 @@
                                  (builder.name, self.buildersbuilder.name.__module__))
         self.buildersbuilder.name = builder
 
-    def preload_builder(self, app: "Sphinx", name: str) -> None:
+    def preload_builder(self, app: Sphinx, name: str) -> None:
         if name is None:
             return
 
@@ -156,13 +149,14 @@
 
             self.load_extension(app, entry_point.module)
 
-    def create_builder(self, app: "Sphinx", name: str) -> Builder:
+    def create_builder(self, app: Sphinx, name: str,
+                       env: BuildEnvironment | None = None) -> Builder:
         if name not in self.builders:
             raise SphinxError(__('Builder name %s not registered') % name)
 
-        return self.buildersname(app)
+        return self.buildersname(app, env)
 
-    def add_domain(self, domain: TypeDomain, override: bool = False) -> None:
+    def add_domain(self, domain: typeDomain, override: bool = False) -> None:
         logger.debug('app adding domain: %r', domain)
         if domain.name in self.domains and not override:
             raise ExtensionError(__('domain %s already registered') % domain.name)
@@ -185,19 +179,19 @@
             yield domain
 
     def add_directive_to_domain(self, domain: str, name: str,
-                                cls: TypeDirective, override: bool = False) -> None:
+                                cls: typeDirective, override: bool = False) -> None:
         logger.debug('app adding directive to domain: %r', (domain, name, cls))
         if domain not in self.domains:
             raise ExtensionError(__('domain %s not yet registered') % domain)
 
-        directives = self.domain_directives.setdefault(domain, {})
+        directives: dictstr, typeDirective = self.domain_directives.setdefault(domain, {})
         if name in directives and not override:
             raise ExtensionError(__('The %r directive is already registered to domain %s') %
                                  (name, domain))
         directivesname = cls
 
     def add_role_to_domain(self, domain: str, name: str,
-                           role: UnionRoleFunction, XRefRole, override: bool = False
+                           role: RoleFunction | XRefRole, override: bool = False,
                            ) -> None:
         logger.debug('app adding role to domain: %r', (domain, name, role))
         if domain not in self.domains:
@@ -208,7 +202,7 @@
                                  (name, domain))
         rolesname = role
 
-    def add_index_to_domain(self, domain: str, index: TypeIndex,
+    def add_index_to_domain(self, domain: str, index: typeIndex,
                             override: bool = False) -> None:
         logger.debug('app adding index to domain: %r', (domain, index))
         if domain not in self.domains:
@@ -219,10 +213,17 @@
                                  (index.name, domain))
         indices.append(index)
 
-    def add_object_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                        parse_node: Callable = None, ref_nodeclass: TypeTextElement = None,
-                        objname: str = '', doc_field_types: List = , override: bool = False
-                        ) -> None:
+    def add_object_type(
+        self,
+        directivename: str,
+        rolename: str,
+        indextemplate: str = '',
+        parse_node: Callable | None = None,
+        ref_nodeclass: typeTextElement | None = None,
+        objname: str = '',
+        doc_field_types: list = ,
+        override: bool = False,
+    ) -> None:
         logger.debug('app adding object type: %r',
                      (directivename, rolename, indextemplate, parse_node,
                       ref_nodeclass, objname, doc_field_types))
@@ -243,9 +244,15 @@
                                  directivename)
         object_typesdirectivename = ObjType(objname or directivename, rolename)
 
-    def add_crossref_type(self, directivename: str, rolename: str, indextemplate: str = '',
-                          ref_nodeclass: TypeTextElement = None, objname: str = '',
-                          override: bool = False) -> None:
+    def add_crossref_type(
+        self,
+        directivename: str,
+        rolename: str,
+        indextemplate: str = '',
+        ref_nodeclass: typeTextElement | None = None,
+        objname: str = '',
+        override: bool = False,
+    ) -> None:
         logger.debug('app adding crossref type: %r',
                      (directivename, rolename, indextemplate, ref_nodeclass, objname))
 
@@ -267,10 +274,9 @@
         logger.debug('app adding source_suffix: %r, %r', suffix, filetype)
         if suffix in self.source_suffix and not override:
             raise ExtensionError(__('source_suffix %r is already registered') % suffix)
-        else:
-            self.source_suffixsuffix = filetype
+        self.source_suffixsuffix = filetype
 
-    def add_source_parser(self, parser: TypeParser, override: bool = False) -> None:
+    def add_source_parser(self, parser: typeParser, override: bool = False) -> None:
         logger.debug('app adding search source_parser: %r', parser)
 
         # create a map from filetype to parser
@@ -278,47 +284,33 @@
             if filetype in self.source_parsers and not override:
                 raise ExtensionError(__('source_parser for %r is already registered') %
                                      filetype)
-            else:
-                self.source_parsersfiletype = parser
+            self.source_parsersfiletype = parser
 
-    def get_source_parser(self, filetype: str) -> TypeParser:
+    def get_source_parser(self, filetype: str) -> typeParser:
         try:
             return self.source_parsersfiletype
         except KeyError as exc:
             raise SphinxError(__('Source parser for %s not registered') % filetype) from exc
 
-    def get_source_parsers(self) -> Dictstr, TypeParser:
+    def get_source_parsers(self) -> dictstr, typeParser:
         return self.source_parsers
 
-    def create_source_parser(self, app: "Sphinx", filename: str) -> Parser:
+    def create_source_parser(self, app: Sphinx, filename: str) -> Parser:
         parser_class = self.get_source_parser(filename)
         parser = parser_class()
         if isinstance(parser, SphinxParser):
             parser.set_application(app)
         return parser
 
-    def get_source_input(self, filetype: str) -> OptionalTypeInput:
-        warnings.warn('SphinxComponentRegistry.get_source_input() is deprecated.',
-                      RemovedInSphinx60Warning)
-
-        try:
-            return self.source_inputsfiletype
-        except KeyError:
-            try:
-                # use special source_input for unknown filetype
-                return self.source_inputs'*'
-            except KeyError:
-                return None
-
-    def add_translator(self, name: str, translator: Typenodes.NodeVisitor,
+    def add_translator(self, name: str, translator: typenodes.NodeVisitor,
                        override: bool = False) -> None:
         logger.debug('app Change of translator for the %s builder.', name)
         if name in self.translators and not override:
             raise ExtensionError(__('Translator for %r already exists') % name)
         self.translatorsname = translator
 
-    def add_translation_handlers(self, node: TypeElement,
-                                 **kwargs: TupleCallable, Callable) -> None:
+    def add_translation_handlers(self, node: typeElement,
+                                 **kwargs: tupleCallable, Callable) -> None:
         logger.debug('app adding translation_handlers: %r, %r', node, kwargs)
         for builder_name, handlers in kwargs.items():
             translation_handlers = self.translation_handlers.setdefault(builder_name, {})
@@ -328,10 +320,10 @@
             except ValueError as exc:
                 raise ExtensionError(
                     __('kwargs for add_node() must be a (visit, depart) '
-                       'function tuple: %r=%r') % (builder_name, handlers)
+                       'function tuple: %r=%r') % (builder_name, handlers),
                 ) from exc
 
-    def get_translator_class(self, builder: Builder) -> Typenodes.NodeVisitor:
+    def get_translator_class(self, builder: Builder) -> typenodes.NodeVisitor:
         return self.translators.get(builder.name,
                                     builder.default_translator_class)
 
@@ -353,24 +345,24 @@
 
         return translator
 
-    def add_transform(self, transform: TypeTransform) -> None:
+    def add_transform(self, transform: typeTransform) -> None:
         logger.debug('app adding transform: %r', transform)
         self.transforms.append(transform)
 
-    def get_transforms(self) -> ListTypeTransform:
+    def get_transforms(self) -> listtypeTransform:
         return self.transforms
 
-    def add_post_transform(self, transform: TypeTransform) -> None:
+    def add_post_transform(self, transform: typeTransform) -> None:
         logger.debug('app adding post transform: %r', transform)
         self.post_transforms.append(transform)
 
-    def get_post_transforms(self) -> ListTypeTransform:
+    def get_post_transforms(self) -> listtypeTransform:
         return self.post_transforms
 
-    def add_documenter(self, objtype: str, documenter: Type"Documenter") -> None:
+    def add_documenter(self, objtype: str, documenter: typeDocumenter) -> None:
         self.documentersobjtype = documenter
 
-    def add_autodoc_attrgetter(self, typ: Type,
+    def add_autodoc_attrgetter(self, typ: type,
                                attrgetter: CallableAny, str, Any, Any) -> None:
         self.autodoc_attrgettrstyp = attrgetter
 
@@ -387,7 +379,7 @@
 
     def add_latex_package(self, name: str, options: str, after_hyperref: bool = False) -> None:
         if self.has_latex_package(name):
-            logger.warn("latex package '%s' already included" % name)
+            logger.warning("latex package '%s' already included", name)
 
         logger.debug('app adding latex package: %r', name)
         if after_hyperref:
@@ -395,16 +387,20 @@
         else:
             self.latex_packages.append((name, options))
 
-    def add_enumerable_node(self, node: TypeNode, figtype: str,
-                            title_getter: TitleGetter = None, override: bool = False) -> None:
+    def add_enumerable_node(
+        self,
+        node: typeNode,
+        figtype: str,
+        title_getter: TitleGetter | None = None, override: bool = False,
+    ) -> None:
         logger.debug('app adding enumerable node: (%r, %r, %r)', node, figtype, title_getter)
         if node in self.enumerable_nodes and not override:
             raise ExtensionError(__('enumerable_node %r already registered') % node)
         self.enumerable_nodesnode = (figtype, title_getter)
 
     def add_html_math_renderer(self, name: str,
-                               inline_renderers: TupleCallable, Callable,
-                               block_renderers: TupleCallable, Callable) -> None:
+                               inline_renderers: tupleCallable, Callable,
+                               block_renderers: tupleCallable, Callable) -> None:
         logger.debug('app adding html_math_renderer: %s, %r, %r',
                      name, inline_renderers, block_renderers)
         if name in self.html_inline_math_renderers:
@@ -416,7 +412,7 @@
     def add_html_theme(self, name: str, theme_path: str) -> None:
         self.html_themesname = theme_path
 
-    def load_extension(self, app: "Sphinx", extname: str) -> None:
+    def load_extension(self, app: Sphinx, extname: str) -> None:
         """Load a Sphinx extension."""
         if extname in app.extensions:  # already loaded
             return
@@ -440,7 +436,7 @@
             if setup is None:
                 logger.warning(__('extension %r has no setup() function; is it really '
                                   'a Sphinx extension module?'), extname)
-                metadata: Dictstr, Any = {}
+                metadata: dictstr, Any = {}
             else:
                 try:
                     metadata = setup(app)
@@ -449,7 +445,7 @@
                     raise VersionRequirementError(
                         __('The %s extension used by this project needs at least '
                            'Sphinx v%s; it therefore cannot be built with this '
-                           'version.') % (extname, err)
+                           'version.') % (extname, err),
                     ) from err
 
             if metadata is None:
@@ -462,18 +458,27 @@
 
             app.extensionsextname = Extension(extname, mod, **metadata)
 
-    def get_envversion(self, app: "Sphinx") -> Dictstr, str:
+    def get_envversion(self, app: Sphinx) -> dictstr, str:
         from sphinx.environment import ENV_VERSION
         envversion = {ext.name: ext.metadata'env_version' for ext in app.extensions.values()
                       if ext.metadata.get('env_version')}
         envversion'sphinx' = ENV_VERSION
         return envversion
 
+    def get_publisher(self, app: Sphinx, filetype: str) -> Publisher:
+        try:
+            return self.publishersfiletype
+        except KeyError:
+            pass
+        publisher = create_publisher(app, filetype)
+        self.publishersfiletype = publisher
+        return publisher
+
 
-def merge_source_suffix(app: "Sphinx", config: Config) -> None:
+def merge_source_suffix(app: Sphinx, config: Config) -> None:
     """Merge any user-specified source_suffix with any added by extensions."""
     for suffix, filetype in app.registry.source_suffix.items():
-        if suffix not in app.config.source_suffix:
+        if suffix not in app.config.source_suffix:  # NoQA: SIM114
             app.config.source_suffixsuffix = filetype
         elif app.config.source_suffixsuffix is None:
             # filetype is not specified (default filetype).
@@ -484,7 +489,7 @@
     app.registry.source_suffix = app.config.source_suffix
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.connect('config-inited', merge_source_suffix, priority=800)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/roles.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/roles.py Changed

@@ -1,16 +1,13 @@
-"""
-    sphinx.roles
-    ~~~~~~~~~~~~
+"""Handlers for additional ReST roles."""
 
-    Handlers for additional ReST roles.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import TYPE_CHECKING, Any, Dict, List, Tuple, Type
+from typing import TYPE_CHECKING, Any
 
+import docutils.parsers.rst.directives
+import docutils.parsers.rst.roles
+import docutils.parsers.rst.states
 from docutils import nodes, utils
 from docutils.nodes import Element, Node, TextElement, system_message
 
@@ -65,11 +62,12 @@
     * Subclassing and overwriting `process_link()` and/or `result_nodes()`.
     """
 
-    nodeclass: TypeElement = addnodes.pending_xref
-    innernodeclass: TypeTextElement = nodes.literal
+    nodeclass: typeElement = addnodes.pending_xref
+    innernodeclass: typeTextElement = nodes.literal
 
     def __init__(self, fix_parens: bool = False, lowercase: bool = False,
-                 nodeclass: TypeElement = None, innernodeclass: TypeTextElement = None,
+                 nodeclass: typeElement | None = None,
+                 innernodeclass: typeTextElement | None = None,
                  warn_dangling: bool = False) -> None:
         self.fix_parens = fix_parens
         self.lowercase = lowercase
@@ -81,7 +79,7 @@
 
         super().__init__()
 
-    def update_title_and_target(self, title: str, target: str) -> Tuplestr, str:
+    def update_title_and_target(self, title: str, target: str) -> tuplestr, str:
         if not self.has_explicit_title:
             if title.endswith('()'):
                 # remove parentheses
@@ -94,20 +92,20 @@
             target = target:-2
         return title, target
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         if ':' not in self.name:
             self.refdomain, self.reftype = '', self.name
             self.classes = 'xref', self.reftype
         else:
             self.refdomain, self.reftype = self.name.split(':', 1)
-            self.classes = 'xref', self.refdomain, '%s-%s' % (self.refdomain, self.reftype)
+            self.classes = 'xref', self.refdomain, f'{self.refdomain}-{self.reftype}'
 
         if self.disabled:
             return self.create_non_xref_node()
         else:
             return self.create_xref_node()
 
-    def create_non_xref_node(self) -> TupleListNode, Listsystem_message:
+    def create_non_xref_node(self) -> tuplelistNode, listsystem_message:
         text = utils.unescape(self.text1:)
         if self.fix_parens:
             self.has_explicit_title = False  # treat as implicit
@@ -116,7 +114,7 @@
         node = self.innernodeclass(self.rawtext, text, classes=self.classes)
         return self.result_nodes(self.inliner.document, self.env, node, is_ref=False)
 
-    def create_xref_node(self) -> TupleListNode, Listsystem_message:
+    def create_xref_node(self) -> tuplelistNode, listsystem_message:
         target = self.target
         title = self.title
         if self.lowercase:
@@ -143,8 +141,8 @@
 
     # methods that can be overwritten
 
-    def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool,
-                     title: str, target: str) -> Tuplestr, str:
+    def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool,
+                     title: str, target: str) -> tuplestr, str:
         """Called after parsing title and target text, and creating the
         reference node (given in *refnode*).  This method can alter the
         reference node and must return a new (or the same) ``(title, target)``
@@ -152,8 +150,8 @@
         """
         return title, ws_re.sub(' ', target)
 
-    def result_nodes(self, document: nodes.document, env: "BuildEnvironment", node: Element,
-                     is_ref: bool) -> TupleListNode, Listsystem_message:
+    def result_nodes(self, document: nodes.document, env: BuildEnvironment, node: Element,
+                     is_ref: bool) -> tuplelistNode, listsystem_message:
         """Called before returning the finished nodes.  *node* is the reference
         node if one was created (*is_ref* is then true), else the content node.
         This method can add other nodes and must return a ``(nodes, messages)``
@@ -163,8 +161,8 @@
 
 
 class AnyXRefRole(XRefRole):
-    def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool,
-                     title: str, target: str) -> Tuplestr, str:
+    def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool,
+                     title: str, target: str) -> tuplestr, str:
         result = super().process_link(env, refnode, has_explicit_title, title, target)
         # add all possible context info (i.e. std:program, py:module etc.)
         refnode.attributes.update(env.ref_context)
@@ -172,7 +170,7 @@
 
 
 class PEP(ReferenceRole):
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         target_id = 'index-%s' % self.env.new_serialno('index')
         entries = ('single', _('Python Enhancement Proposals; PEP %s') % self.target,
                     target_id, '', None)
@@ -201,13 +199,13 @@
         base_url = self.inliner.document.settings.pep_base_url
         ret = self.target.split('#', 1)
         if len(ret) == 2:
-            return base_url + 'pep-%04d#%s' % (int(ret0), ret1)
+            return base_url + 'pep-%04d/#%s' % (int(ret0), ret1)
         else:
-            return base_url + 'pep-%04d' % int(ret0)
+            return base_url + 'pep-%04d/' % int(ret0)
 
 
 class RFC(ReferenceRole):
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         target_id = 'index-%s' % self.env.new_serialno('index')
         entries = ('single', 'RFC; RFC %s' % self.target, target_id, '', None)
 
@@ -246,7 +244,7 @@
 class GUILabel(SphinxRole):
     amp_re = re.compile(r'(?<!&)&(?!&\s)')
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         node = nodes.inline(rawtext=self.rawtext, classes=self.name)
         spans = self.amp_re.split(self.text)
         node += nodes.Text(spans.pop(0))
@@ -264,7 +262,7 @@
 class MenuSelection(GUILabel):
     BULLET_CHARACTER = '\N{TRIANGULAR BULLET}'
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         self.text = self.text.replace('-->', self.BULLET_CHARACTER)
         return super().run()
 
@@ -276,15 +274,15 @@
 class EmphasizedLiteral(SphinxRole):
     parens_re = re.compile(r'(\\\\|\\{|\\}|{|})')
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         children = self.parse(self.text)
         node = nodes.literal(self.rawtext, '', *children,
                              role=self.name.lower(), classes=self.name)
 
         return node, 
 
-    def parse(self, text: str) -> ListNode:
-        result: ListNode = 
+    def parse(self, text: str) -> listNode:
+        result: listNode = 
 
         stack = ''
         for part in self.parens_re.split(text):
@@ -301,7 +299,7 @@
                 if len(stack) == 3 and stack1 == "{" and len(stack2) > 0:
                     # emphasized word found
                     if stack0:
-                        result.append(nodes.Text(stack0, stack0))
+                        result.append(nodes.Text(stack0))
                     result.append(nodes.emphasis(stack2, stack2))
                     stack = ''
                 else:
@@ -318,7 +316,7 @@
         if ''.join(stack):
             # remaining is treated as Text
             text = ''.join(stack)
-            result.append(nodes.Text(text, text))
+            result.append(nodes.Text(text))
 
         return result
 
@@ -329,7 +327,7 @@
 class Abbreviation(SphinxRole):
     abbr_re = re.compile(r'$(.*)$$', re.S)
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         options = self.options.copy()
         matched = self.abbr_re.search(self.text)
         if matched:
@@ -341,7 +339,58 @@
         return nodes.abbreviation(self.rawtext, text, **options), 
 
 
-specific_docroles: Dictstr, RoleFunction = {
+# Sphinx provides the `code-block` directive for highlighting code blocks.
+# Docutils provides the `code` role which in theory can be used similarly by
+# defining a custom role for a given programming language:
+#
+#     .. .. role:: python(code)
+#          :language: python
+#          :class: highlight
+#
+# In practice this does not produce correct highlighting because it uses a
+# separate highlighting mechanism that results in the "long" pygments class
+# names rather than "short" pygments class names produced by the Sphinx
+# `code-block` directive and for which this extension contains CSS rules.
+#
+# In addition, even if that issue is fixed, because the highlighting
+# implementation in docutils, despite being based on pygments, differs from that
+# used by Sphinx, the output does not exactly match that produced by the Sphinx
+# `code-block` directive.
+#
+# This issue is noted here: //github.com/sphinx-doc/sphinx/issues/5157
+#
+# This overrides the docutils `code` role to perform highlighting in the same
+# way as the Sphinx `code-block` directive.
+#
+# TODO: Change to use `SphinxRole` once SphinxRole is fixed to support options.
+def code_role(name: str, rawtext: str, text: str, lineno: int,
+              inliner: docutils.parsers.rst.states.Inliner,
+              options: dict = {}, content: liststr = ,
+              ) -> tuplelistNode, listsystem_message:
+    options = options.copy()
+    docutils.parsers.rst.roles.set_classes(options)
+    language = options.get('language', '')
+    classes = 'code'
+    if language:
+        classes.append('highlight')
+    if 'classes' in options:
+        classes.extend(options'classes')
+
+    if language and language not in classes:
+        classes.append(language)
+
+    node = nodes.literal(rawtext, text, classes=classes, language=language)
+
+    return node, 
+
+
+code_role.options = {  # type: ignore
+    'class': docutils.parsers.rst.directives.class_option,
+    'language': docutils.parsers.rst.directives.unchanged,
+}
+
+
+specific_docroles: dictstr, RoleFunction = {
     # links to download references
     'download': XRefRole(nodeclass=addnodes.download_reference),
     # links to anything
@@ -357,7 +406,7 @@
 }
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     from docutils.parsers.rst import roles
 
     for rolename, nodeclass in generic_docroles.items():
@@ -368,6 +417,10 @@
     for rolename, func in specific_docroles.items():
         roles.register_local_role(rolename, func)
 
+    # Since docutils registers it as a canonical role, override it as a
+    # canonical role as well.
+    roles.register_canonical_role('code', code_role)
+
     return {
         'version': 'builtin',
         'parallel_read_safe': True,

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/__init__.py Changed

@@ -1,26 +1,37 @@
-"""
-    sphinx.search
-    ~~~~~~~~~~~~~
-
-    Create a full-text search index for offline search.
+"""Create a full-text search index for offline search."""
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+import dataclasses
+import functools
 import html
+import json
 import pickle
 import re
 from importlib import import_module
 from os import path
-from typing import IO, Any, Dict, Iterable, List, Optional, Set, Tuple, Type
+from typing import (
+    IO,
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    Union,
+)
 
 from docutils import nodes
 from docutils.nodes import Element, Node
 
 from sphinx import addnodes, package_dir
 from sphinx.environment import BuildEnvironment
-from sphinx.search.jssplitter import splitter_code
-from sphinx.util import jsdump
+from sphinx.util import split_into
 
 
 class SearchLanguage:
@@ -53,11 +64,11 @@
        This class is used to preprocess search word which Sphinx HTML readers
        type, before searching index. Default implementation does nothing.
     """
-    lang: str = None
-    language_name: str = None
-    stopwords: Setstr = set()
-    js_splitter_code: str = None
-    js_stemmer_rawcode: str = None
+    lang: str | None = None
+    language_name: str | None = None
+    stopwords: setstr = set()
+    js_splitter_code: str = ""
+    js_stemmer_rawcode: str | None = None
     js_stemmer_code = """
 /**
  * Dummy stemmer for languages without stemming rules.
@@ -69,18 +80,18 @@
 }
 """
 
-    _word_re = re.compile(r'(?u)\w+')
+    _word_re = re.compile(r'\w+')
 
-    def __init__(self, options: Dict) -> None:
+    def __init__(self, options: dict) -> None:
         self.options = options
         self.init(options)
 
-    def init(self, options: Dict) -> None:
+    def init(self, options: dict) -> None:
         """
         Initialize the class with the options the user has given.
         """
 
-    def split(self, input: str) -> Liststr:
+    def split(self, input: str) -> liststr:
         """
         This method splits a sentence into words.  Default splitter splits input
         at white spaces, which should be enough for most languages except CJK
@@ -118,13 +129,13 @@
 from sphinx.search.en import SearchEnglish
 
 
-def parse_stop_word(source: str) -> Setstr:
+def parse_stop_word(source: str) -> setstr:
     """
     Parse snowball style word list like this:
 
     * http://snowball.tartarus.org/algorithms/finnish/stop.txt
     """
-    result: Setstr = set()
+    result: setstr = set()
     for line in source.splitlines():
         line = line.split('|')0  # remove comment
         result.update(line.split())
@@ -132,7 +143,7 @@
 
 
 # maps language name to module.class or directly a class
-languages: Dictstr, Any = {
+languages: dictstr, str | typeSearchLanguage = {
     'da': 'sphinx.search.da.SearchDanish',
     'de': 'sphinx.search.de.SearchGerman',
     'en': SearchEnglish,
@@ -163,14 +174,14 @@
     SUFFIX = ')'
 
     def dumps(self, data: Any) -> str:
-        return self.PREFIX + jsdump.dumps(data) + self.SUFFIX
+        return self.PREFIX + json.dumps(data) + self.SUFFIX
 
     def loads(self, s: str) -> Any:
         data = slen(self.PREFIX):-len(self.SUFFIX)
         if not data or not s.startswith(self.PREFIX) or not \
            s.endswith(self.SUFFIX):
             raise ValueError('invalid data')
-        return jsdump.loads(data)
+        return json.loads(data)
 
     def dump(self, data: Any, f: IO) -> None:
         f.write(self.dumps(data))
@@ -182,6 +193,27 @@
 js_index = _JavaScriptIndex()
 
 
+def _is_meta_keywords(
+    node: nodes.meta,  # type: ignorename-defined
+    lang: str | None,
+) -> bool:
+    if node.get('name') == 'keywords':
+        meta_lang = node.get('lang')
+        if meta_lang is None:  # lang not specified
+            return True
+        elif meta_lang == lang:  # matched to html_search_language
+            return True
+
+    return False
+
+
+@dataclasses.dataclass
+class WordStore:
+    words: liststr = dataclasses.field(default_factory=list)
+    titles: listtuplestr, str = dataclasses.field(default_factory=list)
+    title_words: liststr = dataclasses.field(default_factory=list)
+
+
 class WordCollector(nodes.NodeVisitor):
     """
     A special visitor that collects words for the `IndexBuilder`.
@@ -189,21 +221,11 @@
 
     def __init__(self, document: nodes.document, lang: SearchLanguage) -> None:
         super().__init__(document)
-        self.found_words: Liststr = 
-        self.found_title_words: Liststr = 
+        self.found_words: liststr = 
+        self.found_titles: listtuplestr, str = 
+        self.found_title_words: liststr = 
         self.lang = lang
 
-    def is_meta_keywords(self, node: Element) -> bool:
-        if (isinstance(node, (addnodes.meta, addnodes.docutils_meta)) and
-                node.get('name') == 'keywords'):
-            meta_lang = node.get('lang')
-            if meta_lang is None:  # lang not specified
-                return True
-            elif meta_lang == self.lang.lang:  # matched to html_search_language
-                return True
-
-        return False
-
     def dispatch_visit(self, node: Node) -> None:
         if isinstance(node, nodes.comment):
             raise nodes.SkipNode
@@ -212,16 +234,19 @@
                 # Some people might put content in raw HTML that should be searched,
                 # so we just amateurishly strip HTML tags and index the remaining
                 # content
-                nodetext = re.sub(r'(?is)<style.*?</style>', '', node.astext())
-                nodetext = re.sub(r'(?is)<script.*?</script>', '', nodetext)
+                nodetext = re.sub(r'<style.*?</style>', '', node.astext(), flags=re.IGNORECASE|re.DOTALL)
+                nodetext = re.sub(r'<script.*?</script>', '', nodetext, flags=re.IGNORECASE|re.DOTALL)
                 nodetext = re.sub(r'<^<+?>', '', nodetext)
                 self.found_words.extend(self.lang.split(nodetext))
             raise nodes.SkipNode
         elif isinstance(node, nodes.Text):
             self.found_words.extend(self.lang.split(node.astext()))
         elif isinstance(node, nodes.title):
-            self.found_title_words.extend(self.lang.split(node.astext()))
-        elif isinstance(node, Element) and self.is_meta_keywords(node):
+            title = node.astext()
+            ids = node.parent'ids'
+            self.found_titles.append((title, ids0 if ids else None))
+            self.found_title_words.extend(self.lang.split(title))
+        elif isinstance(node, Element) and _is_meta_keywords(node, self.lang.lang):
             keywords = node'content'
             keywords = keyword.strip() for keyword in keywords.split(',')
             self.found_words.extend(keywords)
@@ -233,23 +258,30 @@
     passed to the `feed` method.
     """
     formats = {
-        'jsdump':   jsdump,
+        'json':     json,
         'pickle':   pickle
     }
 
-    def __init__(self, env: BuildEnvironment, lang: str, options: Dict, scoring: str) -> None:
+    def __init__(self, env: BuildEnvironment, lang: str, options: dict, scoring: str) -> None:
         self.env = env
-        self._titles: Dictstr, str = {}           # docname -> title
-        self._filenames: Dictstr, str = {}        # docname -> filename
-        self._mapping: Dictstr, Setstr = {}     # stemmed word -> set(docname)
+        # docname -> title
+        self._titles: dictstr, str = env._search_index_titles
+        # docname -> filename
+        self._filenames: dictstr, str = env._search_index_filenames
+        # stemmed words -> set(docname)
+        self._mapping: dictstr, setstr = env._search_index_mapping
         # stemmed words in titles -> set(docname)
-        self._title_mapping: Dictstr, Setstr = {}
-        self._stem_cache: Dictstr, str = {}       # word -> stemmed word
-        self._objtypes: DictTuplestr, str, int = {}     # objtype -> index
+        self._title_mapping: dictstr, setstr = env._search_index_title_mapping
+        # docname -> all titles in document
+        self._all_titles: dictstr, listtuplestr, str = env._search_index_all_titles
+        # docname -> list(index entry)
+        self._index_entries: dictstr, listtuplestr, str, str = env._search_index_index_entries
+        # objtype -> index
+        self._objtypes: dicttuplestr, str, int = env._search_index_objtypes
         # objtype index -> (domain, type, objname (localized))
-        self._objnames: Dictint, Tuplestr, str, str = {}
+        self._objnames: dictint, tuplestr, str, str = env._search_index_objnames
         # add language-specific SearchLanguage instance
-        lang_class: TypeSearchLanguage = languages.get(lang)
+        lang_class = languages.get(lang)
 
         # fallback; try again with language-code
         if lang_class is None and '_' in lang:
@@ -259,8 +291,8 @@
             self.lang: SearchLanguage = SearchEnglish(options)
         elif isinstance(lang_class, str):
             module, classname = lang_class.rsplit('.', 1)
-            lang_class = getattr(import_module(module), classname)
-            self.lang = lang_class(options)
+            lang_class: typeSearchLanguage = getattr(import_module(module), classname)  # type: ignoreno-redef
+            self.lang = lang_class(options)  # type: ignoreoperator
         else:
             # it's directly a class (e.g. added by app.add_search_language)
             self.lang = lang_class(options)
@@ -270,7 +302,7 @@
                 self.js_scorer_code = fp.read().decode()
         else:
             self.js_scorer_code = ''
-        self.js_splitter_code = splitter_code
+        self.js_splitter_code = ""
 
     def load(self, stream: IO, format: Any) -> None:
         """Reconstruct from frozen data."""
@@ -284,8 +316,15 @@
         index2fn = frozen'docnames'
         self._filenames = dict(zip(index2fn, frozen'filenames'))
         self._titles = dict(zip(index2fn, frozen'titles'))
+        self._all_titles = {}
+
+        for docname in self._titles.keys():
+            self._all_titlesdocname = 
+        for title, doc_tuples in frozen'alltitles'.items():
+            for doc, titleid in doc_tuples:
+                self._all_titlesindex2fndoc.append((title, titleid))
 
-        def load_terms(mapping: Dictstr, Any) -> Dictstr, Setstr:
+        def load_terms(mapping: dictstr, Any) -> dictstr, setstr:
             rv = {}
             for k, v in mapping.items():
                 if isinstance(v, int):
@@ -304,9 +343,9 @@
             format = self.formatsformat
         format.dump(self.freeze(), stream)
 
-    def get_objects(self, fn2index: Dictstr, int
-                    ) -> Dictstr, ListTupleint, int, int, str, str:
-        rv: Dictstr, ListTupleint, int, int, str, str = {}
+    def get_objects(self, fn2index: dictstr, int
+                    ) -> dictstr, listtupleint, int, int, str, str:
+        rv: dictstr, listtupleint, int, int, str, str = {}
         otypes = self._objtypes
         onames = self._objnames
         for domainname, domain in sorted(self.env.domains.items()):
@@ -341,8 +380,8 @@
                 plist.append((fn2indexdocname, typeindex, prio, shortanchor, name))
         return rv
 
-    def get_terms(self, fn2index: Dict) -> TupleDictstr, Liststr, Dictstr, Liststr:
-        rvs: TupleDictstr, Liststr, Dictstr, Liststr = ({}, {})
+    def get_terms(self, fn2index: dict) -> tupledictstr, liststr, dictstr, liststr:
+        rvs: tupledictstr, liststr, dictstr, liststr = ({}, {})
         for rv, mapping in zip(rvs, (self._mapping, self._title_mapping)):
             for k, v in mapping.items():
                 if len(v) == 1:
@@ -353,7 +392,7 @@
                     rvk = sorted(fn2indexfn for fn in v if fn in fn2index)
         return rvs
 
-    def freeze(self) -> Dictstr, Any:
+    def freeze(self) -> dictstr, Any:
         """Create a usable data structure for serializing."""
         docnames, titles = zip(*sorted(self._titles.items()))
         filenames = self._filenames.get(docname) for docname in docnames
@@ -363,23 +402,38 @@
         objects = self.get_objects(fn2index)  # populates _objtypes
         objtypes = {v: k0 + ':' + k1 for (k, v) in self._objtypes.items()}
         objnames = self._objnames
+
+        alltitles: dictstr, listtupleint, str = {}
+        for docname, titlelist in self._all_titles.items():
+            for title, titleid in titlelist:
+                alltitles.setdefault(title, ).append((fn2indexdocname, titleid))
+
+        index_entries: dictstr, listtupleint, str = {}
+        for docname, entries in self._index_entries.items():
+            for entry, entry_id, main_entry in entries:
+                index_entries.setdefault(entry.lower(), ).append((fn2indexdocname, entry_id))
+
         return dict(docnames=docnames, filenames=filenames, titles=titles, terms=terms,
                     objects=objects, objtypes=objtypes, objnames=objnames,
-                    titleterms=title_terms, envversion=self.env.version)
+                    titleterms=title_terms, envversion=self.env.version,
+                    alltitles=alltitles, indexentries=index_entries)
 
     def label(self) -> str:
-        return "%s (code: %s)" % (self.lang.language_name, self.lang.lang)
+        return f"{self.lang.language_name} (code: {self.lang.lang})"
 
     def prune(self, docnames: Iterablestr) -> None:
         """Remove data for all docnames not in the list."""
         new_titles = {}
+        new_alltitles = {}
         new_filenames = {}
         for docname in docnames:
             if docname in self._titles:
                 new_titlesdocname = self._titlesdocname
+                new_alltitlesdocname = self._all_titlesdocname
                 new_filenamesdocname = self._filenamesdocname
         self._titles = new_titles
         self._filenames = new_filenames
+        self._all_titles = new_alltitles
         for wordnames in self._mapping.values():
             wordnames.intersection_update(docnames)
         for wordnames in self._title_mapping.values():
@@ -390,35 +444,82 @@
         self._titlesdocname = title
         self._filenamesdocname = filename
 
-        visitor = WordCollector(doctree, self.lang)
-        doctree.walk(visitor)
+        word_store = self._word_collector(doctree)
 
-        # memoize self.lang.stem
-        def stem(word: str) -> str:
-            try:
-                return self._stem_cacheword
-            except KeyError:
-                self._stem_cacheword = self.lang.stem(word).lower()
-                return self._stem_cacheword
         _filter = self.lang.word_filter
+        _stem = self.lang.stem
 
-        for word in visitor.found_title_words:
+        # memoise self.lang.stem
+        @functools.lru_cache(maxsize=None)
+        def stem(word_to_stem: str) -> str:
+            return _stem(word_to_stem).lower()
+
+        self._all_titlesdocname = word_store.titles
+
+        for word in word_store.title_words:
+            # add stemmed and unstemmed as the stemmer must not remove words
+            # from search index.
             stemmed_word = stem(word)
             if _filter(stemmed_word):
                 self._title_mapping.setdefault(stemmed_word, set()).add(docname)
-            elif _filter(word): # stemmer must not remove words from search index
+            elif _filter(word):
                 self._title_mapping.setdefault(word, set()).add(docname)
 
-        for word in visitor.found_words:
+        for word in word_store.words:
+            # add stemmed and unstemmed as the stemmer must not remove words
+            # from search index.
             stemmed_word = stem(word)
-            # again, stemmer must not remove words from search index
             if not _filter(stemmed_word) and _filter(word):
                 stemmed_word = word
-            already_indexed = docname in self._title_mapping.get(stemmed_word, set())
+            already_indexed = docname in self._title_mapping.get(stemmed_word, ())
             if _filter(stemmed_word) and not already_indexed:
                 self._mapping.setdefault(stemmed_word, set()).add(docname)
 
-    def context_for_searchtool(self) -> Dictstr, Any:
+        # find explicit entries within index directives
+        _index_entries: settuplestr, str, str = set()
+        for node in doctree.findall(addnodes.index):
+            for entry_type, value, target_id, main, *index_key in node'entries':
+                _index_entries |= _parse_index_entry(entry_type, value, target_id, main)
+        self._index_entriesdocname = sorted(_index_entries)
+
+    def _word_collector(self, doctree: nodes.document) -> WordStore:
+        def _visit_nodes(node):
+            if isinstance(node, nodes.comment):
+                return
+            elif isinstance(node, nodes.raw):
+                if 'html' in node.get('format', '').split():
+                    # Some people might put content in raw HTML that should be searched,
+                    # so we just amateurishly strip HTML tags and index the remaining
+                    # content
+                    nodetext = re.sub(r'<style.*?</style>', '', node.astext(),
+                                      flags=re.IGNORECASE | re.DOTALL)
+                    nodetext = re.sub(r'<script.*?</script>', '', nodetext,
+                                      flags=re.IGNORECASE | re.DOTALL)
+                    nodetext = re.sub(r'<^<+?>', '', nodetext)
+                    word_store.words.extend(split(nodetext))
+                return
+            elif (isinstance(node, nodes.meta)  # type: ignoreattr-defined
+                  and _is_meta_keywords(node, language)):
+                keywords = keyword.strip() for keyword in node'content'.split(',')
+                word_store.words.extend(keywords)
+            elif isinstance(node, nodes.Text):
+                word_store.words.extend(split(node.astext()))
+            elif isinstance(node, nodes.title):
+                title = node.astext()
+                ids = node.parent'ids'
+                word_store.titles.append((title, ids0 if ids else None))
+                word_store.title_words.extend(split(title))
+            for child in node.children:
+                _visit_nodes(child)
+            return
+
+        word_store = WordStore()
+        split = self.lang.split
+        language = self.lang.lang
+        _visit_nodes(doctree)
+        return word_store
+
+    def context_for_searchtool(self) -> dictstr, Any:
         if self.lang.js_splitter_code:
             js_splitter_code = self.lang.js_splitter_code
         else:
@@ -426,12 +527,12 @@
 
         return {
             'search_language_stemming_code': self.get_js_stemmer_code(),
-            'search_language_stop_words': jsdump.dumps(sorted(self.lang.stopwords)),
+            'search_language_stop_words': json.dumps(sorted(self.lang.stopwords)),
             'search_scorer_tool': self.js_scorer_code,
             'search_word_splitter_code': js_splitter_code,
         }
 
-    def get_js_stemmer_rawcodes(self) -> Liststr:
+    def get_js_stemmer_rawcodes(self) -> liststr:
         """Returns a list of non-minified stemmer JS files to copy."""
         if self.lang.js_stemmer_rawcode:
             return 
@@ -441,18 +542,56 @@
         else:
             return 
 
-    def get_js_stemmer_rawcode(self) -> Optionalstr:
+    def get_js_stemmer_rawcode(self) -> str | None:
         return None
 
     def get_js_stemmer_code(self) -> str:
         """Returns JS code that will be inserted into language_data.js."""
         if self.lang.js_stemmer_rawcode:
             js_dir = path.join(package_dir, 'search', 'minified-js')
-            with open(path.join(js_dir, 'base-stemmer.js')) as js_file:
+            with open(path.join(js_dir, 'base-stemmer.js'), encoding='utf-8') as js_file:
                 base_js = js_file.read()
-            with open(path.join(js_dir, self.lang.js_stemmer_rawcode)) as js_file:
+            with open(path.join(js_dir, self.lang.js_stemmer_rawcode), encoding='utf-8') as js_file:
                 language_js = js_file.read()
             return ('%s\n%s\nStemmer = %sStemmer;' %
                     (base_js, language_js, self.lang.language_name))
         else:
             return self.lang.js_stemmer_code
+
+
+def _parse_index_entry(
+    entry_type: str,
+    value: str,
+    target_id: str,
+    main: str
+) -> settuplestr, str, str:
+    target_id = target_id or ''
+    if entry_type == 'single':
+        try:
+            entry, subentry = split_into(2, 'single', value)
+            if subentry:
+                return {(entry, target_id, main), (subentry, target_id, main)}
+        except ValueError:
+            entry, = split_into(1, 'single', value)
+        return {(entry, target_id, main)}
+    elif entry_type == 'pair':
+        try:
+            first, second = split_into(2, 'pair', value)
+            return {(first, target_id, main), (second, target_id, main)}
+        except ValueError:
+            pass
+    elif entry_type == 'triple':
+        try:
+            first, second, third = split_into(3, 'triple', value)
+            return {(first, target_id, main),
+                    (second, target_id, main),
+                    (third, target_id, main)}
+        except ValueError:
+            pass
+    elif entry_type in {'see', 'seealso'}:
+        try:
+            first, second = split_into(2, 'see', value)
+            return {(first, target_id, main)}
+        except ValueError:
+            pass
+    return set()

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/da.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/da.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/de.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/de.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/en.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/en.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/es.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/es.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/fi.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/fi.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/fr.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/fr.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/hu.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/hu.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/it.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/it.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/ja.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/ja.py Changed

@@ -1,12 +1,4 @@
-"""
-    sphinx.search.ja
-    ~~~~~~~~~~~~~~~~
-
-    Japanese search language: includes routine to split words.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Japanese search language: includes routine to split words."""
 
 # Python Version of TinySegmenter
 # (http://chasen.org/~taku/software/TinySegmenter/)
@@ -16,6 +8,8 @@
 # Python Version was developed by xnights <programming.magic(at)gmail.com>.
 # For details, see http://programming-magic.com/?id=170
 
+from __future__ import annotations
+
 import os
 import re
 import sys
@@ -39,10 +33,10 @@
 
 
 class BaseSplitter:
-    def __init__(self, options: Dict) -> None:
+    def __init__(self, options: dict) -> None:
         self.options = options
 
-    def split(self, input: str) -> Liststr:
+    def split(self, input: str) -> liststr:
         """
         :param str input:
         :return:
@@ -52,7 +46,7 @@
 
 
 class MecabSplitter(BaseSplitter):
-    def __init__(self, options: Dict) -> None:
+    def __init__(self, options: dict) -> None:
         super().__init__(options)
         self.ctypes_libmecab: Any = None
         self.ctypes_mecab: Any = None
@@ -62,7 +56,7 @@
             self.init_native(options)
         self.dict_encode = options.get('dic_enc', 'utf-8')
 
-    def split(self, input: str) -> Liststr:
+    def split(self, input: str) -> liststr:
         if native_module:
             result = self.native.parse(input)
         else:
@@ -70,14 +64,14 @@
                 self.ctypes_mecab, input.encode(self.dict_encode))
         return result.split(' ')
 
-    def init_native(self, options: Dict) -> None:
+    def init_native(self, options: dict) -> None:
         param = '-Owakati'
         dict = options.get('dict')
         if dict:
             param += ' -d %s' % dict
         self.native = MeCab.Tagger(param)
 
-    def init_ctypes(self, options: Dict) -> None:
+    def init_ctypes(self, options: dict) -> None:
         import ctypes.util
 
         lib = options.get('lib')
@@ -117,11 +111,9 @@
         if self.ctypes_libmecab:
             self.ctypes_libmecab.mecab_destroy(self.ctypes_mecab)
 
-MeCabBinder = MecabSplitter  # keep backward compatibility until Sphinx-1.6
-
 
 class JanomeSplitter(BaseSplitter):
-    def __init__(self, options: Dict) -> None:
+    def __init__(self, options: dict) -> None:
         super().__init__(options)
         self.user_dict = options.get('user_dic')
         self.user_dict_enc = options.get('user_dic_enc', 'utf8')
@@ -132,7 +124,7 @@
             raise RuntimeError('Janome is not available')
         self.tokenizer = janome.tokenizer.Tokenizer(udic=self.user_dict, udic_enc=self.user_dict_enc)
 
-    def split(self, input: str) -> Liststr:
+    def split(self, input: str) -> liststr:
         result = ' '.join(token.surface for token in self.tokenizer.tokenize(input))
         return result.split(' ')
 
@@ -415,13 +407,13 @@
         return 'O'
 
     # ts_
-    def ts_(self, dict: Dictstr, int, key: str) -> int:
+    def ts_(self, dict: dictstr, int, key: str) -> int:
         if key in dict:
             return dictkey
         return 0
 
     # segment
-    def split(self, input: str) -> Liststr:
+    def split(self, input: str) -> liststr:
         if not input:
             return 
 
@@ -513,9 +505,6 @@
         return result
 
 
-TinySegmenter = DefaultSplitter  # keep backward compatibility until Sphinx-1.6
-
-
 class SearchJapanese(SearchLanguage):
     """
     Japanese search implementation: uses no stemmer, but word splitting is quite
@@ -524,7 +513,7 @@
     lang = 'ja'
     language_name = 'Japanese'
 
-    def init(self, options: Dict) -> None:
+    def init(self, options: dict) -> None:
         dotted_path = options.get('type', 'sphinx.search.ja.DefaultSplitter')
         try:
             self.splitter = import_object(dotted_path)(options)
@@ -532,7 +521,7 @@
             raise ExtensionError("Splitter module %r can't be imported" %
                                  dotted_path) from exc
 
-    def split(self, input: str) -> Liststr:
+    def split(self, input: str) -> liststr:
         return self.splitter.split(input)
 
     def word_filter(self, stemmed_word: str) -> bool:

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/nl.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/nl.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/no.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/no.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/pt.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/pt.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/ro.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/ro.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/ru.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/ru.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/sv.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/sv.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/tr.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/tr.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/search/zh.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/search/zh.py Changed

@@ -1,19 +1,14 @@
-"""
-    sphinx.search.zh
-    ~~~~~~~~~~~~~~~~
-
-    Chinese search language: includes routine to split words.
+"""Chinese search language: includes routine to split words."""
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import re
 from typing import Dict, List
 
+import snowballstemmer
+
 from sphinx.search import SearchLanguage
-from sphinx.util.stemmer import get_stemmer
 
 try:
     import jieba
@@ -230,18 +225,18 @@
     js_stemmer_code = js_porter_stemmer
     stopwords = english_stopwords
     latin1_letters = re.compile(r'a-zA-Z0-9_+')
-    latin_terms: Liststr = 
+    latin_terms: liststr = 
 
-    def init(self, options: Dict) -> None:
+    def init(self, options: dict) -> None:
         if JIEBA:
             dict_path = options.get('dict')
             if dict_path and os.path.isfile(dict_path):
                 jieba.load_userdict(dict_path)
 
-        self.stemmer = get_stemmer()
+        self.stemmer = snowballstemmer.stemmer('english')
 
-    def split(self, input: str) -> Liststr:
-        chinese: Liststr = 
+    def split(self, input: str) -> liststr:
+        chinese: liststr = 
         if JIEBA:
             chinese = list(jieba.cut_for_search(input))
 
@@ -260,8 +255,8 @@
         should_not_be_stemmed = (
             word in self.latin_terms and
             len(word) >= 3 and
-            len(self.stemmer.stem(word.lower())) < 3
+            len(self.stemmer.stemWord(word.lower())) < 3
         )
         if should_not_be_stemmed:
             return word.lower()
-        return self.stemmer.stem(word.lower())
+        return self.stemmer.stemWord(word.lower())

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/graphviz/graphviz.css -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/graphviz/graphviz.css Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/latex/latex.tex_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/latex/latex.tex_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/latex/longtable.tex_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/latex/longtable.tex_t Changed

@@ -1,34 +1,74 @@
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}
-<%- if table.align in ('center', 'default') -%>
-  c
-<%- elif table.align == 'left' -%>
-  l
-<%- elif table.align == 'right' -%>
-  r
-<%- endif -%>
-<%= table.get_colspec() %>
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+<% if 'booktabs' in table.styles -%>
+\sphinxthistablewithbooktabsstyle
+<% endif -%>
+<% if 'borderless' in table.styles -%>
+\sphinxthistablewithborderlessstyle
+<% endif -%>
+<% if 'standard' in table.styles -%>
+\sphinxthistablewithstandardstyle
+<% endif -%>
+<% if 'vlines' in table.styles -%>
+\sphinxthistablewithvlinesstyle
+<% endif -%>
+<% if 'novlines' in table.styles -%>
+\sphinxthistablewithnovlinesstyle
+<% endif -%>
+<% if 'colorrows' in table.styles -%>
+\sphinxthistablewithcolorrowsstyle
+<% endif -%>
+<% if 'nocolorrows' in table.styles -%>
+\sphinxthistablewithnocolorrowsstyle
+<% endif -%>
+\makeatletter
+<%- if table.align in ('center', 'default') %>
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+<%- elif table.align == 'left' %>
+  \LTleft \@totalleftmargin
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+<%- elif table.align == 'right' %>
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax
+<%- endif %>
+\makeatother
+\begin{longtable}<%= table.get_colspec() %>
 <%- if table.caption -%>
 \sphinxthelongtablecaptionisattop
 \caption{<%= ''.join(table.caption) %>\strut}<%= labels %>\\*\sphinxlongtablecapskipadjust
-\hline
 <% elif labels -%>
-\hline\noalign{\phantomsection<%= labels %>}%
-<% else -%>
-\hline
+\noalign{\phantomsection<%= labels %>}%
+<% endif -%>
+\sphinxtoprule
+<%= ''.join(table.header) -%>
+<%- if table.header -%>
+\sphinxmidrule
 <% endif -%>
-<%= ''.join(table.header) %>
 \endfirsthead
 
-\multicolumn{<%= table.colcount %>}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} <%= _('continued from previous page') %>}}}\\
-\hline
-<%= ''.join(table.header) %>
+\multicolumn{<%= table.colcount %>}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} <%= _('continued from previous page') %>}}%
+}\\
+\sphinxtoprule
+<%= ''.join(table.header) -%>
+<%- if table.header -%>
+\sphinxmidrule
+<% endif -%>
 \endhead
 
-\hline
-\multicolumn{<%= table.colcount %>}{r}{\makebox0ptr{\sphinxtablecontinued{<%= _('continues on next page') %>}}}\\
+\sphinxbottomrule
+\multicolumn{<%= table.colcount %>}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{<%= _('continues on next page') %>}}%
+}\\
 \endfoot
 
 \endlastfoot
-<%= ''.join(table.body) %>
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxtableatstartofbodyhook
+<%= ''.join(table.body) -%>
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/latex/tabular.tex_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/latex/tabular.tex_t Changed

@@ -1,4 +1,26 @@
 \begin{savenotes}\sphinxattablestart
+\sphinxthistablewithglobalstyle
+<% if 'booktabs' in table.styles -%>
+\sphinxthistablewithbooktabsstyle
+<% endif -%>
+<% if 'borderless' in table.styles -%>
+\sphinxthistablewithborderlessstyle
+<% endif -%>
+<% if 'standard' in table.styles -%>
+\sphinxthistablewithstandardstyle
+<% endif -%>
+<% if 'vlines' in table.styles -%>
+\sphinxthistablewithvlinesstyle
+<% endif -%>
+<% if 'novlines' in table.styles -%>
+\sphinxthistablewithnovlinesstyle
+<% endif -%>
+<% if 'colorrows' in table.styles -%>
+\sphinxthistablewithcolorrowsstyle
+<% endif -%>
+<% if 'nocolorrows' in table.styles -%>
+\sphinxthistablewithnocolorrowsstyle
+<% endif -%>
 <% if table.align -%>
   <%- if table.align in ('center', 'default') -%>
   \centering
@@ -19,9 +41,14 @@
 \phantomsection<%= labels %>\nobreak
 <% endif -%>
 \begin{tabular}t<%= table.get_colspec() -%>
-\hline
-<%= ''.join(table.header) %>
-<%=- ''.join(table.body) %>
+\sphinxtoprule
+<%= ''.join(table.header) -%>
+<%- if table.header -%>
+\sphinxmidrule
+<% endif -%>
+\sphinxtableatstartofbodyhook
+<%=- ''.join(table.body) -%>
+\sphinxbottomrule
 \end{tabular}
-\par
+\sphinxtableafterendhook\par
 \sphinxattableend\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/latex/tabulary.tex_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/latex/tabulary.tex_t Changed

@@ -1,4 +1,26 @@
 \begin{savenotes}\sphinxattablestart
+\sphinxthistablewithglobalstyle
+<% if 'booktabs' in table.styles -%>
+\sphinxthistablewithbooktabsstyle
+<% endif -%>
+<% if 'borderless' in table.styles -%>
+\sphinxthistablewithborderlessstyle
+<% endif -%>
+<% if 'standard' in table.styles -%>
+\sphinxthistablewithstandardstyle
+<% endif -%>
+<% if 'vlines' in table.styles -%>
+\sphinxthistablewithvlinesstyle
+<% endif -%>
+<% if 'novlines' in table.styles -%>
+\sphinxthistablewithnovlinesstyle
+<% endif -%>
+<% if 'colorrows' in table.styles -%>
+\sphinxthistablewithcolorrowsstyle
+<% endif -%>
+<% if 'nocolorrows' in table.styles -%>
+\sphinxthistablewithnocolorrowsstyle
+<% endif -%>
 <% if table.align -%>
   <%- if table.align in ('center', 'default') -%>
   \centering
@@ -19,9 +41,14 @@
 \phantomsection<%= labels %>\nobreak
 <% endif -%>
 \begin{tabulary}{\linewidth}t<%= table.get_colspec() -%>
-\hline
-<%= ''.join(table.header) %>
-<%=- ''.join(table.body) %>
+\sphinxtoprule
+<%= ''.join(table.header) -%>
+<%- if table.header -%>
+\sphinxmidrule
+<% endif -%>
+\sphinxtableatstartofbodyhook
+<%=- ''.join(table.body) -%>
+\sphinxbottomrule
 \end{tabulary}
-\par
+\sphinxtableafterendhook\par
 \sphinxattableend\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/quickstart/conf.py_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/quickstart/conf.py_t Changed

@@ -1,30 +1,18 @@
 # Configuration file for the Sphinx documentation builder.
 #
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
+# For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
+{% if append_syspath -%}
 # -- Path setup --------------------------------------------------------------
 
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-{% if append_syspath -%}
 import os
 import sys
 sys.path.insert(0, {{ module_path | repr }})
-{% else -%}
-# import os
-# import sys
-{% if module_path -%}
-# sys.path.insert(0, {{ module_path | repr }})
-{% else -%}
-# sys.path.insert(0, os.path.abspath('.'))
-{% endif -%}
-{% endif %}
 
+{% endif -%}
 # -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = {{ project | repr }}
 copyright = {{ copyright | repr }}
@@ -32,88 +20,52 @@
 
 {%- if version %}
 
-# The short X.Y version
 version = {{ version | repr }}
 {%- endif %}
 {%- if release %}
-
-# The full version, including alpha/beta/rc tags
 release = {{ release | repr }}
 {%- endif %}
 
-
 # -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = 
+extensions = {% if extensions %}
 {%- for ext in extensions %}
     '{{ ext }}',
 {%- endfor %}
-
+{% endif %}
 
-# Add any paths that contain templates here, relative to this directory.
 templates_path = '{{ dot }}templates'
+exclude_patterns = {{ exclude_patterns }}
 
 {% if suffix != '.rst' -%}
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-# source_suffix = '.rst', '.md'
 source_suffix = {{ suffix | repr }}
-
 {% endif -%}
+
 {% if root_doc != 'index' -%}
-# The root document.
 root_doc = {{ root_doc | repr }}
-
 {% endif -%}
+
 {% if language -%}
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
 language = {{ language | repr }}
-
-{% endif -%}
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = {{ exclude_patterns }}
-
+{%- endif %}
 
 # -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
 html_theme = 'alabaster'
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = '{{ dot }}static'
-{%- if extensions %}
-
-
-# -- Extension configuration -------------------------------------------------
-{%- endif %}
-{%- if 'sphinx.ext.intersphinx' in extensions %}
-
+{% if 'sphinx.ext.intersphinx' in extensions %}
 # -- Options for intersphinx extension ---------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#configuration
 
-# Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3', None),
 }
-
-{%- endif %}
-{%- if 'sphinx.ext.todo' in extensions %}
-
+{% endif -%}
+{% if 'sphinx.ext.todo' in extensions %}
 # -- Options for todo extension ----------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/extensions/todo.html#configuration
 
-# If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
-{%- endif %}
+{% endif %}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/templates/quickstart/make.bat.new_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/templates/quickstart/make.bat.new_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/testing/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing/comparer.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/testing/comparer.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.testing.comparer
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""Sphinx test comparer for pytest"""
+from __future__ import annotations
 
-    Sphinx test comparer for pytest
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
 import difflib
 import pathlib
-from typing import Any, List, Union
+from typing import Any
 
 
 class PathComparer:
@@ -32,7 +26,7 @@
     >>> 'C:\\to\\index' == PathComparer('D:/to/index')
     False
     """
-    def __init__(self, path: Unionstr, pathlib.Path):
+    def __init__(self, path: str | pathlib.Path):
         """
         :param str path: path string, it will be cast as pathlib.Path.
         """
@@ -42,12 +36,12 @@
         return self.path.as_posix()
 
     def __repr__(self) -> str:
-        return "<{0.__class__.__name__}: '{0}'>".format(self)
+        return f"<{self.__class__.__name__}: '{self}'>"
 
-    def __eq__(self, other: Unionstr, pathlib.Path) -> bool:  # type: ignore
+    def __eq__(self, other: str | pathlib.Path) -> bool:  # type: ignore
         return not bool(self.ldiff(other))
 
-    def diff(self, other: Unionstr, pathlib.Path) -> Liststr:
+    def diff(self, other: str | pathlib.Path) -> liststr:
         """compare self and other.
 
         When different is not exist, return empty list.
@@ -66,19 +60,19 @@
         """
         return self.ldiff(other)
 
-    def ldiff(self, other: Unionstr, pathlib.Path) -> Liststr:
+    def ldiff(self, other: str | pathlib.Path) -> liststr:
         return self._diff(
             self.path,
             pathlib.Path(other),
         )
 
-    def rdiff(self, other: Unionstr, pathlib.Path) -> Liststr:
+    def rdiff(self, other: str | pathlib.Path) -> liststr:
         return self._diff(
             pathlib.Path(other),
             self.path,
         )
 
-    def _diff(self, lhs: pathlib.Path, rhs: pathlib.Path) -> Liststr:
+    def _diff(self, lhs: pathlib.Path, rhs: pathlib.Path) -> liststr:
         if lhs == rhs:
             return 
 
@@ -94,7 +88,7 @@
         return line.strip() for line in difflib.Differ().compare(s_path, o_path)
 
 
-def pytest_assertrepr_compare(op: str, left: Any, right: Any) -> Liststr:
+def pytest_assertrepr_compare(op: str, left: Any, right: Any) -> liststr:
     if isinstance(left, PathComparer) and op == "==":
         return 'Comparing path:' + left.ldiff(right)
     elif isinstance(right, PathComparer) and op == "==":

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing/fixtures.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/testing/fixtures.py Changed

@@ -1,19 +1,12 @@
-"""
-    sphinx.testing.fixtures
-    ~~~~~~~~~~~~~~~~~~~~~~~
+"""Sphinx test fixtures for pytest"""
 
-    Sphinx test fixtures for pytest
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import subprocess
 import sys
 from collections import namedtuple
 from io import StringIO
-from subprocess import PIPE
-from typing import Any, Callable, Dict, Generator, Tuple
+from typing import Any, Callable, Generator
 
 import pytest
 
@@ -36,12 +29,12 @@
 
 
 @pytest.fixture(scope='session')
-def rootdir() -> str:
+def rootdir() -> str | None:
     return None
 
 
 class SharedResult:
-    cache: Dictstr, Dictstr, str = {}
+    cache: dictstr, dictstr, str = {}
 
     def store(self, key: str, app_: SphinxTestApp) -> Any:
         if key in self.cache:
@@ -52,7 +45,7 @@
         }
         self.cachekey = data
 
-    def restore(self, key: str) -> Dictstr, StringIO:
+    def restore(self, key: str) -> dictstr, StringIO:
         if key not in self.cache:
             return {}
         data = self.cachekey
@@ -62,9 +55,9 @@
         }
 
 
-@pytest.fixture
-def app_params(request: Any, test_params: Dict, shared_result: SharedResult,
-               sphinx_test_tempdir: str, rootdir: str) -> TupleDict, Dict:
+@pytest.fixture()
+def app_params(request: Any, test_params: dict, shared_result: SharedResult,
+               sphinx_test_tempdir: str, rootdir: str) -> tupledict, dict:
     """
     Parameters that are specified by 'pytest.mark.sphinx' for
     sphinx.application.Sphinx initialization
@@ -72,19 +65,14 @@
 
     # ##### process pytest.mark.sphinx
 
-    if hasattr(request.node, 'iter_markers'):  # pytest-3.6.0 or newer
-        markers = request.node.iter_markers("sphinx")
-    else:
-        markers = request.node.get_marker("sphinx")
     pargs = {}
-    kwargs: Dictstr, Any = {}
+    kwargs: dictstr, Any = {}
 
-    if markers is not None:
-        # to avoid stacking positional args
-        for info in reversed(list(markers)):
-            for i, a in enumerate(info.args):
-                pargsi = a
-            kwargs.update(info.kwargs)
+    # to avoid stacking positional args
+    for info in reversed(list(request.node.iter_markers("sphinx"))):
+        for i, a in enumerate(info.args):
+            pargsi = a
+        kwargs.update(info.kwargs)
 
     args = pargsi for i in sorted(pargs.keys())
 
@@ -110,8 +98,8 @@
     return namedtuple('app_params', 'args,kwargs')(args, kwargs)  # type: ignore
 
 
-@pytest.fixture
-def test_params(request: Any) -> Dict:
+@pytest.fixture()
+def test_params(request: Any) -> dict:
     """
     Test parameters that are specified by 'pytest.mark.test_params'
 
@@ -121,10 +109,7 @@
        have same 'shared_result' value.
        **NOTE**: You can not specify both shared_result and srcdir.
     """
-    if hasattr(request.node, 'get_closest_marker'):  # pytest-3.6.0 or newer
-        env = request.node.get_closest_marker('test_params')
-    else:
-        env = request.node.get_marker('test_params')
+    env = request.node.get_closest_marker('test_params')
     kwargs = env.kwargs if env else {}
     result = {
         'shared_result': None,
@@ -138,7 +123,7 @@
 
 
 @pytest.fixture(scope='function')
-def app(test_params: Dict, app_params: TupleDict, Dict, make_app: Callable,
+def app(test_params: dict, app_params: tupledict, dict, make_app: Callable,
         shared_result: SharedResult) -> GeneratorSphinxTestApp, None, None:
     """
     Provides the 'sphinx.application.Sphinx' object
@@ -175,7 +160,7 @@
 
 
 @pytest.fixture()
-def make_app(test_params: Dict, monkeypatch: Any) -> GeneratorCallable, None, None:
+def make_app(test_params: dict, monkeypatch: Any) -> GeneratorCallable, None, None:
     """
     Provides make_app function to initialize SphinxTestApp instance.
     if you want to initialize 'app' in your test function. please use this
@@ -202,7 +187,7 @@
         app_.cleanup()
 
 
-@pytest.fixture
+@pytest.fixture()
 def shared_result() -> SharedResult:
     return SharedResult()
 
@@ -212,8 +197,8 @@
     SharedResult.cache.clear()
 
 
-@pytest.fixture
-def if_graphviz_found(app: SphinxTestApp) -> None:
+@pytest.fixture()
+def if_graphviz_found(app: SphinxTestApp) -> None:  # NoQA: PT004
     """
     The test will be skipped when using 'if_graphviz_found' fixture and graphviz
     dot command is not found.
@@ -221,7 +206,7 @@
     graphviz_dot = getattr(app.config, 'graphviz_dot', '')
     try:
         if graphviz_dot:
-            subprocess.run(graphviz_dot, '-V', stdout=PIPE, stderr=PIPE)  # show version
+            subprocess.run(graphviz_dot, '-V', capture_output=True)  # show version
             return
     except OSError:  # No such file or directory
         pass
@@ -230,7 +215,7 @@
 
 
 @pytest.fixture(scope='session')
-def sphinx_test_tempdir(tmpdir_factory: Any) -> "util.path":
+def sphinx_test_tempdir(tmpdir_factory: Any) -> util.path:
     """
     Temporary directory wrapped with `path` class.
     """
@@ -238,8 +223,8 @@
     return util.path(tmpdir).abspath()
 
 
-@pytest.fixture
-def tempdir(tmpdir: str) -> "util.path":
+@pytest.fixture()
+def tempdir(tmpdir: str) -> util.path:
     """
     Temporary directory wrapped with `path` class.
     This fixture is for back-compatibility with old test implementation.
@@ -247,8 +232,8 @@
     return util.path(tmpdir)
 
 
-@pytest.fixture
-def rollback_sysmodules():
+@pytest.fixture()
+def rollback_sysmodules():  # NoQA: PT004
     """
     Rollback sys.modules to its value before testing to unload modules
     during tests.

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing/path.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/testing/path.py Changed

@@ -1,19 +1,12 @@
-"""
-    sphinx.testing.path
-    ~~~~~~~~~~~~~~~~~~~
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import builtins
 import os
 import shutil
 import sys
-import warnings
-from typing import IO, Any, Callable, List
+from typing import IO, TYPE_CHECKING, Any, Callable
 
-from sphinx.deprecation import RemovedInSphinx50Warning
+if TYPE_CHECKING:
+    import builtins
 
 FILESYSTEMENCODING = sys.getfilesystemencoding() or sys.getdefaultencoding()
 
@@ -35,7 +28,7 @@
     """
 
     @property
-    def parent(self) -> "path":
+    def parent(self) -> path:
         """
         The name of the directory the file or directory is in.
         """
@@ -44,7 +37,7 @@
     def basename(self) -> str:
         return os.path.basename(self)
 
-    def abspath(self) -> "path":
+    def abspath(self) -> path:
         """
         Returns the absolute path.
         """
@@ -80,7 +73,7 @@
         """
         return os.path.ismount(self)
 
-    def rmtree(self, ignore_errors: bool = False, onerror: Callable = None) -> None:
+    def rmtree(self, ignore_errors: bool = False, onerror: Callable | None = None) -> None:
         """
         Removes the file or directory and any files or directories it may
         contain.
@@ -157,14 +150,6 @@
         with open(self, 'w', encoding=encoding, **kwargs) as f:
             f.write(text)
 
-    def text(self, encoding: str = 'utf-8', **kwargs: Any) -> str:
-        """
-        Returns the text in the file.
-        """
-        warnings.warn('Path.text() is deprecated.  Please use read_text() instead.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self.read_text(encoding, **kwargs)
-
     def read_text(self, encoding: str = 'utf-8', **kwargs: Any) -> str:
         """
         Returns the text in the file.
@@ -172,14 +157,6 @@
         with open(self, encoding=encoding, **kwargs) as f:
             return f.read()
 
-    def bytes(self) -> builtins.bytes:
-        """
-        Returns the bytes in the file.
-        """
-        warnings.warn('Path.bytes() is deprecated.  Please use read_bytes() instead.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self.read_bytes()
-
     def read_bytes(self) -> builtins.bytes:
         """
         Returns the bytes in the file.
@@ -220,16 +197,16 @@
         """
         os.makedirs(self, mode, exist_ok=exist_ok)
 
-    def joinpath(self, *args: Any) -> "path":
+    def joinpath(self, *args: Any) -> path:
         """
         Joins the path with the argument given and returns the result.
         """
         return self.__class__(os.path.join(self, *map(self.__class__, args)))
 
-    def listdir(self) -> Liststr:
+    def listdir(self) -> liststr:
         return os.listdir(self)
 
     __div__ = __truediv__ = joinpath
 
     def __repr__(self) -> str:
-        return '%s(%s)' % (self.__class__.__name__, super().__repr__())
+        return f'{self.__class__.__name__}({super().__repr__()})'

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing/restructuredtext.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/testing/restructuredtext.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/testing/util.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/testing/util.py Changed

@@ -1,19 +1,12 @@
-"""
-    sphinx.testing.util
-    ~~~~~~~~~~~~~~~~~~~
+"""Sphinx test suite utilities"""
+from __future__ import annotations
 
-    Sphinx test suite utilities
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
 import functools
 import os
 import re
 import sys
 import warnings
-from io import StringIO
-from typing import IO, Any, Dict, Generator, List, Pattern
+from typing import IO, TYPE_CHECKING, Any, Generator
 from xml.etree import ElementTree
 
 from docutils import nodes
@@ -25,24 +18,27 @@
 from sphinx.testing.path import path
 from sphinx.util.osutil import relpath
 
+if TYPE_CHECKING:
+    from io import StringIO
+
 __all__ = 
     'Struct', 'SphinxTestApp', 'SphinxTestAppWrapperForSkipBuilding',
 
 
 
-def assert_re_search(regex: Pattern, text: str, flags: int = 0) -> None:
+def assert_re_search(regex: re.Pattern, text: str, flags: int = 0) -> None:
     if not re.search(regex, text, flags):
-        assert False, '%r did not match %r' % (regex, text)
+        raise AssertionError(f'{regex!r} did not match {text!r}')
 
 
-def assert_not_re_search(regex: Pattern, text: str, flags: int = 0) -> None:
+def assert_not_re_search(regex: re.Pattern, text: str, flags: int = 0) -> None:
     if re.search(regex, text, flags):
-        assert False, '%r did match %r' % (regex, text)
+        raise AssertionError(f'{regex!r} did match {text!r}')
 
 
 def assert_startswith(thing: str, prefix: str) -> None:
     if not thing.startswith(prefix):
-        assert False, '%r does not start with %r' % (thing, prefix)
+        raise AssertionError(f'{thing!r} does not start with {prefix!r}')
 
 
 def assert_node(node: Node, cls: Any = None, xpath: str = "", **kwargs: Any) -> None:
@@ -67,10 +63,10 @@
                 path = xpath + "%d" % i
                 assert_node(nodei, nodecls, xpath=path, **kwargs)
         elif isinstance(cls, str):
-            assert node == cls, 'The node %r is not %r: %r' % (xpath, cls, node)
+            assert node == cls, f'The node {xpath!r} is not {cls!r}: {node!r}'
         else:
             assert isinstance(node, cls), \
-                'The node%s is not subclass of %r: %r' % (xpath, cls, node)
+                f'The node{xpath} is not subclass of {cls!r}: {node!r}'
 
     if kwargs:
         assert isinstance(node, nodes.Element), \
@@ -78,15 +74,15 @@
 
         for key, value in kwargs.items():
             assert key in node, \
-                'The node%s does not have %r attribute: %r' % (xpath, key, node)
+                f'The node{xpath} does not have {key!r} attribute: {node!r}'
             assert nodekey == value, \
-                'The node%s%s is not %r: %r' % (xpath, key, value, nodekey)
+                f'The node{xpath}{key} is not {value!r}: {nodekey!r}'
 
 
 def etree_parse(path: str) -> Any:
     with warnings.catch_warnings(record=False):
         warnings.filterwarnings("ignore", category=DeprecationWarning)
-        return ElementTree.parse(path)
+        return ElementTree.parse(path)  # NoQA: S314  # using known data in tests
 
 
 class Struct:
@@ -99,13 +95,22 @@
     A subclass of :class:`Sphinx` that runs on the test root, with some
     better default values for the initialization parameters.
     """
-    _status: StringIO = None
-    _warning: StringIO = None
-
-    def __init__(self, buildername: str = 'html', srcdir: path = None, builddir: path = None,
-                 freshenv: bool = False, confoverrides: Dict = None, status: IO = None,
-                 warning: IO = None, tags: Liststr = None, docutilsconf: str = None,
-                 parallel: int = 0) -> None:
+    _status: StringIO
+    _warning: StringIO
+
+    def __init__(
+        self,
+        buildername: str = 'html',
+        srcdir: path | None = None,
+        builddir: path | None = None,
+        freshenv: bool = False,
+        confoverrides: dict | None = None,
+        status: IO | None = None,
+        warning: IO | None = None,
+        tags: liststr | None = None,
+        docutilsconf: str | None = None,
+        parallel: int = 0,
+    ) -> None:
 
         if docutilsconf is not None:
             (srcdir / 'docutils.conf').write_text(docutilsconf)
@@ -151,7 +156,11 @@
                 delattr(nodes.GenericNodeVisitor, 'depart_' + method6:)
 
     def __repr__(self) -> str:
-        return '<%s buildername=%r>' % (self.__class__.__name__, self.builder.name)
+        return f'<{self.__class__.__name__} buildername={self.builder.name!r}>'
+
+    def build(self, force_all: bool = False, filenames: liststr | None = None) -> None:
+        self.env._pickled_doctree_cache.clear()
+        super().build(force_all, filenames)
 
 
 class SphinxTestAppWrapperForSkipBuilding:
@@ -177,10 +186,10 @@
 _unicode_literals_re = re.compile(r'u(".*?")|u(\'.*?\')')
 
 
-def find_files(root: str, suffix: bool = None) -> Generatorstr, None, None:
+def find_files(root: str, suffix: str | None = None) -> Generatorstr, None, None:
     for dirpath, _dirs, files in os.walk(root, followlinks=True):
         dirpath = path(dirpath)
-        for f in f for f in files if not suffix or f.endswith(suffix):  # type: ignore
+        for f in f for f in files if not suffix or f.endswith(suffix):
             fpath = dirpath / f
             yield relpath(fpath, root)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/LatinRules.xdy -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/LatinRules.xdy Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinx.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinx.sty Changed

@@ -6,7 +6,7 @@
 %
 
 \NeedsTeXFormat{LaTeX2e}1995/12/01
-\ProvidesPackage{sphinx}2021/01/27 v4.0.0 LaTeX package (Sphinx markup)
+\ProvidesPackage{sphinx}2023/03/19 v6.2.0 LaTeX package (Sphinx markup)
 
 % provides \ltx@ifundefined
 % (many packages load ltxcmds: graphicx does for pdftex and lualatex but
@@ -17,6 +17,7 @@
 %% for deprecation warnings
 \newcommand\sphinxdeprecationwarning4{% #1 the deprecated macro or name,
 % #2 = when deprecated, #3 = when removed, #4 = additional info
+  {% limit scope of \spx@tempa, \AtEndDocument works even if nested.
   \edef\spx@tempa{\detokenize{#1}}%
   \ltx@ifundefined{sphinx_depr_\spx@tempa}{%
      \global\expandafter\let\csname sphinx_depr_\spx@tempa\endcsname\spx@tempa
@@ -28,27 +29,117 @@
          \@spaces- and removed at Sphinx #3.^^J
          #4^^J****}}%
   }{% warning already emitted (at end of latex log), don't repeat
-  }}
+   }%
+  }% end of scope limiting group for \spx@tempa
+}
+%% important build warnings use an undefined reference to induce latexmk
+%% into complaining (once per warning) at very end of console output
+\newcommand\sphinxbuildwarning1{%
+  \ifcsname sphinx_emitted_#1\endcsname
+  \else
+    \global\expandafter\let\csname sphinx_emitted_#1\endcsname\@empty
+    \AtEndDocument{\hbox{% should the printing of text be made conditional on
+                         % some boolean?
+                         \bfseries\color{red}%
+                         \@nameuse{sphinx_buildwarning_#1}%
+                         % place an undefined reference deliberately
+                         \let\nfss@text\@gobble % no ??
+                         \ref{!!\@nameuse{sphinx_buildwarning_#1}}%
+                         }}%
+  \fi
+}
+\@namedef{sphinx_buildwarning_coloursyntax}{%
+   The colours whose definition used xcolor syntax were set to white
+   as xcolor was not found; check the latex log warnings for details}
+\@namedef{sphinx_buildwarning_colorblend}{%
+   Command \string\sphinxcolorblend\space seen but ignored in tables
+   as xcolor was not found; check the latex log warnings for details}
+\@namedef{sphinx_buildwarning_badtitlesec}{%
+   Your system has titlesec version 2.10.1 which causes disappearance
+   of section numbers; check the latex log warning for details}
+\@namedef{sphinx_buildwarning_booktabs}{%
+   Some tables with booktabs class (check latex log) but booktabs
+   package not loaded; add its loading to the latex preamble}%
+\@namedef{sphinx_buildwarning_badfootnotes}{%
+   Footnote rendering may have had problems, due to extra package or
+   document class; check latex log for instructions}%
 
 
 %% OPTION HANDLING
 %
 
-% We first handle options then load packages, but we need \definecolor from
-% xcolor/color.
+% We generally first handle options then load packages, but we need
+% \definecolor from xcolor/color to handle the options.
 
-% FIXME: we should \RequirePackage{xcolor} always now
-% The xcolor package draws better fcolorboxes around verbatim code
+% MEMO: xcolor \fcolorbox coloured boxes render better in some PDF viewers
+% than with color package \fcolorbox.  Since 1.6.3, Sphinx uses only its own
+% custom variant of \fcolorbox when handling code-blocks.  But \fcolorbox
+% appears also in Pygmentize output mark-up.  Also, since 5.3.0, 'sphinxsetup'
+% color options get a richer input syntax if Sphinx knows xcolor is loaded,
+% and the \sphinxcolorblend (for tables) is made available only if xcolor is
+% loaded.
 \IfFileExists{xcolor.sty}{
+% Should Sphinx load xcolor with its dvipsnames and svgnames options?
     \RequirePackage{xcolor}
 }{
     \RequirePackage{color}
 }
 
+% the \colorlet of xcolor (if at all loaded) is overkill for most internal use
+\newcommand{\sphinxcolorlet}2
+    {\expandafter\let\csname\@backslashchar color@#1\expandafter\endcsname
+                     \csname\@backslashchar color@#2\endcsname }
+
+% (5.3.0) Allow colour options to use both the \definecolor and the \colorlet
+% syntaxes, for example VerbatimColor={gray}{0.9} or VerbatimColor=red!10
+% In the latter case we need the real \colorlet from xcolor package.
+\def\spx@defineorletcolor#1{%
+    \def\spx@definedcolor{{#1}}%
+    \futurelet\spx@token\spx@defineorlet}
+\def\spx@defineorlet{%
+    \ifx\spx@token\bgroup
+    \expandafter\spx@definecolor\else\expandafter\spx@colorlet\fi}
+\def\spx@colorlet#1\relax{\expandafter\colorlet\spx@definedcolor{#1}}
+\def\spx@definecolor{\expandafter\definecolor\spx@definedcolor}
+%
+\@ifpackageloaded{xcolor}%
+   {}%
+   {% xcolor not loaded because it was not found in the LaTeX installation
+\def\spx@colorlet#1\relax{%
+    \sphinxbuildwarning{coloursyntax}%
+    \PackageWarning{sphinx}{%
+Sorry, the #1 syntax requires package xcolor,\MessageBreak
+which was not found on your TeX/LaTeX installation.\MessageBreak
+\@spaces\expandafter\@firstofone\spx@definedcolor\MessageBreak
+will be set to white}%
+    \expandafter\definecolor\spx@definedcolor{rgb}{1,1,1}%
+    }% end of redefinition of \spx@colorlet
+   }% end of xcolor not found branch
+
+
 % Handle options via "kvoptions" (later loaded by hyperref anyhow)
 \RequirePackage{kvoptions}
 \SetupKeyvalOptions{prefix=spx@opt@} % use \spx@opt@ prefix
 
+% Optional usage of booktabs package for tables
+\DeclareBoolOptionfalse{booktabs}
+\DeclareBoolOptionfalse{borderless}
+\DeclareBoolOptiontrue{booktabscolorgaps}
+\DeclareVoidOption{booktabsnogaps}{%
+  \ifx\@nodocument\relax
+  % in body
+    \expandafter\@firstofone
+  \else
+  % in preamble, wait for at begin document
+    \expandafter\AtBeginDocument
+  \fi
+  {\ifdefined\abovetopsep % silently do nothing if booktabs not loaded
+      \abovetopsep\z@\belowrulesep\z@\aboverulesep\z@\belowbottomsep\z@
+   \fi
+  }%
+}
+% Coloured table rows
+\DeclareBoolOptionfalse{colorrows}
 % Sphinx legacy text layout: 1in margins on all four sides
 \ifx\@jsc@uplatextrue\@undefined
 \DeclareStringOption1in{hmargin}
@@ -68,30 +159,10 @@
 \define@key{sphinx}{bookmarksdepth}{\AtBeginDocument{\hypersetup{bookmarksdepth=#1}}}
 \AtBeginDocument{\define@key{sphinx}{bookmarksdepth}{\hypersetup{bookmarksdepth=#1}}}
 % \DeclareBoolOptionfalse{usespart}% not used
-% dimensions, we declare the \dimen registers here.
-\newdimen\sphinxverbatimsep
-\newdimen\sphinxverbatimborder
-\newdimen\sphinxshadowsep
-\newdimen\sphinxshadowsize
-\newdimen\sphinxshadowrule
-% \DeclareStringOption is not convenient for the handling of these dimensions
-% because we want to assign the values to the corresponding registers. Even if
-% we added the code to the key handler it would be too late for the initial
-% set-up and we would need to do initial assignments explicitly. We end up
-% using \define@key directly.
-% verbatim
-\sphinxverbatimsep=\fboxsep
-  \define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax}
-\sphinxverbatimborder=\fboxrule
-  \define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax}
-% topic boxes
-\sphinxshadowsep =5pt
-  \define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax}
-\sphinxshadowsize=4pt
-  \define@key{sphinx}{shadowsize}{\sphinxshadowsize\dimexpr #1\relax}
-\sphinxshadowrule=\fboxrule
-  \define@key{sphinx}{shadowrule}{\sphinxshadowrule\dimexpr #1\relax}
-% verbatim
+% INFO: the keys for padding and border widths were extended at 5.1.0,
+% and legacy names for user interface were kept, but their definitions
+% are delayed further down.  The legacy internally used dimen registers
+% \sphinxverbatimborder and \sphinxverbatimsep got removed at 6.2.0.
 \DeclareBoolOptiontrue{verbatimwithframe}
 \DeclareBoolOptiontrue{verbatimwrapslines}
 \DeclareBoolOptionfalse{verbatimforcewraps}
@@ -109,19 +180,37 @@
 \DeclareStringOption % must use braces to hide the brackets
   {\makebox2\fontcharwd\font`\xr{\textcolor{red}{\tiny$\m@th\hookrightarrow$}}}%
   {verbatimcontinued}
+% topic boxes
+%
+% 5.1.0 added new keys for configuration.  The legacy keys shadowsep,
+% shadowsize, shadowrule were kept for backward compatibility.  Unfortunately
+% this had bugs due to typos, which got fixed later at 6.1.2.
+%
+% All configuration is now to be found in the "CSS" section below.
+%
+% \sphinxshadowsep, \sphinxshadowsize, \sphinxshadowrule \dimen registers
+% became at 5.1.0 either no-op or, for the latter, were used under an aliased
+% name.  They got removed at 6.2.0.
+%
 % notices/admonitions
-% the dimensions for notices/admonitions are kept as macros and assigned to
-% \spx@notice@border at time of use, hence \DeclareStringOption is ok for this
-\newdimen\spx@notice@border
-\DeclareStringOption0.5pt{noteborder}
-\DeclareStringOption0.5pt{hintborder}
-\DeclareStringOption0.5pt{importantborder}
-\DeclareStringOption0.5pt{tipborder}
-\DeclareStringOption1pt{warningborder}
-\DeclareStringOption1pt{cautionborder}
-\DeclareStringOption1pt{attentionborder}
-\DeclareStringOption1pt{dangerborder}
-\DeclareStringOption1pt{errorborder}
+%
+% 5.1.0 added much customizability to warning, caution, attention, danger and
+% error types of notices via an enhanced sphinxheavybox environment.
+%
+% 6.2.0 added the possibility to use the same kind of rendering also for
+% note, hint, important, and tip.
+%
+% Legacy user interface for options was kept working.  All of it is handled in
+% the "CSS" section below.
+%
+% These 6.2.0 added booleans serve internally.  There is no reason for user to
+% know about them, except if it is desired to toggle mid-way in the document
+% whether note, hint, important, and tip should use the "lightbox" or the
+% "heavybox" rendering.
+\DeclareBoolOptionfalse{heavynote}
+\DeclareBoolOptionfalse{heavyhint}
+\DeclareBoolOptionfalse{heavyimportant}
+\DeclareBoolOptionfalse{heavytip}
 % footnotes
 \DeclareStringOption\mbox{ }{AtStartFootnote}
 % we need a public macro name for direct use in latex file
@@ -132,41 +221,561 @@
 \DeclareStringOption\sffamily\bfseries{HeaderFamily}
 % colours
 % same problems as for dimensions: we want the key handler to use \definecolor.
-% first, some colours with no prefix, for backwards compatibility
+% first, some colours with no prefix, for backward compatibility
 \newcommand*{\sphinxDeclareColorOption}2{%
+   % set the initial default; only \definecolor syntax for defaults!
    \definecolor{#1}#2%
-   \define@key{sphinx}{#1}{\definecolor{#1}##1}%
+   % set the key handler to accept both \definecolor and \colorlet syntax
+   \define@key{sphinx}{#1}{\spx@defineorletcolor{#1}##1\relax}%
 }%
 \sphinxDeclareColorOption{TitleColor}{{rgb}{0.126,0.263,0.361}}
 \sphinxDeclareColorOption{InnerLinkColor}{{rgb}{0.208,0.374,0.486}}
 \sphinxDeclareColorOption{OuterLinkColor}{{rgb}{0.216,0.439,0.388}}
-\sphinxDeclareColorOption{VerbatimColor}{{rgb}{1,1,1}}
-\sphinxDeclareColorOption{VerbatimBorderColor}{{rgb}{0,0,0}}
-% now the colours defined with "sphinx" prefix in their names
+\sphinxDeclareColorOption{VerbatimColor}{{gray}{0.95}}
+\sphinxDeclareColorOption{VerbatimBorderColor}{{RGB}{32,32,32}}
+% all other colours will be named with a "sphinx" prefix
 \newcommand*{\sphinxDeclareSphinxColorOption}2{%
-   % set the initial default
+   % set the initial default; only \definecolor syntax for defaults!
    \definecolor{sphinx#1}#2%
-   % set the key handler. The "value" ##1 must be acceptable by \definecolor.
-   \define@key{sphinx}{#1}{\definecolor{sphinx#1}##1}%
+   % set the key handler to accept both \definecolor and \colorlet syntax
+   \define@key{sphinx}{#1}{\spx@defineorletcolor{sphinx#1}##1\relax}%
+}%
+% table row colors
+\sphinxDeclareSphinxColorOption{TableRowColorHeader}{{gray}{0.86}}
+\sphinxDeclareSphinxColorOption{TableRowColorOdd}{{gray}{0.92}}
+\sphinxDeclareSphinxColorOption{TableRowColorEven}{{gray}{0.98}}
+% if not set, the "Merge" colour will keep in sync with the "Row" colour
+\def\sphinxTableMergeColorHeader{sphinxTableRowColorHeader}
+\define@key{sphinx}{TableMergeColorHeader}{%
+    \spx@defineorletcolor{sphinxTableMergeColorHeader}#1\relax
+    \def\sphinxTableMergeColorHeader{sphinxTableMergeColorHeader}%
+}%
+\def\sphinxTableMergeColorOdd{sphinxTableRowColorOdd}
+\define@key{sphinx}{TableMergeColorOdd}{%
+    \spx@defineorletcolor{sphinxTableMergeColorOdd}#1\relax
+    \def\sphinxTableMergeColorOdd{sphinxTableMergeColorOdd}%
+}%
+\def\sphinxTableMergeColorEven{sphinxTableRowColorEven}
+\define@key{sphinx}{TableMergeColorEven}{%
+    \spx@defineorletcolor{sphinxTableMergeColorEven}#1\relax
+    \def\sphinxTableMergeColorEven{sphinxTableMergeColorEven}%
 }%
 % Default color chosen to be as in minted.sty LaTeX package!
 \sphinxDeclareSphinxColorOption{VerbatimHighlightColor}{{rgb}{0.878,1,1}}
 % admonition boxes, "light" style
+% border color defaults to black
+% at 6.2.0 also background color is possible, but it then triggers
+% usage of the "sphinxheavybox" from sphinxlatexadmonitions.sty.
 \sphinxDeclareSphinxColorOption{noteBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{hintBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{importantBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{tipBorderColor}{{rgb}{0,0,0}}
+\sphinxDeclareSphinxColorOption{noteBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{hintBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{importantBgColor}{{rgb}{1,1,1}}
+\sphinxDeclareSphinxColorOption{tipBgColor}{{rgb}{1,1,1}}
 % admonition boxes, "heavy" style
+% border color defaults to black and background color to white
+% As long as the color are not explicitly set via user options,
+% the sphinxpackageboxes.sty code will actually not use them anyhow.
 \sphinxDeclareSphinxColorOption{warningBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{cautionBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{attentionBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{dangerBorderColor}{{rgb}{0,0,0}}
 \sphinxDeclareSphinxColorOption{errorBorderColor}{{rgb}{0,0,0}}
+% BgColor should have been from the start BackgroundColor for better
+% match with CSS property names, but this is legacy interface
+% which is too late to change because the internal color names
+% and not only the option names have been documented at user level.
 \sphinxDeclareSphinxColorOption{warningBgColor}{{rgb}{1,1,1}}
 \sphinxDeclareSphinxColorOption{cautionBgColor}{{rgb}{1,1,1}}
 \sphinxDeclareSphinxColorOption{attentionBgColor}{{rgb}{1,1,1}}
 \sphinxDeclareSphinxColorOption{dangerBgColor}{{rgb}{1,1,1}}
 \sphinxDeclareSphinxColorOption{errorBgColor}{{rgb}{1,1,1}}
+%%%%%%%%
+%
+% Additions of CSS-like keys at 5.1.0 (and possibility of rounded boxes)
+% -----------------------------------
+%
+% These CSS-named alikes allow to configure 4 border widths, 4 padding seps, 4
+% corner radii, optional shadow, border color, background color, shadow color.
+%
+% In future, an alternative user interface will perhaps be provided to parse
+% genuine CSS, but this will be easier to do in Python than in LaTeX.
+%
+% Refactoring (and extension) at 6.2.0
+% ------------------------------------
+%
+% 6.2.0 batch defines in one go all auxiliaries for code-blocks, topics, and
+% admonitions.  The needed steps to maintain the legacy option names working
+% and to set some specific defaults are handled in a second step.
+%
+% This allowed to:
+%
+% - associate these CSS-named options also to note, hint, important, and tip
+% which thus can access the full customizability of sphinxheavybox if they use
+% it.
+%
+% - provide a \sphinxbox command for boxing inline text elements with the same
+% full customizability.
+%
+% The \dimen's \sphinxverbatimborder, \sphinxverbatimsep, \sphinxshadowsep,
+% \sphinxshadowsize, and \sphinxshadowrule, which had been deprecated have
+% finally been removed entirely.  No more \dimen register is used here only
+% storage in macros.
+%
+\def\spxstring@none{none}
+\def\spxstring@clone{clone}
+%
+% Border keys
+%
+\def\spx@tempa#1{% #1 = macro prefix
+  \expandafter\spx@tempb
+  \csname #1border\expandafter\endcsname
+  \csname #1border@top\expandafter\endcsname
+  \csname #1border@right\expandafter\endcsname
+  \csname #1border@bottom\expandafter\endcsname
+  \csname #1border@left\expandafter\endcsname
+  \csname if#1border@open\expandafter\endcsname
+  \csname #1border@opentrue\expandafter\endcsname
+  \csname #1border@openfalse\endcsname
+}%
+\def\spx@tempb #1#2#3#4#5#6#7#8#9{% #9 = option prefix
+  \define@key{sphinx}{#9border-top-width}{\def#2{##1}}%
+  \define@key{sphinx}{#9border-right-width}{\def#3{##1}}%
+  \define@key{sphinx}{#9border-bottom-width}{\def#4{##1}}%
+  \define@key{sphinx}{#9border-left-width}{\def#5{##1}}%
+  \define@key{sphinx}{#9border-width}{%
+    \def#1{##1}% MEMO: not immediately expanded, should this be changed?
+    \def#2{#1}\let#3#2\let#4#2\let#5#2%
+    }%
+  \newif#6%
+  \define@key{sphinx}{#9box-decoration-break}%
+           {\begingroup\edef\spx@tempa{##1}\expandafter\endgroup
+            \ifx\spx@tempa\spxstring@clone#8\else#7\fi}%
+  \spx@tempc{#9}% option prefix
+}
+\def\spx@tempc #1#2{% #1 = option prefix, #2 = legacy option name
+  % keep legacy option names as aliases to new-named options
+  \expandafter\let\csname KV@sphinx@#2\expandafter\endcsname
+                  \csname KV@sphinx@#1border-width\endcsname
+  % init border-width (fetches next argument)
+  \csname KV@sphinx@#1border-width\endcsname
+}
+% MEMO: prior to 6.2.0 the \fboxrule value (0.4pt, a priori) was frozen here via
+% a \dimen assignment done immediately. Now it remains \fboxrule until being used.
+%          macro prefix   option prefix   legacy option    init value
+\spx@tempa{spx@pre@}      {pre_}          {verbatimborder} \fboxrule
+\spx@tempa{spx@topic@}    {div.topic_}    {shadowrule}     \fboxrule
+\spx@tempa{spx@note@}     {div.note_}     {noteborder}     {0.5pt}
+\spx@tempa{spx@hint@}     {div.hint_}     {hintborder}     {0.5pt}
+\spx@tempa{spx@important@}{div.important_}{importantborder}{0.5pt}
+\spx@tempa{spx@tip@}      {div.tip_}      {tipborder}      {0.5pt}
+\spx@tempa{spx@warning@}  {div.warning_}  {warningborder}  {1pt}
+\spx@tempa{spx@caution@}  {div.caution_}  {cautionborder}  {1pt}
+\spx@tempa{spx@attention@}{div.attention_}{attentionborder}{1pt}
+\spx@tempa{spx@danger@}   {div.danger_}   {dangerborder}   {1pt}
+\spx@tempa{spx@error@}    {div.error_}    {errorborder}    {1pt}
+% this one new at 6.2.0: (we do not create a "legacy name" for it)
+\spx@tempa{spx@box@}      {box_}          {box_border-width}\fboxrule
+% Set default box-decoration-break style for codeblocks to slice
+\spx@pre@border@opentrue % new default at 6.0.0: slice, not clone
+% 6.2.0 has added support for box-decoration-break=slice to all
+% other directives, formerly the option setting was ignored for them.
+
+% Padding keys
+%
+\def\spx@tempa#1{%
+  \expandafter\spx@tempb
+  \csname #1padding\expandafter\endcsname
+  \csname #1padding@top\expandafter\endcsname
+  \csname #1padding@right\expandafter\endcsname
+  \csname #1padding@bottom\expandafter\endcsname
+  \csname #1padding@left\endcsname
+}%
+\def\spx@tempb #1#2#3#4#5#6{% #6 = option prefix
+  \define@key{sphinx}{#6padding-top}{\def#2{##1}}%
+  \define@key{sphinx}{#6padding-right}{\def#3{##1}}%
+  \define@key{sphinx}{#6padding-bottom}{\def#4{##1}}%
+  \define@key{sphinx}{#6padding-left}{\def#5{##1}}%
+  \define@key{sphinx}{#6padding}{%
+     \def#1{##1}%
+     \def#2{#1}\let#3#2\let#4#2\let#5#2%
+  }%
+  % initialization (will fetch "init" argument next):
+  \csname KV@sphinx@#6padding\endcsname
+}
+% MEMO: prior to 6.2.0 the \fboxsep value (3pt, a priori) was frozen here via
+% a \dimen assignment done immediately. Now it remains \fboxsep until being used.
+%         #1 macro prefix #6 option prefix  init value
+\spx@tempa{spx@pre@}      {pre_}            \fboxsep
+\spx@tempa{spx@topic@}    {div.topic_}      {5pt}
+% MEMO: prior to 6.2.0, "note" type admonitions used sphinxlightbox automatically
+% and had no interface to set the padding parameters needed by sphinxheavybox.
+% At 6.2.0 they acquired such interface and the default is set as for legacy
+% default of "warning" type.  I hesitated using \fboxsep, but if I did I would
+% then need to explain how to change "note etc..." into behaving exactly
+% as "warning etc...", which goes via the \dimexpr here which is too scary to
+% put sanely into documentation.
+\spx@tempa{spx@note@}     {div.note_}       {\dimexpr.6\baselineskip-\spx@note@border\relax}
+\spx@tempa{spx@hint@}     {div.hint_}       {\dimexpr.6\baselineskip-\spx@hint@border\relax}
+\spx@tempa{spx@important@}{div.important_}  {\dimexpr.6\baselineskip-\spx@important@border\relax}
+\spx@tempa{spx@tip@}      {div.tip_}        {\dimexpr.6\baselineskip-\spx@tip@border\relax}
+% MEMO: prior to 5.1.0 padding was not separately customizable from border
+% width for warning type admonitions.  The below keeps the legacy behavior of a
+% constant borderwidth+padding.  The dim expression is not evaluated yet, only
+% at time of use (so that it dynamically adapts to the border width setting).
+% MEMO: I could use everywhere \spx@notice@border, as sphinxadmonition environment
+% configures it to hold the \spx@<type>@border value.
+\spx@tempa{spx@warning@}  {div.warning_}    {\dimexpr.6\baselineskip-\spx@warning@border\relax}
+\spx@tempa{spx@caution@}  {div.caution_}    {\dimexpr.6\baselineskip-\spx@caution@border\relax}
+\spx@tempa{spx@attention@}{div.attention_}  {\dimexpr.6\baselineskip-\spx@attention@border\relax}
+\spx@tempa{spx@danger@}   {div.danger_}     {\dimexpr.6\baselineskip-\spx@danger@border\relax}
+\spx@tempa{spx@error@}    {div.error_}      {\dimexpr.6\baselineskip-\spx@error@border\relax}
+\spx@tempa{spx@box@}      {box_}            \fboxsep
+% define legacy verbatimsep key as alias of pre_padding key
+\expandafter\let\expandafter\KV@sphinx@verbatimsep\csname KV@sphinx@pre_padding\endcsname
+% define legacy shadowsep key as alias of div.topic_padding key
+\expandafter\let\expandafter\KV@sphinx@shadowsep\csname KV@sphinx@div.topic_padding\endcsname
+
+% Corner radii keys
+%
+% Prior to 6.2.0, the "rounded box" branch obeyed the 4 radii but ignored
+% the separate border widths and used only the border-width setting.
+% Now, all 4 + 4 parameters are obeyed.
+\def\spx@tempa#1{% #1 = macro prefix
+  \expandafter\spx@tempb
+  \csname #1radius@topleft\expandafter\endcsname
+  \csname #1radius@topright\expandafter\endcsname
+  \csname #1radius@bottomright\expandafter\endcsname
+  \csname #1radius@bottomleft\endcsname
+}%
+\def\spx@tempb #1#2#3#4#5{% #5 = option prefix
+  \define@key{sphinx}{#5border-top-left-radius}{\def#1{##1}}%
+  \define@key{sphinx}{#5border-top-right-radius}{\def#2{##1}}%
+  \define@key{sphinx}{#5border-bottom-right-radius}{\def#3{##1}}%
+  \define@key{sphinx}{#5border-bottom-left-radius}{\def#4{##1}}%
+  \define@key{sphinx}{#5border-radius}{\def#1{##1}\let#2#1\let#3#1\let#4#1}%
+  \csname KV@sphinx@#5border-radius\endcsname % fetches next argument
+}
+% The init value for corner radius in code-blocks was \z@ (i.e. 0pt) prior
+% to 6.0.0., then 3pt, then \fboxsep at 6.2.0 as padding is \fboxsep,
+% and \fboxsep=3pt per default (also with platex).
+%          macro prefix    option prefix     init value
+\spx@tempa{spx@pre@}      {pre_}            \fboxsep
+\spx@tempa{spx@topic@}    {div.topic_}      \z@
+\spx@tempa{spx@note@}     {div.note_}       \z@
+\spx@tempa{spx@hint@}     {div.hint_}       \z@
+\spx@tempa{spx@important@}{div.important_}  \z@
+\spx@tempa{spx@tip@}      {div.tip_}        \z@
+\spx@tempa{spx@warning@}  {div.warning_}    \z@
+\spx@tempa{spx@caution@}  {div.caution_}    \z@
+\spx@tempa{spx@attention@}{div.attention_}  \z@
+\spx@tempa{spx@danger@}   {div.danger_}     \z@
+\spx@tempa{spx@error@}    {div.error_}      \z@
+\spx@tempa{spx@box@}      {box_}            \fboxsep
+
+% Shadow keys
+%
+% Prior to 6.2.0, an "inset" shadow caused the rendering to ignore
+% rounded corners.  Starting with 6.2.0, an "inset" shadow is simply
+% ignored (not implemented) if any of the corner radii is positive,
+% rather than forcing a rectangle+inset shadow output.
+\def\spx@tempa#1{%
+  \expandafter\spx@tempb
+  \csname if#1withshadow\expandafter\endcsname
+  \csname if#1insetshadow\endcsname
+}%
+\def\spx@tempb#1#2{\newif#1\newif#2}%
+%          macro prefix
+\spx@tempa{spx@pre@}
+\spx@tempa{spx@topic@}
+\spx@tempa{spx@note@}
+\spx@tempa{spx@hint@}
+\spx@tempa{spx@important@}
+\spx@tempa{spx@tip@}
+\spx@tempa{spx@warning@}
+\spx@tempa{spx@caution@}
+\spx@tempa{spx@attention@}
+\spx@tempa{spx@danger@}
+\spx@tempa{spx@error@}
+\spx@tempa{spx@box@}
+%
+\def\spx@tempa#1{% #1 = macro prefix
+  \expandafter\spx@tempb
+  \csname #1withshadowtrue\expandafter\endcsname
+  \csname #1withshadowfalse\expandafter\endcsname
+  \csname #1insetshadowtrue\expandafter\endcsname
+  \csname #1insetshadowfalse\expandafter\endcsname
+  \csname #1shadow@setter\expandafter\endcsname
+  \csname #1shadow@xoffset\expandafter\endcsname
+  \csname #1shadow@yoffset\endcsname
+}%
+\def\spx@tempb#1#2#3#4#5#6#7#8{% #8 = option prefix
+  \define@key{sphinx}{#8box-shadow}{#5##1 {} {} \@nnil}%
+  \def#5##1 ##2 ##3 ##4\@nnil{%
+  \begingroup\edef\spx@tempa{##1}\expandafter\endgroup
+  \ifx\spx@tempa\spxstring@none
+        #2%
+        % MEMO: at 5.1.0 and up to 6.2.0, an \edef with \number\dimexpr was
+        % used here.  Since 6.2.0, expansion is delayed to time of use as for
+        % the other dimensions handled above.  This is synched with an added
+        % encapsulation in \dimexpr...\relax by the "setup" from
+        % sphinxpackageboxes.sty.  An induced regression had to be fixed in
+        % the sphinxShadowBox environment as it was using in an \ifdim the
+        % \spx@topic@shadow@yoffset macro, now holding by default 4pt+\z@
+        % rather than an already digested 262144sp.  The +\z@ is in case ##2
+        % is empty.
+  \else #1%
+        \def#6{##1}\def#7{##2+\z@}%
+        \if\relax\detokenize{##3}\relax#4\else#3\fi
+  \fi
+  }%
+  #5none {} {} \@nnil % no shadow by default (except for topic, see below)
+}
+\spx@tempa{spx@pre@}      {pre_}
+\spx@tempa{spx@topic@}    {div.topic_}
+% This corresponds to the legacy parameters of ShadowBox
+    \spx@topic@shadow@setter 4pt 4pt {} \@nnil
+\spx@tempa{spx@note@}     {div.note_}
+\spx@tempa{spx@hint@}     {div.hint_}
+\spx@tempa{spx@important@}{div.important_}
+\spx@tempa{spx@tip@}      {div.tip_}
+\spx@tempa{spx@warning@}  {div.warning_}
+\spx@tempa{spx@caution@}  {div.caution_}
+\spx@tempa{spx@attention@}{div.attention_}
+\spx@tempa{spx@danger@}   {div.danger_}
+\spx@tempa{spx@error@}    {div.error_}
+\spx@tempa{spx@box@}      {box_}
+
+% Support for legacy shadowsize (topic/contents)
+% This definition was broken due to a typo at 5.1.0 and got fixed at 6.1.2
+% MEMO: at 6.2.0 this no longer does \number\dimexpr in an \edef.  Reason is to
+% keep in sync with div.topic_box-shadow handling of xoffset and yoffset.
+% Attention in particular to \ifdim context, we add a \dimexpr to the one here.
+\define@key{sphinx}{shadowsize}{%
+  \def\spx@topic@shadow@xoffset{#1}%
+  \let\spx@topic@shadow@yoffset\spx@topic@shadow@xoffset
+  \ifdim\dimexpr\spx@topic@shadow@xoffset=\z@
+      \spx@topic@withshadowfalse
+  \else
+      \spx@topic@withshadowtrue
+      \spx@topic@insetshadowfalse
+  \fi
+}%
+
+% Color keys
+% (four of them: border, background, shadow and the text color)
+%
+% Some problems due to legacy naming scheme which had diverging conventions
+% for code-blocks (VerbatimBorderColor, VerbatimColor) and admonitions
+% (sphinxwarningBorderColor, sphinxwarningBgColor, etc...)  regarding the
+% internal names of the used colors.  Unfortunately VerbatimColor and for
+% example sphinxwarningBgColor are also documented at user level, they are not
+% only internally used.
+%
+% For topic directive, "legacy" (by this I mean Sphinx around 2016-2017 after
+% my first additions to LaTeX) had no interface for colors, so I could change
+% some internals with no breakage during 5.x up to 6.2.0.  So topic
+% (shadowbox) could be unified with admonitions (sphinxheavybox), and the
+% "set-up" macros could all be moved into a single one in the
+% sphinxpackageboxes.sty file, with only one argument holding the directive
+% type.
+%
+% It was then needed only for sphinxlatexliterals.sty to let its
+% \spx@verb@boxes@fcolorbox@setup incorporate some extra adjustment.
+%
+% We associate a boolean to each color, so that the box code can
+% decide to insert a \color command or consider it is not needed.
+\def\spx@tempa#1{%
+  \expandafter\spx@tempb
+  \csname if#1withshadowcolor\expandafter\endcsname
+  \csname if#1withbordercolor\expandafter\endcsname
+  \csname if#1withbackgroundcolor\expandafter\endcsname
+  \csname if#1withtextcolor\endcsname
+}%
+\def\spx@tempb#1#2#3#4{\newif#1\newif#2\newif#3\newif#4}%
+%          macro prefix
+\spx@tempa{spx@pre@}
+\spx@tempa{spx@topic@}
+\spx@tempa{spx@note@}
+\spx@tempa{spx@hint@}
+\spx@tempa{spx@important@}
+\spx@tempa{spx@tip@}
+\spx@tempa{spx@warning@}
+\spx@tempa{spx@caution@}
+\spx@tempa{spx@attention@}
+\spx@tempa{spx@danger@}
+\spx@tempa{spx@error@}
+\spx@tempa{spx@box@}
+%
+\def\spx@tempa#1{% #1 = macro prefix
+  \expandafter\spx@tempb
+  \csname #1withbordercolortrue\expandafter\endcsname
+  \csname #1withbackgroundcolortrue\expandafter\endcsname
+  \csname #1withshadowcolortrue\expandafter\endcsname
+  \csname #1withtextcolortrue\endcsname
+}
+\def\spx@tempb#1#2#3#4#5#6{% #5 = option prefix, #6 = color name prefix
+  \define@key{sphinx}{#5border-TeXcolor}%
+     {#1\spx@defineorletcolor{#6BorderColor}##1\relax}%
+  \define@key{sphinx}{#5background-TeXcolor}%
+     {#2\spx@defineorletcolor{#6BgColor}##1\relax}%
+  \define@key{sphinx}{#5box-shadow-TeXcolor}%
+     {#3\spx@defineorletcolor{#6ShadowColor}##1\relax}%
+  \define@key{sphinx}{#5TeXcolor}%
+     {#4\spx@defineorletcolor{#6TextColor}##1\relax}%
+}
+%          macro prefix    option prefix    color name prefix
+\spx@tempa{spx@pre@}      {pre_}            {Verbatim}
+    % (memo: internal VerbatimShadowColor was formerly sphinxVerbatimShadowColor)
+    % internal legacy color name is VerbatimColor not VerbatimBgColor, so redefine:
+    \define@key{sphinx}{pre_background-TeXcolor}%
+      {\spx@pre@withbackgroundcolortrue\spx@defineorletcolor{VerbatimColor}#1\relax}%
+    \spx@pre@withbordercolortrue        % 6.0.0 VerbatimBorderColor {RGB}{32,32,32}
+    \spx@pre@withbackgroundcolortrue    % 6.0.0 VerbatimColor       {gray}{0.95}
+    % Keep legacy option names working
+    \expandafter\let\expandafter\KV@sphinx@VerbatimBorderColor
+                                \csname KV@sphinx@pre_border-TeXcolor\endcsname
+    \expandafter\let\expandafter\KV@sphinx@VerbatimColor
+                                \csname KV@sphinx@pre_background-TeXcolor\endcsname
+% (6.2.0 modified some internal namings for the colors of topic boxes)
+%          macro prefix   option prefix     color name prefix
+\spx@tempa{spx@topic@}    {div.topic_}      {sphinxtopic}% (no legacy interface)
+\spx@tempa{spx@note@}     {div.note_}       {sphinxnote}
+\spx@tempa{spx@hint@}     {div.hint_}       {sphinxhint}
+\spx@tempa{spx@important@}{div.important_}  {sphinximportant}
+\spx@tempa{spx@tip@}      {div.tip_}        {sphinxtip}
+\spx@tempa{spx@warning@}  {div.warning_}    {sphinxwarning}
+\spx@tempa{spx@caution@}  {div.caution_}    {sphinxcaution}
+\spx@tempa{spx@attention@}{div.attention_}  {sphinxattention}
+\spx@tempa{spx@danger@}   {div.danger_}     {sphinxdanger}
+\spx@tempa{spx@error@}    {div.error_}      {sphinxerror}
+\spx@tempa{spx@box@}      {box_}            {sphinxbox}
+    % Keep legacy sphinxsetup color options interface for "strong" admonitions
+    \def\spx@tempa#1#2{% #1 = option prefix, #2 = legacy option prefix
+      \expandafter\let\csname KV@sphinx@#2BorderColor\expandafter\endcsname
+                      \csname KV@sphinx@#1border-TeXcolor\endcsname
+      \expandafter\let\csname KV@sphinx@#2BgColor\expandafter\endcsname
+                      \csname KV@sphinx@#1background-TeXcolor\endcsname
+    }
+    \spx@tempa{div.warning_}    {warning}
+    \spx@tempa{div.caution_}    {caution}
+    \spx@tempa{div.attention_}  {attention}
+    \spx@tempa{div.danger_}     {danger}
+    \spx@tempa{div.error_}      {error}
+
+    % Keep legacy sphinxsetup <type>BorderColor for <type>=note, hint, ...
+    % which will not trigger sphinxheavybox
+    % Add "legacy" hintTextColor etc... that will not trigger sphinxheavybox
+    \def\spx@tempa#1#2{% #1 = CSS like option prefix, #2 = legacy option prefix
+      \expandafter\let\csname KV@sphinx@#2BorderColor\expandafter\endcsname
+                      \csname KV@sphinx@#1border-TeXcolor\endcsname
+      \expandafter\let\csname KV@sphinx@#2TextColor\expandafter\endcsname
+                      \csname KV@sphinx@#1TeXcolor\endcsname
+    }
+    \spx@tempa{div.note_}       {note}
+    \spx@tempa{div.hint_}       {hint}
+    \spx@tempa{div.important_}  {important}
+    \spx@tempa{div.tip_}        {tip}
+
+% The TeXextras key
+%
+\def\spx@tempa#1{% #1 = macro prefix
+  \expandafter\spx@tempb\csname #1TeXextras\endcsname
+}
+\def\spx@tempb#1#2{% #2 = option prefix
+  \define@key{sphinx}{#2TeXextras}{\def#1{##1}}%
+}
+%          macro prefix   option prefix
+\spx@tempa{spx@pre@}      {pre_}
+\spx@tempa{spx@topic@}    {div.topic_}
+\spx@tempa{spx@note@}     {div.note_}
+\spx@tempa{spx@hint@}     {div.hint_}
+\spx@tempa{spx@important@}{div.important_}
+\spx@tempa{spx@tip@}      {div.tip_}
+\spx@tempa{spx@warning@}  {div.warning_}
+\spx@tempa{spx@caution@}  {div.caution_}
+\spx@tempa{spx@attention@}{div.attention_}
+\spx@tempa{spx@danger@}   {div.danger_}
+\spx@tempa{spx@error@}    {div.error_}
+\spx@tempa{spx@box@}      {box_}
+    % Add "legacy" hintTeXextras etc... that will not trigger sphinxheavybox
+    \def\spx@tempa#1#2{% #1 = CSS like option prefix, #2 = legacy option prefix
+      \expandafter\let\csname KV@sphinx@#2TeXextras\expandafter\endcsname
+                      \csname KV@sphinx@#1TeXextras\endcsname
+    }
+    \spx@tempa{div.note_}       {note}
+    \spx@tempa{div.hint_}       {hint}
+    \spx@tempa{div.important_}  {important}
+    \spx@tempa{div.tip_}        {tip}
+
+% For note type admonitions, redefine all CSS-like named options to trigger
+% the "heavybox" path.
+%
+% MEMO: the noteBorderColor and noteborder legacy options have already been
+% re-created and they do not trigger the "heavybox" as their meaning will not
+% be modified in the loop below contrarily to their CSS counterparts
+% div.note_border-TeXcolor and div.note_border-width, and to the noteBgColor
+% etc... which are handled below.
+%
+% This goes via rather hardcore TeX here.
+\def\spx@tempa#1{\if\relax#1\expandafter\@gobble
+  \else
+    \toks@{##1}%
+    \expandafter\def\csname KV@sphinx@div.note_#1\expandafter\endcsname
+        \the\toks0\expandafter{%
+        \csname spx@opt@heavynotetrue\expandafter\expandafter\expandafter\endcsname
+        \csname KV@sphinx@div.note_#1\endcsname{##1}}%
+    \expandafter\def\csname KV@sphinx@div.hint_#1\expandafter\endcsname
+        \the\toks0\expandafter{%
+        \csname spx@opt@heavyhinttrue\expandafter\expandafter\expandafter\endcsname
+        \csname KV@sphinx@div.hint_#1\endcsname{##1}}%
+    \expandafter\def\csname KV@sphinx@div.important_#1\expandafter\endcsname
+        \the\toks0\expandafter{%
+        \csname spx@opt@heavyimportanttrue\expandafter\expandafter\expandafter\endcsname
+        \csname KV@sphinx@div.important_#1\endcsname{##1}}%
+    \expandafter\def\csname KV@sphinx@div.tip_#1\expandafter\endcsname
+        \the\toks0\expandafter{%
+        \csname spx@opt@heavytiptrue\expandafter\expandafter\expandafter\endcsname
+        \csname KV@sphinx@div.tip_#1\endcsname{##1}}%
+  \fi
+  \spx@tempa
+}
+\spx@tempa{border-width}%
+          {border-top-width}{border-right-width}{border-bottom-width}{border-left-width}%
+          {box-decoration-break}%
+          {padding}%
+          {padding-top}{padding-right}{padding-bottom}{padding-left}%
+          {border-radius}%
+          {border-top-left-radius}{border-top-right-radius}%
+          {border-bottom-right-radius}{border-bottom-left-radius}%
+          {box-shadow}%
+          {border-TeXcolor}{background-TeXcolor}{box-shadow-TeXcolor}{TeXcolor}%
+          {TeXextras}%
+\relax
+
+% Now we add at 6.2.0 <type>BgColor et al. options which will trigger the
+% "heavybox" as they are \let to the div.<type>_background-TeXColor option
+% which has already been enhanced to set the boolean for rendering via
+% "heavybox".  This is in contrast with legacy <type>BorderColor,
+% and with the new <type>TeXcolor and <type>TeXextras.
+    \def\spx@tempa#1#2{% #1 = CSS like option prefix, #2 = legacy style option prefix
+      \expandafter\let\csname KV@sphinx@#2BgColor\expandafter\endcsname
+                      \csname KV@sphinx@#1background-TeXcolor\endcsname
+    }
+    \spx@tempa{div.note_}       {note}
+    \spx@tempa{div.hint_}       {hint}
+    \spx@tempa{div.important_}  {important}
+    \spx@tempa{div.tip_}        {tip}
+
+\newif\ifspx@opt@box@addstrut
+\expandafter\def\csname KV@sphinx@box_addstrut\endcsname#1{%
+    \csname spx@opt@box@addstrut#1\endcsname
+}
+\expandafter\def\csname KV@sphinx@box_addstrut@default\endcsname{%
+    \spx@opt@box@addstruttrue
+}
 
 \DeclareDefaultOption{\@unknownoptionerror}
 \ProcessKeyvalOptions*
@@ -175,6 +784,9 @@
 \DisableKeyvalOption{sphinx}{numfigreset}
 \DisableKeyvalOption{sphinx}{nonumfigreset}
 \DisableKeyvalOption{sphinx}{mathnumfig}
+\DisableKeyvalOption{sphinx}{booktabs}
+\DisableKeyvalOption{sphinx}{borderless}
+\DisableKeyvalOption{sphinx}{rowcolors}
 % FIXME: this is unrelated to an option, move this elsewhere
 % To allow hyphenation of first word in narrow contexts; no option,
 % customization to be done via 'preamble' key
@@ -182,7 +794,7 @@
 % No need for the \hspace{0pt} trick (\hskip\z@skip) with luatex
 \ifdefined\directlua\let\sphinxAtStartPar\@empty\fi
 % user interface: options can be changed midway in a document!
-\newcommand\sphinxsetup1{\setkeys{sphinx}{#1}}
+\newcommand\sphinxsetup{\setkeys{sphinx}}
 
 
 %% MISCELLANEOUS CONTEXT
@@ -265,6 +877,63 @@
 
 %% FRAMED ENVIRONMENTS
 %
+% \sphinxbox added at 6.2.0, its definition is in sphinxpackageboxes.
+%
+% Alias all \sphinxsetup "box_" keys to become \sphinxboxsetup no-prefix keys
+\@tfor\x:={border-width}%
+          {border-top-width}{border-right-width}{border-bottom-width}{border-left-width}%
+          {box-decoration-break}% This one is actually useless, as \sphinxbox
+          % creates an unbreakable horizontal box, not a breakable vertical
+          % box.  And as is well-known it is very complicated (not to say
+          % impossible) to create in LaTeX breakable horizontal boxes.  No
+          % package offers them.  See the complications for the support of
+          % verbatimforcewraps in sphinxlatexliterals.sty or see the source
+          % code of the soul or soulutf8 packages.
+          {padding}%
+          {padding-top}{padding-right}{padding-bottom}{padding-left}%
+          {border-radius}%
+          {border-top-left-radius}{border-top-right-radius}%
+          {border-bottom-right-radius}{border-bottom-left-radius}%
+          {box-shadow}%
+          {border-TeXcolor}{background-TeXcolor}{box-shadow-TeXcolor}{TeXcolor}%
+          {TeXextras}{addstrut}{addstrut@default}%
+\do{\expandafter\let\csname KV@sphinxbox@\x\expandafter\endcsname
+                    \csname KV@sphinx@box_\x\endcsname}
+% Let \sphinxboxsetup also prepare a "reset", which will be used by nested
+% boxes; currently and by laziness this is implemented simply by accumulating
+% all passed options inside some storage, in the order they were given, rather
+% than saving the box would-be parameters.  Advantage is that this will not
+% have to be modified if additional keys are added in future (e.g. for
+% elliptic corners).  Storing obeys TeX groups.  (these details would be
+% relevant only for some genuine independent LaTeX package and manual user
+% authored mark-up, not Sphinx auto mark-up).
+\newcommand\sphinxboxsetup1{%
+    \setkeys{sphinxbox}{#1}%
+    \expandafter\def\expandafter\spx@boxes@sphinxbox@defaults\expandafter
+       {\spx@boxes@sphinxbox@defaults,#1}%
+}
+\def\spx@boxes@sphinxbox@reset{%
+  \begingroup\def\x{\endgroup\setkeys{sphinxbox}}%
+  \expandafter\x\expandafter{\spx@boxes@sphinxbox@defaults}%
+}
+% Some of these defaults got already set.  But we now list them all explicitly
+% for a complete initial configuration of reset storage.
+%
+\let\spx@boxes@sphinxbox@defaults\@gobble
+\sphinxboxsetup{%
+                border-width=\fboxrule,% <-not really needed to avoid EOL space
+                padding=\fboxsep,%         but done here out of habit
+                border-radius=\fboxsep,%
+                box-shadow=none,%
+% As xcolor is perhaps not loaded we can not use background-TeXcolor=VerbatimColor
+% which would not be compatible with \definecolor syntax.
+                border-TeXcolor={RGB}{32,32,32},%  the default VerbatimBorderColor
+                background-TeXcolor={gray}{0.95},% the default VerbatimColor
+                box-shadow-TeXcolor={rgb}{0,0,0},%
+                TeXextras={},%
+                addstrut=false% (a final comma here would not hurt)
+               }%
+\RequirePackage{sphinxpackageboxes}
 \input{sphinxlatexadmonitions.sty}
 \input{sphinxlatexliterals.sty}
 \input{sphinxlatexshadowbox.sty}
@@ -298,18 +967,11 @@
 %% FOOTNOTES
 %
 % Support scopes for footnote numbering
+% This is currently stepped at each input file
 \newcounter{sphinxscope}
 \newcommand{\sphinxstepscope}{\stepcounter{sphinxscope}}
-% Explicitly numbered footnotes may be referred to, and for this to be
-% clickable we need to have only one target. So we will step this at each
-% explicit footnote and let \thesphinxscope take it into account
-\newcounter{sphinxexplicit}
-\newcommand{\sphinxstepexplicit}{\stepcounter{sphinxexplicit}}
-% Some babel/polyglossia languages fiddle with \@arabic, so let's be extra
-% cautious and redefine \thesphinxscope with \number not \@arabic.
-% Memo: we expect some subtle redefinition of \thesphinxscope to be a part of page
-% scoping for footnotes, when we shall implement it.
-\renewcommand{\thesphinxscope}{\number\value{sphinxscope}.\number\value{sphinxexplicit}}
+% We ensure \thesphinxscope expands to digits tokens, independently of language
+\renewcommand{\thesphinxscope}{\number\value{sphinxscope}}
 \newcommand\sphinxthefootnotemark2{%
    % this is used to make reference to an explicitly numbered footnote not on same page
    % #1=label of footnote text, #2=page number where footnote text was printed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxhowto.cls -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxhowto.cls Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexadmonitions.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexadmonitions.sty Changed

@@ -1,14 +1,17 @@
 %% NOTICES AND ADMONITIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexadmonitions.sty}2021/01/27 admonitions
+\ProvidesFile{sphinxlatexadmonitions.sty}2023/03/19 admonitions
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
+% - sphinxseealso environment added at 6.1.0
+%
 % - sphinxadmonition (environment)
 %   This is a dispatch supporting
 %
 %   - note, hint, important, tip                 (via sphinxlightbox)
+%                    (also optionally via sphinxheavybox since 6.2.0)
 %   - warning, caution, attention, danger, error (via sphinxheavybox)
 %
 %   Each sphinx<notice name> environment can be redefined by user.
@@ -16,13 +19,22 @@
 %   settings, cf sphinx docs (latex customization).
 %
 % Requires:
+\RequirePackage{sphinxpackageboxes}
 \RequirePackage{framed}% used by sphinxheavybox
 %
 % Dependencies (they do not need to be defined at time of loading):
+%
 % - of course the various colour and dimension options handled via sphinx.sty
-% - \sphinxstrong (for sphinxlightbox and sphinxheavybox)
+%
 % - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
+%
 % - \savenotes/\spewnotes from sphinxpackagefootnote (for sphinxheavybox)
+%
+% - \sphinxstylenotetitle, ..., \sphinxstylewarningtitle, etc... which are used by
+%   default in the corresponding sphinx<notice> environments to replace at 6.2.0
+%   formerly hard-coded \sphinxstrong{#1}<space>
+%   Their definitions are in sphinxlatexstyletext.sty.
+
 
 % Provides: (also in sphinxlatexliterals.sty)
 \providecommand*\sphinxvspacefixafterfrenchlists{%
@@ -30,11 +42,17 @@
 }
 
 % Some are quite plain
-% the spx@notice@bordercolor etc are set in the sphinxadmonition environment
+\newenvironment{sphinxseealso}1{\sphinxstyleseealsotitle{#1}}{}
+
+% This \dimen register is a legacy relic from Sphinx 1.5 which is used now
+% only for sphinxlightbox.  It is set in the sphinxadmonition environment.
+\newdimen\spx@notice@border
+
 \newenvironment{sphinxlightbox}{%
   \par
   \noindent{\color{spx@notice@bordercolor}%
-            \rule{\linewidth}{\spx@notice@border}}\par\nobreak
+            \rule{\linewidth}{\spx@notice@border}}%
+  \par\nobreak
   {\parskip\z@skip\noindent}%
   }
   {%
@@ -46,44 +64,98 @@
        \rule\dimexpr.4\baselineskip-\spx@notice@border\relax
              {\linewidth}{\spx@notice@border}}\hss}\allowbreak
   }% end of sphinxlightbox environment definition
-% may be renewenvironment'd by user for complete customization
+
+% note/hint/important/tip notices
+%
+% Since 1.5 these environments are named individually to allow user to
+% redefine them entirely.
+%
+% The Sphinx definitions were done like this, prior to 6.2.0:
+%
+% \newenvironment{sphinxhint}1
+%   {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+%
+% The more complex definition below will branch to sphinxheavybox if a certain
+% boolean associated to the notice type is true.  This boolean is set to true
+% whenever a CSS-named alike options for the notice type has been used in
+% sphinxsetup.  The old coding as above would still work, with the new options
+% being then simply ignored.  A user redefinition will probably either use
+% directly sphinxlightbox or sphinxheavybox or something else, with no need to
+% test the boolean.
+%
+% 6.2.0 also adds one layer of mark-up via \sphinxnotetitle etc..., because
+% the former \sphinxstrong{#1}<space> used a too generic \sphinxstrong.  But
+% perhaps the #1 should be passed over to sphinx{light,heavy}box as parameter.
+% Unfortunately replacing these environments with one-parameter environments
+% would be potentially a breaking change.  Anyway, sphinxpackageboxes.sty does not
+% provide a "titled" box; the caption of code-blocks is handled by extra
+% code in sphinxVerbatim.
 \newenvironment{sphinxnote}1
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+  {\edef\spx@env{sphinx\ifspx@opt@heavynote heavy\else light\fi box}%
+   \expandafter\begin\expandafter{\spx@env}\sphinxstylenotetitle{#1}}
+  {\expandafter\end\expandafter{\spx@env}}
 \newenvironment{sphinxhint}1
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+  {\edef\spx@env{sphinx\ifspx@opt@heavyhint heavy\else light\fi box}%
+   \expandafter\begin\expandafter{\spx@env}\sphinxstylehinttitle{#1}}
+  {\expandafter\end\expandafter{\spx@env}}
 \newenvironment{sphinximportant}1
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
+  {\edef\spx@env{sphinx\ifspx@opt@heavyimportant heavy\else light\fi box}%
+   \expandafter\begin\expandafter{\spx@env}\sphinxstyleimportanttitle{#1}}
+  {\expandafter\end\expandafter{\spx@env}}
 \newenvironment{sphinxtip}1
-  {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
-% or just use the package options
-% these are needed for common handling by notice environment of lightbox
-% and heavybox but they are  currently not used by lightbox environment
-% and there is consequently no corresponding package option
-\definecolor{sphinxnoteBgColor}{rgb}{1,1,1}
-\definecolor{sphinxhintBgColor}{rgb}{1,1,1}
-\definecolor{sphinximportantBgColor}{rgb}{1,1,1}
-\definecolor{sphinxtipBgColor}{rgb}{1,1,1}
+  {\edef\spx@env{sphinx\ifspx@opt@heavytip heavy\else light\fi box}%
+   \expandafter\begin\expandafter{\spx@env}\sphinxstyletiptitle{#1}}
+  {\expandafter\end\expandafter{\spx@env}}
 
-% Others get more distinction
+% warning/caution/attention/danger/error  get more distinction
+%
 % Code adapted from framed.sty's "snugshade" environment.
 % Nesting works (inner frames do not allow page breaks).
 \newenvironment{sphinxheavybox}{\par
-   \setlength{\FrameRule}{\spx@notice@border}%
-   \setlength{\FrameSep}{\dimexpr.6\baselineskip-\FrameRule\relax}
+   % 6.2.0 allows to not have to distinguish here between warning type notices
+   % which always use sphinxheavybox or note type notices which might use it.
+   % (MEMO: it is not a problem here if there is no sphinx<type>ShadowColor,
+   %  as it used only if set)
+   \spx@boxes@fcolorbox@setup{\spx@noticetype}%
+   % Those are used by sphinxVerbatim if the \ifspx@inframed boolean is true
+   \setlength{\FrameRule}{0.5\dimexpr\spx@boxes@border@top+\spx@boxes@border@bottom\relax}%
+   % MEMO: prior to 5.1.0 \FrameSep was determined as 0.6\baselineskip -
+   % \FrameRule, and there was no possibility for user to adjust padding.
+   % Then \fcolorbox was used with \fboxrule set to \FrameRule and \fboxsep
+   % set to \FrameSep.
+   % The 5.1.0 default calculation of padding parameters maintains PDF output
+   % identical to legacy behaviour, as long as padding is not set by user.
+   \setlength{\FrameSep}{0.5\dimexpr\spx@boxes@padding@top+\spx@boxes@padding@bottom\relax}%
+   % "setup" macro has prepared the \spx@boxes@... dimen registers
    \advance\spx@image@maxheight
-   -\dimexpr2\FrameRule
-           +2\FrameSep
+   -\dimexpr\spx@boxes@border@top+\spx@boxes@border@bottom
+           +\spx@boxes@padding@top+\spx@boxes@padding@bottom
            +\baselineskip\relax % will happen again if nested, needed indeed!
+   % MEMO: the next comment is before boxing was extended to allow padding and
+   % multiple border-widths, not to mention shadows...
    % configure framed.sty's parameters to obtain same vertical spacing
    % as for "light" boxes. We need for this to manually insert parskip glue and
    % revert a skip done by framed before the frame.
     \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}%
     \vspace{\FrameHeightAdjust}
    % copied/adapted from framed.sty's snugshade
-   \def\FrameCommand##1{\hskip\@totalleftmargin
-       \fboxsep\FrameSep \fboxrule\FrameRule
-       \fcolorbox{spx@notice@bordercolor}{spx@notice@bgcolor}{##1}%
-       \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
+   % but now using in place of \fcolorbox the Sphinx sophisticated own
+   \def\FrameCommand##1{%
+       \hskip\@totalleftmargin
+       % "setup" macro MUST have been called before
+       \spx@boxes@fcolorbox{##1}%
+       \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth
+   }%
+   % 6.2.0 adds support for div.<notice type>_box-decoration-break=slice.
+   % (it is yet undecided if slice style should inhibit a bottom shadow)
+   \csname ifspx@\spx@noticetype @border@open\endcsname
+     \def\FirstFrameCommand
+               {\spx@boxes@fcolorbox@setup@openbottom\FrameCommand}%
+     \def\MidFrameCommand
+               {\spx@boxes@fcolorbox@setup@openboth  \FrameCommand}%
+     \def\LastFrameCommand
+               {\spx@boxes@fcolorbox@setup@opentop   \FrameCommand}%
+   \fi
    \savenotes
    % use a minipage if we are already inside a framed environment
    \ifspx@inframed
@@ -103,9 +175,11 @@
      \let\@listdepth\@mplistdepth \@mplistdepth\z@
      \@minipagerestore
      \@setminipage }%
+   \color@begingroup % workaround to an upstream framed.sty bug
    }
    {%
    \par\unskip
+   \color@endgroup   % matches the \color@begingroup
    \@minipagefalse
    \endMakeFramed
    \ifspx@inframed\end{minipage}\fi
@@ -114,35 +188,55 @@
    % arrange for similar spacing below frame as for "light" boxes.
    \vskip .4\baselineskip
    }% end of sphinxheavybox environment definition
-% may be renewenvironment'd by user for complete customization
+
+% - Since 1.5 these environments are named individually to allow user to
+% redefine them entirely.
+%
+% - Since 5.1.0, sphinxheavybox is more versatile and four border widths, four
+% padding widths, four corner radii, optional shadow, and three colors can all
+% be modified via CSS-named alike options.
+%
+% - Since 6.2.0, also note/hint/important/tip notices can use these options
+% and then they go automatically via sphinxheavybox.  If only the legacy options
+% are used, they keep using sphinxlightbox.
+%
+% - Since 6.2.0, \sphinxwarningtitle etc... add one level of mark-up (they
+% expand to \sphinxstrong{#1}<space> which was former hard-coded mark-up).
+% Example:
+% \renewcommand{\sphinxwarningtitle}1{\textbf{#1}\par\smallskip
+%   {\color{sphinxwarningBorderColor}\hrule height1pt}\smallskip}
 \newenvironment{sphinxwarning}1
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+  {\begin{sphinxheavybox}\sphinxstylewarningtitle{#1}}{\end{sphinxheavybox}}
 \newenvironment{sphinxcaution}1
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+  {\begin{sphinxheavybox}\sphinxstylecautiontitle{#1}}{\end{sphinxheavybox}}
 \newenvironment{sphinxattention}1
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+  {\begin{sphinxheavybox}\sphinxstyleattentiontitle{#1}}{\end{sphinxheavybox}}
 \newenvironment{sphinxdanger}1
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
+  {\begin{sphinxheavybox}\sphinxstyledangertitle{#1}}{\end{sphinxheavybox}}
 \newenvironment{sphinxerror}1
-  {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}}
-% or just use package options
-
-% the \colorlet of xcolor (if at all loaded) is overkill for our use case
-\newcommand{\sphinxcolorlet}2
-    {\expandafter\let\csname\@backslashchar color@#1\expandafter\endcsname
-                     \csname\@backslashchar color@#2\endcsname }
+  {\begin{sphinxheavybox}\sphinxstyleerrortitle{#1}}{\end{sphinxheavybox}}
 
 % the main dispatch for all types of notices
 \newenvironment{sphinxadmonition}2{% #1=type, #2=heading
   % can't use #1 directly in definition of end part
   \def\spx@noticetype {#1}%
-  % set parameters of heavybox/lightbox
+  % those next three are a remnant of legacy code; they are not used at
+  % all by sphinxheavybox, and their usage could be disposed of by sphinxlightbox
+  % but we keep for backward compatibility and also because it may be simpler
+  % for user redefinitions to employ for example "spx@notice@bgcolor" and not
+  % the more bulky "sphinx\spx@noticetype BgColor".
   \sphinxcolorlet{spx@notice@bordercolor}{sphinx#1BorderColor}%
   \sphinxcolorlet{spx@notice@bgcolor}{sphinx#1BgColor}%
-  \spx@notice@border \dimexpr\csname spx@opt@#1border\endcsname\relax
-  % start specific environment, passing the heading as argument
-  \begin{sphinx#1}{#2}}
-  % workaround some LaTeX "feature" of \end command
- {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp}
+  \spx@notice@border \dimexpr\csname spx@#1@border\endcsname\relax
+  % trigger the sphinx<type> environment, #2=heading is passed as argument
+  \begin{sphinx#1}{#2}%
+  % 6.2.0 support of div.<type>_TeX{color,extras} options
+  \csname ifspx@\spx@noticetype @withtextcolor\endcsname
+         \color{sphinx\spx@noticetype TextColor}%
+  \fi
+  \csname spx@\spx@noticetype @TeXextras\endcsname
+  }
+  % workaround some LaTeX "feature" of \end command (can't use "sphinx#1" here)
+  {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp}
 
 \endinput

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexlists.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexlists.sty Changed

@@ -1,13 +1,47 @@
 %% ALPHANUMERIC LIST ITEMS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexlists.sty}2021/01/27 lists
+\ProvidesFile{sphinxlatexlists.sty}2021/12/20 lists
 
 % Provides support for this output mark-up from Sphinx latex writer:
 % - \sphinxsetlistlabels
-
+% - \sphinxlineitem
+% and for the maxlistdepth key of sphinxsetup
 % Dependencies: the \spx@opt@maxlistdepth from sphinx.sty
 
+% We need some helpers macros
+\newtoks\spx@lineitemlabel
+\long\def\sphinx@gobto@sphinxlineitem#1\sphinxlineitem{}
+% TeX/LaTeX has no (easy to use) built-in "peek-ahead" mechanism, but
+% we would like to know if next token is another \sphinxlineitem (this
+% can happen in glossary entries with multiple terms for same definition)
+% so we simply grab next token (assuming it is not {tokens} originally)
+\newcommand\sphinxlineitem2{%
+  % safe test of whether #2 is \sphinxlineitem
+  \sphinx@gobto@sphinxlineitem#2\@gobbletwo\sphinxlineitem\unless
+  \iftrue
+    % case with sphinxlineitem immediately followed by another \sphinxlineitem:
+    % accumulate successive terms until actual definition or sub-list is found
+    \spx@lineitemlabel\expandafter{\the\spx@lineitemlabel\strut#1\\}%
+  \else
+    % now issue the \item command with possibly multi-line contents
+    % these weird incantations with \kern are related to how LaTeX
+    % handles \item generally
+    \item\kern\labelwidth\kern-\itemindent\kern-\leftmargin
+          {\parboxt{\dimexpr\linewidth+\leftmargin\relax}{%
+          \raggedright
+          \the\spx@lineitemlabel% accumulated terms before this one, CR separated
+          \strut#1}}% due to LaTeX internals no \par token allowed here,
+                    % but the \parbox will insert one tacitly at end
+          \kern-\labelsep%
+    \spx@lineitemlabel{}%
+    % this causes the label to be typeset (filling up the line), clearing up
+    % things in case a nested list follows.
+    \leavevmode
+  \fi #2%
+}%
+
+
 \newcommand\sphinxsetlistlabels5
 {% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix
  % #2 and #3 are counters used by enumerate environment e.g. enumi, enumii.

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexliterals.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexliterals.sty Changed

@@ -1,7 +1,7 @@
 %% LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexliterals.sty}2021/12/06 code-blocks and parsed literals
+\ProvidesFile{sphinxlatexliterals.sty}2023/04/01 code-blocks and parsed literals
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
@@ -32,6 +32,8 @@
 % - alltt
 % - upquote
 % - needspace
+% - sphinxpackageboxes
+\RequirePackage{sphinxpackageboxes}
 
 % also in sphinxlatexadmonitions.sty:
 % This is a workaround to a "feature" of French lists, when literal block
@@ -50,8 +52,8 @@
 % 4- while still allowing expansion of Pygments latex mark-up
 % Other aspects such as framing, caption handling, codeline wrapping are
 % added on top of it. We should stop using fancyvrb and implement
-% 1, 2, 3, 4 by own Sphinx fully native Verbatim. This would allow to solve
-% limitations with wrapped long code line not allowing page break.
+% 1, 2, 3, 4 by own Sphinx fully native Verbatim. This would greatly simplify
+% in particular wrapping long code lines in a way allowing page breaks.
 \RequirePackage{fancyvrb}
 % For parsed-literal blocks.
 \RequirePackage{alltt}
@@ -92,77 +94,141 @@
 \newif\ifsphinxverbatimwithminipage   \sphinxverbatimwithminipagefalse
 
 % Framing macro for use with framed.sty's \FrameCommand
+% MEMO: the sophisticated code in \spx@fcolorbox/\spx@CustomFBox
+%       is here for good reasons
+%       - be responsive to indented list environments in the manner of
+%         the "framed" (\fbox) and "shaded" (\colorbox) environments of
+%         framed.sty; indeed code here is an evolution related to \fcolorbox
+%       - attach non-detachable continuation hints above/below frame
+%       - draw the frame and fill the background color in a manner avoiding
+%         problems in some pdf viewers
+%       - do background coloring differently from color.sty/xcolor.sty macros
+%         (even core internal ones) to work around issues at page breaks
+%         as the framed contents are split into chunks with possibly unpaired
+%         "color push" or "color pop"
+% About the produced output:
 %  - it obeys current indentation,
-%  - frame is \fboxsep separated from the contents,
-%  - the contents use the full available text width,
-%  - #1 = color of frame, #2 = color of background,
-%  - #3 = above frame, #4 = below frame, #5 = within frame,
-%  - #3 and #4 must be already typeset boxes; they must issue \normalcolor
-%    or similar, else, they are under scope of color #1
-\long\def\spx@fcolorbox #1#2#3#4#5{%
+%  - frame with 4 padding parameters and 4 border-width parameters
+%  - the contents use the full available text width, limited by indentation,
+%  - #1 = will be typeset above frame, in a non detachable way,
+%  - #2 = will be typeset below frame, in a non detachable way,
+%  - #3 = will be typeset within the frame.
+% #1 and #2 are expected to be already typeset \hbox'es.
+% #3 are the contents, and in the context of usage of fancyvrb+framed,
+% it will arrive here already transformed into horizontal boxes,
+% interline penalties and glues.
+%
+\long\def\spx@verb@FrameCommand #1#2#3{%
+  % The \spx@verb@boxes@fcolorbox@setup MUST have been executed beforehand.
+  % These \hskips are for fancyvrb.sty measuring and will make the
+  % framing "adapt" to an indented context.
   \hskip\@totalleftmargin
-  \hskip-\fboxsep\hskip-\fboxrule
-  % use of \color@b@x here is compatible with both xcolor.sty and color.sty
-  \color@b@x {\color{#1}\spx@CustomFBox{#3}{#4}}{\color{#2}}{#5}%
-  \hskip-\fboxsep\hskip-\fboxrule
+  \hskip-\spx@boxes@border@left\hskip-\spx@boxes@padding@left
+  \spx@verb@fcolorbox {#1}{#2}{#3}%
+  \hskip-\spx@boxes@padding@right\hskip-\spx@boxes@border@right
   \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth
 }%
-% #1 = for material above frame, such as a caption or a "continued" hint
-% #2 = for material below frame, such as a caption or "continues on next page"
-% #3 = actual contents, which will be typeset with a background color
-\long\def\spx@CustomFBox#1#2#3{%
-  \begingroup
-  \setbox\@tempboxa\hbox{{#3}}% inner braces to avoid color leaks
-  \vbox{#1% above frame
-            % draw frame border _latest_ to avoid pdf viewer issue
-            \kern\fboxrule
-            \hbox{\kern\fboxrule
-                  \copy\@tempboxa
-                  \kern-\wd\@tempboxa\kern-\fboxrule
-                  \vrule\@width\fboxrule
-                  \kern\wd\@tempboxa
-                  \vrule\@width\fboxrule}%
-            \kern-\dimexpr\ht\@tempboxa+\dp\@tempboxa+\fboxrule\relax
-            \hrule\@height\fboxrule
-            \kern\dimexpr\ht\@tempboxa+\dp\@tempboxa\relax
-            \hrule\@height\fboxrule
-        #2% below frame
-       }%
-  \endgroup
-}%
-\def\spx@fcolorbox@put@c#1{% hide width from framed.sty measuring
-    \moveright\dimexpr\fboxrule+.5\wd\@tempboxa\hb@xt@\z@{\hss#1\hss}%
-}%
-\def\spx@fcolorbox@put@r#1{% right align with contents, width hidden
-    \moveright\dimexpr\fboxrule+\wd\@tempboxa-\fboxsep\hb@xt@\z@{\hss#1}%
-}%
-\def\spx@fcolorbox@put@l#1{% left align with contents, width hidden
-    \moveright\dimexpr\fboxrule+\fboxsep\hb@xt@\z@{#1\hss}%
+\long\def\spx@verb@fcolorbox #1#2#3{%
+  % The \spx@verb@boxes@fcolorbox@setup MUST have been executed beforehand.
+%
+  % MEMO: in the context of framed.sty this will always expand inside some
+  % \hbox isolated from other code, so we can use \box\z@, \box\tw@,...
+  % with no need of extra group.
+%
+  % MEMO: this code was originally using \color@b@x but the latter has
+  % problematic features regarding color in a context like here where #3
+  % may contain an unbalanced "color push".
+%
+  \setbox\z@\hbox{#3}%
+  \edef\spx@verb@fcolorbox@width@sp
+      {\number\dimexpr\wd\z@+\spx@boxes@border@left
+                            +\spx@boxes@padding@left
+                            +\spx@boxes@padding@right
+                            +\spx@boxes@border@right\relax sp}%
+  \vbox{#1% continuation hint attached above frame, uses \spx@verb@fcolorbox@width@sp
+        % the boxes@fcolorbox constructs an \hbox with bbox containing the border
+        % \spx@verb@boxes@fcolorbox@setup MUST have been executed beforehand.
+        \spx@boxes@fcolorbox{\box\z@}%
+        % This \nointerlineskip to maintain legacy spacing when a \hrule was
+        % formerly last prior item in vertical list.  TODO: remove this at 6.0.0 ?
+        \nointerlineskip
+        #2% continuation hint attached below frame, uses \spx@verb@fcolorbox@width@sp
+       }% end of \vbox
+}%
+\def\spx@verb@fcolorbox@put@c#1{% hide width from framed.sty measuring
+    \moveright.5\dimexpr\spx@verb@fcolorbox@width@sp\hb@xt@\z@{\hss#1\hss}%
+}%
+\def\spx@verb@fcolorbox@put@r#1{% right align with contents, width hidden
+    \moveright\dimexpr\spx@verb@fcolorbox@width@sp-%
+                      \spx@boxes@padding@right-%
+                      \spx@boxes@border@right\hb@xt@\z@{\hss#1}%
+}%
+\def\spx@verb@fcolorbox@put@l#1{% left align with contents, width hidden
+    \moveright\dimexpr\spx@boxes@border@left+%
+                      \spx@boxes@padding@left\hb@xt@\z@{#1\hss}%
 }%
 %
-\def\sphinxVerbatim@Continued
-   {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuedalign\endcsname
-    {\normalcolor\sphinxstylecodecontinued\literalblockcontinuedname}}%
-\def\sphinxVerbatim@Continues
-   {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuesalign\endcsname
-    {\normalcolor\sphinxstylecodecontinues\literalblockcontinuesname}}%
-\def\sphinxVerbatim@Title
-   {\spx@fcolorbox@put@c{\unhcopy\sphinxVerbatim@TitleBox}}%
+\def\sphinxVerbatim@Continued{%
+    \csname spx@verb@fcolorbox@put@\spx@opt@verbatimcontinuedalign\endcsname
+    {{\normalcolor\sphinxstylecodecontinued\literalblockcontinuedname}}%
+}%
+\def\sphinxVerbatim@Continues{%
+    \csname spx@verb@fcolorbox@put@\spx@opt@verbatimcontinuesalign\endcsname
+    {{\normalcolor\sphinxstylecodecontinues\literalblockcontinuesname}}%
+}%
+\def\sphinxVerbatim@Title{%
+    \spx@verb@fcolorbox@put@c{\unhcopy\sphinxVerbatim@TitleBox}%
+}%
 \let\sphinxVerbatim@Before\@empty
 \let\sphinxVerbatim@After\@empty
 % Defaults are redefined in document preamble according to language
 \newcommand*\literalblockcontinuedname{continued from previous page}%
 \newcommand*\literalblockcontinuesname{continues on next page}%
 %
-\def\spx@verbatimfcolorbox{\spx@fcolorbox{VerbatimBorderColor}{VerbatimColor}}%
-\def\sphinxVerbatim@FrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@After}%
-\def\sphinxVerbatim@FirstFrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@Continues}%
-\def\sphinxVerbatim@MidFrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@Continues}%
-\def\sphinxVerbatim@LastFrameCommand
-   {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@After}%
+\def\sphinxVerbatim@FrameCommand{%
+    \spx@verb@FrameCommand\sphinxVerbatim@Before\sphinxVerbatim@After
+}%
+\def\sphinxVerbatim@FirstFrameCommand{%
+    \ifspx@pre@border@open
+      \spx@boxes@fcolorbox@setup@openbottom
+    \fi
+    \spx@verb@FrameCommand\sphinxVerbatim@Before\sphinxVerbatim@Continues
+}%
+\def\sphinxVerbatim@MidFrameCommand{%
+    \ifspx@pre@border@open
+      \spx@boxes@fcolorbox@setup@openboth
+    \fi
+    \spx@verb@FrameCommand\sphinxVerbatim@Continued\sphinxVerbatim@Continues
+}%
+\def\sphinxVerbatim@LastFrameCommand{%
+    \ifspx@pre@border@open
+      \spx@boxes@fcolorbox@setup@opentop
+    \fi
+    \spx@verb@FrameCommand\sphinxVerbatim@Continued\sphinxVerbatim@After
+}%
+%
+\def\spx@verb@boxes@fcolorbox@setup{%
+    % Prepares usage of \spx@boxes@fcolorbox
+    % Extras to remap legacy color names VerbatimBorderColor and VerbatimColor
+    % to a common naming scheme with admonitions (and topic directive), as
+    % expected by \spx@boxes@fcolorbox@setup from sphinxpackageboxes.sty.
+    \sphinxcolorlet{sphinxpreBorderColor}{VerbatimBorderColor}%
+    \sphinxcolorlet{sphinxpreBgColor}{VerbatimColor}%
+    % This VerbatimShadowColor is not a legacy name nor user documented but is
+    % an outcome of sphinx.sty batch definitions for CSS option support.
+    \sphinxcolorlet{sphinxpreShadowColor}{VerbatimShadowColor}%
+    \spx@boxes@fcolorbox@setup{pre}%
+    \ifspx@opt@verbatimwithframe
+    \else
+       \spx@boxes@border@top\z@
+       \spx@boxes@border@right\z@
+       \spx@boxes@border@bottom\z@
+       \spx@boxes@border@left\z@
+       \spx@boxes@border\z@
+       % MEMO: rounded corners still make sense in presence of a background
+       % color, so we do not force the fcolorbox@rectangle here
+    \fi
+}%
 
 % For linebreaks inside Verbatim environment from package fancyvrb.
 \newbox\sphinxcontinuationbox
@@ -198,7 +264,8 @@
 \def\sphinx@verbatim@nolig@list {\do \`}%
 % Some characters . , ; ? ! / are neither pygmentized nor "tex-escaped".
 % This macro makes them "active" and they will insert potential linebreaks.
-% Not compatible with math mode (cf \sphinxunactivateextras).
+% Not compatible with math mode (cf \sphinxunactivateextras, which uses
+% these lists to make sure activated characters get de-activated).
 \newcommand*\sphinxbreaksbeforeactivelist {}% none
 \newcommand*\sphinxbreaksafteractivelist  {\do\.\do\,\do\;\do\?\do\!\do\/}
 \newcommand*\sphinxbreaksviaactive {%
@@ -251,7 +318,7 @@
   \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}%
 }
 \newcommand*{\sphinxverbatimsmallskipamount}{\smallskipamount}
-% serves to implement line highlighting and line wrapping
+% serves to implement line highlighting
 \newcommand\sphinxFancyVerbFormatLine1{%
   \expandafter\sphinx@verbatim@checkifhl\expandafter{\the\FV@CodeLineNo}%
   \ifin@
@@ -260,26 +327,120 @@
      \sphinxVerbatimFormatLine{#1}%
   \fi
 }%
+\let\spx@original@set@color\set@color
 \newcommand\sphinxVerbatimHighlightLine1{%
-  \edef\sphinxrestorefboxsep{\fboxsep\the\fboxsep\relax}%
-  \fboxsep0pt\relax % cf LaTeX bug graphics/4524
-  \colorbox{sphinxVerbatimHighlightColor}%
-           {\sphinxrestorefboxsep\sphinxVerbatimFormatLine{#1}}%
-  % no need to restore \fboxsep here, as this ends up in a \hbox from fancyvrb
-}%
-% \sphinxVerbatimFormatLine will be set locally to one of those two:
-\newcommand\sphinxVerbatimFormatLineWrap{%
-  \hsize\linewidth
-  \ifspx@opt@verbatimforcewraps
-       \expandafter\spx@verb@FormatLineForceWrap
-  \else\expandafter\spx@verb@FormatLineWrap
-  \fi
+% This is morally a \colorbox (with a \fboxsep which would be 0pt)
+% but some issues of potential colour disappearance at pagebreaks
+% require workaround such as the one done here.
+  \leavevmode
+  % MEMO: usage of original \colorbox would insert a \set@color here
+  %       and this then places a "color pop" at the end of the \box\z@.
+  %       But this could pair erroneously with an unmatched "color push"
+  %       as #1 is maybe only a part (already hboxed) of a codeline
+  %       if (default) verbatimwrapslines=true
+  %       (cf \spx@verb@@PreProcessLine; refs: #8686)
+  % MEMO: formerly we did something with \fboxsep in relation to the LaTeX
+  %       bug graphics/4524 for \colorbox, but as we don't use \colorbox...
+  \setbox\z@\hb@xt@\linewidth{\strut#1\hss}%
+  % MEMO: \colorbox would lead to \color{sphinxVerbatimHighlightColor}
+  % plus \color@block, which results in doubled (a color.sty feature)
+  % color command send to device driver and more importantly has
+  % a "color pop" which will be after \box\z@.  We avoid that for reasons
+  % mentioned above.
+  {%
+  \def\set@color{\let\set@color\spx@original@set@color}%
+  % will only set \current@color and delay the \set@color to \color@block
+  % as this all happens inside fancyvrb nested \hbox'es.
+  \color{sphinxVerbatimHighlightColor}%
+  % will use \current@color and pop it **before** \box\z@
+  \color@block{\wd\z@}{\ht\z@}{\dp\z@}\box\z@
+  }%
+  % we added a group only for \FV@RightListNumber not be influenced by the
+  % \current@color, if \fvset has been used to set numbers to the right.
 }%
-\newcommand\sphinxVerbatimFormatLineNoWrap1{\hb@xt@\linewidth{\strut #1\hss}}%
-\long\def\spx@verb@FormatLineWrap#1{%
-    \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
+% MEMO: fancyvrb has options obeytabs and tabsize.  Anyhow tab characters
+% do not make it to the tex file, they have been converted to spaces earlier.
+% But, if this was not the case, the support would be implemented here via
+% \newcommand\sphinxVerbatimFormatLine1{\FV@ObeyTabs{\strut #1}}%
+\newcommand\sphinxVerbatimFormatLine1{\strut#1}%
+% MEMO: if verbatimwrapslines is set to true (default) the #1 above is
+% simply \box\spx@tempboxb, from the next two macros.
+% The next two macros are a deep hack of fancyvrb.sty core line processing in
+% order to wrap too long lines, either at spaces and natural break-points,
+% (soft wrap) or optionally at any character (hard wrap).  This requires deep
+% hack to work around the \hbox'es wrappers of fancyvrb.sty as they would
+% prevent page breaks.  Formerly Sphinx obtained wrapping by inserting the
+% material into a vertical box (which was later again boxed -- twice -- by
+% fancyvrb thinking it was a single line...) but this was incompatible with
+% allowing page breaks (refs: #8686).
+% We use core TeX techniques to pre-process a paragraph then recover its
+% constituents lines (as boxes, not as tokens) and hand them over to original
+% fancyvrb line process.  It is mandatory to update \FV@ProcessLine and
+% \@tempboxa globally to get fancyvrb internals into working to our
+% satisfaction.
+% This will get disrupted if anything adding vertical penalties or glues
+% is activated via some \vadjust from inside the Pygmentized code lines.
+\def\spx@verb@@ProcessLines{%
+   \unskip
+   \unpenalty
+   \setbox\spx@tempboxb\lastbox
+\ifvoid\spx@tempboxb\else
+   {\spx@verb@@ProcessLines}%
+   \FV@ProcessLine{\box\spx@tempboxb}%
+   \global\let\FV@ProcessLine\FV@ProcessLine
+   \global\setbox\@tempboxa=\box\@tempboxa
+   \aftergroup\spx@verb@@InhibitLineNumber
+\fi
+}%
+\def\spx@verb@@InhibitLineNumber{%
+    \let\FV@LeftListNumber\relax
+    \let\FV@RightListNumber\relax
+}%
+% This will replace fancyvrb's \FV@@PreProcessLine
+% Instead of boxing \FV@Line (which contains the Pygmentized line tokens), we
+% first typeset it in a vertical box of the suitable width (taking into
+% account nested lists) to activate the TeX built-in paragraph builder, then
+% we recover individual lines as horizontal boxes and feed them to fancyvrb
+% native line processing (which may add line numbers).  The interline
+% penalties and vertical glue to maintain baseline distance will be added
+% again by this process so in recursive \spx@verb@@ProcessLines which starts
+% from bottom and makes its way up to first part of the wrapped line we do not
+% need to worry about them.  An additional initial measuring step is needed if
+% user issued verbatimforcewraps=true, which elaborates on the same technique.
+% If hard wraps get activated, they get implemented via hacked \PYG macros.
+\def\spx@verb@@PreProcessLine{%
+  \FV@StepLineNo
+  \FV@Gobble
+     \def\spx@verb@FV@Line{\FV@Line}%
+     \ifspx@opt@verbatimforcewraps
+       \spx@verb@DecideIfWillDoForceWrap
+     \fi
+% MEMO: \everypar{} was issued earlier (and due to \@setminipage
+% would have been only \@minipagefalse\everypar{} otherwise).
+     \setbox\spx@tempboxa=\vtop{\hsize\linewidth
+          \raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
           \doublehyphendemerits\z@\finalhyphendemerits\z@
-          \strut #1\strut}%
+% MEMO: fancyvrb has options obeytabs and tabsize.  Anyhow tab characters
+% do not make it to the tex file, they have been converted to spaces earlier.
+% But, if this was not the case, the support would be implemented here via
+%     \FV@ObeyTabs{\strut\spx@verb@FV@Line\strut}%
+% And one would need a similar change in the measuring phase done by
+% \spx@verb@DecideIfWillDoForceWrap
+                   \strut\spx@verb@FV@Line\strut
+% MEMO: since LaTeX 2021-06-01, there might be some hooks executed at
+% start and end of paragraphs (in future: PDF tagging), but we need an
+% explicit \par here for that.  Else the kernel hooks at start of paragraph
+% are executed but not the ones at its end.
+          \par
+          }%
+     \setbox\spx@tempboxa=\vtop{\unvbox\spx@tempboxa
+          \setbox\spx@tempboxb\lastbox
+          {\spx@verb@@ProcessLines}%
+          \FV@ProcessLine{\box\spx@tempboxb}%
+          \global\let\FV@ProcessLine\FV@ProcessLine
+          \global\setbox\@tempboxa=\box\@tempboxa
+          }%
+  \unvbox\spx@tempboxa
 }%
 %
 % The normal line wrapping allows breaks at spaces and ascii non
@@ -318,6 +479,9 @@
 % box does not store in an accessible way what was the maximal
 % line-width during paragraph building.
 %
+% MEMO: in future use perhaps rather \RawNoindent/\RawParEnd, but
+% ltpara (LaTeX 2021-06-01) is not yet in final form (June 2022).
+%
 % Avoid LaTeX 2021 alteration of \@@par which potentially could break our
 % measurement step (typically if the para/after hook is configured to use
 % \vspace).  Of course, breakage could happen only from user or package
@@ -342,52 +506,51 @@
 % character widths, or if the min width plus verbatimmaxunderfull character
 % widths is inferior to linewidth, then we apply the "force wrapping" with
 % potential line break at each character, else we don't.
-\long\def\spx@verb@FormatLineForceWrap#1{%
-    % \spx@image@box is a scratch box register that we can use here
+\long\def\spx@verb@DecideIfWillDoForceWrap{%
     \global\let\spx@verb@maxwidth\z@
     \global\let\spx@verb@minwidth\linewidth
-    \setbox\spx@image@box
+    \setbox\spx@tempboxa
     \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
           \doublehyphendemerits\z@\finalhyphendemerits\z@
-          \spx@everypar{}\noindent\strut #1\strut\spx@par
+          \spx@everypar{}\noindent\strut\FV@Line\strut\spx@par
           \spx@verb@getwidths}%
     \ifdim\spx@verb@maxwidth>
           \dimexpr\linewidth+\spx@opt@verbatimmaxoverfull\fontcharwd\font`X \relax
-      \spx@verb@FormatLineWrap{\spx@verb@wrapPYG #1\spx@verb@wrapPYG}%
+% The \expandafter is due to \spx@verb@wrapPYG requiring to "see" the TeX tokens
+% from the pygmentize output.
+      \def\spx@verb@FV@Line{\expandafter\spx@verb@wrapPYG\FV@Line\spx@verb@wrapPYG}%
     \else
       \ifdim\spx@verb@minwidth<
             \dimexpr\linewidth-\spx@opt@verbatimmaxunderfull\fontcharwd\font`X \relax
-        \spx@verb@FormatLineWrap{\spx@verb@wrapPYG #1\spx@verb@wrapPYG}%
-      \else
-        \spx@verb@FormatLineWrap{#1}%
-    \fi\fi
+        \def\spx@verb@FV@Line{\expandafter\spx@verb@wrapPYG\FV@Line\spx@verb@wrapPYG}%
+      \fi
+    \fi
 }%
 % auxiliary paragraph dissector to get max and min widths
 % but minwidth must not take into account the last line
-\newbox\spx@scratchbox
 \def\spx@verb@getwidths {%
     \unskip\unpenalty
-    \setbox\spx@scratchbox\lastbox
-    \ifvoid\spx@scratchbox
+    \setbox\spx@tempboxb\lastbox
+    \ifvoid\spx@tempboxb
     \else
-       \setbox\spx@scratchbox\hbox{\unhbox\spx@scratchbox}%
-       \ifdim\spx@verb@maxwidth<\wd\spx@scratchbox
-          \xdef\spx@verb@maxwidth{\number\wd\spx@scratchbox sp}%
+       \setbox\spx@tempboxb\hbox{\unhbox\spx@tempboxb}%
+       \ifdim\spx@verb@maxwidth<\wd\spx@tempboxb
+          \xdef\spx@verb@maxwidth{\number\wd\spx@tempboxb sp}%
        \fi
        \expandafter\spx@verb@getwidths@loop
     \fi
 }%
 \def\spx@verb@getwidths@loop {%
     \unskip\unpenalty
-    \setbox\spx@scratchbox\lastbox
-    \ifvoid\spx@scratchbox
+    \setbox\spx@tempboxb\lastbox
+    \ifvoid\spx@tempboxb
     \else
-       \setbox\spx@scratchbox\hbox{\unhbox\spx@scratchbox}%
-       \ifdim\spx@verb@maxwidth<\wd\spx@scratchbox
-          \xdef\spx@verb@maxwidth{\number\wd\spx@scratchbox sp}%
+       \setbox\spx@tempboxb\hbox{\unhbox\spx@tempboxb}%
+       \ifdim\spx@verb@maxwidth<\wd\spx@tempboxb
+          \xdef\spx@verb@maxwidth{\number\wd\spx@tempboxb sp}%
        \fi
-       \ifdim\spx@verb@minwidth>\wd\spx@scratchbox
-          \xdef\spx@verb@minwidth{\number\wd\spx@scratchbox sp}%
+       \ifdim\spx@verb@minwidth>\wd\spx@tempboxb
+          \xdef\spx@verb@minwidth{\number\wd\spx@tempboxb sp}%
        \fi
        \expandafter\spx@verb@getwidths@loop
     \fi
@@ -508,15 +671,23 @@
            {\sphinxVerbatim@Title\nointerlineskip
             \kern\dimexpr-\dp\strutbox+\sphinxbelowcaptionspace
                  % if no frame (code-blocks inside table cells), remove
-                 % the "verbatimsep" whitespace from the top (better visually)
-                 \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi
+                 % the top padding (better visually)
+                 \ifspx@opt@verbatimwithframe\else
+                    % but we must now check if there is a background color
+                    % MEMO: "fcolorbox@setup" will have been done by time of use
+                    \ifspx@boxes@withbackgroundcolor\else-\spx@boxes@padding@top\fi
+                \fi
                  % caption package adds \abovecaptionskip vspace, remove it
                  \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax}%
      \else
        \vskip\sphinxverbatimsmallskipamount
        \def\sphinxVerbatim@After
           {\nointerlineskip\kern\dimexpr\dp\strutbox
-            \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi
+            \ifspx@opt@verbatimwithframe\else
+                    % but we must now check if there is a background color
+                    % MEMO: "fcolorbox@setup" will have been done by time of use
+                    \ifspx@boxes@withbackgroundcolor\else-\spx@boxes@padding@bottom\fi
+            \fi
             \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax
            \sphinxVerbatim@Title}%
      \fi
@@ -533,33 +704,29 @@
   \fi
   \global\let\sphinxLiteralBlockLabel\empty
   \global\let\sphinxVerbatimTitle\empty
-  \fboxsep\sphinxverbatimsep \fboxrule\sphinxverbatimborder
-  \ifspx@opt@verbatimwithframe\else\fboxrule\z@\fi
+  % the "FrameCommand"'s are also responsible to attach the "Title".
   \let\FrameCommand     \sphinxVerbatim@FrameCommand
+  % those will also check status of the pre_box-decoration-break option
   \let\FirstFrameCommand\sphinxVerbatim@FirstFrameCommand
   \let\MidFrameCommand  \sphinxVerbatim@MidFrameCommand
   \let\LastFrameCommand \sphinxVerbatim@LastFrameCommand
+  %
   \ifspx@opt@verbatimhintsturnover\else
       \let\sphinxVerbatim@Continued\@empty
       \let\sphinxVerbatim@Continues\@empty
   \fi
+  % initialization for \spx@boxes@fcolorbox from sphinxpackageboxes.sty
+  % it will take into account status of verbatimwithframe Boolean
+  \spx@verb@boxes@fcolorbox@setup
   \ifspx@opt@verbatimwrapslines
-  % fancyvrb's Verbatim puts each input line in (unbreakable) horizontal boxes.
-  % This customization wraps each line from the input in a \vtop, thus
-  % allowing it to wrap and display on two or more lines in the latex output.
-  %     - The codeline counter will be increased only once.
-  %     - The wrapped material will not break across pages, it is impossible
-  %       to achieve this without extensive rewrite of fancyvrb.
-  %     - The (not used in sphinx) obeytabs option to Verbatim is
-  %       broken by this change (showtabs and tabspace work).
-    \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineWrap
+    % deep hack into fancyvrb's internal processing of input lines
+    \let\FV@@PreProcessLine\spx@verb@@PreProcessLine
+    % space character will allow line breaks
     \let\FV@Space\spx@verbatim@space
-  % Allow breaks at special characters using \PYG... macros.
+    % allow breaks at special characters using \PYG... macros.
     \sphinxbreaksatspecials
-  % Breaks at punctuation characters . , ; ? ! and / (needs catcode activation)
+    % breaks at punctuation characters . , ; ? ! and / (needs catcode activation)
     \fvset{codes*=\sphinxbreaksviaactive}%
-  \else % end of conditional code for wrapping long code lines
-    \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineNoWrap
   \fi
   \let\FancyVerbFormatLine\sphinxFancyVerbFormatLine
   \VerbatimEnvironment
@@ -604,20 +771,47 @@
      \ifspx@opt@verbatimwrapslines
        \let\verbatim@nolig@list \sphinx@verbatim@nolig@list
      \fi
+     % optimization: as codelines will be handled inside boxes, \everypar is
+     % never reset, and it issues \@minipagefalse repeatedly (from \@setminipage).
+     % As fancyvrb Verbatim will do \@minipagefalse itself, let's simplify things.
+     \everypar{}%
+     \color@begingroup % protect against color leaks (upstream framed.sty bug)
+     \ifspx@pre@withtextcolor\color{VerbatimTextColor}\fi % mostly shadowed by
+                                % Pygments highlighting anyhow
+     \spx@pre@TeXextras
      % will fetch its optional arguments if any
      \OriginalVerbatim
-}
+}%
 {%
   \endOriginalVerbatim
+  \color@endgroup % matches the \color@begingroup
   \ifspx@inframed
    \egroup % finish \sphinxVerbatim@ContentsBox vbox
    \nobreak % update page totals
-   \ifdim\dimexpr\ht\sphinxVerbatim@ContentsBox+
+%%%%
+% MEMO (2022/07/09, while preparing 5.1.0 LaTeX CSS-style sphinxsetup options)
+% This test will systematically cause to abandon framing if the code-block
+% is near bottom of a warning-type notice which TeX has not yet decided whether
+% it fits on current page and which is near bottom of page.  Indeed the
+% \pagetotal will already be very near \pagegoal. This is probably a not
+% intended behaviour, and perhaps the whole thing should be removed?  Indeed
+% the result is surprising then because the notice will be split, code-block
+% will be on page 2 and will have no background-color, no border.
+   \ifdim\dimexpr
+         \ht\sphinxVerbatim@ContentsBox+
          \dp\sphinxVerbatim@ContentsBox+
          \ht\sphinxVerbatim@TitleBox+
          \dp\sphinxVerbatim@TitleBox+
-         2\fboxsep+2\fboxrule+
+         % 6.2.0 uses here the dimen registers from sphinxpackageboxes.sty,
+         % they got setup by \spx@verb@boxes@fcolorbox@setup
+         \spx@boxes@padding@top+
+         \spx@boxes@padding@bottom+
+         \ifspx@opt@verbatimwithframe \spx@boxes@border@top+
+                                      \spx@boxes@border@bottom+\fi
          % try to account for external frame parameters
+         % MEMO: this is because the sphinxheavybox (for warning admonitions)
+         %       environment sets \FrameSep and \FrameRule
+         % TODO: fix this bad implicit dependency
          \FrameSep+\FrameRule+
          % Usage here of 2 baseline distances is empirical.
          % In border case where code-block fits barely in remaining space,
@@ -644,7 +838,7 @@
       \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage
       }%
      \unvbox\sphinxVerbatim@ContentsBox
-     % some of this may be superfluous:
+     % the \@minipagefalse is superfluous, actually.
      \par\unskip\@minipagefalse\endMakeFramed
     \end{minipage}%
    \fi
@@ -791,6 +985,12 @@
 % Hence \sphinx@do@noligs will be removed, or rather replaced  with code
 % inserting discretionaries, as they allow a continuation symbol on start of
 % next line to achieve common design with code-blocks.
+% TODO: do the above TODO!
+% Extend \sphinxunactivateextras for \sphinxhref as the latter may
+% actually be in the scope of \sphinxupquote and does a \scantokens
+% of its own.
+   \expandafter\def\expandafter\sphinxunactivateextras\expandafter
+      {\sphinxunactivateextras\verbatim@nolig@list}%
    \let\do@noligs\sphinx@do@noligs
    \@noligs\endlinechar\m@ne\everyeof{}% (<- in case inside \sphinxhref)
    \expandafter\scantokens

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexobjects.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexobjects.sty Changed

@@ -1,7 +1,7 @@
 %% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexobjects.sty}2021/12/05 documentation environments
+\ProvidesFile{sphinxlatexobjects.sty}2022/01/13 documentation environments
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
@@ -77,56 +77,90 @@
 
 % Signatures, possibly multi-line
 %
+% For legacy reasons Sphinx uses LaTeX \list and \item's for signatures
+% This is delicate:
+% - the actual item label is not typeset immediately by \item but later as part
+% of the \everypar which will be triggered by either next paragraph or a manual
+% \leavevmode, or if nothing in-between by the next \item,
+% - \begingroup <set-up>\itemfoo <setup>\endgroup leads to errors,
+% - vertical space depends on \parskip and \itemsep values in somewhat
+% subtle manners.
+%
+% Since the 2022/01/13 version things are simpler as \parskip is simply set
+% to zero during execution of \pysigline/\pysiglinewithargsret
+%
+% Parameter for separation via \itemsep of multiple signatures with common desc
+\newlength\sphinxsignaturesep
+\setlength\sphinxsignaturesep{\smallskipamount}
+% latex.py outputs mark-up like this:
+% \pysigstartsignatures <signatures> \pysigstopsignatures <actual desc>
+\newcommand{\pysigstartsignatures}{%
+   % store current \parskip and \itemsep
+   \edef\pysig@restore@itemsep@and@parskip{%
+       \itemsep\the\itemsep\relax
+       \parskip\the\parskip\relax
+   }%
+   % set them to control the spacing between signatures sharing common desc
+   \parskip\z@skip
+   \itemsep\sphinxsignaturesep
+}
+\newcommand{\pysigstopsignatures}{%
+% 1) encourage a pagebreak in an attempt to try to avoid last
+% signature ending up separated from description (due to voodoo next)
+\penalty-100
+% 2) some voodoo to separate last signature from description in a manner
+% robust with respect to the latter being itself a LaTeX list object
+\leavevmode\par\kern-\baselineskip\item\strut
+%
+   \leavevmode
+   % it is important \leavevmode was issued before the \parskip reset, and
+   % it is also needed for the case of an object desc itself a LaTeX \list
+   % now restore \itemsep and \parskip
+   \pysig@restore@itemsep@and@parskip
+}
+%
+% Use a \parbox to accommodate long argument list in signatures
+% LaTeX did not imagine that an \item label could need multi-line rendering
 \newlength{\py@argswidth}
 \newcommand{\py@sigparams}2{%
-  % The \py@argswidth has been computed in \pysiglinewithargsret to make this
-  % occupy full available width on line.
+  % The \py@argswidth has been computed in \pysiglinewithargsret to make the
+  % argument list use full available width
   \parboxt{\py@argswidth}{\raggedright #1\sphinxcode{)}#2\strut}%
-  % final strut is to help get correct vertical separation in case of multi-line
-  % box with the item contents. 
+  % final strut is to help get correct vertical separation
 }
 \newcommand{\pysigline}1{%
-% the \py@argswidth is available we use it despite its name (no "args" here)
-% the \relax\relax is because \py@argswidth is a "skip" variable and the first
-% \relax only ends its "dimen" part
+  % as \py@argswidth is available, we use it but no "args" here
+  % the \relax\relax is because \py@argswidth is a "skip" variable
+  % this will make the label occupy the full available linewidth
   \py@argswidth=\dimexpr\linewidth+\labelwidth\relax\relax
   \item{\parboxt{\py@argswidth}{\raggedright #1\strut}}
-  \futurelet\sphinx@token\pysigline@preparevspace@i
+  \pysigadjustitemsep
 }
 \newcommand{\pysiglinewithargsret}3{%
+  % as #1 may contain a footnote using \label we need to make \label
+  % a no-op here to avoid LaTeX complaining about duplicates
+\let\spx@label\label\let\label\@gobble
   \settowidth{\py@argswidth}{#1\sphinxcode{(}}%
+\let\label\spx@label
   \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax
   \item{#1\sphinxcode{(}\py@sigparams{#2}{#3}\strut}
-  \futurelet\sphinx@token\pysigline@preparevspace@i
+  \pysigadjustitemsep
 }
-\def\pysigline@preparevspace@i{%
-  \ifx\sphinx@token\@sptoken
-   \expandafter\pysigline@preparevspace@again
-   \else\expandafter\pysigline@preparevspace@ii
-  \fi
-}
-\@firstofone{\def\pysigline@preparevspace@again} {\futurelet\sphinx@token\pysigline@preparevspace@i}
-\long\def\pysigline@preparevspace@ii#1{%
-  \ifx\sphinx@token\bgroup\expandafter\@firstoftwo
+\newcommand{\pysigadjustitemsep}{%
+  % adjust \itemsep to control the separation with the next signature
+  % sharing common description
+  \ifsphinxsigismultiline
+  % inside a multiline signature, no extra vertical spacing
+  % ("multiline" here does not refer to possibly long
+  %  list of arguments, but to a cpp domain feature)
+      \itemsep\z@skip
   \else
-    \ifx\sphinx@token\phantomsection
-    \else
-% this strange incantation is because at its root LaTeX in fact did not
-% imagine a multi-line label, it is always wrapped in a horizontal box at core
-% LaTeX level and we have to find tricks to get correct interline distances.
-% It interacts badly with a follow-up \phantomsection hence the test above
-    \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox
-    \fi
-    \expandafter\@secondoftwo
+      \itemsep\sphinxsignaturesep
   \fi
-  {{#1}}{#1}%
-}
-\newcommand{\pysigstartmultiline}{%
- \def\pysigstartmultiline{\vskip\smallskipamount\parskip\z@skip\itemsep\z@skip}%
- \edef\pysigstopmultiline
-     {\noexpand\leavevmode\parskip\the\parskip\relax\itemsep\the\itemsep\relax}%
- \parskip\z@skip\itemsep\z@skip
 }
+\newif\ifsphinxsigismultiline
+\newcommand{\pysigstartmultiline}{\sphinxsigismultilinetrue}%
+\newcommand{\pysigstopmultiline}{\sphinxsigismultilinefalse\itemsep\sphinxsignaturesep}%
 
 % Production lists
 %

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexshadowbox.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexshadowbox.sty Changed

@@ -1,7 +1,7 @@
 %% TOPIC AND CONTENTS BOXES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexshadowbox.sty}2021/01/27 sphinxShadowBox
+\ProvidesFile{sphinxlatexshadowbox.sty}2023/03/19 sphinxShadowBox
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
@@ -16,48 +16,58 @@
 %
 % Requires:
 \RequirePackage{framed}
+\RequirePackage{sphinxpackageboxes}
 
-% Again based on use of "framed.sty", this allows breakable framed boxes.
-\long\def\spx@ShadowFBox#1{%
-  \leavevmode\begingroup
-  % first we frame the box #1
-  \setbox\@tempboxa
-   \hbox{\vrule\@width\sphinxshadowrule
-         \vbox{\hrule\@height\sphinxshadowrule
-               \kern\sphinxshadowsep
-               \hbox{\kern\sphinxshadowsep #1\kern\sphinxshadowsep}%
-               \kern\sphinxshadowsep
-               \hrule\@height\sphinxshadowrule}%
-         \vrule\@width\sphinxshadowrule}%
-  % Now we add the shadow, like \shadowbox from fancybox.sty would do
-  \dimen@\dimexpr.5\sphinxshadowrule+\sphinxshadowsize\relax
-  \hbox{\vbox{\offinterlineskip
-              \hbox{\copy\@tempboxa\kern-.5\sphinxshadowrule
-                    % add shadow on right side
-                    \lower\sphinxshadowsize
-                          \hbox{\vrule\@height\ht\@tempboxa \@width\dimen@}%
-                    }%
-              \kern-\dimen@ % shift back vertically to bottom of frame
-              % and add shadow at bottom
-              \moveright\sphinxshadowsize
-                    \vbox{\hrule\@width\wd\@tempboxa \@height\dimen@}%
-              }%
-        % move left by the size of right shadow so shadow adds no width
-        \kern-\sphinxshadowsize
-       }%
-  \endgroup
-}
+% At 5.1.0 the code formerly here in a definition of \spx@ShadowFBox has been
+% refactored to hand over to a more powerful \spx@boxes@fcolorbox provided by
+% file sphinxpackageboxes.sty, it can draw rounded corners and add a background
+% color.
 
-% use framed.sty to allow page breaks in frame+shadow
-% works well inside Lists and Quote-like environments
-% produced by ``topic'' directive (or local contents)
-% could nest if LaTeX writer authorized it
+% At 6.2.0, \spx@ShadowFBox is so much simplified that it is now not
+% separately defined but directly incorporated into the \FrameCommand
+% definition done by sphinxShadowBox environment below.
+
+% Use framed.sty \MakeFramed/\endMakeFramed to allow page breaks for topic
+% boxes.  Originally Sphinx used \shadowbox from fancybox.sty but it did not
+% allow pagebreaks (which was problematic for "contents" directive if there
+% are many subsections).
+%
+% Docutils does not allow topic to be nested within topics or other body
+% elements.  But the LaTeX code here does allow it:
+%
+% - a topic inside another topic would be rendered in a minipage (thus not
+%   allowing pagebreaks).  Its external frame would adapt perfectly to
+%   the *current (smaller) width for text*.
+%
+% - a topic inside (nested) lists or quote environments would have its frame
+%   take the *full width* of the page, but its text contents on the other hand
+%   would obey exactly the current indentation plus inner separation.  This is
+%   in contrast with the framing used for literal blocks, also based, but in a
+%   more sophisticated way on usage of \MakeFramed/\endMakeFramed, and
+%   adjusting to current text indentation.
 \newenvironment{sphinxShadowBox}
-  {\def\FrameCommand {\spx@ShadowFBox }%
+  {%
+   \spx@boxes@fcolorbox@setup{topic}%
+   % we will use the dimen registers from sphinxpackageboxes.sty which now hold
+   % the values from options related to topic/contents
+   % MEMO: \spx@boxes@fcolorbox creates an \hbox but does not quit vertical
+   %       mode; but in context of framed.sty's \FrameCommand TeX is already
+   %       in restricted horizontal mode, so no need for a \leavevmode here.
+   \def\FrameCommand {\spx@boxes@fcolorbox}%
+   % 6.2.0 adds support for div.topic_box-decoration-break=slice.
+   % (it is yet undecided if slice style should inhibit a bottom shadow)
+   \ifspx@topic@border@open
+     \def\FirstFrameCommand
+               {\spx@boxes@fcolorbox@setup@openbottom\FrameCommand}%
+     \def\MidFrameCommand
+               {\spx@boxes@fcolorbox@setup@openboth  \FrameCommand}%
+     \def\LastFrameCommand
+               {\spx@boxes@fcolorbox@setup@opentop   \FrameCommand}%
+   \fi
    \advance\spx@image@maxheight
-   -\dimexpr2\sphinxshadowrule
-           +2\sphinxshadowsep
-           +\sphinxshadowsize
+   -\dimexpr\spx@boxes@border@top+\spx@boxes@border@bottom
+           +\spx@boxes@padding@top+\spx@boxes@padding@bottom
+           +\ifdim\spx@boxes@shadow@yoffset<\z@-\fi\spx@boxes@shadow@yoffset
            +\baselineskip\relax
    % configure framed.sty not to add extra vertical spacing
    \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}%
@@ -73,7 +83,7 @@
     % use a minipage if we are already inside a framed environment
     \ifspx@inframed\begin{minipage}{\linewidth}\fi
     \MakeFramed {\spx@inframedtrue
-    % framed.sty puts into "\width" the added width (=2shadowsep+2shadowrule)
+    % framed.sty puts into "\width" the added width (padding+border widths)
     % adjust \hsize to what the contents must use
     \advance\hsize-\width
     % adjust LaTeX parameters to behave properly in indented/quoted contexts
@@ -86,9 +96,15 @@
     \@minipagerestore
     \@setminipage
     }%
+    \color@begingroup % workaround upstream framed.sty bug
+    \ifspx@topic@withtextcolor
+      \color{sphinxtopicTextColor}%
+    \fi
+    \spx@topic@TeXextras
   }%
   {% insert the "endminipage" code
     \par\unskip
+    \color@endgroup   % matches the \color@begingroup
     \@minipagefalse
    \endMakeFramed
      \ifspx@inframed\end{minipage}\fi

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexstyleheadings.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexstyleheadings.sty Changed

@@ -1,7 +1,7 @@
 %% TITLES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstyleheadings.sty}2021/01/27 headings
+\ProvidesFile{sphinxlatexstyleheadings.sty}2023/02/11 headings
 
 \RequirePackagenobottomtitles*{titlesec}
 \@ifpackagelater{titlesec}{2016/03/15}%
@@ -25,6 +25,7 @@
 ******** and Sphinx could not patch it, perhaps because your local ...|^^J%
 ******** copy is already fixed without a changed release date. .......|^^J%
 ******** If not, you must update titlesec! ...........................|}}%
+     \sphinxbuildwarning{badtitlesec}%
    \fi
   }%
  }{}
@@ -35,13 +36,15 @@
             {\py@TitleColor\thesection}{0.5em}{\py@TitleColor}
 \titleformat{\subsection}{\large\py@HeaderFamily}%
             {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor}
-\titleformat{\subsubsection}{\py@HeaderFamily}%
+% \normalsize added as work-around to a lualatex-ja upstream problem
+% https://osdn.net/projects/luatex-ja/ticket/47321
+\titleformat{\subsubsection}{\normalsize\py@HeaderFamily}%
             {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor}
 % By default paragraphs (and subsubsections) will not be numbered because
 % sphinxmanual.cls and sphinxhowto.cls set secnumdepth to 2
-\titleformat{\paragraph}{\py@HeaderFamily}%
+\titleformat{\paragraph}{\normalsize\py@HeaderFamily}%
             {\py@TitleColor\theparagraph}{0.5em}{\py@TitleColor}
-\titleformat{\subparagraph}{\py@HeaderFamily}%
+\titleformat{\subparagraph}{\normalsize\py@HeaderFamily}%
             {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatexstyletext.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatexstyletext.sty Changed

@@ -1,11 +1,46 @@
 %% TEXT STYLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstyletext.sty}2021/12/06 text styling
+\ProvidesFile{sphinxlatexstyletext.sty}2023/03/26 text styling
 
 % Basically everything here consists of macros which are part of the latex
 % markup produced by the Sphinx latex writer
 
+% But those arise rather from the default definitions of the respective
+% latex environments done in sphinxlatexadmonitions.sty
+\def\sphinxstylenotetitle   #1{\sphinxstrong{#1} }
+\let\sphinxstylehinttitle     \sphinxstylenotetitle % #1 holds the localized notice name
+\let\sphinxstyleimportanttitle\sphinxstylenotetitle % followed by a colon
+\let\sphinxstyletiptitle      \sphinxstylenotetitle
+\let\sphinxstylewarningtitle  \sphinxstylenotetitle
+\let\sphinxstylecautiontitle  \sphinxstylenotetitle
+\let\sphinxstyleattentiontitle\sphinxstylenotetitle
+\let\sphinxstyledangertitle   \sphinxstylenotetitle
+\let\sphinxstyleerrortitle    \sphinxstylenotetitle
+\def\sphinxstyleseealsotitle#1{\sphinxstrong{#1}\par\nopagebreak}
+%
+% A utility to remove a final colon.  Removing last token is not easy in
+% LaTeX, and there are additional complications:
+% - some languages will make the : "active" in document body,
+% - the generic admonition ends up using "note", so for \sphinxnotetitle to
+%   use it safely, the utility has to allow an input not having any final colon.
+% - a bit far-fetched but maybe there is more than one colon inside the input
+%   (possible from a generic admonition title).
+% Hence the scary code.
+\def\sphinxremovefinalcolon#1{% #1 is the "active" : TeX token
+\protected\def\sphinxremovefinalcolon ##1{%
+   % complications due to : possibly "active"
+   \begingroup\ifnum\catcode`:=\active
+                    \def\x####1#1\relax{####1}%
+               \else\def\x####1:\relax{####1}\fi
+   \expandafter\endgroup\x##1\relax
+   % trick to let \x work also if input ##1 has no ending colon
+   \@gobblefour#1\relax:\relax\relax\relax
+   }%
+}% end of wrapper to inject active :
+\begingroup\catcode`:\active\expandafter\endgroup\sphinxremovefinalcolon:
+% See doc/latex.rst for an example.
+
 % Some custom font markup commands.
 \protected\def\sphinxstrong#1{\textbf{#1}}
 \protected\def\sphinxcode#1{\texttt{#1}}
@@ -19,6 +54,8 @@
 \protected\def\sphinxaccelerator#1{\underline{#1}}
 \protected\def\sphinxcrossref#1{\emph{#1}}
 \protected\def\sphinxtermref#1{\emph{#1}}
+\protected\def\sphinxsamedocref#1{\emph{#1}}
+\protected\def\sphinxparam#1{\emph{#1}}
 % \optional is used for ``, arg``, i.e. desc_optional nodes.
 \long\protected\def\sphinxoptional#1{%
   {\textnormal{\Large}}{#1}\hspace{0.5mm}{\textnormal{\Large}}}
@@ -39,6 +76,7 @@
 \protected\def\sphinxstyleothertitle   #1{\textbf{#1}}
 \protected\def\sphinxstylesidebarsubtitle #1{~\\\textbf{#1} \smallskip}
 % \text.. commands do not allow multiple paragraphs
+% attention, this one is not self-delimiting
 \protected\def\sphinxstyletheadfamily    {\sffamily}
 \protected\def\sphinxstyleemphasis     #1{\emph{#1}}
 \protected\def\sphinxstyleliteralemphasis#1{\emph{\sphinxcode{#1}}}
@@ -46,8 +84,8 @@
 \protected\def\sphinxstyleliteralstrong#1{\sphinxbfcode{#1}}
 \protected\def\sphinxstyleabbreviation #1{\textsc{#1}}
 \protected\def\sphinxstyleliteralintitle#1{\sphinxcode{#1}}
-\newcommand*\sphinxstylecodecontinued1{\footnotesize(#1)}%
-\newcommand*\sphinxstylecodecontinues1{\footnotesize(#1)}%
+\newcommand*\sphinxstylecodecontinued1{{\footnotesize(#1)}}%
+\newcommand*\sphinxstylecodecontinues1{{\footnotesize(#1)}}%
 % figure legend comes after caption and may contain arbitrary body elements
 \newenvironment{sphinxlegend}{\par\small}{\par}
 % reduce hyperref "Token not allowed in a PDF string" warnings on PDF builds
@@ -67,7 +105,9 @@
     \let\sphinxemail    \@firstofone
     \let\sphinxcrossref \@firstofone
     \let\sphinxtermref  \@firstofone
+    \let\sphinxsamedocref\@firstofone
     \let\sphinxhyphen\sphinxhyphenforbookmarks
+    \def\PYG#1#2{#2}% (can not yet appear in section titles, but perhaps in future)
 }}
 
 % Special characters

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxlatextables.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxlatextables.sty Changed

@@ -1,7 +1,7 @@
 %% TABLES (WITH SUPPORT FOR MERGED CELLS OF GENERAL CONTENTS)
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatextables.sty}2021/01/27 tables%
+\ProvidesFile{sphinxlatextables.sty}2022/08/15 tables%
 
 % Provides support for this output mark-up from Sphinx latex writer
 % and table templates:
@@ -25,12 +25,31 @@
 % - \sphinxtablestrut
 % - \sphinxthecaptionisattop
 % - \sphinxthelongtablecaptionisattop
+% - \sphinxhline
+% - \sphinxcline
+% - \sphinxvlinecrossing
+% - \sphinxfixclines
+% - \sphinxtoprule
+% - \sphinxmidrule
+% - \sphinxbottomrule
+% - \sphinxtableatstartofbodyhook
+% - \sphinxtableafterendhook
+% - \sphinxthistablewithglobalstyle
+% - \sphinxthistablewithbooktabsstyle
+% - \sphinxthistablewithborderlessstyle
+% - \sphinxthistablewithstandardstyle
+% - \sphinxthistablewithcolorrowsstyle
+% - \sphinxthistablewithnocolorrowsstyle
+% - \sphinxthistablewithvlinesstyle
+% - \sphinxthistablewithnovlinesstyle
 %
 % Executes \RequirePackage for:
 %
 % - tabulary
 % - longtable
 % - varwidth
+% - colortbl
+% - booktabs if 'booktabs' in latex_table_style
 %
 % Extends tabulary and longtable via patches and custom macros to support
 % merged cells possibly containing code-blocks in complex tables
@@ -43,9 +62,13 @@
 % X or S (Sphinx) may have meanings if some table package is loaded hence
 % \X was chosen to avoid possibility of conflict
 \newcolumntype{\X}2{p{\dimexpr
-      (\linewidth-\arrayrulewidth)*#1/#2-\tw@\tabcolsep-\arrayrulewidth\relax}}
+      (\linewidth-\spx@arrayrulewidth)*#1/#2-\tw@\tabcolsep-\spx@arrayrulewidth\relax}}
 \newcolumntype{\Y}1{p{\dimexpr
-      #1\dimexpr\linewidth-\arrayrulewidth\relax-\tw@\tabcolsep-\arrayrulewidth\relax}}
+      #1\dimexpr\linewidth-\spx@arrayrulewidth\relax-\tw@\tabcolsep-\spx@arrayrulewidth\relax}}
+% \spx@arrayrulewidth is used internally and its meaning will be set according
+% to the table type; no extra user code should modify it.  In particular any
+% \setlength{\spx@arrayrulewidth}{...} may break all of LaTeX... (really...)
+\def\spx@arrayrulewidth{\arrayrulewidth}% 5.3.0, to be adjusted by each table
 % using here T (for Tabulary) feels less of a problem than the X could be
 \newcolumntype{T}{J}%
 % For tables allowing pagebreaks
@@ -167,6 +190,11 @@
       \unexpanded\expandafter{\@vwid@setup}}%
 }%
 
+% NOTA BENE: since the multicolumn and multirow code was written Sphinx
+% decided to prefix non public internal macros by \spx@ and in fact all
+% such macros here should now be prefixed by \spx@table@, but doing the
+% update is delayed to later. (written at 5.3.0)
+
 %%%%%%%%%%%%%%%%%%%%%
 % --- MULTICOLUMN ---
 % standard LaTeX's \multicolumn
@@ -208,6 +236,16 @@
 % \arrayrulewidth space for each column separation in its estimate of available
 % width).
 %
+% Update at 5.3.0: code uses \spx@arrayrulewidth which is kept in sync with the
+% table column specification (aka preamble):
+% - no | in preamble:             \spx@arrayrulewidth -> \z@
+% - at least a | in the preamble: \spx@arrayrulewidth -> \arrayrulewidth
+% This is used for computation of merged cells widths.  Mixed preambles using
+% at least a | but not using it for all columns (as can be obtained via the
+% tabularcolumns directive) may cause some merged cells contents to be slightly
+% shifted to the left as they assume merged columns are | separated where in
+% fact they perhaps are not.
+%
 % TN. 1b: as Sphinx multicolumn uses neither \omit nor \span, it can not
 % (easily) get rid of extra macros from >{...} or <{...} between columns. At
 % least, it has been made compatible with colortbl's \columncolor.
@@ -229,7 +267,19 @@
 % Sphinx generates no nested tables, and if some LaTeX macro uses internally a
 % tabular this will not have a \sphinxstartmulticolumn within it!
 %
-\def\sphinxstartmulticolumn{%
+% 5.3.0 adds a check for multirow as single-row multi-column will allow a row
+% colour but multi-row multi-column should not.
+% Attention that this assumes \sphinxstartmulticolumn is always followed
+% in latex mark-up either by \sphinxmultirow or \begin (from \begin{varwidth}).
+\def\sphinxstartmulticolumn#1#2{%
+    \ifx\sphinxmultirow#2%
+        \gdef\spx@table@hackCT@inmergedcell{\spx@table@hackCT@nocolor}%
+    \else
+        \global\let\spx@table@hackCT@inmergedcell\spx@@table@hackCT@inmergedcell
+    \fi
+    \sphinx@startmulticolumn{#1}#2%
+}%
+\def\sphinx@startmulticolumn{%
     \ifx\equation$% $ tabulary's first pass
         \expandafter\sphinx@TYI@start@multicolumn
     \else % either not tabulary or tabulary's second pass
@@ -285,32 +335,21 @@
     \else
     % if in an l, r, c type column, try and hope for the best
        \xdef\sphinx@tempb{\the\dimexpr(\ifx\TY@final\@undefined\linewidth\else
-            \sphinx@TY@tablewidth\fi-\arrayrulewidth)/\sphinx@tempa
-            -\tw@\tabcolsep-\arrayrulewidth\relax}%
+            \sphinx@TY@tablewidth\fi-\spx@arrayrulewidth)/\sphinx@tempa
+            -\tw@\tabcolsep-\spx@arrayrulewidth\relax}%
     \fi
     \noindent\kern\sphinx@tempb\relax
     \xdef\sphinx@multiwidth
-           {\the\dimexpr\sphinx@multiwidth+\sphinx@tempb+\tw@\tabcolsep+\arrayrulewidth}%
-    % hack the \vline and the colortbl macros
-    \sphinx@hack@vline\sphinx@hack@CT&\relax
+           {\the\dimexpr\sphinx@multiwidth+\sphinx@tempb+\tw@\tabcolsep+\spx@arrayrulewidth}%
+    \spx@table@hackCT@fixcolorpanel
+    % silence a | column separator in our merged cell
+    \spx@table@hackCT@inhibitvline
+    % prevent column colours to interfere with our multi-column but allow row
+    % colour (we can't obey a \cellcolor as it has not be seen yet at this stage)
+    \spx@table@hackCT@inmergedcell&\relax
     % repeat
     \expandafter\sphinx@multispan\expandafter{\the\numexpr#1-\@ne}%
 }%
-% packages like colortbl add group levels, we need to "climb back up" to be
-% able to hack the \vline and also the colortbl inserted tokens. This creates
-% empty space whether or not the columns were | separated:
-\def\sphinx@hack@vline{\ifnum\currentgrouptype=6\relax
-    \kern\arrayrulewidth\arrayrulewidth\z@\else\aftergroup\sphinx@hack@vline\fi}%
-\def\sphinx@hack@CT{\ifnum\currentgrouptype=6\relax
-    \let\CT@setup\sphinx@CT@setup\else\aftergroup\sphinx@hack@CT\fi}%
-% It turns out \CT@row@color is not expanded contrarily to \CT@column@color
-% during LaTeX+colortbl preamble preparation, hence it would be possible for
-% \sphinx@CT@setup to discard only the column color and choose to obey or not
-% row color and cell color. It would even be possible to propagate cell color
-% to row color for the duration of the Sphinx multicolumn... the (provisional?)
-% choice has been made to cancel the colortbl colours for the multicolumn
-% duration.
-\def\sphinx@CT@setup #1\endgroup{\endgroup}% hack to remove colour commands
 \def\sphinx@multispan@end#1{%
     % first, trace back our steps horizontally
     \noindent\kern-\dimexpr\sphinx@multiwidth\relax
@@ -320,11 +359,12 @@
     \else
        \xdef\sphinx@multiwidth{\the\dimexpr\sphinx@multiwidth+
          (\ifx\TY@final\@undefined\linewidth\else
-          \sphinx@TY@tablewidth\fi-\arrayrulewidth)/\sphinx@tempa
-          -\tw@\tabcolsep-\arrayrulewidth\relax}%
+          \sphinx@TY@tablewidth\fi-\spx@arrayrulewidth)/\sphinx@tempa
+          -\tw@\tabcolsep-\spx@arrayrulewidth\relax}%
     \fi
-    % we need to remove colour set-up also for last cell of the multi-column
-    \aftergroup\sphinx@hack@CT
+    % last cell of the multi-column
+    \aftergroup\spx@table@hackCT@fixcolorpanel
+    \aftergroup\spx@table@hackCT@inmergedcell
 }%
 \newcommand*\sphinxcolwidth2{%
   % this dimension will always be used for varwidth, and serves as maximum
@@ -345,8 +385,8 @@
         \linewidth
     \else
         % l, c, r columns. Do our best.
-        \dimexpr(\linewidth-\arrayrulewidth)/#2-
-                \tw@\tabcolsep-\arrayrulewidth\relax
+        \dimexpr(\linewidth-\spx@arrayrulewidth)/#2-
+                \tw@\tabcolsep-\spx@arrayrulewidth\relax
     \fi
    \else % in tabulary
     \ifx\equation$%$% first pass
@@ -357,8 +397,8 @@
          \linewidth % in a L, R, C, J column or a p, \X, \Y ...
      \else
          % we have hacked \TY@final to put in \sphinx@TY@tablewidth the table width
-         \dimexpr(\sphinx@TY@tablewidth-\arrayrulewidth)/#2-
-                 \tw@\tabcolsep-\arrayrulewidth\relax
+         \dimexpr(\sphinx@TY@tablewidth-\spx@arrayrulewidth)/#2-
+                 \tw@\tabcolsep-\spx@arrayrulewidth\relax
      \fi
     \fi
    \fi
@@ -368,7 +408,125 @@
 % \sphinxcolwidth will use this only inside LaTeX's standard \multicolumn
 \def\sphinx@multiwidth #1#2{\dimexpr % #1 to gobble the \@gobble (!)
     (\ifx\TY@final\@undefined\linewidth\else\sphinx@TY@tablewidth\fi
-     -\arrayrulewidth)*#2-\tw@\tabcolsep-\arrayrulewidth\relax}%
+     -\spx@arrayrulewidth)*#2-\tw@\tabcolsep-\spx@arrayrulewidth\relax}%
+
+% \spx@table@hackCT@inhibitvline
+% packages like colortbl add group levels, we need to "climb back up" to be
+% able to hack the \vline and also the colortbl inserted tokens.  The hack
+% sets the \arrayrulewidth to \z@ to inhibit a | separator at right end
+% of the cell, if present (our code does not use \omit so can not avoid the
+% \vline insertion, but setting its width to zero makes it do nothing).
+% Some subtlety with colour panels must be taken care of.
+\def\spx@table@hackCT@inhibitvline{\ifnum\currentgrouptype=6\relax
+    \kern\spx@arrayrulewidth % will be compensated by extra colour panel left overhang
+    \arrayrulewidth\z@% trick to inhibit the {\vrule width \arrayrulewidth}
+    \else\aftergroup\spx@table@hackCT@inhibitvline\fi}%
+
+% hacking around colour matters
+% Sphinx 1.6 comment:
+% It turns out \CT@row@color is not expanded contrarily to \CT@column@color
+% during LaTeX+colortbl preamble preparation, hence it would be possible for
+% \CT@setup to discard only the column color and choose to obey or not
+% row color and cell color. It would even be possible to propagate cell color
+% to row color for the duration of the Sphinx multicolumn... the (provisional?)
+% choice has been made to cancel the colortbl colours for the multicolumn
+% duration.
+% Sphinx 5.3.0 comment:
+% - colortbl has no mechanism to disable colour background in a given cell:
+%   \cellcolor triggers one more \color, but has no possibility to revert
+%   a previously emitted \color, only to override it via an additional \color
+% - prior to 5.3.0, Sphinx did not officially support colour in tables,
+%   but it did have a mechanism to protect merged cells from being partly
+%   covered by colour panels at various places.  At 5.3.0 this mechanism
+%   is relaxed a bit to allow row colour for a single-row merged cell.
+%
+% fixcolorpanel
+\def\spx@table@hackCT@fixcolorpanel{\ifnum\currentgrouptype=6\relax
+    \edef\spx@table@leftcolorpanelextra
+    % \edef as \arrayrulewidth will be set to \z@ next,
+    % hence also \spx@arrayrulewidth...
+         {\sphinxcolorpanelextraoverhang+\the\spx@arrayrulewidth}%
+    \else\aftergroup\spx@table@hackCT@fixcolorpanel\fi}%
+%
+% inmergedcell
+% \spx@table@hackCT@inmergedcell will be locally set to either this
+% \spx@@table@hackCT@inmergedcell or to \spx@table@hackCT@nocolor
+% "\let\spx@original@CT@setup\CT@setup" is done after loading colortbl
+\def\spx@@table@hackCT@inmergedcell{\ifnum\currentgrouptype=6\relax
+    \let\CT@setup\spx@CT@setup@inmergedcell
+    \else\aftergroup\spx@@table@hackCT@inmergedcell\fi
+}%
+\newif\ifspx@table@inmergedcell
+\def\spx@CT@setup@inmergedcell #1\endgroup{%
+    % - obey only row color and disable effect of \sphinxcolorblend
+    % - turn on the inmergedcell boolean to signal to \CT@row@color
+    \spx@original@CT@setup
+    \spx@table@inmergedcelltrue % needed by \CT@row@color
+    % deactivate effect of \sphinxcolorblend if it happened at all
+    \ifdefined\blendcolors\blendcolors{}\fi
+    \CT@row@color
+    \CT@do@color
+    \global\let\CT@cell@color\relax
+    \endgroup
+}%
+%
+% nocolor
+\def\spx@table@hackCT@nocolor{\ifnum\currentgrouptype=6\relax
+% sadly \CT@column@color is possibly already expanded so we can't
+% simply do \let\CT@column@color\relax etc...
+% admittedly we could perhaps hack \CT@color but well
+    \let\CT@setup\spx@CT@setup@nocolor
+    \else\aftergroup\spx@table@hackCT@nocolor\fi
+}
+\def\spx@CT@setup@nocolor#1\endgroup{%
+        \global\let\CT@cell@color\relax
+    % the above fix was added at 5.3.0
+    % formerly a \cellcolor added by a raw latex directive in the merged cell
+    % would have caused colour to apply to the *next* cell after the merged
+    % one; we don't support \cellcolor from merged cells contents anyhow.
+    \endgroup}
+%
+% norowcolor
+\def\spx@table@hackCT@norowcolor{%
+% a bit easier although merged cells complicate the matter as they do need
+% to keep the rowcolor; and we can't know yet if we are in a merged cell
+    \ifnum\currentgrouptype=6\relax
+       \ifx\CT@row@color\relax
+       \else
+           \let\spx@saved@CT@row@color\CT@row@color
+           \def\CT@row@color{%
+             \ifspx@table@inmergedcell\expandafter\spx@saved@CT@row@color\fi
+           }%
+       \fi
+    \else\aftergroup\spx@table@hackCT@norowcolor\fi
+}
+%
+% \sphinxcolorblend
+\def\spx@table@hackCT@colorblend{%
+    \ifnum\currentgrouptype=6\relax
+        \expandafter\blendcolors\spx@colorblendparam
+        % merged cells will do a \blendcolors{} to cancel the effet
+        % we can not know here yet if in merged cell as the boolean
+        % \ifspx@table@inmergedcell is not yet updated
+    \else
+      \aftergroup\spx@table@hackCT@colorblend
+    \fi
+}
+\def\sphinxcolorblend#1{\gdef\spx@colorblendparam{{#1}}\spx@table@hackCT@colorblend}
+% Either xcolor.sty exists on user system and has been loaded by sphinx.sty,
+% or it does not exist, so we can use \@ifpackageloaded without delaying.
+\@ifpackageloaded{xcolor}%
+  {}%
+  {\def\sphinxcolorblend#1{%
+\PackageWarning{sphinx}{This table uses \string\sphinxcolorblend\space
+  but xcolor is not in\MessageBreak
+  the TeX/LaTeX installation, the command will be\MessageBreak
+  ignored in this and the next tables}%
+   \global\let\sphinxcolorblend\@gobble
+   \sphinxbuildwarning{colorblend}%
+   }%
+  }
+
 
 %%%%%%%%%%%%%%%%%%
 % --- MULTIROW ---
@@ -390,9 +548,22 @@
 % that the table rows have the needed height. The needed mark-up is done
 % by LaTeX writer, which has its own id for the merged cells.
 %
-% The colour issue is solved by clearing colour panels in all cells,
+% The colour issue is "solved" by clearing colour panels in all cells,
 % whether or not the multirow is single-column or multi-column.
 %
+% MEMO at 5.3.0: to allow a multirow cell in a single column to react to
+% \columncolor correctly, it seems only way is that the contents
+% are inserted by bottom cell (this is mentioned in multirow.sty doc, too).
+% Sphinx could at Python level "move" the contents to that cell.  But the
+% mechanism used here via \sphinxtablestrut to enlarge rows to make room for
+% the contents if needed becomes more challenging yet, because \sphinxtablestrut
+% mark-up will be parsed by TeX *before* it sees the contents of the merged
+% cell.. So it seems the best way would be to actually store the contents into
+% some owned-by-Sphinx box storage which needs to be globally allocated to
+% that usage ; then we need multiple such boxes, say at least 5 to cover
+% 99% or use case.  Or perhaps some trick with storing in a \vbox and recovering
+% via some \vsplit but this becomes complicated... perhaps in future.
+%
 % In passing we obtain baseline alignements across rows (only if
 % \arraystretch is 1, as LaTeX's does not obey \arraystretch in "p"
 % multi-line contents, only first and last line...)
@@ -410,6 +581,15 @@
   \setbox\z@\hbox\bgroup\aftergroup\sphinx@@multirow\strut
 }%
 \def\sphinx@@multirow {%
+% MEMO: we could check status of \CT@cell@color here, but unfortunately we
+% can't know the exact height which will be covered by the cells in total
+% (it may be more than our \box\z@ dimensions).  We could use an \fcolorbox
+% wrapper on \box\z@ but this will not extend precisely to the bottom rule.
+%
+% Only solution if we want to obey a raw \cellcolor, or a \columncolor, seems
+% to delay unboxing the gathered contents as part of the bottom row with
+% a suitable vertical adjustment...
+%
   % The contents, which is a varwidth environment, has been captured in
   % \box0 (a \hbox).
   % We have with \sphinx@cellid an assigned unique id. The goal is to give
@@ -475,7 +655,592 @@
         \@width\z@
   \endgroup
   % we need this to avoid colour panels hiding bottom parts of multirow text
-  \sphinx@hack@CT
+  \spx@table@hackCT@nocolor
 }%
 
+%%%%%%%%%%%%%%%%%%
+% --- STYLING ---
+%
+
+%
+% Support for colour in table
+%
+% Core LaTeX package (very old, part of texlive-latex-base on Debian distr.)
+% providing \columncolor, \rowcolor, \cellcolor and \arrayrulecolor.
+\RequirePackage{colortbl}
+\let\spx@original@CT@setup\CT@setup
+
+% LaTeX's \cline has **strong** deficiencies
+% ******************************************
+% We work around them via an added \sphinxfixclines{number of columns} in the
+% table mark-up, and also extra mark-up \sphinxvlinecrossing{col no} for
+% crossings not contiguous to any cline.  To fix the gap at left extremity of a
+% \cline, we redefine the core LaTeX \c@line because this avoids adjoining a
+% small square with potential PDF viewer anti-aliasing issues.  We waited
+% after loading colortbl because it also redefines \c@line for it to obey the
+% colour set by \arrayrulecolor.
+% MEMO: booktabs package does *not* redefine \@cline so we are safe here.
+\def\@cline#1-#2\@nil{%
+  \omit
+  \@multicnt#1%
+  \advance\@multispan\m@ne
+  \ifnum\@multicnt=\@ne\@firstofone{&\omit}\fi
+  \@multicnt#2%
+  \advance\@multicnt-#1%
+  \advance\@multispan\@ne
+  {\CT@arc@
+% start of Sphinx modification
+  \ifnum#1>\@ne\kern-\spx@arrayrulewidth\fi% fix gap at join with vertical lines
+% end of Sphinx modification
+%    Comments:
+%
+%    If we had the information whether the previous column ended with a | or
+%    not, we could decide what to do here.  Alternatively the mark-up could
+%    use either original \cline or the one modified as here depending on case.
+%    One wonders why LaTeX does not provide itself the alternative as a
+%    complement to \cline, to use on case by case basis.
+%    Here we handle both at same time via using the \spx@arrayrulewidth which
+%    will be \z@ if no | at all so will induce here nothing.
+%
+%    As a result Sphinx basically supports well only tables having either all
+%    columns |-separated, or no | at all, as it uses \spx@arrayrrulewidth in
+%    all columns (here and in multicolumn code).
+%
+%    We also considered a method not modifying \c@line but it requires too
+%    much extra mark-up from Python LaTeX writer and/or extra LaTeX coding.
+% back to LaTeX+colortbl code
+  \leaders\hrule\@height\arrayrulewidth\hfill}%
+  \cr
+% the last one will need to be compensated, this is job of \sphinxclines
+  \noalign{\vskip-\arrayrulewidth}%
+}
+\def\spx@table@fixvlinejoin{%
+  {\CT@arc@ % this is the color command set up by \arrayrulecolor
+   \vrule\@height\arrayrulewidth
+% side remark: LaTeX has only a single \arrayrulewidth for all kinds
+% for cell borders in table, horizontal or vertical...
+         \@depth\z@
+         \@width\spx@arrayrulewidth
+  }%
+}
+% Sphinx LaTeX writer issues one such for each vertical line separating two
+% contiguous multirow cells; i.e. those crossings which can are not already
+% taken care of by our modified at left extremity \cline.
+% One could imagine a more \...crossingS (plural) receiving a comma delimited
+% list, which would simplify the mark-up but this would complexify both the
+% Python and the LaTeX coding.
+\def\sphinxtablevlinecrossing#1{%
+  \sphinxtabledecrementrownum
+  \omit
+  \@multispan{#1}%
+  \hfill
+  \spx@table@fixvlinejoin
+  \cr
+  \noalign{\vskip-\arrayrulewidth}%
+}
+% This "fixclines" is also needed if no \sphinxcline emitted and is useful
+% even in extreme case with no \sphinxvlinecrossing either, to give correct
+% height to multirow extending across all table width assuming other rows are
+% separated generally by an \hline, so as to keep coherent line spacing.
+%
+% It is designed to work ok even if no | separators are in the table (because
+% \spx@table@fixvlinejoin uses \spx@arrayrulewidth which is \z@ in that case).
+\def\sphinxtablefixclines#1{% #1 is the number of columns of the table
+  \sphinxtabledecrementrownum
+  \omit
+  \spx@table@fixvlinejoin% unneeded if first \cline started at column 1 but does
+                         % not hurt; fills small gap at left-bordered table
+  \@multispan{#1}%
+  \hfill
+  \spx@table@fixvlinejoin% fill small gap at right-bordered table
+  \cr
+  % this final one does NO \vskip-\arrayrulewidth... that's the whole point
+}
+%%%% end of \cline workarounds
+
+%
+% - passing option "table" to xcolor also loads colortbl but we needed to
+%   load color or xcolor prior to the handling of the options
+%
+% - the \rowcolors command from table{xcolor} has various problems:
+%
+%   *  it is rigid and does not out-of-the-box allow a more complex scheme
+%   such as colorA+colorB+colorC+colorB+colorC+colorB+colorC...  suitable to
+%   distinguish a header row.
+%
+%   *  its code does not export the used colour, an information which we may
+%   need for example to colourize the rule via \arrayrulecolor in the
+%   appropriate manner, for example to colourize the booktabs induced vertical
+%   whitespace to avoid gaps (if one wants to).
+%
+%   *  incompatibility with tabulary: the output depends on parity of total
+%   number of rows!
+%
+%   *  problems with longtable: the caption will receive a background colour
+%   panel, if we do not deactivate the \rowcolors action during definition of
+%   the headers and footers; this requires extra mark-up.  Besides if we
+%   deactivate using \hiderowcolors during header and footer formation, the
+%   parity of the body rows is shifted, \rownum is even, not odd, at first body
+%   row.  And setting \rownum at start of first body row is too late for
+%   influencing the colour.
+%
+%   *  it has a global impact and must be reset at each table.  We can not
+%   issue it only once and it provides no public interface (without @) to
+%   cancel its effect conveniently (\hiderowcolors can only be used from
+%   *inside* a table.)
+%
+%   *  its core mechanism which increments the row count is triggered
+%   if a \cline is encountered... so this offsets the alternating colours...
+%   ... or not if there are two \cline's in the row...
+%   (as we will use same mechanism we have to correct this increment).
+%
+% So we need our own code.
+
+% Provide \rownum and rownum LaTeX counter (code copied from colortbl v1.0f)
+\ltx@ifundefined{rownum}{%
+  \ltx@ifundefined{c@rownum}%
+       {\newcount\rownum\let\c@rownum\rownum}%
+       {\let\rownum\c@rownum}%
+  }%
+{\let\c@rownum\rownum}
+\providecommand\therownum{\arabic{rownum}}
+
+% extra overhang for color panels to avoid visual artifacts in pdf viewers
+% (particularly if borderless)
+\def\sphinxcolorpanelextraoverhang{0.1pt}
+\def\spx@table@leftcolorpanelextra {\sphinxcolorpanelextraoverhang}
+\def\spx@table@rightcolorpanelextra{\sphinxcolorpanelextraoverhang}
+% the macro to which \CT@row@color will be set for coloured rows, serves both
+% in header and body, the colours must have been defined at time of use
+\def\spx@table@CT@row@color{\ifspx@table@inmergedcell
+                              \CT@color{sphinxTableMergeColor}%
+                            \else
+                              \CT@color{sphinxTableRowColor}%
+                            \fi
+                            \@tempdimb\dimexpr\col@sep+\spx@table@leftcolorpanelextra\relax
+                            \@tempdimc\dimexpr\col@sep+\spx@table@rightcolorpanelextra\relax
+                           }%
+% used by itself this will influence a single row if \CT@everycr is the
+% colortbl one, to influences all rows the \CT@everycr must be modified (see
+% below)
+\def\sphinxrowcolorON {\global\let\CT@row@color\spx@table@CT@row@color}%
+% this one turns off row colours until the next \sphinxrowcolorON
+\def\sphinxrowcolorOFF{\global\let\CT@row@color\relax}%
+% this one inhibits the row colour in one cell only (can be used as
+% >{\sphinxnorowcolor} for turning off row colours in a given column)
+\def\sphinxnorowcolor{\spx@table@hackCT@norowcolor}%
+
+% \sphinxtoprule (or rather \sphinxtabletoprulehook) will be modified by
+% the colorrows class to execute this one: 
+\def\spx@table@@toprule@rowcolorON{%
+        \noalign{%
+          % Because of tabulary 2-pass system, the colour set-up at end of table
+          % would contaminate the header colours at start of table, so must reset
+          % them here.  We want all header rows to obey same colours, so we don't
+          % use original \CT@everycr which sets \CT@row@color to \relax.
+          \global\CT@everycr{\the\everycr}%
+          \global\sphinxcolorlet{sphinxTableRowColor}{sphinxTableRowColorHeader}%
+          \global\sphinxcolorlet{sphinxTableMergeColor}{\sphinxTableMergeColorHeader}%
+          \sphinxrowcolorON
+         }%
+}%
+
+% \sphinxtableatstartofbodyhook will be modified by colorrows class to
+% execute this one; it starts the alternating colours and triggers increment
+% or \rownum count at each new row (the xcolor base method for \rowcolors)
+\def\spx@table@@startbodycolorrows{%
+    \noalign{%
+       \global\CT@everycr{% Nota Bene: in a longtable with \hline the \everycr is
+                          % done two extra times! but 2 is even, so this is ok
+          \noalign{\global\advance\rownum\@ne % the xcolor \rowcolors base trick
+% MEMO: colortbl \CT@row@color is expanded *after* the cell contents have been
+% gathered and measured, so it can't be used to expose e.g. the colour to the
+% cell contents macro code.  Of course if it is known how the colour is chosen
+% the procedure could be done from inside the cell.  Simpler to expose the colour
+% in a public name sphinxTableRowColor at start of the row in this \noalign.
+                   \sphinxSwitchCaseRowColor\rownum
+                  }%
+          \the\everycr
+       }%
+       \global\rownum\@ne % is done from inside table so ok with tabulary two passes
+       \sphinxSwitchCaseRowColor\rownum % set up color for the first body row
+       \sphinxrowcolorON  % has been done from \sphinxtoprule location but let's do
+                          % it again in case  \sphinxtabletoprulehook has been used
+                          % to inhibit colours in the header rows
+    }% end of noalign contents
+}
+% set the colours according to row parity; a priori #1 is \rownum, but
+% the macro has been designed to be usable in user level added code
+\def\sphinxSwitchCaseRowColor#1{%
+  \ifodd#1\relax
+    \global\sphinxcolorlet{sphinxTableRowColor}{sphinxTableRowColorOdd}%
+    \global\sphinxcolorlet{sphinxTableMergeColor}{\sphinxTableMergeColorOdd}%
+  \else
+    \global\sphinxcolorlet{sphinxTableRowColor}{sphinxTableRowColorEven}%
+    \global\sphinxcolorlet{sphinxTableMergeColor}{\sphinxTableMergeColorEven}%
+  \fi
+}
+
+% each \cline or \cmidrule (booktabs) consumes one \cr, offsetting the \rownum
+% parity; so this macro serves to compensate and must be added to each such
+% \cline or \cmidrule (see below)
+\def\spx@table@@decrementrownum{\noalign{\global\advance\rownum\m@ne}}
+\let\sphinxtabledecrementrownum\@empty
+
+% \sphinxtableafterendhook will be modified by colorrows class to execute
+% this after the table
+\def\spx@table@resetcolortbl{%
+    \sphinxrowcolorOFF
+    \spx@table@reset@CTeverycr
+% this last bit is done in order for the \sphinxbottomrule from the "foot"
+% longtable template to be able to use same code as the \sphinxbottomrule
+% at end of table body; see \sphinxbooktabsspecialbottomrule code
+    \global\rownum\z@
+}
+\def\spx@table@reset@CTeverycr{%
+% we should probably be more cautious and not hard-code here the colortbl
+% set-up; so the macro is defined without @ to fac
+    \global\CT@everycr{\noalign{\global\let\CT@row@color\relax}\the\everycr}%
+}
+
+% At last the style macros \sphinxthistablewithstandardstyle etc...
+
+% They are executed before the table environments in a scope limiting
+% wrapper "savenotes" environment.
+%
+% 0) colour support is enacted via adding code to three hooks:
+%    - \sphinxtabletoprulehook       (implicit from \sphinxtoprule expansion)
+%    - \sphinxtableatstartofbodyhook (explicit from table templates)
+%    - \sphinxtableafterendhook      (explicit from table templates)
+%    additionally special adjustment must be made in \sphinxcline
+%
+\def\sphinxtoprule{\spx@toprule\sphinxtabletoprulehook}
+% \spx@toprule is what is defined by the standard, booktabs and borderless
+% styles.
+% The colorrows class will prepend \spx@table@toprule@rowcolorON into
+% \sphinxtabletoprulehook which a priori is \@empty but can contain user added
+% extra code, and is executed after \spx@toprule.
+\let\sphinxtabletoprulehook      \@empty
+\let\sphinxtableatstartofbodyhook\@empty
+\let\sphinxtableafterendhook     \@empty
+%
+% 1) we manage these three hooks in a way allowing a custom user extra wrapper
+% environment from a container class to use them as entry point for some
+% custom code.  The container code is done first, prior to table templates.
+% So, the style macros will *prepend* the needed color-code to the existing
+% custom user code, so the custom user code can override them.  The custom
+% user code should not redefine any of the 3 \sphinxtable...hook macros via a
+% \global\def, but their contents can use \gdef.  In fact they probably need
+% to for the first two hooks which are executed from inside the table and
+% a priori need their code to be in a \noalign which limits scope.
+%
+% 2) the table templates and LaTeX writer code make it so that only
+% one of either
+%      \sphinxthistablewithcolorrowsstyle,
+% or   \sphinxthistablewithnocolorrowsstyle
+% will be inserted explicitly depending on local :class: for table.
+% The global 'colorrows' style in latex_table_style translates at bottom
+% of this file into code for inserting \sphinxthistablewithcolorrowsstyle
+% at end of \sphinxthistablewithglobalstyle.  So it is impossible
+% to have first \sphinxthistablewithnocolorrowsstyle, then
+% \sphinxthistablewithcolorrowsstyle.  Nevertheless we have written
+% the code so that in this case colorrows would indeed activate (except
+% if it was already executed before as it self-annihilates).
+
+% standard style
+\def\sphinxthistablewithstandardstyle{%
+    % Those two are produced by the latex writer
+    \def\sphinxhline      {\hline}%
+    % \sphinxtabledecrementrownum is a no-op which is redefined by colorrows
+    % to correct the \rownum increment induced by \cline in colorrows regime
+    \def\sphinxcline      {\sphinxtabledecrementrownum\cline}%
+    % LaTeX's \cline needs fixing
+    \let\sphinxvlinecrossing\sphinxtablevlinecrossing
+    \let\sphinxfixclines    \sphinxtablefixclines
+    % Those three are inserted by the table templates
+    \def\spx@toprule      {\hline}%
+    \def\sphinxmidrule    {\hline}%
+    \def\sphinxbottomrule {\hline}%
+    % Do not tamper with this internal
+    \def\spx@arrayrulewidth{\arrayrulewidth}%
+}
+
+% booktabs style
+% The \@xcmidrule patch below will do beyond its main stuff
+%     \sphinxadjustcmidrulebelowsep
+% Indeed the poor booktabs spacing with \cmidrule (if \sphinxbooktabscmidrule
+% defined below is overwritten to use it) is quite awful.  Do
+%     \let\sphinxadjustcmidrulebelowsep\empty
+% if you prefer booktabs defaults.
+\def\sphinxadjustcmidrulebelowsep{\belowrulesep=\aboverulesep}
+\AtBeginDocument{% patch booktabs to avoid extra vertical space from
+                 % consecutive \sphinxcline, if defined to use \cmidrule
+  \ifdefined\@xcmidrule
+    \let\spx@original@@xcmidrule\@xcmidrule
+    \def\@xcmidrule{\sphinxadjustcmidrulebelowsep
+                    % if we don't do that, two \sphinxcline in the same row
+                    % will cause the second short rule to be shifted down
+                    \ifx\@tempa\sphinxcline\let\@tempa\cmidrule\fi
+                    \spx@original@@xcmidrule}%
+  \fi
+}
+% wrappers to allow customization, e.g. via a container class
+% the top, mid, bottom definitions are in fact overwritten (later, below)
+% byt more complex ones needed to handle booktabs+colorrows context
+\def\sphinxbooktabstoprule   {\toprule}
+\def\sphinxbooktabsmidrule   {\midrule}
+\def\sphinxbooktabsbottomrule{\bottomrule}
+%
+\let\sphinxbooktabscmidrule  \@gobble % i.e. draw no short rules at all!
+% You can redefine this to use \cmidrule with various options, such
+% as \cmidrule(lr), but:
+% Attention, if you want this to use \cmidrule (or \cline) you must,
+% if the table uses row colours,
+% also include the \sphinxtabledecrementrownum token like e.g. this
+%     \def\sphinxbooktabscmidrule{\sphinxtabledecrementrownum\cmidrule(lr)}
+% and it must be first due to internals of the \cmidrule usage of \futurelet.
+
+\def\sphinxthistablewithbooktabsstyle{%
+    \let\sphinxhline\@empty % there is no wrapper macro here so if you want to change that
+                            % you will have to redefine \sphinxthistablewithbooktabsstyle
+    \def\sphinxcline     {\sphinxbooktabscmidrule}% defaults to give \@gobble
+    \let\sphinxvlinecrossing\@gobble % no | in a booktabs-style table !
+    \let\sphinxfixclines    \@gobble % should not be used with booktabs + \cmidrule
+    \def\spx@toprule     {\sphinxbooktabstoprule}%
+    \def\sphinxmidrule   {\sphinxbooktabsmidrule}%
+    \def\sphinxbottomrule{\sphinxbooktabsbottomrule}%
+    \def\spx@arrayrulewidth{\z@}%
+}
+\AtBeginDocument{\@ifpackageloaded{booktabs}%
+    {}%
+    {\def\sphinxthistablewithbooktabsstyle{%
+    \PackageWarning{sphinx}{%
+Add \string\usepackage{booktabs} to the preamble to allow\MessageBreak
+local use of booktabs table style}%
+    \sphinxbuildwarning{booktabs}%
+    \sphinxthistablewithstandardstyle
+    }}%
+}%
+
+% borderless style
+\def\sphinxthistablewithborderlessstyle{%
+    \let\sphinxhline      \@empty
+    \let\sphinxcline      \@gobble
+    \let\sphinxvlinecrossing\@gobble
+    \let\sphinxfixclines    \@gobble
+    \let\spx@toprule      \@empty
+    \let\sphinxmidrule    \@empty
+    \let\sphinxbottomrule \@empty
+    \def\spx@arrayrulewidth{\z@}%
+}%
+
+% colorrows style
+%
+\let\sphinxifthistablewithcolorrowsTF\@secondoftwo
+\def\sphinxthistablewithcolorrowsstyle{%
+    \let\sphinxifthistablewithcolorrowsTF\@firstoftwo
+% this is defined to auto-silence itself (in the surrounding scope-limiting
+% environment) after one execution ("colorrows" can never follow "nocolorrows")
+    \let\sphinxthistablewithcolorrowsstyle\@empty
+%
+    \let\spx@table@toprule@rowcolorON  \spx@table@@toprule@rowcolorON
+    \let\spx@table@startbodycolorrows  \spx@table@@startbodycolorrows
+    \let\sphinxtabledecrementrownum    \spx@table@@decrementrownum
+% Is it the best choice to "prepend" to existing code there?
+    \spx@prepend\spx@table@toprule@rowcolorON\to\sphinxtabletoprulehook
+    \spx@prepend\spx@table@startbodycolorrows\to\sphinxtableatstartofbodyhook
+%
+% this one is not set to \@empty by nocolorrows, because it looks harmless
+% to execute it always, as it simply resets to standard colortbl state after
+% the table; so we don't need an @@ version for this one
+    \spx@prepend\spx@table@resetcolortbl\to\sphinxtableafterendhook
+}
+\def\spx@prepend#1\to#2{% attention about using this only with #2 "storage macro"
+    \toks@{#1}%
+    \toks@\expandafter\expandafter\expandafter{\expandafter\the\expandafter\toks@#2}%
+    \edef#2{\the\toks@}%
+}%
+
+\def\sphinxthistablewithnocolorrowsstyle{%
+    \let\sphinxifthistablewithcolorrowsTF\@secondoftwo
+% rather than trying to remove the code added by 'colorrows' style, we 
+% simply make it no-op, without even checking if really it was activated.
+    \let\spx@table@toprule@rowcolorON\@empty
+    \let\spx@table@startbodycolorrows\@empty
+    \let\sphinxtabledecrementrownum  \@empty
+% we don't worry about \sphinxtableafterendhook as the \spx@table@resetcolortbl
+% done at end can not do harm; and we could also have not bothered with the
+% \sphinxtabledecrementrownum as its \rownum decrement, if active, is harmless
+% in non-colorrows context
+}
+
+% (not so easy) implementation of the booktabscolorgaps option.  This option
+% defaults to true and is not officially documented, as already colorrows is
+% only opt-in, so it is there only as a "turn-off" switch, but if nobody
+% complains in next few months, it will probably be removed altogether at
+% 6.0.0.  The reason it exists is because of longtable aspeces described
+% below.
+%
+% As it is used via \sphinxsetup booktabscolorgaps status is not known here
+% and may change locally.  So it must be implemented via delayed or
+% conditional code.
+%
+% We do not know the order of execution of \sphinxthistablewithbooktabsstyle
+% versus \sphinxthistablewithcolorrows: if booktabs is global option it
+% will be executed first; but if colorrows is global option and not booktabs
+% then colorrows will be executed first via \sphinxthistablewithglobalstyle
+%
+% Modifying things from locations such as \sphinxtabletoprulehook which are
+% executed within the table is not convenient as it must use \global
+% but then we would have to undo this after the table.
+%
+% So what we do is to prepare booktabs specific macros to incorporate
+% a conditional to check the colorrows status.  We must each time check
+% both if colorrows is activated and if colorgaps is.  We do this via
+% macros without @ so they can be used easily in customization code.
+% When and if booktabscolorgaps option is removed, we can then replace
+% \sphinxifbooktabswithcolorgapsTF by \sphinxifthistablewithcolorrowsTF
+\def\sphinxifbooktabswithcolorgapsTF{%
+    \if1\ifspx@opt@booktabscolorgaps
+        \sphinxifthistablewithcolorrowsTF{1}{0}%
+        \else0\fi
+         \expandafter\@firstoftwo
+    \else\expandafter\@secondoftwo
+    \fi
+}
+% as this is done without "@" it can be relatively easily be overwritten
+% by user in customization code
+\def\sphinxbooktabstoprule{%
+    \sphinxifbooktabswithcolorgapsTF
+    {\sphinxbooktabsspecialtoprule}%
+    {\toprule}%
+}%
+\def\sphinxbooktabscolorgapsoverhang{0.1pt}% avoid pixel/rounding effects
+% auxiliary fork
+\long\def\spx@table@crazyfork
+     #1\endfirsthead\endhead\sphinxtableatstartofbodyhook#2#3\@nil{#2}
+% we fetch the next token to check if there is a header or not
+% this is a bit fragile as it relies on the table templates
+% and it assumes this token #1 is never braced...
+% let's make this \long in case #1 is \par (should not be)
+\long\def\sphinxbooktabsspecialtoprule\sphinxtabletoprulehook#1{%
+    \specialrule{\heavyrulewidth}{\abovetopsep}{\z@}%
+    % this macro contains colour init code (and defines sphinxTableRowColor)
+    \sphinxtabletoprulehook
+    % unfortunately colortbl provides no way to save/restore the
+    % \arrayrulecolor status, we have to code it ourselves
+    \noalign{\global\let\spx@@saved@CT@arc@\CT@arc@
+% \@declaredcolor is not \long.  Although #1 can probably never be \par with
+% our templates, let's be cautious and not use the creazyfork inside the \color
+                  \spx@table@crazyfork
+% this crazy code checks if #1 is one of \endfirsthead, \endhead or
+% \sphinxtableatstartofbodyhook, as criterion for table with no header
+             #1\endhead\sphinxtableatstartofbodyhook\@secondoftwo
+             \endfirsthead#1\sphinxtableatstartofbodyhook\@secondoftwo
+             \endfirsthead\endhead#1\@secondoftwo
+             \endfirsthead\endhead\sphinxtableatstartofbodyhook\@firstoftwo
+                  \@nil
+             {\gdef\CT@arc@{\color{sphinxTableRowColor}}}%
+             {\gdef\CT@arc@{\color{sphinxTableRowColorOdd}}}%
+            }% end of \noalign
+    % \specialrule uses \noalign itself
+    \specialrule{\dimexpr\belowrulesep+\sphinxbooktabscolorgapsoverhang\relax}%
+                {\z@}{-\sphinxbooktabscolorgapsoverhang}%
+    \noalign{\global\let\CT@arc@\spx@@saved@CT@arc@}%
+    #1% let's not forget to re-insert this #1 in token stream
+      % fortunately longtable's \endfirsthead/\endhead are not delimiters but
+      % are really tokens awaiting expansion...
+}%
+\def\sphinxbooktabsmidrule{%
+   \sphinxifbooktabswithcolorgapsTF
+   {\sphinxbooktabsspecialmidrule}%
+   {\midrule}%
+}%
+\def\sphinxbooktabsspecialmidrule{%
+   \noalign{\global\let\spx@@saved@CT@arc@\CT@arc@
+            \gdef\CT@arc@{\color{sphinxTableRowColor}}% this is RowColorHeader
+   }%
+   \specialrule{\dimexpr\aboverulesep+\sphinxbooktabscolorgapsoverhang\relax\relax}%
+               {-\sphinxbooktabscolorgapsoverhang}{\z@}%
+   \noalign{\global\let\CT@arc@\spx@@saved@CT@arc@}%
+   \specialrule{\lightrulewidth}{\z@}{\z@}%
+   \noalign{\gdef\CT@arc@{\color{sphinxTableRowColorOdd}}}%
+   \specialrule{\dimexpr\belowrulesep+\sphinxbooktabscolorgapsoverhang\relax\relax}%
+               {\z@}{-\sphinxbooktabscolorgapsoverhang}%
+   \noalign{\global\let\CT@arc@\spx@@saved@CT@arc@}%
+}%
+\def\sphinxbooktabsbottomrule{%
+   \sphinxifbooktabswithcolorgapsTF
+   {\sphinxbooktabsspecialbottomrule}%
+   {\bottomrule}%
+}%
+% The colour here is already updated because of the \\ before so we must
+% execute again the colour selection code, but this is not too complicated.
+% What is annoying though is that \sphinxbottomrule in the longtable context
+% appears both in the "foot" part and after the last body row.  For the first
+% occurrence the \rownum could be arbitrary if it had not been reset by each
+% table using it via the \sphinxtableafterendhook (see above).  This avoids
+% having to modify the longtable template.  But as \rownum is thus 0 in the
+% "foot", the \sphinxSwitchCaseRowColor has to know how to handle negative
+% inputs (in fact the -1 value), the Sphinx definition has no issue with that
+% but any redefinition must be aware of this constraint.
+\def\sphinxbooktabsspecialbottomrule{%
+   \noalign{\global\let\spx@@saved@CT@arc@\CT@arc@
+            \sphinxSwitchCaseRowColor{\numexpr\rownum-\@ne\relax}%
+            \gdef\CT@arc@{\color{sphinxTableRowColor}}%
+   }%
+   \specialrule{\dimexpr\aboverulesep+\sphinxbooktabscolorgapsoverhang\relax}%
+               {-\sphinxbooktabscolorgapsoverhang}{\z@}%
+   \noalign{\global\let\CT@arc@\spx@@saved@CT@arc@}%
+   \specialrule{\heavyrulewidth}{\z@}{\belowbottomsep}%
+}%
+%
+% MEMO: with longtable \sphinxtoprule, \sphinxmidrule and \sphinxbottomrule
+% are evaluated at time of constructing the headers and footers as boxes
+% (already typeset material and expanded macros; \sphinxbottomrule is also
+% evaluated at very end of table body, i.e. "normally").  So the used colour
+% to fill the booktabs gaps is decided during the headers and footers
+% construction by longtable.  Actually they are expanded twice: in firsthead
+% then in head, respectively in foot and lastfoot.  But in current design the
+% header row colours are fixed, not alternating, so there is at least no
+% coherence issue there.
+
+% The \spx@arrayrulewidth is used for some complex matters of merged
+% cells size computations.
+% tabularcolumns argument will override any global or local style and
+% trigger the appropriate adjustment of \spx@arrayrulewidth.
+% Notice that this will be bad if the table uses booktabs style
+% but anyhow table with booktabs should not use any | separator.
+\def\sphinxthistablewithvlinesstyle{%
+    \def\spx@arrayrulewidth{\arrayrulewidth}%
+    \let\sphinxvlinecrossing\sphinxtablevlinecrossing
+    \let\sphinxfixclines    \sphinxtablefixclines
+}%
+\def\sphinxthistablewithnovlinesstyle{%
+    \def\spx@arrayrulewidth{\z@}%
+    \let\sphinxvlinecrossing\@gobble
+    % let's not bother to modify \sphinxfixclines, it works fine and is
+    % useful in standard style + no vline (only hlines and clines);
+    % besides, only one of vline or novline style macro is executed
+}%
+
+% default is the standard style
+\def\sphinxthistablewithglobalstyle{\sphinxthistablewithstandardstyle}
+
+\ifspx@opt@booktabs
+    \RequirePackage{booktabs}
+    \def\sphinxthistablewithglobalstyle{\sphinxthistablewithbooktabsstyle}
+\fi
+\ifspx@opt@borderless
+    \def\sphinxthistablewithglobalstyle{\sphinxthistablewithborderlessstyle}
+\fi
+% colorrows appends to the current globalstyle (standard, booktabs, or borderless)
+\ifspx@opt@colorrows % let the globalstyle trigger the colorrows style on top of it
+    \expandafter\def\expandafter\sphinxthistablewithglobalstyle\expandafter
+    {\sphinxthistablewithglobalstyle
+     \sphinxthistablewithcolorrowsstyle
+    }
+\fi
+
+
 \endinput

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxpackageboxes.sty Added

@@ -0,0 +1,854 @@
+%% COLOURED BOXES
+%
+% change this info string if making any custom modification
+\ProvidesPackage{sphinxpackageboxes}2023/03/19 v6.2.0 advanced colored boxes
+% Optionally executes \RequirePackage for:
+%
+% - pict2e.  Ideally we would like to use the v0.4a 2020/08/16 release of this
+%   package as it allows dimensional arguments to its \moveto, \lineto, etc...
+%   Or we could use extra package "picture".  We opt for custom wrappers
+%   \spx@moveto, \spx@lineto, ..., working with old versions.
+%
+% - ellipse.  This package extends pict2e with elliptical arcs.  Its author
+%   Daan Leijen also has contributed package longfbox which is part of
+%   TeXLive.  Had I known about it, I would perhaps have based Sphinx CSS on
+%   top of longfbox at least partly.  But this would not have spared me all
+%   the work in sphinx.sty, which was a long walk until 6.2.0 version.
+%   Besides I don't need the breakable boxes from longfbox, as Sphinx has
+%   its own rather advanced layer on top of framed.  I would need to check if
+%   some thorny color issues solved by Sphinx (and not by tcolorbox) at page
+%   breaks are solved by longfbox as well.  (I have not tested)
+
+%   At 6.2.0 refactoring, we do not wait for at begin document to try to load
+%   pict2e.  Actually since 6.0.0 the default is for code-blocks to use
+%   rounded boxes, and the only reason since then to wait "at begin document"
+%   was to check if user had reverted that default and in fact pict2e was not
+%   needed.  But with \sphinxbox, we can not know for sure even in that case
+%   that pict2e is not needed.  And even back then it would have been possible
+%   to user to try to employ \sphinxsetup via raw directive in document body
+%   and require some rounded corners (which was thus impossible to satisfy).
+%   Time to be much simpler and attempt unconditionally to load pict2e
+%   immediately.  This will also have advantage that we can use
+%   \@ifpackageloaded{pict2e} and not have to query and save its setting later
+%   at begin document.
+\IfFileExists{pict2e.sty}
+   {\RequirePackage{pict2e}}
+   {\PackageWarningNoLine{sphinx}{%
+     The package pict2e is required for rounded boxes.\MessageBreak
+     It does not seem to be available on your system.\MessageBreak
+     Options for setting radii will be ignored%
+    }%
+    % Formerly a \sphinxbuildwarning was issued but if we did that now it
+    % would mean that the produced PDF will always have a red banner near its
+    % end about pict2e not being available if indeed it is not available, even
+    % if user has reverted the default and dropped rounded corners.  Formerly
+    % the serious warning was done after having checked at begin document that
+    % indeed a rounded corner option had been used.  As we drop the check now,
+    % let's be more discrete and simply duplicate the earlier warning to make
+    % it visible near end of compilation log and console output.
+    \AtEndDocument{\PackageWarningNoLine{sphinx}{%
+     The package pict2e is required for rounded boxes.\MessageBreak
+     As it does not seem to be available on your system,\MessageBreak
+     options setting radii have all been ignored}}%
+   }%
+
+\IfFileExists{ellipse.sty}
+   {\RequirePackage{ellipse}}
+   {\PackageWarningNoLine{sphinx}{%
+     The package ellipse is required for elliptical corners.\MessageBreak
+     It does not seem to be available on your system.\MessageBreak
+     All non-straight corners will use circle arcs.%
+    }%
+    \AtEndDocument{\PackageWarningNoLine{sphinx}{%
+     The package ellipse is required for elliptical corners.\MessageBreak
+     As it does not seem to be available on your system,\MessageBreak
+     all non-straight corners have used circle arcs.}}%
+   }%
+
+% The pict2e release v0.4b of 2020/09/30 does not allocate scratch dimen
+% register \@tempdimd which ellipse package uses.  Thus ellipse package is
+% broken since (written on March 20, 2023).  Simply allocate the register
+% ourself to fix that, pending some upstream fix.
+\@ifpackageloaded{ellipse}{\ifdefined\@tempdimd\else\newdimen\@tempdimd\fi}{}
+
+% Provides box registers \spx@tempboxa, \spx@tempboxb usable in other places
+\newbox\spx@tempboxa
+\newbox\spx@tempboxb
+
+%%%%%%%%%%%%%%%%
+% Internal registers, conditionals, colors to be configured by each caller
+% via a preliminary "setup" call
+%
+\newif\ifspx@boxes@withshadow
+\newif\ifspx@boxes@insetshadow
+\newif\ifspx@boxes@withbackgroundcolor
+\newif\ifspx@boxes@withshadowcolor
+\newif\ifspx@boxes@withbordercolor
+\newif\ifspx@boxes@shadowinbbox
+%
+\newdimen\spx@boxes@border
+\newdimen\spx@boxes@border@top
+\newdimen\spx@boxes@border@right
+\newdimen\spx@boxes@border@bottom
+\newdimen\spx@boxes@border@left
+%
+\newdimen\spx@boxes@padding@top
+\newdimen\spx@boxes@padding@right
+\newdimen\spx@boxes@padding@bottom
+\newdimen\spx@boxes@padding@left
+%
+\newdimen\spx@boxes@shadow@xoffset
+\newdimen\spx@boxes@shadow@yoffset
+%
+\newdimen\spx@boxes@radius@topleft@x
+\newdimen\spx@boxes@radius@topright@x
+\newdimen\spx@boxes@radius@bottomright@x
+\newdimen\spx@boxes@radius@bottomleft@x
+\newdimen\spx@boxes@radius@topleft@y
+\newdimen\spx@boxes@radius@topright@y
+\newdimen\spx@boxes@radius@bottomright@y
+\newdimen\spx@boxes@radius@bottomleft@y
+%
+% These colors will be set to colors defined appropriately by caller of
+% \spx@boxes@fcolorbox@setup macro
+% spx@boxes@bordercolor
+% spx@boxes@backgroundcolor
+% spx@boxes@shadowcolor
+% spx@boxes@textcolor
+
+%%%%%%%%%%%%%%%%
+% "setup" macro
+%
+% It must be called prior to \spx@boxes@fcolorbox for parameters of the latter
+% to be initialized.
+%
+% It also prepares \spx@boxes@fcolorbox to expand to one of
+% \spx@boxes@fcolorbox@rectangle or \spx@boxes@fcolorbox@rounded depending on
+% the configuration and availability of the pict2e package.
+%
+% The #1 is one of: pre, topic, warning, danger, etc....
+%
+% We delay until here the parsing of radii options to extract x and y
+% components.
+\def\spx@boxes@setradii#1 #2 #3\@nnil#4#5{%
+  #4\dimexpr#1\relax
+  #5\dimexpr#2\relax
+  \ifdim#5=-\maxdimen#5#4\fi
+  % if one of them is zero or negative set both to zero
+  \ifdim#4>\z@\else#4\z@#5\z@\fi
+  \ifdim#5>\z@\else#4\z@#5\z@\fi
+}%
+% if ellipse.sty is not available ignore the second component of all radii
+% specifications, use circle arcs with radius the x component
+\@ifpackageloaded{ellipse}
+   {}
+   {\def\spx@boxes@setradii#1 #2 #3\@nnil#4#5{#4\dimexpr#1\relax #5#4}}
+
+% Using \dimexpr for maximal user input flexibility.
+\def\spx@boxes@fcolorbox@setup#1{%
+  \spx@boxes@border@top   \dimexpr\@nameuse{spx@#1@border@top}\relax
+  \spx@boxes@border@right \dimexpr\@nameuse{spx@#1@border@right}\relax
+  \spx@boxes@border@bottom\dimexpr\@nameuse{spx@#1@border@bottom}\relax
+  \spx@boxes@border@left  \dimexpr\@nameuse{spx@#1@border@left}\relax
+  \spx@boxes@border       \dimexpr\@nameuse{spx@#1@border}\relax
+  %
+  \spx@boxes@padding@top   \dimexpr\@nameuse{spx@#1@padding@top}\relax
+  \spx@boxes@padding@right \dimexpr\@nameuse{spx@#1@padding@right}\relax
+  \spx@boxes@padding@bottom\dimexpr\@nameuse{spx@#1@padding@bottom}\relax
+  \spx@boxes@padding@left  \dimexpr\@nameuse{spx@#1@padding@left}\relax
+  %
+  \edef\spx@temp{\csname spx@#1@radius@topleft\endcsname\space}%
+  \expandafter
+        \spx@boxes@setradii
+        \spx@temp
+        {-\maxdimen}
+        \@nnil
+        \spx@boxes@radius@topleft@x\spx@boxes@radius@topleft@y
+  \edef\spx@temp{\csname spx@#1@radius@topright\endcsname\space}%
+  \expandafter
+        \spx@boxes@setradii
+        \spx@temp
+        {-\maxdimen}
+        \@nnil
+        \spx@boxes@radius@topright@x\spx@boxes@radius@topright@y
+  \edef\spx@temp{\csname spx@#1@radius@bottomright\endcsname\space}%
+  \expandafter
+        \spx@boxes@setradii
+        \spx@temp
+        {-\maxdimen}
+        \@nnil
+        \spx@boxes@radius@bottomright@x\spx@boxes@radius@bottomright@y
+  \edef\spx@temp{\csname spx@#1@radius@bottomleft\endcsname\space}%
+  \expandafter
+        \spx@boxes@setradii
+        \spx@temp
+        {-\maxdimen}
+        \@nnil
+        \spx@boxes@radius@bottomleft@x\spx@boxes@radius@bottomleft@y
+  %
+  \@nameuse{ifspx@#1@withshadow}%
+     \spx@boxes@withshadowtrue
+     \spx@boxes@shadow@xoffset \dimexpr\@nameuse{spx@#1@shadow@xoffset}\relax
+     \spx@boxes@shadow@yoffset \dimexpr\@nameuse{spx@#1@shadow@yoffset}\relax
+  \else
+     \spx@boxes@withshadowfalse
+  \fi
+  % not nesting in previous to avoid TeX conditional subtleties
+  \@nameuse{ifspx@#1@insetshadow}%
+     \spx@boxes@insetshadowtrue
+  \else
+     \spx@boxes@insetshadowfalse
+  \fi
+  %
+  \@nameuse{ifspx@#1@withbordercolor}%
+    \spx@boxes@withbordercolortrue
+    \sphinxcolorlet{spx@boxes@bordercolor}{sphinx#1BorderColor}%
+  \else
+    \spx@boxes@withbordercolorfalse
+  \fi
+  %
+  \@nameuse{ifspx@#1@withbackgroundcolor}%
+    \spx@boxes@withbackgroundcolortrue
+    \sphinxcolorlet{spx@boxes@backgroundcolor}{sphinx#1BgColor}%
+  \else
+    \spx@boxes@withbackgroundcolorfalse
+  \fi
+  %
+  \@nameuse{ifspx@#1@withshadowcolor}%
+    \spx@boxes@withshadowcolortrue
+    \sphinxcolorlet{spx@boxes@shadowcolor}{sphinx#1ShadowColor}%
+  \else
+    \spx@boxes@withshadowcolorfalse
+  \fi
+  % Display elements pre, topic, warning et al. by default do not include
+  % shadow in box (legacy; and only topic actually uses a shadow per default)
+  % This may be refactored still more in future, but this 6.2.0 extra helped
+  % reduce workload from code-blocks (pre), contents (topic) and admonitions.
+  % As this conditional is a priori false and should only be changed locally
+  % (by \sphinxbox), this line is actually superfluous.
+  \spx@boxes@shadowinbboxfalse
+  \spx@boxes@fcolorbox@setup@fcolorbox
+}
+\@ifpackageloaded{pict2e}
+{%  pict2e is available and loaded
+ \def\spx@boxes@fcolorbox@setup@fcolorbox{%
+  \if1% use rounded boxes only if needed (rx>0 iff ry>0)
+    \ifdim\spx@boxes@radius@topleft@x    >\z@0\fi
+    \ifdim\spx@boxes@radius@topright@x   >\z@0\fi
+    \ifdim\spx@boxes@radius@bottomright@x>\z@0\fi
+    \ifdim\spx@boxes@radius@bottomleft@x >\z@0\fi
+    1\def\spx@boxes@fcolorbox{\spx@boxes@fcolorbox@rectangle}%
+  \else
+    \def\spx@boxes@fcolorbox{\spx@boxes@fcolorbox@rounded}%
+  \fi
+ }% end of definition of setup@fcolorbox in case of presence of pict2e
+}%
+{% pict2e could not be loaded, we must always use fcolorbox@rectangle
+ \def\spx@boxes@fcolorbox@setup@fcolorbox{%
+    \def\spx@boxes@fcolorbox{\spx@boxes@fcolorbox@rectangle}%
+ }% end of definition of setup@fcolorbox in case of absence of pict2e
+}% end of "no pict2e" branch
+
+%%%%%%%%%%%%%%%%
+% Support of box-decoration-break=slice
+%
+% 6.2.0 has renamed and moved this here from sphinxlatexliterals.sty,
+% to facilitate supporting box-decoration-break=slice for all directives,
+% not only code-block.
+%
+% It also modified when these post actions are executed, in order
+% for openboth to be able to trigger usage of fcolorbox@rectangle.
+% So now openbottom and opentop also take advantage of this possible
+% optimization.
+\def\spx@boxes@fcolorbox@setup@openbottom{%
+    \spx@boxes@border@bottom     \z@
+    \spx@boxes@radius@bottomright@x\z@ \spx@boxes@radius@bottomright@y\z@
+    \spx@boxes@radius@bottomleft@x \z@ \spx@boxes@radius@bottomleft@y \z@
+    \spx@boxes@fcolorbox@setup@fcolorbox
+}%
+\def\spx@boxes@fcolorbox@setup@opentop{%
+    \spx@boxes@border@top     \z@
+    \spx@boxes@radius@topright@x\z@ \spx@boxes@radius@topright@y\z@
+    \spx@boxes@radius@topleft@x \z@ \spx@boxes@radius@topleft@y \z@
+    \spx@boxes@fcolorbox@setup@fcolorbox
+}%
+\def\spx@boxes@fcolorbox@setup@openboth{%
+    \spx@boxes@border@top     \z@
+    \spx@boxes@border@bottom  \z@
+    \spx@boxes@radius@bottomright@x\z@ \spx@boxes@radius@bottomright@y\z@
+    \spx@boxes@radius@bottomleft@x \z@ \spx@boxes@radius@bottomleft@y \z@
+    \spx@boxes@radius@topright@x\z@ \spx@boxes@radius@topright@y\z@
+    \spx@boxes@radius@topleft@x \z@ \spx@boxes@radius@topleft@y \z@
+    \def\spx@boxes@fcolorbox{\spx@boxes@fcolorbox@rectangle}%
+}%
+
+%%%%%%%%%%%%%%%%
+% \sphinxbox (added at 6.2.0)
+%
+% For an inline box, possibly rounded.
+\newcommand\sphinxbox1{% #1 stands for the options, they are... optional!
+  % \leavevmode makes sure TeX switches to paragraph mode, which is necessary
+  % if this is first in a paragraph or a list element.  The \sphinxAtStartPar
+  % mechanism also ensures this automatically, if not redefined, but not with
+  % lualatex as then it is by default doing nothing.
+  \leavevmode
+  \begingroup
+    \ifcsname spx@boxes@sphinxbox@isnested\endcsname
+        % nested boxes reset all box options to be as the \sphinxboxsetup
+        % defaults, before applying their specific options
+        \spx@boxes@sphinxbox@reset
+    \else
+        % top layer box, toggle the nested flag
+        \csname spx@boxes@sphinxbox@isnested\endcsname
+    \fi
+    % we do not use \sphinxboxsetup as it is a user command extending the
+    % "reset" storage
+    \setkeys{sphinxbox}{#1}%
+    \spx@boxes@fcolorbox@setup{box}%
+    \spx@boxes@shadowinbboxtrue% inline sphinx boxes include shadow in bbox
+    \ifspx@box@withtextcolor\color{sphinxboxTextColor}\fi
+    %
+    % MEMO: the fcolorbox@{rectangle,rounded} draw the contents (which here
+    % will be encapsulated as \box\z@) last, i.e.  after shadow, background,
+    % and border and their color commands.  The \reset@color from naked
+    % top-level \color commands in argument (which can not arise from Sphinx
+    % mark-up anyhow) would end up being placed via color.sty \aftergroup core
+    % mechanism in token stream after \spx@boxes@sphinxbox@a (which is the
+    % first \aftergroup) hence after the box contents with its unbalanced
+    % color pushes is shipped to PDF.  So the missing color pop specials are
+    % inserted then in correct order at correct place (after the \endgroup at
+    % end of \spx@boxes@sphinxbox@a but this is not relevant) and do not end
+    % up causing havoc in push/pop pairs (and all this happens on same page).
+    %
+    % There is thus no reason here to go to the trouble to add an extra
+    % \color@begingroup/\color@endgroup or like pair to encapsulate the caught
+    % contents in order for the \box\z@ to contain as many color pop's as it
+    % has color pushes.  But as this is subtle, this comment was added for
+    % future maintenance.  Actually even if the contents were not drawn last,
+    % their (purely theoretical, as Sphinx mark-up can not create it) missing
+    % color pop's would not have caused trouble I guess as long as the color
+    % insertions for shadow, background, border are correctly balanced.
+    \setbox0\hbox\bgroup\aftergroup\spx@boxes@sphinxbox@a
+    \afterassignment\spx@box@TeXextras
+    \let\next=%
+}
+\def\spx@boxes@sphinxbox@a{\spx@boxes@fcolorbox{%
+    \ifspx@opt@box@addstrut\strut\fi\box\z@}\endgroup}
+
+\newcommand\newsphinxbox2{%
+   \newcommand#21{\sphinxbox#1,##1}%
+}
+% Let's catch \renewsphinxbox...{\sphinxbox} which would cause \sphinxbox
+% to fall into infinite looping on use.
+\newcommand\renewsphinxbox2{%
+   \in@{#2}{\sphinxbox}%
+   \ifin@
+      \PackageWarning{sphinx}{Attempt to \string\renewsphinxbox\space
+        the \string\sphinxbox\space command\MessageBreak
+        itself.  This is not allowed and will be ignored.\MessageBreak
+        Reported}%
+   \else
+     \renewcommand#21{\sphinxbox#1,##1}%
+   \fi
+}
+
+%%%%%%%%%%%%%%%%
+% MACROS
+%
+% \spx@boxes@fcolorbox expands either to \spx@boxes@fcolorbox@rectangle
+% or \spx@boxes@fcolorbox@rounded depending on preliminary set-up.
+%
+% This is decided by the "setup" which must have been executed by the caller.
+% Let's give it some (thus unneeded) default fall-back for clarity.
+\def\spx@boxes@fcolorbox{\spx@boxes@fcolorbox@rectangle}
+%
+% A macro \spx@boxes@fcolorbox@setuphook used to be executed at start of the
+% \hbox constructs (rectangle or rounded).  This was used until 6.2.0 for the
+% support of pre_box-decoration-break option, hence was really an internal
+% non-public macro.  As it is not needed anymore, with some hesitation it got
+% entirely removed at 6.2.0 on the occasion of a refactoring of interactions of
+% this file with sphinxlatexliterals.sty.  Besides its name should have been
+% rather something such as \spx@boxes@fcolorbox@atstartofhbox.
+%
+% After "setup", \spx@boxes@fcolorbox expands to one of:
+%
+% - \spx@boxes@fcolorbox@rectangle (4 padding parameters, 4 border widths, 2 shadow widths,
+%   and three colours: background, border and shadow; same as in CSS styling)
+%
+%   It branches to one of:
+%   - \spx@boxes@fcolorbox@externalshadow
+%   - \spx@boxes@fcolorbox@insetshadow    (same concept of "inset" as in CSS styling)
+%
+% - \spx@boxes@fcolorbox@rounded: rounded corners using the picture environment
+%   and pict2e package for its low-weight interface to PDF graphics operations
+
+% MEMO: we have also successfully tested usage of tcolorbox.sty (its \tcbox) but
+% decided to use pict2e.sty for the following reasons:
+% 1- PDF build was observed to be an order of magnitude faster,
+% 2- the boxes we can do with pict2e appear to be fancy enough,
+%    almost matching what one can see in HTML renderings,
+% 2- orders of magnitude smaller dependency (tcolorbox uses the pgf TeX
+%    framework), although on Ubuntu it seems texlive-pictures is
+%    needed which also contains the whole of pgf/TikZ... so this point
+%    is a bit moot...
+
+% For code-blocks, attachments of caption and continuation hints are done
+% exactly as prior to extension of Sphinx via this package, whether the box
+% has straight or rounded corners.  The vertical space occupied is the same,
+% if nothing else is changed (perhaps in future the title itself could be also
+% rendered in a rounded box?)
+
+%%%%%%%%
+%//// \spx@boxes@fcolorbox@rectangle
+%
+% This box will have the same baseline as its argument (which is typeset in
+% horizontal mode).  It takes into account four border widths parameters, four
+% padding parameters, two shadow widths (each possibly negative), and three
+% colors: background, border and shadow.  Its boundary box takes into account
+% border and padding.  Width of shadow is taken into account if the boolean
+% \ifspx@boxes@shadowinbbox is \iftrue.  The "setup" sets it to \iffalse.
+% Prior to 6.2.0, shadow size was included in bbox but the callers manually
+% removed it by extra steps.  The \sphinxbox command sets it to \iftrue after
+% the "setup".
+%
+% It is up to the caller to take extra steps if the border and padding must go
+% into margin as well (see sphinxlatexliterals.sty for how this is done in
+% \spx@verb@FrameCommand).
+%
+% In usage as a "FrameCommand" with framed.sty, the argument will already be a
+% collection of TeX boxes (and interline glues).
+%
+% This was designed so that the parameters configured by "setup" are
+% interpreted as they would be as CSS properties in an HTML context.
+\long\def\spx@boxes@fcolorbox@rectangle#1{%
+  \hbox\bgroup
+  \setbox\spx@tempboxa
+   \hbox{\kern\dimexpr\spx@boxes@border@left+\spx@boxes@padding@left\relax
+         {#1}%
+         \kern\dimexpr\spx@boxes@padding@right+\spx@boxes@border@right\relax}%
+  \ht\spx@tempboxa
+     \dimexpr\ht\spx@tempboxa+\spx@boxes@border@top+\spx@boxes@padding@top\relax
+  \dp\spx@tempboxa
+     \dimexpr\dp\spx@tempboxa+\spx@boxes@padding@bottom+\spx@boxes@border@bottom\relax
+  \ifspx@boxes@insetshadow
+     \expandafter\spx@boxes@fcolorbox@insetshadow
+  \else
+     \expandafter\spx@boxes@fcolorbox@externalshadow
+  \fi
+}
+
+% external shadow
+\def\spx@boxes@fcolorbox@externalshadow{%
+  % reserve space to external shadow if on left
+  \ifspx@boxes@withshadow
+   \ifspx@boxes@shadowinbbox
+    \ifdim\spx@boxes@shadow@xoffset<\z@\kern-\spx@boxes@shadow@xoffset\fi
+   \fi
+  \fi
+  % BACKGROUND
+  % draw background and move back to reference point
+  \ifspx@boxes@withbackgroundcolor
+   {\color{spx@boxes@backgroundcolor}%
+    \vrule\@height\ht\spx@tempboxa
+          \@depth\dp\spx@tempboxa
+          \@width\wd\spx@tempboxa
+    \kern-\wd\spx@tempboxa
+    }%
+  \fi
+  % BOX SHADOW
+  % draw shadow and move back to reference point
+  \ifspx@boxes@withshadow
+  \vbox{%
+    \moveright\spx@boxes@shadow@xoffset
+    \hbox{\lower\spx@boxes@shadow@yoffset
+          \vbox{\ifspx@boxes@withshadowcolor
+                    \color{spx@boxes@shadowcolor}%
+                \else
+                    % 6.2.0: guard against a manually inserted \color command in
+                    % contents which could leak at a page break to the shadow
+                    \normalcolor
+                \fi
+                \ifdim\spx@boxes@shadow@yoffset<\z@
+                  \hrule\@height-\spx@boxes@shadow@yoffset
+                  \kern\spx@boxes@shadow@yoffset
+                \fi
+                \setbox\spx@tempboxb\hb@xt@\wd\spx@tempboxa{%
+                 \ifdim\spx@boxes@shadow@xoffset<\z@\vrule\@width-\spx@boxes@shadow@xoffset\fi
+                 \hss
+                 \ifdim\spx@boxes@shadow@xoffset>\z@\vrule\@width\spx@boxes@shadow@xoffset\fi
+                 }%
+                \ht\spx@tempboxb\ht\spx@tempboxa
+                \dp\spx@tempboxb\dp\spx@tempboxa
+                \box\spx@tempboxb
+                \ifdim\spx@boxes@shadow@yoffset>\z@
+                  \kern-\spx@boxes@shadow@yoffset
+                  \hrule\@height\spx@boxes@shadow@yoffset
+                \fi
+                \kern-\dp\spx@tempboxa
+               }% end of \vbox, attention it will have zero depth if yoffset>0
+          \kern-\wd\spx@tempboxa
+          \ifdim\spx@boxes@shadow@xoffset>\z@
+            \kern-\spx@boxes@shadow@xoffset
+          \fi
+         }% end of \hbox, attention its depth is only yoffset if yoffset>0
+       }% end of \vbox
+  \fi % end of shadow drawing, and we are back to horizontal reference point
+  % BOX BORDER
+  \vbox{\ifspx@boxes@withbordercolor
+            \color{spx@boxes@bordercolor}%
+        \else
+            % 6.2.0: guard against a \color command in contents whose effect
+            % could leak to border at a pagebreak
+            \normalcolor
+        \fi
+        \hrule\@height\spx@boxes@border@top
+           \kern-\spx@boxes@border@top
+        \setbox\spx@tempboxb\hb@xt@\wd\spx@tempboxa
+                  {\vrule\@width\spx@boxes@border@left
+                   \hss\vrule\@width\spx@boxes@border@right
+                  }%
+            \ht\spx@tempboxb\ht\spx@tempboxa
+            \dp\spx@tempboxb\dp\spx@tempboxa
+        \box\spx@tempboxb
+        \kern-\spx@boxes@border@bottom
+        \hrule\@height\spx@boxes@border@bottom
+        \kern-\dp\spx@tempboxa
+       }% attention this box has zero depth due to \hrule at bottom
+  % step back to horizontal reference point
+  \kern-\wd\spx@tempboxa
+  % end of border drawing
+  % CONTENTS
+  % adjust the total depth to include the bottom shadow
+  \ifspx@boxes@withshadow
+    \ifdim\spx@boxes@shadow@yoffset>\z@
+      \dp\spx@tempboxa\dimexpr\dp\spx@tempboxa+\spx@boxes@shadow@yoffset\relax
+    \fi
+  \fi
+  \box\spx@tempboxa
+  % include lateral shadow in total width
+  \ifspx@boxes@withshadow
+   \ifspx@boxes@shadowinbbox
+    \ifdim\spx@boxes@shadow@xoffset>\z@\kern\spx@boxes@shadow@xoffset\fi
+   \fi
+  \fi
+  \egroup
+}
+
+% inset shadow
+%
+% The parameters signs are interpreted as in CSS styling.
+\def\spx@boxes@fcolorbox@insetshadow{%
+  % BACKGROUND
+  % draw background and move back to reference point
+  \ifspx@boxes@withbackgroundcolor
+   {\color{spx@boxes@backgroundcolor}%
+    \vrule\@height\ht\spx@tempboxa
+          \@depth\dp\spx@tempboxa
+          \@width\wd\spx@tempboxa
+    \kern-\wd\spx@tempboxa
+    }%
+  \fi
+  % BOX SHADOW
+  % draw shadow and move back to reference point
+  \ifspx@boxes@withshadow
+    \hbox{\vbox{\ifspx@boxes@withshadowcolor
+                    \color{spx@boxes@shadowcolor}%
+                \else
+                    % 6.2.0: guard against a manually inserted \color command in
+                    % contents which could leak at a page break to the shadow
+                    \normalcolor
+                \fi
+% NOTA BENE
+% We deliberately draw shadow partially under an area later covered by frame
+% with the idea to avoid anti-aliasing problems but in fact this may be a bad
+% idea with border is thin.
+% This may need some extra testing with PDF viewers... reports welcome!
+                \ifdim\spx@boxes@shadow@yoffset>\z@
+                  \hrule\@height\dimexpr\spx@boxes@border@top+\spx@boxes@shadow@yoffset\relax
+                  \kern-\spx@boxes@shadow@yoffset
+                  \kern-\spx@boxes@border@top
+                \fi
+                \setbox\spx@tempboxb\hb@xt@\wd\spx@tempboxa{%
+                 \ifdim\spx@boxes@shadow@xoffset>\z@
+                  \vrule\@width\dimexpr\spx@boxes@border@left+\spx@boxes@shadow@xoffset\relax\fi
+                 \hss
+                 \ifdim\spx@boxes@shadow@xoffset<\z@
+                  \vrule\@width\dimexpr-\spx@boxes@shadow@xoffset+\spx@boxes@border@right\relax\fi
+                 }%
+                \ht\spx@tempboxb\ht\spx@tempboxa
+                \dp\spx@tempboxb\dp\spx@tempboxa
+                \box\spx@tempboxb
+                \ifdim\spx@boxes@shadow@yoffset<\z@
+                  \kern\spx@boxes@shadow@yoffset
+                  \kern-\spx@boxes@border@bottom
+                  \hrule\@height\dimexpr-\spx@boxes@shadow@yoffset+\spx@boxes@border@bottom\relax
+                \fi
+                \kern-\dp\spx@tempboxa
+               }% end of \vbox, attention it will have zero depth if yoffset<0
+          \kern-\wd\spx@tempboxa
+         }% end of \hbox, attention its depth is only |yoffset| if yoffset<0
+  \fi % end of inset shadow drawing, and we are back to horizontal reference point
+  % BOX BORDER
+  \vbox{\ifspx@boxes@withbordercolor
+            \color{spx@boxes@bordercolor}%
+        \else
+            % 6.2.0: guard against a \color command in contents whose effect
+            % could leak to border at a pagebreak
+            \normalcolor
+        \fi
+        \hrule\@height\spx@boxes@border@top
+           \kern-\spx@boxes@border@top
+        \setbox\spx@tempboxb\hb@xt@\wd\spx@tempboxa
+                  {\vrule\@width\spx@boxes@border@left
+                   \hss\vrule\@width\spx@boxes@border@right
+                  }%
+            \ht\spx@tempboxb\ht\spx@tempboxa
+            \dp\spx@tempboxb\dp\spx@tempboxa
+        \box\spx@tempboxb
+        \kern-\spx@boxes@border@bottom
+        \hrule\@height\spx@boxes@border@bottom
+        \kern-\dp\spx@tempboxa
+       }% attention this box has zero depth due to \hrule at bottom
+  % step back to horizontal reference point
+  \kern-\wd\spx@tempboxa
+  % end of border drawing
+  % CONTENTS
+  \box\spx@tempboxa
+  \egroup
+}
+
+% let's abort input if pict2e package could not be loaded.
+% To be extra safe we also alias @rounded to @rectangle but
+% a priori the architecture is done so that @rounded will never
+% be called in that case by other Sphinx LaTeX components.
+\@ifpackageloaded{pict2e}
+  {}
+  {\def\spx@boxes@fcolorbox@rounded{\spx@boxes@fcolorbox@rectangle}%
+   \endinput
+  }
+
+% we proceed now in the context of pict2e being available and loaded
+% (TeX being a macro-expansion based language it would have
+%  swallowed all the coming definitions even if pict2e
+%  had in fact not been loaded... but we aborted the input above)
+%%%%%%%%
+%//// \spx@boxes@fcolorbox@rounded
+%
+% Prior to 6.2.0, a constant border-width was applied as the border was
+% obtained as a \strokepath.  This allowed 4 distinct radii but not to vary the
+% border widths.  Now the border is drawn by two \fillpath operation, the first
+% one filling up to external border, the second one actually filling for the
+% background paradoxically on top of it, up to internal border path.
+%
+% This 6.2.0 abandonment of \strokepath allowed great simplification in
+% supporting opentop, openbottom and openboth situations, and it can
+% allow automatic support of openleft and openright analogs.
+%
+% And 6.2.0 also implements elliptical arcs thanks to ellipse package,
+% which extends pict2e.
+
+% Currently, inset shadow is not supported.
+%
+% Prior to 6.2.0 an inset shadow triggered the rectangle variant, so we never
+% ended here, but now it is simply ignored.  This change does not appear to me
+% to be breaking, as it changes output only for conf.py's specifying both
+% rounded corners and an inset shadow and the documentation said it was
+% incompatible.
+
+% wrappers for pict2e usage if old
+% Better not to copy over 2020 pict2e definitions in case
+% something internal changes
+% However our wrappers will work ONLY with dimensional inputs
+% No need to pre-expand the arguments
+% Braces in case the expression uses parentheses
+\def\spx@moveto(#1,#2){\moveto({\strip@pt\dimexpr#1\relax},{\strip@pt\dimexpr#2\relax})}
+\def\spx@lineto(#1,#2){\lineto({\strip@pt\dimexpr#1\relax},{\strip@pt\dimexpr#2\relax})}
+% attention here the N becomes mandatory
+% \circlearc<N>{<X>}{<Y>}{<RAD>}{<ANGLE1>}{<ANGLE2>}
+\def\spx@circlearc#1#2#3#4%#5#6
+   {\circlearc#1{\strip@pt\dimexpr#2\relax}%
+                  {\strip@pt\dimexpr#3\relax}%
+                  {\strip@pt\dimexpr#4\relax}%
+   }
+% attention here too the N becomes mandatory
+% the core path macro of ellipse.sty.  Thanks to Daan Leijen, author of this
+% package.
+% \elliparc <initial>{<center-x>}{<center-y>}{<x-rad>}{<y-rad>}{<start-angle>}{<end-angle>}
+% maybe this wrapper is unneeded but I don't have real time to check
+\def\spx@elliparc#1#2#3#4#5%#6#7
+   {\elliparc#1{\strip@pt\dimexpr#2\relax}%
+                 {\strip@pt\dimexpr#3\relax}%
+                 {\strip@pt\dimexpr#4\relax}%
+                 {\strip@pt\dimexpr#5\relax}%
+   }
+
+% Macro whose execution prepares a path to be either stroked or filled
+% Only fill operation is used at 6.2.0.  The radii are given by the set box
+% parameters, but the width and height are in \spx@width and \spx@height.  A
+% \put command will be used for appropriate shifts.
+% 6.2.0 adds elliptical corners!
+% But I feel perhaps I need to think about how x-radius and y-radius should
+% interact with border-width.  So consider output WIP for time being.
+\def\spx@boxes@border@defpath{%
+  \spx@moveto(\spx@boxes@radius@bottomleft@x,\z@)% our \spx@moveto is a bit rigid
+                                                 % and we must use \z@ not 0 here
+  \spx@lineto(\spx@width-\spx@boxes@radius@bottomright@x,\z@)%
+  % x and y radii are either both positive or both zero
+  % probably not needed to actually guard against the latter case,
+  % let's do it nevertheless
+  \ifdim\spx@boxes@radius@bottomright@x>\z@
+    \ifdim\spx@boxes@radius@bottomright@x=\spx@boxes@radius@bottomright@y
+      \spx@circlearc2{\spx@width-\spx@boxes@radius@bottomright@x}%
+                       {\spx@boxes@radius@bottomright@y}%
+                       {\spx@boxes@radius@bottomright@x}{-90}{0}%
+    \else
+      \spx@elliparc2{\spx@width-\spx@boxes@radius@bottomright@x}%
+                      {\spx@boxes@radius@bottomright@y}%
+                      {\spx@boxes@radius@bottomright@x}
+                      {\spx@boxes@radius@bottomright@y}{-90}{0}%
+    \fi
+  \fi
+  \spx@lineto(\spx@width,%
+              \spx@height-\spx@boxes@radius@topright@y)%
+  \ifdim\spx@boxes@radius@topright@x>\z@
+    \ifdim\spx@boxes@radius@topright@x=\spx@boxes@radius@topright@y
+      \spx@circlearc2{\spx@width-\spx@boxes@radius@topright@x}
+                       {\spx@height-\spx@boxes@radius@topright@y}%
+                       {\spx@boxes@radius@topright@x}{0}{90}%
+    \else
+      \spx@elliparc2{\spx@width-\spx@boxes@radius@topright@x}
+                      {\spx@height-\spx@boxes@radius@topright@y}%
+                      {\spx@boxes@radius@topright@x}%
+                      {\spx@boxes@radius@topright@y}{0}{90}%
+    \fi
+  \fi
+  \spx@lineto(\spx@boxes@radius@topleft@x,\spx@height)%
+  \ifdim\spx@boxes@radius@topleft@x>\z@
+    \ifdim\spx@boxes@radius@topleft@x=\spx@boxes@radius@topleft@y
+      \spx@circlearc2{\spx@boxes@radius@topleft@x}%
+                       {\spx@height-\spx@boxes@radius@topleft@y}%
+                       {\spx@boxes@radius@topleft@x}{90}{180}%
+    \else
+      \spx@elliparc2{\spx@boxes@radius@topleft@x}%
+                      {\spx@height-\spx@boxes@radius@topleft@y}%
+                      {\spx@boxes@radius@topleft@x}%
+                      {\spx@boxes@radius@topleft@y}{90}{180}%
+    \fi
+  \fi
+  \spx@lineto(\z@,\spx@boxes@radius@bottomleft@y)%
+  \ifdim\spx@boxes@radius@bottomleft@x>\z@
+    \ifdim\spx@boxes@radius@bottomleft@x=\spx@boxes@radius@bottomleft@y
+      \spx@circlearc2{\spx@boxes@radius@bottomleft@x}%
+                       {\spx@boxes@radius@bottomleft@y}%
+                       {\spx@boxes@radius@bottomleft@x}{180}{270}%
+    \else
+      \spx@elliparc2{\spx@boxes@radius@bottomleft@x}%
+                      {\spx@boxes@radius@bottomleft@y}%
+                      {\spx@boxes@radius@bottomleft@x}%
+                      {\spx@boxes@radius@bottomleft@y}{180}{270}%
+    \fi
+  \fi
+}% end of definition of \spx@boxes@border@defpath
+
+% The customization of the various parameters must have been done via an
+% appropriate call to \spx@boxes@fcolorbox@setup, which will have set up
+% \spx@boxes@fcolorbox to expand to \spx@boxes@fcolorbox@rounded, and will
+% have set its various parameters.
+%
+\long\def\spx@boxes@fcolorbox@rounded #1{%
+  \hbox{%
+   \ifspx@boxes@withshadow
+     \ifspx@boxes@insetshadow
+       \spx@boxes@withshadowfalse % ignore inset shadow
+     \fi
+   \fi
+   % reserve space to external shadow if on left
+   \ifspx@boxes@withshadow
+    \ifspx@boxes@shadowinbbox
+     \ifdim\spx@boxes@shadow@xoffset<\z@\kern-\spx@boxes@shadow@xoffset\fi
+    \fi
+   \fi
+   \vbox{%
+     % adjust vertical bbox
+     \ifspx@boxes@withshadow
+       \ifdim\spx@boxes@shadow@yoffset<\z@
+           \kern-\spx@boxes@shadow@yoffset
+       \fi
+     \fi
+     \setlength{\unitlength}{1pt}%
+     \setbox\spx@tempboxa
+     \hbox{\kern\dimexpr\spx@boxes@border@left+\spx@boxes@padding@left\relax
+           {#1}%
+           \kern\dimexpr\spx@boxes@padding@right+\spx@boxes@border@right\relax}%
+     \ht\spx@tempboxa
+     \dimexpr\ht\spx@tempboxa+\spx@boxes@border@top+\spx@boxes@padding@top\relax
+     \dp\spx@tempboxa
+     \dimexpr\dp\spx@tempboxa+\spx@boxes@padding@bottom+\spx@boxes@border@bottom\relax
+     \edef\spx@width{\number\wd\spx@tempboxa sp}%
+     \edef\spx@height{\number\dimexpr\ht\spx@tempboxa+\dp\spx@tempboxa sp}%
+     \hbox{%
+   \begin{picture}%
+      % \strip@pt\dimexpr to work around "old" LaTeX picture limitation
+      % (we could use the "picture" package, this would add another dependency)
+      (\strip@pt\dimexpr\spx@width\relax,\strip@pt\dimexpr\spx@height\relax)%
+      \spx@boxes@border@defpath
+      \ifspx@boxes@withshadow
+              \ifspx@boxes@withshadowcolor
+                 \color{spx@boxes@shadowcolor}%
+              \else
+                 % 6.2.0: here and elsewhere guard against a manually inserted
+                 % \color command in contents which could leak to the shadow
+                 % to the shadow
+                 \normalcolor
+              \fi
+              \put(\strip@pt\spx@boxes@shadow@xoffset,%
+                   \strip@pt\dimexpr-\spx@boxes@shadow@yoffset\relax)
+                   {\fillpath}%
+      \fi
+      \spx@boxes@border@defpath% must be redone after each \fillpath! (even if
+                               % was in a  \put)
+      \ifspx@boxes@withbordercolor
+         \color{spx@boxes@bordercolor}%
+      \else
+         \normalcolor
+      \fi
+      \fillpath
+      \ifspx@boxes@withbackgroundcolor
+         \color{spx@boxes@backgroundcolor}%
+      \else
+         \color{white}%
+      \fi
+      \edef\spx@width{\number\dimexpr\spx@width-\spx@boxes@border@left
+                                               -\spx@boxes@border@right sp}%
+      \edef\spx@height{\number\dimexpr\spx@height-\spx@boxes@border@top
+                                                 -\spx@boxes@border@bottom sp}%
+      % redefine a path (in relative coordinates) matching the area delimited
+      % by the internal borders
+      \spx@boxes@border@defpath
+      % use \put to shift, and fill it with background color
+      \put(\strip@pt\spx@boxes@border@left,\strip@pt\spx@boxes@border@bottom)
+          {\fillpath}%
+   \end{picture}}% end of picture \hbox in \vbox
+   % back-up vertically for outputting the contents
+   \kern-\dimexpr\ht\spx@tempboxa+\dp\spx@tempboxa\relax
+     % adjust vertical bbox
+     \ifspx@boxes@withshadow
+       \ifdim\spx@boxes@shadow@yoffset>\z@
+           \dp\spx@tempboxa\dimexpr\dp\spx@tempboxa+\spx@boxes@shadow@yoffset\relax
+       \fi
+     \fi
+   % inhibit TeX's "line skip" adjustment when piling up hboxes in a vbox
+   \nointerlineskip
+   \box\spx@tempboxa
+   }% end of \vbox
+  % include lateral shadow in total width
+  \ifspx@boxes@withshadow
+   \ifspx@boxes@shadowinbbox
+    \ifdim\spx@boxes@shadow@xoffset>\z@\kern\spx@boxes@shadow@xoffset\fi
+   \fi
+  \fi
+  }% end of \hbox
+}%
+
+
+\endinput

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/texinputs/sphinxpackagefootnote.sty -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/texinputs/sphinxpackagefootnote.sty Changed

@@ -1,27 +1,37 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{sphinxpackagefootnote}%
- 2021/02/04 v1.1d footnotehyper adapted to sphinx (Sphinx team)
-% Provides support for this output mark-up from Sphinx latex writer:
-% - footnote environment
-% - savenotes environment (table templates)
-% - \sphinxfootnotemark
-%
+ 2022/08/15 v5.3.0 Sphinx custom footnotehyper package (Sphinx team)
 %%
 %% Package: sphinxpackagefootnote
 %% Version: based on footnotehyper.sty 2021/02/04 v1.1d
-%% as available at https://www.ctan.org/pkg/footnotehyper
+%%          https://www.ctan.org/pkg/footnotehyper
 %% License: the one applying to Sphinx
 %%
-%% Refer to the PDF documentation  at https://www.ctan.org/pkg/footnotehyper for
-%% the code comments.
+% Provides support for footnote mark-up from Sphinx latex writer:
+% - "footnote" and "footnotetext"  environments allowing verbatim material
+% - "savenotes" environment for wrapping environments, such as for tables
+%   which have problems with LaTeX footnotes
+% - hyperlinks
+% 
+% Sphinx uses exclusively this mark-up for footnotes:
+% - \begin{footnote}N
+% - \begin{footnotetext}N
+% - \sphinxfootnotemarkN
+% where N is a number.
+%
+%% Some small differences from upstream footnotehyper.sty:
+%% - a tabulary compatibility layer (partial but enough for Sphinx),
+%% - usage of \spx@opt@BeforeFootnote
+%% - usage of \sphinxunactivateextrasandspace from sphinx.sty,
+%% - \sphinxlongtablepatch
+%%
+%% Starting with Sphinx v4.5.0, inherited footnotehyper macros for
+%% footnote/footnotetext receive some Sphinx specific extras to
+%% implement "intelligent" footnote marks checking page numbers.
 %%
-%% Differences:
-%% 1. a partial tabulary compatibility layer added (enough for Sphinx mark-up),
-%% 2. use of \spx@opt@BeforeFootnote from sphinx.sty,
-%% 3. use of \sphinxunactivateextrasandspace from sphinx.sty,
-%% 4. macro definition \sphinxfootnotemark,
-%% 5. macro definition \sphinxlongtablepatch
-%% 6. replaced some \undefined by \@undefined
+%% All footnotes output from Sphinx are hyperlinked. With "savenotes"
+%% footnotes may appear on page distinct from footnote mark, the latter
+%% will indicate page number of the footnote.
 \newif\iffootnotehyperparse\footnotehyperparsetrue
 \DeclareOption*{\PackageWarning{sphinxpackagefootnote}{Option `\CurrentOption' is unknown}}%
 \ProcessOptions\relax
@@ -42,6 +52,7 @@
     \let\footnotetext   \FNH@footnotetext
     \let\endfootnote    \FNH@endfntext
     \let\endfootnotetext\FNH@endfntext
+    % always True branch taken with Sphinx
     \@ifpackageloaded{hyperref}
      {\ifHy@hyperfootnotes
          \let\FNH@H@@footnotetext\H@@footnotetext
@@ -175,12 +186,40 @@
 }%
 \def\FNH@footnoteenv@i#1{%
     \begingroup
+     % This legacy code from LaTeX core restricts #1 to be digits only
+     % This limitation could be lifted but legacy Sphinx anyhow obeys it
      \csname c@\@mpfn\endcsname #1\relax
      \unrestored@protected@xdef\@thefnmark{\thempfn}%
     \endgroup
+% -- Sphinx specific:
+% currently commented out due to 
+% https://github.com/sphinx-doc/sphinx/pull/10191#issuecomment-1038807448
+% Memo: memoir class detection of successive footnote marks (to separate them
+%       by commas) is broken by \refstepcounter and also by \label, and some
+%       mitigation such as in \sphinxfootref would be needed
+      % \global\let\spx@saved@thefnmark\@thefnmark
+      % % this is done to access robustly the page number where footnote mark is
+      % \refstepcounter{sphinxfootnotemark}\label{footnotemark.\thesphinxfootnotemark}%
+      % % if possible, compare page numbers of mark and footnote to define \@thefnmark 
+      % \ltx@ifundefined{r@\thesphinxscope.footnote.#1}%
+      % {}%                           one more latex run is needed
+      % {\sphinx@xdef@thefnmark{#1}}% check of page numbers possible
+% --
     \@footnotemark
     \def\FNH@endfntext@fntext{\@footnotetext}%
+% -- Sphinx specific:
+      % we need to reset \@thefnmark as it is used by \FNH@startfntext via
+      % \FNH@startnote to set \@currentlabel which will be used by \label
+% currently commented out (see above)
+      % \global\let\@thefnmark\spx@saved@thefnmark
+% --
     \FNH@startfntext
+% -- again Sphinx specific
+      % \@currentlabel as needed by \label got set by \FNH@startnote
+      % insert this at start of footnote text then the label will allow
+      % to robustly know on which page the footnote text ends up
+% currently only of use for extra footnote marks so in case footnote multiply referred
+      \phantomsection\label{\thesphinxscope.footnote.#1}%
 }%
 \def\FNH@footnotetext{%
     \ifx\@currenvir\FNH@footnotetext@envname
@@ -207,6 +246,8 @@
       \def\FNH@endfntext@fntext{\FNH@H@@footnotetext}%
     \fi
     \FNH@startfntext
+% -- Sphinx specific addition
+    \phantomsection\label{\thesphinxscope.footnote.#1}%
 }%
 \def\FNH@startfntext{%
   \setbox\z@\vbox\bgroup
@@ -297,6 +338,7 @@
 }%
 % slight reformulation for Sphinx
 \def\FNH@bad@makefntext@alert{%
+  \sphinxbuildwarning{badfootnotes}%
   \PackageWarningNoLine{sphinxpackagefootnote}%
     {Footnotes will be sub-optimal, sorry. This is due to the document class or^^J
   some package modifying macro \string\@makefntext.^^J
@@ -329,60 +371,55 @@
 }%
 %
 % some extras for Sphinx :
-% \sphinxfootnotemark: usable in section titles and silently removed from TOCs.
+% \sphinxfootnotemark:
+% - if in section titles will auto-remove itself from TOC
 \def\sphinxfootnotemark #1%
    {\ifx\thepage\relax\else\sphinxfootref{#1}\fi}%
-% \sphinxfootref:
-% - \spx@opt@BeforeFootnote is from BeforeFootnote sphinxsetup option
-% - \ref:
-%     the latex.py writer inserts a \phantomsection\label{<scope>.<num>}
-%     whenever
-%     - the footnote was explicitly numbered in sources,
-%     - or it was in restrained context and is rendered using footnotetext
-%
-%     These are the two types of footnotes that \sphinxfootnotemark must
-%     handle. But for explicitly numbered footnotes the same number
-%     can be found in document. So a secondary part in  <scope> is updated
-%     at each novel such footnote to know what is the target from then on
-%     for \sphinxfootnotemark and already encountered 1, or 2,...
-%
-% LaTeX package varioref is not supported by hyperref (from its doc: "There
-% are too many problems with varioref. Nobody has time to sort them out.
-% Therefore this package is now unsupported.") So we will simply use our own
-% macros to access the page number of footnote text and decide whether to print
-% it. \pagename is internationalized by latex-babel.
-\def\spx@thefnmark#1#2{%
-  % #1=label for reference, #2=page where footnote was printed
-  \ifx\spx@tempa\spx@tempb
-     % same page
-     #1%
-  \else
-    \sphinxthefootnotemark{#1}{#2}%
-  \fi
+\newcounter{sphinxfootnotemark}
+\renewcommand\thesphinxfootnotemark{\number\value{sphinxfootnotemark}}
+% - compares page number of footnote mark versus the one of footnote text
+\def\sphinx@xdef@thefnmark#1{%
+   \expandafter\expandafter\expandafter\sphinx@footref@get
+               \csname r@\thesphinxscope.footnote.#1\endcsname\relax
+   \expandafter\expandafter\expandafter\sphinx@footmark@getpage
+               \csname r@footnotemark.\thesphinxfootnotemark\endcsname\thepage\relax
+   \protected@xdef\@thefnmark{%
+     \ifx\spx@footmarkpage\spx@footrefpage
+       \spx@footreflabel
+     \else
+       % the macro \sphinxthefootnotemark is in sphinx.sty
+       \sphinxthefootnotemark{\spx@footreflabel}{\spx@footrefpage}%
+     \fi
+     }%
+}%
+\def\sphinx@footref@get #1#2#3#4#5\relax{%
+    \def\spx@footreflabel{#1}%
+    \def\spx@footrefpage {#2}%
+    \def\spx@footrefHref {#4}%
 }%
-\def\sphinxfootref@get #1#2#3#4#5\relax{%
-    \def\sphinxfootref@label{#1}%
-    \def\sphinxfootref@page {#2}%
-    \def\sphinxfootref@Href {#4}%
+\def\sphinx@footmark@getpage #1#2#3\relax{%
+    \edef\spx@footmarkpage{#2}%
 }%
-\protected\def\sphinxfootref#1{% #1 always explicit number in Sphinx usage
+\protected\def\sphinxfootref#1{% #1 always is explicit number in Sphinx
   \spx@opt@BeforeFootnote
-  \ltx@ifundefined{r@\thesphinxscope.#1}%
-    {\gdef\@thefnmark{?}\H@@footnotemark}%
-    {\expandafter\expandafter\expandafter\sphinxfootref@get
-                 \csname r@\thesphinxscope.#1\endcsname\relax
-     \edef\spx@tempa{\thepage}\edef\spx@tempb{\sphinxfootref@page}%
-     \protected@xdef\@thefnmark{\spx@thefnmark{\sphinxfootref@label}{\sphinxfootref@page}}%
-     \let\spx@@makefnmark\@makefnmark
-     \def\@makefnmark{%
-       \hyper@linkstart{link}{\sphinxfootref@Href}%
-       \spx@@makefnmark
+  % each of \refstepcounter and \label interferes with memoir class detection
+  % of successive footnote marks, so we move them to inside \@makefnmark
+  \let\spx@saved@makefnmark\@makefnmark
+  \ltx@ifundefined{r@\thesphinxscope.footnote.#1}%
+    {\gdef\@thefnmark{?}% on first LaTeX run
+     \refstepcounter{sphinxfootnotemark}\label{footnotemark.\thesphinxfootnotemark}%
+    }%
+    {\sphinx@xdef@thefnmark{#1}% also defines \spx@footrefHref
+     \def\@makefnmark{% will be used by \H@@footnotemark
+       \refstepcounter{sphinxfootnotemark}\label{footnotemark.\thesphinxfootnotemark}%
+       \hyper@linkstart{link}{\spx@footrefHref}%
+       \spx@saved@makefnmark
        \hyper@linkend
-     }%
-     \H@@footnotemark
-     \let\@makefnmark\spx@@makefnmark
+      }%
     }%
-}%
+  \H@@footnotemark
+  \let\@makefnmark\spx@saved@makefnmark
+}%  
 \AtBeginDocument{%
    % let hyperref less complain
    \pdfstringdefDisableCommands{\def\sphinxfootnotemark #1{}}%

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/agogo/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/agogo/layout.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/agogo/static/agogo.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/agogo/static/agogo.css_t Changed

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- agogo theme.
  *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
@@ -271,7 +271,8 @@
 
 /* Sidebar */
 
-div.sidebar {
+div.sidebar,
+aside.sidebar {
   width: {{ theme_sidebarwidth|todim }};
   {%- if theme_rightsidebar|tobool %}
   float: right;
@@ -281,26 +282,29 @@
   font-size: .9em;
 }
 
-div.sidebar a, div.header a {
+div.sidebar a, aside.sidebar a, div.header a {
   text-decoration: none;
 }
 
-div.sidebar a:hover, div.header a:hover {
+div.sidebar a:hover, aside.sidebar a:hover, div.header a:hover {
   text-decoration: underline;
 }
 
-div.sidebar h3 {
+div.sidebar h3,
+aside.sidebar h3 {
   color: #2e3436;
   text-transform: uppercase;
   font-size: 130%;
   letter-spacing: .1em;
 }
 
-div.sidebar ul {
+div.sidebar ul,
+aside.sidebar ul {
   list-style-type: none;
 }
 
-div.sidebar li.toctree-l1 a {
+div.sidebar li.toctree-l1 a,
+aside.sidebar li.toctree-l1 a {
   display: block;
   padding: 1px;
   border: 1px solid #dddddd;
@@ -310,37 +314,44 @@
   color: #2e3436;
 }
 
-div.sidebar li.toctree-l2 a {
+div.sidebar li.toctree-l2 a,
+aside.sidebar li.toctree-l2 a {
   background-color: transparent;
   border: none;
   margin-left: 1em;
   border-bottom: 1px solid #dddddd;
 }
 
-div.sidebar li.toctree-l3 a {
+div.sidebar li.toctree-l3 a,
+aside.sidebar li.toctree-l3 a {
   background-color: transparent;
   border: none;
   margin-left: 2em;
   border-bottom: 1px solid #dddddd;
 }
 
-div.sidebar li.toctree-l2:last-child a {
+div.sidebar li.toctree-l2:last-child a,
+aside.sidebar li.toctree-l2:last-child a {
   border-bottom: none;
 }
 
-div.sidebar li.toctree-l1.current a {
+div.sidebar li.toctree-l1.current a,
+aside.sidebar li.toctree-l1.current a {
   border-right: 5px solid {{ theme_headerlinkcolor }};
 }
 
-div.sidebar li.toctree-l1.current li.toctree-l2 a {
+div.sidebar li.toctree-l1.current li.toctree-l2 a,
+aside.sidebar li.toctree-l1.current li.toctree-l2 a {
   border-right: none;
 }
 
-div.sidebar inputtype="text" {
+div.sidebar inputtype="text",
+aside.sidebar inputtype="text" {
   width: 170px;
 }
 
-div.sidebar inputtype="submit" {
+div.sidebar inputtype="submit",
+aside.sidebar inputtype="submit" {
   width: 30px;
 }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/defindex.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/defindex.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/domainindex.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/domainindex.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/genindex-single.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/genindex-single.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/genindex-split.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/genindex-split.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/genindex.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/genindex.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/globaltoc.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/globaltoc.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/layout.html Changed

@@ -4,15 +4,12 @@
 
     Master layout template for Sphinx themes.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+    :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
     :license: BSD, see LICENSE for details.
 #}
-{%- block doctype -%}{%- if html5_doctype %}
+{%- block doctype -%}
 <!DOCTYPE html>
-{%- else %}
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-{%- endif %}{%- endblock %}
+{%- endblock %}
 {%- set reldelim1 = reldelim1 is not defined and ' &#187;' or reldelim1 %}
 {%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %}
 {%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and
@@ -81,6 +78,7 @@
             {%- endblock %}
           {%- endif %}
         </div>
+        {%- block sidebarextra %}{%- endblock %}
       </div>
       {%- endif %}
 {%- endmacro %}
@@ -104,17 +102,10 @@
 {%- if html_tag %}
 {{ html_tag }}
 {%- else %}
-<html{% if not html5_doctype %} xmlns="http://www.w3.org/1999/xhtml"{% endif %}{% if language is not none %} lang="{{ language }}"{% endif %}>
+<html{% if language is not none %} lang="{{ language }}"{% endif %}>
 {%- endif %}
   <head>
-    {%- if not html5_doctype and not skip_ua_compatible %}
-    <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
-    {%- endif %}
-    {%- if use_meta_charset or html5_doctype %}
     <meta charset="{{ encoding }}" />
-    {%- else %}
-    <meta http-equiv="Content-Type" content="text/html; charset={{ encoding }}" />
-    {%- endif %}
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     {{- metatags }}
     {%- block htmltitle %}
@@ -136,7 +127,7 @@
           href="{{ pathto('_static/opensearch.xml', 1) }}"/>
     {%- endif %}
     {%- if favicon_url %}
-    <link rel="shortcut icon" href="{{ favicon_url|e }}"/>
+    <link rel="icon" href="{{ favicon_url|e }}"/>
     {%- endif %}
     {%- endif %}
 {%- block linktags %}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/localtoc.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/localtoc.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/page.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/page.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/relations.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/relations.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/search.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/search.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/searchbox.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/searchbox.html Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/searchfield.html Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/sourcelink.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/sourcelink.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/basic.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/static/basic.css_t Changed

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- basic theme.
  *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
@@ -237,16 +237,6 @@
     visibility: hidden;
 }
 
-a.brackets:before,
-span.brackets > a:before{
-    content: "";
-}
-
-a.brackets:after,
-span.brackets > a:after {
-    content: "";
-}
-
 h1:hover > a.headerlink,
 h2:hover > a.headerlink,
 h3:hover > a.headerlink,
@@ -335,12 +325,16 @@
     font-weight: bold;
 }
 
+nav.contents,
+aside.topic,
 div.admonition, div.topic, blockquote {
     clear: left;
 }
 
 /* -- topics ---------------------------------------------------------------- */
 
+nav.contents,
+aside.topic,
 div.topic {
     border: 1px solid #ccc;
     padding: 7px;
@@ -379,6 +373,8 @@
 
 div.sidebar > :last-child,
 aside.sidebar > :last-child,
+nav.contents > :last-child,
+aside.topic > :last-child,
 div.topic > :last-child,
 div.admonition > :last-child {
     margin-bottom: 0;
@@ -386,6 +382,8 @@
 
 div.sidebar::after,
 aside.sidebar::after,
+nav.contents::after,
+aside.topic::after,
 div.topic::after,
 div.admonition::after,
 blockquote::after {
@@ -428,10 +426,6 @@
     border-bottom: 1px solid #aaa;
 }
 
-table.footnote td, table.footnote th {
-    border: 0 !important;
-}
-
 th {
     text-align: left;
     padding-right: 5px;
@@ -615,19 +609,26 @@
     margin-bottom: 0;
 }
 
-dl.footnote > dt,
-dl.citation > dt {
+aside.footnote > span,
+div.citation > span {
     float: left;
-    margin-right: 0.5em;
 }
-
-dl.footnote > dd,
-dl.citation > dd {
+aside.footnote > span:last-of-type,
+div.citation > span:last-of-type {
+  padding-right: 0.5em;
+}
+aside.footnote > p {
+  margin-left: 2em;
+}
+div.citation > p {
+  margin-left: 4em;
+}
+aside.footnote > p:last-of-type,
+div.citation > p:last-of-type {
     margin-bottom: 0em;
 }
-
-dl.footnote > dd:after,
-dl.citation > dd:after {
+aside.footnote > p:last-of-type:after,
+div.citation > p:last-of-type:after {
     content: "";
     clear: both;
 }
@@ -644,10 +645,6 @@
     padding-right: 5px;
 }
 
-dl.field-list > dt:after {
-    content: ":";
-}
-
 dl.field-list > dd {
     padding-left: 0.5em;
     margin-top: 0em;

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/doctools.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/static/doctools.js Changed

@@ -2,325 +2,155 @@
  * doctools.js
  * ~~~~~~~~~~~
  *
- * Sphinx JavaScript utilities for all documentation.
+ * Base JavaScript utilities for all Sphinx HTML documentation.
  *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
-
-/**
- * select a different prefix for underscore
- */
-$u = _.noConflict();
-
-/**
- * make the code below compatible with browsers without
- * an installed firebug like debugger
-if (!window.console || !console.firebug) {
-  var names = "log", "debug", "info", "warn", "error", "assert", "dir",
-    "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
-    "profile", "profileEnd";
-  window.console = {};
-  for (var i = 0; i < names.length; ++i)
-    window.consolenamesi = function() {};
-}
- */
-
-/**
- * small helper function to urldecode strings
- *
- * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL
- */
-jQuery.urldecode = function(x) {
-  if (!x) {
-    return x
-  }
-  return decodeURIComponent(x.replace(/\+/g, ' '));
-};
-
-/**
- * small helper function to urlencode strings
- */
-jQuery.urlencode = encodeURIComponent;
-
-/**
- * This function returns the parsed url parameters of the
- * current request. Multiple values per key are supported,
- * it will always return arrays of strings for the value parts.
- */
-jQuery.getQueryParameters = function(s) {
-  if (typeof s === 'undefined')
-    s = document.location.search;
-  var parts = s.substr(s.indexOf('?') + 1).split('&');
-  var result = {};
-  for (var i = 0; i < parts.length; i++) {
-    var tmp = partsi.split('=', 2);
-    var key = jQuery.urldecode(tmp0);
-    var value = jQuery.urldecode(tmp1);
-    if (key in result)
-      resultkey.push(value);
-    else
-      resultkey = value;
+"use strict";
+
+const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set(
+  "TEXTAREA",
+  "INPUT",
+  "SELECT",
+  "BUTTON",
+);
+
+const _ready = (callback) => {
+  if (document.readyState !== "loading") {
+    callback();
+  } else {
+    document.addEventListener("DOMContentLoaded", callback);
   }
-  return result;
 };
 
 /**
- * highlight a given string on a jquery object by wrapping it in
- * span elements with the given class name.
- */
-jQuery.fn.highlightText = function(text, className) {
-  function highlight(node, addItems) {
-    if (node.nodeType === 3) {
-      var val = node.nodeValue;
-      var pos = val.toLowerCase().indexOf(text);
-      if (pos >= 0 &&
-          !jQuery(node.parentNode).hasClass(className) &&
-          !jQuery(node.parentNode).hasClass("nohighlight")) {
-        var span;
-        var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
-        if (isInSVG) {
-          span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
-        } else {
-          span = document.createElement("span");
-          span.className = className;
-        }
-        span.appendChild(document.createTextNode(val.substr(pos, text.length)));
-        node.parentNode.insertBefore(span, node.parentNode.insertBefore(
-          document.createTextNode(val.substr(pos + text.length)),
-          node.nextSibling));
-        node.nodeValue = val.substr(0, pos);
-        if (isInSVG) {
-          var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
-          var bbox = node.parentElement.getBBox();
-          rect.x.baseVal.value = bbox.x;
-          rect.y.baseVal.value = bbox.y;
-          rect.width.baseVal.value = bbox.width;
-          rect.height.baseVal.value = bbox.height;
-          rect.setAttribute('class', className);
-          addItems.push({
-              "parent": node.parentNode,
-              "target": rect});
-        }
-      }
-    }
-    else if (!jQuery(node).is("button, select, textarea")) {
-      jQuery.each(node.childNodes, function() {
-        highlight(this, addItems);
-      });
-    }
-  }
-  var addItems = ;
-  var result = this.each(function() {
-    highlight(this, addItems);
-  });
-  for (var i = 0; i < addItems.length; ++i) {
-    jQuery(addItemsi.parent).before(addItemsi.target);
-  }
-  return result;
-};
-
-/*
- * backward compatibility for jQuery.browser
- * This will be supported until firefox bug is fixed.
- */
-if (!jQuery.browser) {
-  jQuery.uaMatch = function(ua) {
-    ua = ua.toLowerCase();
-
-    var match = /(chrome) \/(\w.+)/.exec(ua) ||
-      /(webkit) \/(\w.+)/.exec(ua) ||
-      /(opera)(?:.*version|) \/(\w.+)/.exec(ua) ||
-      /(msie) (\w.+)/.exec(ua) ||
-      ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:(\w.+)|)/.exec(ua) ||
-      ;
-
-    return {
-      browser: match 1  || "",
-      version: match 2  || "0"
-    };
-  };
-  jQuery.browser = {};
-  jQuery.browserjQuery.uaMatch(navigator.userAgent).browser = true;
-}
-
-/**
  * Small JavaScript module for the documentation.
  */
-var Documentation = {
-
-  init : function() {
-    this.fixFirefoxAnchorBug();
-    this.highlightSearchWords();
-    this.initIndexTable();
-    if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) {
-      this.initOnKeyListeners();
-    }
+const Documentation = {
+  init: () => {
+    Documentation.initDomainIndexTable();
+    Documentation.initOnKeyListeners();
   },
 
   /**
    * i18n support
    */
-  TRANSLATIONS : {},
-  PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; },
-  LOCALE : 'unknown',
+  TRANSLATIONS: {},
+  PLURAL_EXPR: (n) => (n === 1 ? 0 : 1),
+  LOCALE: "unknown",
 
   // gettext and ngettext don't access this so that the functions
   // can safely bound to a different name (_ = Documentation.gettext)
-  gettext : function(string) {
-    var translated = Documentation.TRANSLATIONSstring;
-    if (typeof translated === 'undefined')
-      return string;
-    return (typeof translated === 'string') ? translated : translated0;
+  gettext: (string) => {
+    const translated = Documentation.TRANSLATIONSstring;
+    switch (typeof translated) {
+      case "undefined":
+        return string; // no translation
+      case "string":
+        return translated; // translation exists
+      default:
+        return translated0; // (singular, plural) translation tuple exists
+    }
   },
 
-  ngettext : function(singular, plural, n) {
-    var translated = Documentation.TRANSLATIONSsingular;
-    if (typeof translated === 'undefined')
-      return (n == 1) ? singular : plural;
-    return translatedDocumentation.PLURALEXPR(n);
+  ngettext: (singular, plural, n) => {
+    const translated = Documentation.TRANSLATIONSsingular;
+    if (typeof translated !== "undefined")
+      return translatedDocumentation.PLURAL_EXPR(n);
+    return n === 1 ? singular : plural;
   },
 
-  addTranslations : function(catalog) {
-    for (var key in catalog.messages)
-      this.TRANSLATIONSkey = catalog.messageskey;
-    this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
-    this.LOCALE = catalog.locale;
+  addTranslations: (catalog) => {
+    Object.assign(Documentation.TRANSLATIONS, catalog.messages);
+    Documentation.PLURAL_EXPR = new Function(
+      "n",
+      `return (${catalog.plural_expr})`
+    );
+    Documentation.LOCALE = catalog.locale;
   },
 
   /**
-   * add context elements like header anchor links
+   * helper function to focus on search bar
    */
-  addContextElements : function() {
-    $('divid > :header:first').each(function() {
-      $('<a class="headerlink">\u00B6</a>').
-      attr('href', '#' + this.id).
-      attr('title', _('Permalink to this headline')).
-      appendTo(this);
-    });
-    $('dtid').each(function() {
-      $('<a class="headerlink">\u00B6</a>').
-      attr('href', '#' + this.id).
-      attr('title', _('Permalink to this definition')).
-      appendTo(this);
-    });
+  focusSearchBar: () => {
+    document.querySelectorAll("inputname=q")0?.focus();
   },
 
   /**
-   * workaround a firefox stupidity
-   * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075
+   * Initialise the domain index toggle buttons
    */
-  fixFirefoxAnchorBug : function() {
-    if (document.location.hash && $.browser.mozilla)
-      window.setTimeout(function() {
-        document.location.href += '';
-      }, 10);
-  },
-
-  /**
-   * highlight the search words provided in the url in the text
-   */
-  highlightSearchWords : function() {
-    var params = $.getQueryParameters();
-    var terms = (params.highlight) ? params.highlight0.split(/\s+/) : ;
-    if (terms.length) {
-      var body = $('div.body');
-      if (!body.length) {
-        body = $('body');
+  initDomainIndexTable: () => {
+    const toggler = (el) => {
+      const idNumber = el.id.substr(7);
+      const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`);
+      if (el.src.substr(-9) === "minus.png") {
+        el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`;
+        toggledRows.forEach((el) => (el.style.display = "none"));
+      } else {
+        el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`;
+        toggledRows.forEach((el) => (el.style.display = ""));
       }
-      window.setTimeout(function() {
-        $.each(terms, function() {
-          body.highlightText(this.toLowerCase(), 'highlighted');
-        });
-      }, 10);
-      $('<p class="highlight-link"><a href="javascript:Documentation.' +
-        'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
-          .appendTo($('#searchbox'));
-    }
-  },
-
-  /**
-   * init the domain index toggle buttons
-   */
-  initIndexTable : function() {
-    var togglers = $('img.toggler').click(function() {
-      var src = $(this).attr('src');
-      var idnum = $(this).attr('id').substr(7);
-      $('tr.cg-' + idnum).toggle();
-      if (src.substr(-9) === 'minus.png')
-        $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
-      else
-        $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
-    }).css('display', '');
-    if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
-        togglers.click();
-    }
-  },
+    };
 
-  /**
-   * helper function to hide the search marks again
-   */
-  hideSearchWords : function() {
-    $('#searchbox .highlight-link').fadeOut(300);
-    $('span.highlighted').removeClass('highlighted');
-    var url = new URL(window.location);
-    url.searchParams.delete('highlight');
-    window.history.replaceState({}, '', url);
+    const togglerElements = document.querySelectorAll("img.toggler");
+    togglerElements.forEach((el) =>
+      el.addEventListener("click", (event) => toggler(event.currentTarget))
+    );
+    togglerElements.forEach((el) => (el.style.display = ""));
+    if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler);
   },
 
-  /**
-   * make the url absolute
-   */
-  makeURL : function(relativeURL) {
-    return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
-  },
-
-  /**
-   * get the current relative url
-   */
-  getCurrentURL : function() {
-    var path = document.location.pathname;
-    var parts = path.split(/\//);
-    $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
-      if (this === '..')
-        parts.pop();
-    });
-    var url = parts.join('/');
-    return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
-  },
-
-  initOnKeyListeners: function() {
-    $(document).keydown(function(event) {
-      var activeElementType = document.activeElement.tagName;
-      // don't navigate when in search box, textarea, dropdown or button
-      if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT'
-          && activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey
-          && !event.shiftKey) {
-        switch (event.keyCode) {
-          case 37: // left
-            var prevHref = $('linkrel="prev"').prop('href');
-            if (prevHref) {
-              window.location.href = prevHref;
-              return false;
+  initOnKeyListeners: () => {
+    // only install a listener if it is really needed
+    if (
+      !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS &&
+      !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS
+    )
+      return;
+
+    document.addEventListener("keydown", (event) => {
+      // bail for input elements
+      if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return;
+      // bail with special keys
+      if (event.altKey || event.ctrlKey || event.metaKey) return;
+
+      if (!event.shiftKey) {
+        switch (event.key) {
+          case "ArrowLeft":
+            if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
+
+            const prevLink = document.querySelector('linkrel="prev"');
+            if (prevLink && prevLink.href) {
+              window.location.href = prevLink.href;
+              event.preventDefault();
             }
             break;
-          case 39: // right
-            var nextHref = $('linkrel="next"').prop('href');
-            if (nextHref) {
-              window.location.href = nextHref;
-              return false;
+          case "ArrowRight":
+            if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
+
+            const nextLink = document.querySelector('linkrel="next"');
+            if (nextLink && nextLink.href) {
+              window.location.href = nextLink.href;
+              event.preventDefault();
             }
             break;
         }
       }
+
+      // some keyboard layouts may need Shift to get /
+      switch (event.key) {
+        case "/":
+          if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break;
+          Documentation.focusSearchBar();
+          event.preventDefault();
+      }
     });
-  }
+  },
 };
 
 // quick alias for translations
-_ = Documentation.gettext;
+const _ = Documentation.gettext;
 
-$(document).ready(function() {
-  Documentation.init();
-});
+_ready(Documentation.init);

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/documentation_options.js_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/static/documentation_options.js_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/language_data.js_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/static/language_data.js_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/static/searchtools.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/static/searchtools.js Changed

@@ -4,22 +4,24 @@
  *
  * Sphinx JavaScript utilities for the full-text search.
  *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
+"use strict";
 
-if (!Scorer) {
-  /**
-   * Simple result scoring code.
-   */
+/**
+ * Simple result scoring code.
+ */
+if (typeof Scorer === "undefined") {
   var Scorer = {
     // Implement the following function to further tweak the score for each result
-    // The function takes a result array filename, title, anchor, descr, score
+    // The function takes a result array docname, title, anchor, descr, score, filename
     // and returns the new score.
     /*
-    score: function(result) {
-      return result4;
+    score: result => {
+      const docname, title, anchor, descr, score, filename = result
+      return score
     },
     */
 
@@ -28,9 +30,11 @@
     // or matches in the last dotted part of the object name
     objPartialMatch: 6,
     // Additive scores depending on the priority of the object
-    objPrio: {0:  15,   // used to be importantResults
-              1:  5,   // used to be objectResults
-              2: -5},  // used to be unimportantResults
+    objPrio: {
+      0: 15, // used to be importantResults
+      1: 5, // used to be objectResults
+      2: -5, // used to be unimportantResults
+    },
     //  Used when the priority is not in the mapping.
     objPrioDefault: 0,
 
@@ -39,456 +43,495 @@
     partialTitle: 7,
     // query found in terms
     term: 5,
-    partialTerm: 2
+    partialTerm: 2,
   };
 }
 
-if (!splitQuery) {
-  function splitQuery(query) {
-    return query.split(/\s+/);
+const _removeChildren = (element) => {
+  while (element && element.lastChild) element.removeChild(element.lastChild);
+};
+
+/**
+ * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping
+ */
+const _escapeRegExp = (string) =>
+  string.replace(/.*+\-?^${}()|\\\/g, "\\$&"); // $& means the whole matched string
+
+const _displayItem = (item, searchTerms) => {
+  const docBuilder = DOCUMENTATION_OPTIONS.BUILDER;
+  const docUrlRoot = DOCUMENTATION_OPTIONS.URL_ROOT;
+  const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX;
+  const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX;
+  const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY;
+
+  const docName, title, anchor, descr, score, _filename = item;
+
+  let listItem = document.createElement("li");
+  let requestUrl;
+  let linkUrl;
+  if (docBuilder === "dirhtml") {
+    // dirhtml builder
+    let dirname = docName + "/";
+    if (dirname.match(/\/index\/$/))
+      dirname = dirname.substring(0, dirname.length - 6);
+    else if (dirname === "index/") dirname = "";
+    requestUrl = docUrlRoot + dirname;
+    linkUrl = requestUrl;
+  } else {
+    // normal html builders
+    requestUrl = docUrlRoot + docName + docFileSuffix;
+    linkUrl = docName + docLinkSuffix;
   }
+  let linkEl = listItem.appendChild(document.createElement("a"));
+  linkEl.href = linkUrl + anchor;
+  linkEl.dataset.score = score;
+  linkEl.innerHTML = title;
+  if (descr)
+    listItem.appendChild(document.createElement("span")).innerHTML =
+      " (" + descr + ")";
+  else if (showSearchSummary)
+    fetch(requestUrl)
+      .then((responseData) => responseData.text())
+      .then((data) => {
+        if (data)
+          listItem.appendChild(
+            Search.makeSearchSummary(data, searchTerms)
+          );
+      });
+  Search.output.appendChild(listItem);
+};
+const _finishSearch = (resultCount) => {
+  Search.stopPulse();
+  Search.title.innerText = _("Search Results");
+  if (!resultCount)
+    Search.status.innerText = Documentation.gettext(
+      "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories."
+    );
+  else
+    Search.status.innerText = _(
+      `Search finished, found ${resultCount} page(s) matching the search query.`
+    );
+};
+const _displayNextItem = (
+  results,
+  resultCount,
+  searchTerms
+) => {
+  // results left, load the summary and display it
+  // this is intended to be dynamic (don't sub resultsCount)
+  if (results.length) {
+    _displayItem(results.pop(), searchTerms);
+    setTimeout(
+      () => _displayNextItem(results, resultCount, searchTerms),
+      5
+    );
+  }
+  // search finished, update title and status message
+  else _finishSearch(resultCount);
+};
+
+/**
+ * Default splitQuery function. Can be overridden in ``sphinx.search`` with a
+ * custom function per language.
+ *
+ * The regular expression works by splitting the string on consecutive characters
+ * that are not Unicode letters, numbers, underscores, or emoji characters.
+ * This is the same as ``\W+`` in Python, preserving the surrogate pair area.
+ */
+if (typeof splitQuery === "undefined") {
+  var splitQuery = (query) => query
+      .split(/^\p{Letter}\p{Number}_\p{Emoji_Presentation}+/gu)
+      .filter(term => term)  // remove remaining empty strings
 }
 
 /**
  * Search Module
  */
-var Search = {
-
-  _index : null,
-  _queued_query : null,
-  _pulse_status : -1,
-
-  htmlToText : function(htmlString) {
-      var virtualDocument = document.implementation.createHTMLDocument('virtual');
-      var htmlElement = $(htmlString, virtualDocument);
-      htmlElement.find('.headerlink').remove();
-      docContent = htmlElement.find('role=main')0;
-      if(docContent === undefined) {
-          console.warn("Content block not found. Sphinx search tries to obtain it " +
-                       "via 'role=main'. Could you check your theme or template.");
-          return "";
-      }
-      return docContent.textContent || docContent.innerText;
+const Search = {
+  _index: null,
+  _queued_query: null,
+  _pulse_status: -1,
+
+  htmlToText: (htmlString) => {
+    const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html');
+    htmlElement.querySelectorAll(".headerlink").forEach((el) => { el.remove() });
+    const docContent = htmlElement.querySelector('role="main"');
+    if (docContent !== undefined) return docContent.textContent;
+    console.warn(
+      "Content block not found. Sphinx search tries to obtain it via 'role=main'. Could you check your theme or template."
+    );
+    return "";
   },
 
-  init : function() {
-      var params = $.getQueryParameters();
-      if (params.q) {
-          var query = params.q0;
-          $('inputname="q"')0.value = query;
-          this.performSearch(query);
-      }
+  init: () => {
+    const query = new URLSearchParams(window.location.search).get("q");
+    document
+      .querySelectorAll('inputname="q"')
+      .forEach((el) => (el.value = query));
+    if (query) Search.performSearch(query);
   },
 
-  loadIndex : function(url) {
-    $.ajax({type: "GET", url: url, data: null,
-            dataType: "script", cache: true,
-            complete: function(jqxhr, textstatus) {
-              if (textstatus != "success") {
-                document.getElementById("searchindexloader").src = url;
-              }
-            }});
-  },
+  loadIndex: (url) =>
+    (document.body.appendChild(document.createElement("script")).src = url),
 
-  setIndex : function(index) {
-    var q;
-    this._index = index;
-    if ((q = this._queued_query) !== null) {
-      this._queued_query = null;
-      Search.query(q);
+  setIndex: (index) => {
+    Search._index = index;
+    if (Search._queued_query !== null) {
+      const query = Search._queued_query;
+      Search._queued_query = null;
+      Search.query(query);
     }
   },
 
-  hasIndex : function() {
-      return this._index !== null;
-  },
+  hasIndex: () => Search._index !== null,
 
-  deferQuery : function(query) {
-      this._queued_query = query;
-  },
+  deferQuery: (query) => (Search._queued_query = query),
 
-  stopPulse : function() {
-      this._pulse_status = 0;
-  },
+  stopPulse: () => (Search._pulse_status = -1),
 
-  startPulse : function() {
-    if (this._pulse_status >= 0)
-        return;
-    function pulse() {
-      var i;
+  startPulse: () => {
+    if (Search._pulse_status >= 0) return;
+
+    const pulse = () => {
       Search._pulse_status = (Search._pulse_status + 1) % 4;
-      var dotString = '';
-      for (i = 0; i < Search._pulse_status; i++)
-        dotString += '.';
-      Search.dots.text(dotString);
-      if (Search._pulse_status > -1)
-        window.setTimeout(pulse, 500);
-    }
+      Search.dots.innerText = ".".repeat(Search._pulse_status);
+      if (Search._pulse_status >= 0) window.setTimeout(pulse, 500);
+    };
     pulse();
   },
 
   /**
    * perform a search for something (or wait until index is loaded)
    */
-  performSearch : function(query) {
+  performSearch: (query) => {
     // create the required interface elements
-    this.out = $('#search-results');
-    this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);
-    this.dots = $('<span></span>').appendTo(this.title);
-    this.status = $('<p class="search-summary">&nbsp;</p>').appendTo(this.out);
-    this.output = $('<ul class="search"/>').appendTo(this.out);
-
-    $('#search-progress').text(_('Preparing search...'));
-    this.startPulse();
+    const searchText = document.createElement("h2");
+    searchText.textContent = _("Searching");
+    const searchSummary = document.createElement("p");
+    searchSummary.classList.add("search-summary");
+    searchSummary.innerText = "";
+    const searchList = document.createElement("ul");
+    searchList.classList.add("search");
+
+    const out = document.getElementById("search-results");
+    Search.title = out.appendChild(searchText);
+    Search.dots = Search.title.appendChild(document.createElement("span"));
+    Search.status = out.appendChild(searchSummary);
+    Search.output = out.appendChild(searchList);
+
+    const searchProgress = document.getElementById("search-progress");
+    // Some themes don't use the search progress node
+    if (searchProgress) {
+      searchProgress.innerText = _("Preparing search...");
+    }
+    Search.startPulse();
 
     // index already loaded, the browser was quick!
-    if (this.hasIndex())
-      this.query(query);
-    else
-      this.deferQuery(query);
+    if (Search.hasIndex()) Search.query(query);
+    else Search.deferQuery(query);
   },
 
   /**
    * execute search (requires search index to be loaded)
    */
-  query : function(query) {
-    var i;
-
-    // stem the searchterms and add them to the correct list
-    var stemmer = new Stemmer();
-    var searchterms = ;
-    var excluded = ;
-    var hlterms = ;
-    var tmp = splitQuery(query);
-    var objectterms = ;
-    for (i = 0; i < tmp.length; i++) {
-      if (tmpi !== "") {
-          objectterms.push(tmpi.toLowerCase());
-      }
+  query: (query) => {
+    const filenames = Search._index.filenames;
+    const docNames = Search._index.docnames;
+    const titles = Search._index.titles;
+    const allTitles = Search._index.alltitles;
+    const indexEntries = Search._index.indexentries;
+
+    // stem the search terms and add them to the correct list
+    const stemmer = new Stemmer();
+    const searchTerms = new Set();
+    const excludedTerms = new Set();
+    const highlightTerms = new Set();
+    const objectTerms = new Set(splitQuery(query.toLowerCase().trim()));
+    splitQuery(query.trim()).forEach((queryTerm) => {
+      const queryTermLower = queryTerm.toLowerCase();
+
+      // maybe skip this "word"
+      // stopwords array is from language_data.js
+      if (
+        stopwords.indexOf(queryTermLower) !== -1 ||
+        queryTerm.match(/^\d+$/)
+      )
+        return;
 
-      if ($u.indexOf(stopwords, tmpi.toLowerCase()) != -1 || tmpi === "") {
-        // skip this "word"
-        continue;
-      }
       // stem the word
-      var word = stemmer.stemWord(tmpi.toLowerCase());
-      // prevent stemmer from cutting word smaller than two chars
-      if(word.length < 3 && tmpi.length >= 3) {
-        word = tmpi;
-      }
-      var toAppend;
+      let word = stemmer.stemWord(queryTermLower);
       // select the correct list
-      if (word0 == '-') {
-        toAppend = excluded;
-        word = word.substr(1);
-      }
+      if (word0 === "-") excludedTerms.add(word.substr(1));
       else {
-        toAppend = searchterms;
-        hlterms.push(tmpi.toLowerCase());
+        searchTerms.add(word);
+        highlightTerms.add(queryTermLower);
       }
-      // only add if not already in the list
-      if (!$u.contains(toAppend, word))
-        toAppend.push(word);
-    }
-    var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
+    });
 
-    // console.debug('SEARCH: searching for:');
-    // console.info('required: ', searchterms);
-    // console.info('excluded: ', excluded);
+    if (SPHINX_HIGHLIGHT_ENABLED) {  // set in sphinx_highlight.js
+      localStorage.setItem("sphinx_highlight_terms", ...highlightTerms.join(" "))
+    }
 
-    // prepare search
-    var terms = this._index.terms;
-    var titleterms = this._index.titleterms;
+    // console.debug("SEARCH: searching for:");
+    // console.info("required: ", ...searchTerms);
+    // console.info("excluded: ", ...excludedTerms);
+
+    // array of docname, title, anchor, descr, score, filename
+    let results = ;
+    _removeChildren(document.getElementById("search-progress"));
+
+    const queryLower = query.toLowerCase();
+    for (const title, foundTitles of Object.entries(allTitles)) {
+      if (title.toLowerCase().includes(queryLower) && (queryLower.length >= title.length/2)) {
+        for (const file, id of foundTitles) {
+          let score = Math.round(100 * queryLower.length / title.length)
+          results.push(
+            docNamesfile,
+            titlesfile !== title ? `${titlesfile} > ${title}` : title,
+            id !== null ? "#" + id : "",
+            null,
+            score,
+            filenamesfile,
+          );
+        }
+      }
+    }
 
-    // array of filename, title, anchor, descr, score
-    var results = ;
-    $('#search-progress').empty();
+    // search for explicit entries in index directives
+    for (const entry, foundEntries of Object.entries(indexEntries)) {
+      if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) {
+        for (const file, id of foundEntries) {
+          let score = Math.round(100 * queryLower.length / entry.length)
+          results.push(
+            docNamesfile,
+            titlesfile,
+            id ? "#" + id : "",
+            null,
+            score,
+            filenamesfile,
+          );
+        }
+      }
+    }
 
     // lookup as object
-    for (i = 0; i < objectterms.length; i++) {
-      var others = .concat(objectterms.slice(0, i),
-                             objectterms.slice(i+1, objectterms.length));
-      results = results.concat(this.performObjectSearch(objecttermsi, others));
-    }
+    objectTerms.forEach((term) =>
+      results.push(...Search.performObjectSearch(term, objectTerms))
+    );
 
     // lookup as search terms in fulltext
-    results = results.concat(this.performTermsSearch(searchterms, excluded, terms, titleterms));
+    results.push(...Search.performTermsSearch(searchTerms, excludedTerms));
 
     // let the scorer override scores with a custom scoring function
-    if (Scorer.score) {
-      for (i = 0; i < results.length; i++)
-        resultsi4 = Scorer.score(resultsi);
-    }
+    if (Scorer.score) results.forEach((item) => (item4 = Scorer.score(item)));
 
     // now sort the results by score (in opposite order of appearance, since the
     // display function below uses pop() to retrieve items) and then
     // alphabetically
-    results.sort(function(a, b) {
-      var left = a4;
-      var right = b4;
-      if (left > right) {
-        return 1;
-      } else if (left < right) {
-        return -1;
-      } else {
+    results.sort((a, b) => {
+      const leftScore = a4;
+      const rightScore = b4;
+      if (leftScore === rightScore) {
         // same score: sort alphabetically
-        left = a1.toLowerCase();
-        right = b1.toLowerCase();
-        return (left > right) ? -1 : ((left < right) ? 1 : 0);
+        const leftTitle = a1.toLowerCase();
+        const rightTitle = b1.toLowerCase();
+        if (leftTitle === rightTitle) return 0;
+        return leftTitle > rightTitle ? -1 : 1; // inverted is intentional
       }
+      return leftScore > rightScore ? 1 : -1;
     });
 
+    // remove duplicate search results
+    // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept
+    let seen = new Set();
+    results = results.reverse().reduce((acc, result) => {
+      let resultStr = result.slice(0, 4).concat(result5).map(v => String(v)).join(',');
+      if (!seen.has(resultStr)) {
+        acc.push(result);
+        seen.add(resultStr);
+      }
+      return acc;
+    }, );
+
+    results = results.reverse();
+
     // for debugging
     //Search.lastresults = results.slice();  // a copy
-    //console.info('search results:', Search.lastresults);
+    // console.info("search results:", Search.lastresults);
 
     // print the results
-    var resultCount = results.length;
-    function displayNextItem() {
-      // results left, load the summary and display it
-      if (results.length) {
-        var item = results.pop();
-        var listItem = $('<li></li>');
-        var requestUrl = "";
-        var linkUrl = "";
-        if (DOCUMENTATION_OPTIONS.BUILDER === 'dirhtml') {
-          // dirhtml builder
-          var dirname = item0 + '/';
-          if (dirname.match(/\/index\/$/)) {
-            dirname = dirname.substring(0, dirname.length-6);
-          } else if (dirname == 'index/') {
-            dirname = '';
-          }
-          requestUrl = DOCUMENTATION_OPTIONS.URL_ROOT + dirname;
-          linkUrl = requestUrl;
-
-        } else {
-          // normal html builders
-          requestUrl = DOCUMENTATION_OPTIONS.URL_ROOT + item0 + DOCUMENTATION_OPTIONS.FILE_SUFFIX;
-          linkUrl = item0 + DOCUMENTATION_OPTIONS.LINK_SUFFIX;
-        }
-        listItem.append($('<a/>').attr('href',
-            linkUrl +
-            highlightstring + item2).html(item1));
-        if (item3) {
-          listItem.append($('<span> (' + item3 + ')</span>'));
-          Search.output.append(listItem);
-          setTimeout(function() {
-            displayNextItem();
-          }, 5);
-        } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
-          $.ajax({url: requestUrl,
-                  dataType: "text",
-                  complete: function(jqxhr, textstatus) {
-                    var data = jqxhr.responseText;
-                    if (data !== '' && data !== undefined) {
-                      var summary = Search.makeSearchSummary(data, searchterms, hlterms);
-                      if (summary) {
-                        listItem.append(summary);
-                      }
-                    }
-                    Search.output.append(listItem);
-                    setTimeout(function() {
-                      displayNextItem();
-                    }, 5);
-                  }});
-        } else {
-          // no source available, just display title
-          Search.output.append(listItem);
-          setTimeout(function() {
-            displayNextItem();
-          }, 5);
-        }
-      }
-      // search finished, update title and status message
-      else {
-        Search.stopPulse();
-        Search.title.text(_('Search Results'));
-        if (!resultCount)
-          Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.'));
-        else
-            Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));
-        Search.status.fadeIn(500);
-      }
-    }
-    displayNextItem();
+    _displayNextItem(results, results.length, searchTerms);
   },
 
   /**
    * search for object names
    */
-  performObjectSearch : function(object, otherterms) {
-    var filenames = this._index.filenames;
-    var docnames = this._index.docnames;
-    var objects = this._index.objects;
-    var objnames = this._index.objnames;
-    var titles = this._index.titles;
-
-    var i;
-    var results = ;
-
-    for (var prefix in objects) {
-      for (var iMatch = 0; iMatch != objectsprefix.length; ++iMatch) {
-        var match = objectsprefixiMatch;
-        var name = match4;
-        var fullname = (prefix ? prefix + '.' : '') + name;
-        var fullnameLower = fullname.toLowerCase()
-        if (fullnameLower.indexOf(object) > -1) {
-          var score = 0;
-          var parts = fullnameLower.split('.');
-          // check for different match types: exact matches of full name or
-          // "last name" (i.e. last dotted part)
-          if (fullnameLower == object || partsparts.length - 1 == object) {
-            score += Scorer.objNameMatch;
-          // matches in last name
-          } else if (partsparts.length - 1.indexOf(object) > -1) {
-            score += Scorer.objPartialMatch;
-          }
-          var objname = objnamesmatch12;
-          var title = titlesmatch0;
-          // If more than one term searched for, we require other words to be
-          // found in the name/title/description
-          if (otherterms.length > 0) {
-            var haystack = (prefix + ' ' + name + ' ' +
-                            objname + ' ' + title).toLowerCase();
-            var allfound = true;
-            for (i = 0; i < otherterms.length; i++) {
-              if (haystack.indexOf(othertermsi) == -1) {
-                allfound = false;
-                break;
-              }
-            }
-            if (!allfound) {
-              continue;
-            }
-          }
-          var descr = objname + _(', in ') + title;
-
-          var anchor = match3;
-          if (anchor === '')
-            anchor = fullname;
-          else if (anchor == '-')
-            anchor = objnamesmatch11 + '-' + fullname;
-          // add custom score for some objects according to scorer
-          if (Scorer.objPrio.hasOwnProperty(match2)) {
-            score += Scorer.objPriomatch2;
-          } else {
-            score += Scorer.objPrioDefault;
-          }
-          results.push(docnamesmatch0, fullname, '#'+anchor, descr, score, filenamesmatch0);
-        }
+  performObjectSearch: (object, objectTerms) => {
+    const filenames = Search._index.filenames;
+    const docNames = Search._index.docnames;
+    const objects = Search._index.objects;
+    const objNames = Search._index.objnames;
+    const titles = Search._index.titles;
+
+    const results = ;
+
+    const objectSearchCallback = (prefix, match) => {
+      const name = match4
+      const fullname = (prefix ? prefix + "." : "") + name;
+      const fullnameLower = fullname.toLowerCase();
+      if (fullnameLower.indexOf(object) < 0) return;
+
+      let score = 0;
+      const parts = fullnameLower.split(".");
+
+      // check for different match types: exact matches of full name or
+      // "last name" (i.e. last dotted part)
+      if (fullnameLower === object || parts.slice(-1)0 === object)
+        score += Scorer.objNameMatch;
+      else if (parts.slice(-1)0.indexOf(object) > -1)
+        score += Scorer.objPartialMatch; // matches in last name
+
+      const objName = objNamesmatch12;
+      const title = titlesmatch0;
+
+      // If more than one term searched for, we require other words to be
+      // found in the name/title/description
+      const otherTerms = new Set(objectTerms);
+      otherTerms.delete(object);
+      if (otherTerms.size > 0) {
+        const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase();
+        if (
+          ...otherTerms.some((otherTerm) => haystack.indexOf(otherTerm) < 0)
+        )
+          return;
       }
-    }
 
+      let anchor = match3;
+      if (anchor === "") anchor = fullname;
+      else if (anchor === "-") anchor = objNamesmatch11 + "-" + fullname;
+
+      const descr = objName + _(", in ") + title;
+
+      // add custom score for some objects according to scorer
+      if (Scorer.objPrio.hasOwnProperty(match2))
+        score += Scorer.objPriomatch2;
+      else score += Scorer.objPrioDefault;
+
+      results.push(
+        docNamesmatch0,
+        fullname,
+        "#" + anchor,
+        descr,
+        score,
+        filenamesmatch0,
+      );
+    };
+    Object.keys(objects).forEach((prefix) =>
+      objectsprefix.forEach((array) =>
+        objectSearchCallback(prefix, array)
+      )
+    );
     return results;
   },
 
   /**
-   * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
-   */
-  escapeRegExp : function(string) {
-    return string.replace(/.*+\-?^${}()|\\\/g, '\\$&'); // $& means the whole matched string
-  },
-
-  /**
    * search for full-text terms in the index
    */
-  performTermsSearch : function(searchterms, excluded, terms, titleterms) {
-    var docnames = this._index.docnames;
-    var filenames = this._index.filenames;
-    var titles = this._index.titles;
+  performTermsSearch: (searchTerms, excludedTerms) => {
+    // prepare search
+    const terms = Search._index.terms;
+    const titleTerms = Search._index.titleterms;
+    const filenames = Search._index.filenames;
+    const docNames = Search._index.docnames;
+    const titles = Search._index.titles;
 
-    var i, j, file;
-    var fileMap = {};
-    var scoreMap = {};
-    var results = ;
+    const scoreMap = new Map();
+    const fileMap = new Map();
 
     // perform the search on the required terms
-    for (i = 0; i < searchterms.length; i++) {
-      var word = searchtermsi;
-      var files = ;
-      var _o = 
-        {files: termsword, score: Scorer.term},
-        {files: titletermsword, score: Scorer.title}
+    searchTerms.forEach((word) => {
+      const files = ;
+      const arr = 
+        { files: termsword, score: Scorer.term },
+        { files: titleTermsword, score: Scorer.title },
       ;
       // add support for partial matches
       if (word.length > 2) {
-        var word_regex = this.escapeRegExp(word);
-        for (var w in terms) {
-          if (w.match(word_regex) && !termsword) {
-            _o.push({files: termsw, score: Scorer.partialTerm})
-          }
-        }
-        for (var w in titleterms) {
-          if (w.match(word_regex) && !titletermsword) {
-              _o.push({files: titletermsw, score: Scorer.partialTitle})
-          }
-        }
+        const escapedWord = _escapeRegExp(word);
+        Object.keys(terms).forEach((term) => {
+          if (term.match(escapedWord) && !termsword)
+            arr.push({ files: termsterm, score: Scorer.partialTerm });
+        });
+        Object.keys(titleTerms).forEach((term) => {
+          if (term.match(escapedWord) && !titleTermsword)
+            arr.push({ files: titleTermsword, score: Scorer.partialTitle });
+        });
       }
 
       // no match but word was a required one
-      if ($u.every(_o, function(o){return o.files === undefined;})) {
-        break;
-      }
+      if (arr.every((record) => record.files === undefined)) return;
+
       // found search word in contents
-      $u.each(_o, function(o) {
-        var _files = o.files;
-        if (_files === undefined)
-          return
-
-        if (_files.length === undefined)
-          _files = _files;
-        files = files.concat(_files);
-
-        // set score for the word in each file to Scorer.term
-        for (j = 0; j < _files.length; j++) {
-          file = _filesj;
-          if (!(file in scoreMap))
-            scoreMapfile = {};
-          scoreMapfileword = o.score;
-        }
+      arr.forEach((record) => {
+        if (record.files === undefined) return;
+
+        let recordFiles = record.files;
+        if (recordFiles.length === undefined) recordFiles = recordFiles;
+        files.push(...recordFiles);
+
+        // set score for the word in each file
+        recordFiles.forEach((file) => {
+          if (!scoreMap.has(file)) scoreMap.set(file, {});
+          scoreMap.get(file)word = record.score;
+        });
       });
 
       // create the mapping
-      for (j = 0; j < files.length; j++) {
-        file = filesj;
-        if (file in fileMap && fileMapfile.indexOf(word) === -1)
-          fileMapfile.push(word);
-        else
-          fileMapfile = word;
-      }
-    }
+      files.forEach((file) => {
+        if (fileMap.has(file) && fileMap.get(file).indexOf(word) === -1)
+          fileMap.get(file).push(word);
+        else fileMap.set(file, word);
+      });
+    });
 
     // now check if the files don't contain excluded terms
-    for (file in fileMap) {
-      var valid = true;
-
+    const results = ;
+    for (const file, wordList of fileMap) {
       // check if all requirements are matched
-      var filteredTermCount = // as search terms with length < 3 are discarded: ignore
-        searchterms.filter(function(term){return term.length > 2}).length
+
+      // as search terms with length < 3 are discarded
+      const filteredTermCount = ...searchTerms.filter(
+        (term) => term.length > 2
+      ).length;
       if (
-        fileMapfile.length != searchterms.length &&
-        fileMapfile.length != filteredTermCount
-      ) continue;
+        wordList.length !== searchTerms.size &&
+        wordList.length !== filteredTermCount
+      )
+        continue;
 
       // ensure that none of the excluded terms is in the search result
-      for (i = 0; i < excluded.length; i++) {
-        if (termsexcludedi == file ||
-            titletermsexcludedi == file ||
-            $u.contains(termsexcludedi || , file) ||
-            $u.contains(titletermsexcludedi || , file)) {
-          valid = false;
-          break;
-        }
-      }
+      if (
+        ...excludedTerms.some(
+          (term) =>
+            termsterm === file ||
+            titleTermsterm === file ||
+            (termsterm || ).includes(file) ||
+            (titleTermsterm || ).includes(file)
+        )
+      )
+        break;
 
-      // if we have still a valid result we can add it to the result list
-      if (valid) {
-        // select one (max) score for the file.
-        // for better ranking, we should calculate ranking by using words statistics like basic tf-idf...
-        var score = $u.max($u.map(fileMapfile, function(w){return scoreMapfilew}));
-        results.push(docnamesfile, titlesfile, '', null, score, filenamesfile);
-      }
+      // select one (max) score for the file.
+      const score = Math.max(...wordList.map((w) => scoreMap.get(file)w));
+      // add result to the result list
+      results.push(
+        docNamesfile,
+        titlesfile,
+        "",
+        null,
+        score,
+        filenamesfile,
+      );
     }
     return results;
   },
@@ -496,34 +539,28 @@
   /**
    * helper function to return a node containing the
    * search summary for a given text. keywords is a list
-   * of stemmed words, hlwords is the list of normal, unstemmed
-   * words. the first one is used to find the occurrence, the
-   * latter for highlighting it.
+   * of stemmed words.
    */
-  makeSearchSummary : function(htmlText, keywords, hlwords) {
-    var text = Search.htmlToText(htmlText);
-    if (text == "") {
-      return null;
-    }
-    var textLower = text.toLowerCase();
-    var start = 0;
-    $.each(keywords, function() {
-      var i = textLower.indexOf(this.toLowerCase());
-      if (i > -1)
-        start = i;
-    });
-    start = Math.max(start - 120, 0);
-    var excerpt = ((start > 0) ? '...' : '') +
-      $.trim(text.substr(start, 240)) +
-      ((start + 240 - text.length) ? '...' : '');
-    var rv = $('<p class="context"></p>').text(excerpt);
-    $.each(hlwords, function() {
-      rv = rv.highlightText(this, 'highlighted');
-    });
-    return rv;
-  }
+  makeSearchSummary: (htmlText, keywords) => {
+    const text = Search.htmlToText(htmlText);
+    if (text === "") return null;
+
+    const textLower = text.toLowerCase();
+    const actualStartPosition = ...keywords
+      .map((k) => textLower.indexOf(k.toLowerCase()))
+      .filter((i) => i > -1)
+      .slice(-1)0;
+    const startWithContext = Math.max(actualStartPosition - 120, 0);
+
+    const top = startWithContext === 0 ? "" : "...";
+    const tail = startWithContext + 240 < text.length ? "..." : "";
+
+    let summary = document.createElement("p");
+    summary.classList.add("context");
+    summary.textContent = top + text.substr(startWithContext, 240).trim() + tail;
+
+    return summary;
+  },
 };
 
-$(document).ready(function() {
-  Search.init();
-});
+_ready(Search.init);

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/static/sphinx_highlight.js Added

@@ -0,0 +1,144 @@
+/* Highlighting utilities for Sphinx HTML documentation. */
+"use strict";
+
+const SPHINX_HIGHLIGHT_ENABLED = true
+
+/**
+ * highlight a given string on a node by wrapping it in
+ * span elements with the given class name.
+ */
+const _highlight = (node, addItems, text, className) => {
+  if (node.nodeType === Node.TEXT_NODE) {
+    const val = node.nodeValue;
+    const parent = node.parentNode;
+    const pos = val.toLowerCase().indexOf(text);
+    if (
+      pos >= 0 &&
+      !parent.classList.contains(className) &&
+      !parent.classList.contains("nohighlight")
+    ) {
+      let span;
+
+      const closestNode = parent.closest("body, svg, foreignObject");
+      const isInSVG = closestNode && closestNode.matches("svg");
+      if (isInSVG) {
+        span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
+      } else {
+        span = document.createElement("span");
+        span.classList.add(className);
+      }
+
+      span.appendChild(document.createTextNode(val.substr(pos, text.length)));
+      parent.insertBefore(
+        span,
+        parent.insertBefore(
+          document.createTextNode(val.substr(pos + text.length)),
+          node.nextSibling
+        )
+      );
+      node.nodeValue = val.substr(0, pos);
+
+      if (isInSVG) {
+        const rect = document.createElementNS(
+          "http://www.w3.org/2000/svg",
+          "rect"
+        );
+        const bbox = parent.getBBox();
+        rect.x.baseVal.value = bbox.x;
+        rect.y.baseVal.value = bbox.y;
+        rect.width.baseVal.value = bbox.width;
+        rect.height.baseVal.value = bbox.height;
+        rect.setAttribute("class", className);
+        addItems.push({ parent: parent, target: rect });
+      }
+    }
+  } else if (node.matches && !node.matches("button, select, textarea")) {
+    node.childNodes.forEach((el) => _highlight(el, addItems, text, className));
+  }
+};
+const _highlightText = (thisNode, text, className) => {
+  let addItems = ;
+  _highlight(thisNode, addItems, text, className);
+  addItems.forEach((obj) =>
+    obj.parent.insertAdjacentElement("beforebegin", obj.target)
+  );
+};
+
+/**
+ * Small JavaScript module for the documentation.
+ */
+const SphinxHighlight = {
+
+  /**
+   * highlight the search words provided in localstorage in the text
+   */
+  highlightSearchWords: () => {
+    if (!SPHINX_HIGHLIGHT_ENABLED) return;  // bail if no highlight
+
+    // get and clear terms from localstorage
+    const url = new URL(window.location);
+    const highlight =
+        localStorage.getItem("sphinx_highlight_terms")
+        || url.searchParams.get("highlight")
+        || "";
+    localStorage.removeItem("sphinx_highlight_terms")
+    url.searchParams.delete("highlight");
+    window.history.replaceState({}, "", url);
+
+    // get individual terms from highlight string
+    const terms = highlight.toLowerCase().split(/\s+/).filter(x => x);
+    if (terms.length === 0) return; // nothing to do
+
+    // There should never be more than one element matching "div.body"
+    const divBody = document.querySelectorAll("div.body");
+    const body = divBody.length ? divBody0 : document.querySelector("body");
+    window.setTimeout(() => {
+      terms.forEach((term) => _highlightText(body, term, "highlighted"));
+    }, 10);
+
+    const searchBox = document.getElementById("searchbox");
+    if (searchBox === null) return;
+    searchBox.appendChild(
+      document
+        .createRange()
+        .createContextualFragment(
+          '<p class="highlight-link">' +
+            '<a href="javascript:SphinxHighlight.hideSearchWords()">' +
+            _("Hide Search Matches") +
+            "</a></p>"
+        )
+    );
+  },
+
+  /**
+   * helper function to hide the search marks again
+   */
+  hideSearchWords: () => {
+    document
+      .querySelectorAll("#searchbox .highlight-link")
+      .forEach((el) => el.remove());
+    document
+      .querySelectorAll("span.highlighted")
+      .forEach((el) => el.classList.remove("highlighted"));
+    localStorage.removeItem("sphinx_highlight_terms")
+  },
+
+  initEscapeListener: () => {
+    // only install a listener if it is really needed
+    if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return;
+
+    document.addEventListener("keydown", (event) => {
+      // bail for input elements
+      if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return;
+      // bail with special keys
+      if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return;
+      if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) {
+        SphinxHighlight.hideSearchWords();
+        event.preventDefault();
+      }
+    });
+  },
+};
+
+_ready(SphinxHighlight.highlightSearchWords);
+_ready(SphinxHighlight.initEscapeListener);

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/basic/theme.conf -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/basic/theme.conf Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/bizstyle/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/bizstyle/layout.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/bizstyle/static/bizstyle.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/bizstyle/static/bizstyle.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/bizstyle/static/bizstyle.js_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/bizstyle/static/bizstyle.js_t Changed

@@ -6,36 +6,25 @@
 //
 // This theme was created by referring to 'sphinxdoc'
 //
-// :copyright: Copyright 2012-2014 by Sphinx team, see AUTHORS.
+// :copyright: Copyright 2007-2023 by Sphinx team, see AUTHORS.
 // :license: BSD, see LICENSE for details.
 //
-$(document).ready(function(){
-    if (navigator.userAgent.indexOf('iPhone') > 0 ||
-        navigator.userAgent.indexOf('Android') > 0) {
-        $("li.nav-item-0 a").text("Top");
+const initialiseBizStyle = () => {
+    if (navigator.userAgent.indexOf("iPhone") > 0 || navigator.userAgent.indexOf("Android") > 0) {
+        document.querySelector("li.nav-item-0 a").innerText = "Top"
     }
+    const truncator = item => {if (item.textContent.length > 20) {
+        item.title = item.innerText
+        item.innerText = item.innerText.substr(0, 17) + "..."
+      }
+    }
+    document.querySelectorAll("div.related:first ul li:not(.right) a").slice(1).forEach(truncator);
+    document.querySelectorAll("div.related:last ul li:not(.right) a").slice(1).forEach(truncator);
+}
 
-    $("div.related:first ul li:not(.right) a").slice(1).each(function(i, item){
-        if (item.text.length > 20) {
-            var tmpstr = item.text
-            $(item).attr("title", tmpstr);
-            $(item).text(tmpstr.substr(0, 17) + "...");
-        }
-    });
-    $("div.related:last ul li:not(.right) a").slice(1).each(function(i, item){
-        if (item.text.length > 20) {
-            var tmpstr = item.text
-            $(item).attr("title", tmpstr);
-            $(item).text(tmpstr.substr(0, 17) + "...");
-        }
-    });
-});
+window.addEventListener("resize",
+  () => (document.querySelector("li.nav-item-0 a").innerText = (window.innerWidth <= 776) ? "Top" : "{{ shorttitle|e }}")
+)
 
-$(window).resize(function(){
-    if ($(window).width() <= 776) {
-        $("li.nav-item-0 a").text("Top");
-    }
-    else {
-        $("li.nav-item-0 a").text("{{ shorttitle|e }}");
-    }
-});
+if (document.readyState !== "loading") initialiseBizStyle()
+else document.addEventListener("DOMContentLoaded", initialiseBizStyle)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/classic/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/classic/layout.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/classic/static/classic.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/classic/static/classic.css_t Changed

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- classic theme.
  *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
@@ -28,6 +28,7 @@
 }
 
 div.document {
+    display: flex;
     background-color: {{ theme_sidebarbgcolor }};
 }
 
@@ -153,9 +154,39 @@
 }
 
 {% if theme_collapsiblesidebar|tobool %}
+{% if theme_rightsidebar|tobool %}
+    {% set side = 'right' %}
+    {% set opposite = 'left' %}
+{% else %}
+    {% set side = 'left' %}
+    {% set opposite = 'right' %}
+{% endif %}
 /* for collapsible sidebar */
-div#sidebarbutton {
+#sidebarbutton {
+    height: 100%;
     background-color: {{ theme_sidebarbtncolor }};
+    margin-{{side}}: 0;
+    color: #FFFFFF;
+    border-{{side}}: 1px solid {{ theme_relbarbgcolor }};
+    font-size: 1.2em;
+    cursor: pointer;
+    padding-top: 1px;
+    float: {{ 'left' if theme_rightsidebar|tobool else 'right' }};
+    display: table; /* for vertically centering the <span> */
+}
+
+#sidebarbutton:hover {
+    background-color: {{ theme_relbarbgcolor }};
+}
+
+#sidebarbutton span {
+    display: table-cell;
+    vertical-align: middle;
+}
+
+div.sphinxsidebarwrapper {
+    float: {{side}};
+    margin-{{opposite}}: 0;
 }
 {% endif %}
 
@@ -259,6 +290,8 @@
     border: 1px solid #ff6;
 }
 
+nav.contents,
+aside.topic,
 div.topic {
     background-color: #eee;
 }

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/classic/static/sidebar.js_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/classic/static/sidebar.js_t Changed

@@ -16,150 +16,57 @@
  * Once the browser is closed the cookie is deleted and the position
  * reset to the default (expanded).
  *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
 
-$(function() {
+const initialiseSidebar = () => {
   {% if theme_rightsidebar|tobool %}
-  {% set side = 'right' %}
-  {% set opposite = 'left' %}
-  {% set initial_label = '&raquo;' %}
-  {% set expand_label = '«' %}
-  {% set collapse_label = '»' %}
+    {% set side = 'Right' %}
   {% else %}
-  {% set side = 'left' %}
-  {% set opposite = 'right' %}
-  {% set initial_label = '&laquo;' %}
-  {% set expand_label = '»' %}
-  {% set collapse_label = '«' %}
+    {% set side = 'Left' %}
   {% endif %}
 
   // global elements used by the functions.
-  // the 'sidebarbutton' element is defined as global after its
-  // creation, in the add_sidebar_button function
-  var bodywrapper = $('.bodywrapper');
-  var sidebar = $('.sphinxsidebar');
-  var sidebarwrapper = $('.sphinxsidebarwrapper');
+  const bodyWrapper = document.getElementsByClassName("bodywrapper")0
+  const sidebar = document.getElementsByClassName("sphinxsidebar")0
+  const sidebarWrapper = document.getElementsByClassName('sphinxsidebarwrapper')0
+  const sidebarButton = document.getElementById("sidebarbutton")
+  const sidebarArrow = sidebarButton.querySelector('span')
 
   // for some reason, the document has no sidebar; do not run into errors
-  if (!sidebar.length) return;
+  if (typeof sidebar === "undefined") return;
 
-  // original margin-left of the bodywrapper and width of the sidebar
-  // with the sidebar expanded
-  var bw_margin_expanded = bodywrapper.css('margin-{{side}}');
-  var ssb_width_expanded = sidebar.width();
+  const flipArrow = element => element.innerText = (element.innerText === "»") ? "«" : "»"
 
-  // margin-left of the bodywrapper and width of the sidebar
-  // with the sidebar collapsed
-  var bw_margin_collapsed = '.8em';
-  var ssb_width_collapsed = '.8em';
-
-  // colors used by the current theme
-  var dark_color = $('.related').css('background-color');
-  var light_color = $('.document').css('background-color');
-
-  function sidebar_is_collapsed() {
-    return sidebarwrapper.is(':not(:visible)');
-  }
-
-  function toggle_sidebar() {
-    if (sidebar_is_collapsed())
-      expand_sidebar();
-    else
-      collapse_sidebar();
-  }
-
-  function collapse_sidebar() {
-    sidebarwrapper.hide();
-    sidebar.css('width', ssb_width_collapsed);
-    bodywrapper.css('margin-{{side}}', bw_margin_collapsed);
-    sidebarbutton.css({
-        'margin-{{side}}': '0',
-        'height': bodywrapper.height()
-    });
-    sidebarbutton.find('span').text('{{expand_label}}');
-    sidebarbutton.attr('title', _('Expand sidebar'));
-    document.cookie = 'sidebar=collapsed';
+  const collapse_sidebar = () => {
+    bodyWrapper.style.margin{{side}} = ".8em";
+    sidebar.style.width = ".8em"
+    sidebarWrapper.style.display = "none"
+    flipArrow(sidebarArrow)
+    sidebarButton.title = _('Expand sidebar')
+    window.localStorage.setItem("sidebar", "collapsed")
   }
 
-  function expand_sidebar() {
-    bodywrapper.css('margin-{{side}}', bw_margin_expanded);
-    sidebar.css('width', ssb_width_expanded);
-    sidebarwrapper.show();
-    sidebarbutton.css({
-        'margin-{{side}}': ssb_width_expanded-12,
-        'height': bodywrapper.height()
-    });
-    sidebarbutton.find('span').text('{{collapse_label}}');
-    sidebarbutton.attr('title', _('Collapse sidebar'));
-    document.cookie = 'sidebar=expanded';
+  const expand_sidebar = () => {
+    bodyWrapper.style.margin{{side}} = ""
+    sidebar.style.removeProperty("width")
+    sidebarWrapper.style.display = ""
+    flipArrow(sidebarArrow)
+    sidebarButton.title = _('Collapse sidebar')
+    window.localStorage.setItem("sidebar", "expanded")
   }
 
-  function add_sidebar_button() {
-    sidebarwrapper.css({
-        'float': '{{side}}',
-        'margin-{{opposite}}': '0',
-        'width': ssb_width_expanded - 28
-    });
-    // create the button
-    sidebar.append(
-        '<div id="sidebarbutton"><span>{{initial_label}}</span></div>'
-    );
-    var sidebarbutton = $('#sidebarbutton');
-    light_color = sidebarbutton.css('background-color');
-    // find the height of the viewport to center the '<<' in the page
-    var viewport_height;
-    if (window.innerHeight)
- 	  viewport_height = window.innerHeight;
-    else
-	  viewport_height = $(window).height();
-    sidebarbutton.find('span').css({
-        'display': 'block',
-        'margin-top': (viewport_height - sidebar.position().top - 20) / 2
-    });
-
-    sidebarbutton.click(toggle_sidebar);
-    sidebarbutton.attr('title', _('Collapse sidebar'));
-    sidebarbutton.css({
-        'color': '#FFFFFF',
-        'border-{{side}}': '1px solid ' + dark_color,
-        'font-size': '1.2em',
-        'cursor': 'pointer',
-        'height': bodywrapper.height(),
-        'padding-top': '1px',
-        'margin-{{side}}': ssb_width_expanded - 12
-    });
+  sidebarButton.addEventListener("click", () => {
+    (sidebarWrapper.style.display === "none") ? expand_sidebar() : collapse_sidebar()
+  })
 
-    sidebarbutton.hover(
-      function () {
-          $(this).css('background-color', dark_color);
-      },
-      function () {
-          $(this).css('background-color', light_color);
-      }
-    );
-  }
-
-  function set_position_from_cookie() {
-    if (!document.cookie)
-      return;
-    var items = document.cookie.split(';');
-    for(var k=0; k<items.length; k++) {
-      var key_val = itemsk.split('=');
-      var key = key_val0.replace(/ /, "");  // strip leading spaces
-      if (key == 'sidebar') {
-        var value = key_val1;
-        if ((value == 'collapsed') && (!sidebar_is_collapsed()))
-          collapse_sidebar();
-        else if ((value == 'expanded') && (sidebar_is_collapsed()))
-          expand_sidebar();
-      }
-    }
-  }
+  if (!window.localStorage.getItem("sidebar")) return
+  const value = window.localStorage.getItem("sidebar")
+  if (value === "collapsed") collapse_sidebar();
+  else if (value === "expanded") expand_sidebar();
+}
 
-  add_sidebar_button();
-  var sidebarbutton = $('#sidebarbutton');
-  set_position_from_cookie();
-});
+if (document.readyState !== "loading") initialiseSidebar()
+else document.addEventListener("DOMContentLoaded", initialiseSidebar)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/epub/epub-cover.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/epub/epub-cover.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/epub/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/epub/layout.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/epub/static/epub.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/epub/static/epub.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/haiku/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/haiku/layout.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/haiku/static/haiku.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/haiku/static/haiku.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nature/static/nature.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/nature/static/nature.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/nonav/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/nonav/layout.html Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/nonav/static/nonav.css_t Added

@@ -0,0 +1,584 @@
+/*
+ * nonav.css
+ * ~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- nonav theme.
+ *
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/* -- main layout ----------------------------------------------------------- */
+
+div.clearer {
+    clear: both;
+}
+
+a:link, a:visited {
+    color: #3333ff;
+    text-decoration: underline;
+}
+
+img {
+    border: 0;
+    max-width: 100%;
+}
+
+/* -- relbar ---------------------------------------------------------------- */
+
+div.related {
+    width: 100%;
+    font-family: sans-serif;
+    font-size: 90%;
+}
+
+div.related h3 {
+    display: none;
+}
+
+div.related ul {
+    margin: 0;
+    padding: 0 0 0 10px;
+    list-style: none;
+}
+
+div.related li {
+    display: inline;
+}
+
+div.related li.right {
+    float: right;
+    margin-right: 5px;
+}
+
+/* -- sidebar --------------------------------------------------------------- */
+
+div.sphinxsidebarwrapper {
+    padding: 10px 5px 0 10px;
+}
+
+div.sphinxsidebar {
+    float: left;
+    width: 230px;
+    margin-left: -100%;
+    font-size: 90%;
+}
+
+div.sphinxsidebar ul {
+    list-style: none;
+}
+
+div.sphinxsidebar ul ul,
+div.sphinxsidebar ul.want-points {
+    margin-left: 20px;
+    list-style: square;
+}
+
+div.sphinxsidebar ul ul {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+div.sphinxsidebar form {
+    margin-top: 10px;
+}
+
+div.sphinxsidebar input {
+    border: 1px solid #98dbcc;
+    font-family: sans-serif;
+    font-size: 100%;
+}
+
+img {
+    border: 0;
+    max-width: 100%;
+}
+
+/* -- search page ----------------------------------------------------------- */
+
+ul.search {
+    margin: 10px 0 0 20px;
+    padding: 0;
+}
+
+ul.search li {
+    padding: 5px 0 5px 20px;
+    background-image: url(file.png);
+    background-repeat: no-repeat;
+    background-position: 0 7px;
+}
+
+ul.search li a {
+    font-weight: bold;
+}
+
+ul.search li div.context {
+    color: #888;
+    margin: 2px 0 0 30px;
+    text-align: left;
+}
+
+ul.keywordmatches li.goodmatch a {
+    font-weight: bold;
+}
+
+/* -- index page ------------------------------------------------------------ */
+
+table.contentstable {
+    width: 90%;
+}
+
+table.contentstable p.biglink {
+    line-height: 150%;
+}
+
+a.biglink {
+    font-size: 130%;
+}
+
+span.linkdescr {
+    font-style: italic;
+    padding-top: 5px;
+    font-size: 90%;
+}
+
+/* -- general index --------------------------------------------------------- */
+
+table.indextable td {
+    text-align: left;
+    vertical-align: top;
+}
+
+table.indextable ul {
+    margin-top: 0;
+    margin-bottom: 0;
+    list-style-type: none;
+}
+
+table.indextable > tbody > tr > td > ul {
+    padding-left: 0em;
+}
+
+table.indextable tr.pcap {
+    height: 10px;
+}
+
+table.indextable tr.cap {
+    margin-top: 10px;
+    background-color: #f2f2f2;
+}
+
+img.toggler {
+    margin-right: 3px;
+    margin-top: 3px;
+    cursor: pointer;
+}
+
+/* -- domain module index --------------------------------------------------- */
+
+table.modindextable td {
+    padding: 2px;
+    border-collapse: collapse;
+}
+
+/* -- general body styles --------------------------------------------------- */
+
+a.headerlink {
+    visibility: hidden;
+}
+
+div.body p.caption {
+    text-align: inherit;
+}
+
+div.body td {
+    text-align: left;
+}
+
+.first {
+    margin-top: 0 !important;
+}
+
+p.rubric {
+    margin-top: 30px;
+    font-weight: bold;
+}
+
+.align-left {
+    text-align: left;
+}
+
+.align-center {
+    text-align: center;
+}
+
+.align-right {
+    text-align: right;
+}
+
+/* -- sidebars -------------------------------------------------------------- */
+
+div.sidebar, aside.sidebar {
+    margin: 0 0 0.5em 1em;
+    border: 1px solid #ddb;
+    padding: 7px 7px 0 7px;
+    background-color: #ffe;
+    width: 40%;
+    float: right;
+}
+
+p.sidebar-title {
+    font-weight: bold;
+}
+
+/* -- topics ---------------------------------------------------------------- */
+
+nav.contents,
+aside.topic,
+div.topic {
+    border: 1px solid #ccc;
+    padding: 7px 7px 0 7px;
+    margin: 10px 0 10px 0;
+}
+
+p.topic-title {
+    font-size: 110%;
+    font-weight: bold;
+    margin-top: 10px;
+}
+
+/* -- admonitions ----------------------------------------------------------- */
+
+div.admonition {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    padding: 7px;
+}
+
+div.admonition dt {
+    font-weight: bold;
+}
+
+div.admonition dl {
+    margin-bottom: 0;
+}
+
+p.admonition-title {
+    margin: 0px 10px 5px 0px;
+    font-weight: bold;
+}
+
+div.body p.centered {
+    text-align: center;
+    margin-top: 25px;
+}
+
+/* -- tables ---------------------------------------------------------------- */
+
+table.docutils {
+    border: 0;
+    border-collapse: collapse;
+}
+
+table caption span.caption-number {
+    font-style: italic;
+}
+
+table caption span.caption-text {
+}
+
+table.docutils td, table.docutils th {
+    padding: 1px 8px 1px 5px;
+    border-top: 0;
+    border-left: 0;
+    border-right: 0;
+    border-bottom: 1px solid #aaa;
+}
+
+table.footnote td, table.footnote th {
+    border: 0 !important;
+}
+
+th {
+    text-align: left;
+    padding-right: 5px;
+}
+
+table.citation {
+    border-left: solid 1px gray;
+    margin-left: 1px;
+}
+
+table.citation td {
+    border-bottom: none;
+}
+
+/* -- figures --------------------------------------------------------------- */
+
+div.figure p.caption span.caption-number,
+figcaption span.caption-number {
+    font-style: italic;
+}
+
+div.figure p.caption span.caption-text,
+figcaption span.caption-text {
+}
+
+/* -- field list styles ----------------------------------------------------- */
+
+table.field-list td, table.field-list th {
+    border: 0 !important;
+}
+
+.field-list ul {
+    margin: 0;
+    padding-left: 1em;
+}
+
+.field-list p {
+    margin: 0;
+}
+
+/* -- other body styles ----------------------------------------------------- */
+
+ol.arabic {
+    list-style: decimal;
+}
+
+ol.loweralpha {
+    list-style: lower-alpha;
+}
+
+ol.upperalpha {
+    list-style: upper-alpha;
+}
+
+ol.lowerroman {
+    list-style: lower-roman;
+}
+
+ol.upperroman {
+    list-style: upper-roman;
+}
+
+dl {
+    margin-bottom: 15px;
+}
+
+dd p {
+    margin-top: 0px;
+}
+
+dd ul, dd table {
+    margin-bottom: 10px;
+}
+
+dd {
+    margin-top: 3px;
+    margin-bottom: 10px;
+    margin-left: 30px;
+}
+
+dt:target, .highlighted {
+    background-color: #ddd;
+}
+
+dl.glossary dt {
+    font-weight: bold;
+    font-size: 110%;
+}
+
+.optional {
+    font-size: 130%;
+}
+
+.sig-paren {
+    font-size: larger;
+}
+
+.versionmodified {
+    font-style: italic;
+}
+
+.system-message {
+    background-color: #fda;
+    padding: 5px;
+    border: 3px solid red;
+}
+
+.footnote:target  {
+    background-color: #dddddd;
+}
+
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}
+
+.guilabel, .menuselection {
+    font-style: italic;
+}
+
+.accelerator {
+    text-decoration: underline;
+}
+
+.classifier {
+    font-style: oblique;
+}
+
+abbr, acronym {
+    border-bottom: dotted 1px;
+    cursor: help;
+}
+
+/* -- code displays --------------------------------------------------------- */
+
+pre {
+    font-family: monospace;
+    overflow: auto;
+    overflow-y: hidden;
+}
+
+td.linenos pre {
+    padding: 5px 0px;
+    border: 0;
+    background-color: transparent;
+    color: #aaa;
+}
+
+table.highlighttable {
+    margin-left: 0.5em;
+}
+
+table.highlighttable td {
+    padding: 0 0.5em 0 0.5em;
+}
+
+code {
+    font-family: monospace;
+}
+
+div.code-block-caption span.caption-number {
+    padding: 0.1em 0.3em;
+    font-style: italic;
+}
+
+div.code-block-caption span.caption-text {
+}
+
+div.literal-block-wrapper {
+    padding: 1em 1em 0;
+}
+
+div.literal-block-wrapper div.highlight {
+    margin: 0;
+}
+
+code.descname {
+    background-color: transparent;
+    font-weight: bold;
+    font-size: 1.2em;
+}
+
+code.descclassname {
+    background-color: transparent;
+}
+
+code.xref, a code {
+    background-color: transparent;
+    font-weight: bold;
+}
+
+h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
+    background-color: transparent;
+}
+
+/* -- math display ---------------------------------------------------------- */
+
+img.math {
+    vertical-align: middle;
+}
+
+div.body div.math p {
+    text-align: center;
+}
+
+span.eqno {
+    float: right;
+}
+
+/* -- special divs  --------------------------------------------------------- */
+
+div.quotebar {
+    background-color: #e3eff1;
+    max-width: 250px;
+    float: right;
+    font-family: sans-serif;
+    padding: 7px 7px;
+    border: 1px solid #ccc;
+}
+div.footer {
+    background-color: #e3eff1;
+    padding: 3px 8px 3px 0;
+    clear: both;
+    font-family: sans-serif;
+    font-size: 80%;
+    text-align: right;
+}
+
+div.footer a {
+    text-decoration: underline;
+}
+
+/* -- link-target ----------------------------------------------------------- */
+
+.link-target {
+    font-size: 80%;
+}
+
+table .link-target {
+    /* Do not show links in tables, there is not enough space */
+    display: none;
+}
+
+/* -- font-face ------------------------------------------------------------- */
+
+/*
+@font-face {
+    font-family: "LiberationNarrow";
+    font-style: normal;
+    font-weight: normal;
+    src: url("res:///Data/fonts/LiberationNarrow-Regular.otf")
+        format("opentype");
+}
+@font-face {
+    font-family: "LiberationNarrow";
+    font-style: oblique, italic;
+    font-weight: normal;
+    src: url("res:///Data/fonts/LiberationNarrow-Italic.otf")
+        format("opentype");
+}
+@font-face {
+    font-family: "LiberationNarrow";
+    font-style: normal;
+    font-weight: bold;
+    src: url("res:///Data/fonts/LiberationNarrow-Bold.otf")
+        format("opentype");
+}
+@font-face {
+    font-family: "LiberationNarrow";
+    font-style: oblique, italic;
+    font-weight: bold;
+    src: url("res:///Data/fonts/LiberationNarrow-BoldItalic.otf")
+        format("opentype");
+}
+*/

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/pyramid/static/epub.css_t Added

@@ -0,0 +1,312 @@
+/*
+ * default.css_t
+ * ~~~~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- default theme.
+ *
+ * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+@import url("basic.css");
+
+/* -- page layout ----------------------------------------------------------- */
+
+body {
+    font-family: {{ theme_bodyfont }};
+    font-size: 100%;
+    background-color: {{ theme_footerbgcolor }};
+    color: #000;
+    margin: 0;
+    padding: 0;
+}
+
+div.document {
+    background-color: {{ theme_sidebarbgcolor }};
+}
+
+div.documentwrapper {
+    float: left;
+    width: 100%;
+}
+
+div.bodywrapper {
+    margin: 0 0 0 230px;
+}
+
+div.body {
+    background-color: {{ theme_bgcolor }};
+    color: {{ theme_textcolor }};
+    padding: 0 20px 30px 20px;
+}
+
+{%- if theme_rightsidebar|tobool %}
+div.bodywrapper {
+    margin: 0 230px 0 0;
+}
+{%- endif %}
+
+div.footer {
+    color: {{ theme_footertextcolor }};
+    width: 100%;
+    padding: 9px 0 9px 0;
+    text-align: center;
+    font-size: 75%;
+}
+
+div.footer a {
+    color: {{ theme_footertextcolor }};
+    text-decoration: underline;
+}
+
+div.related {
+    background-color: {{ theme_relbarbgcolor }};
+    line-height: 30px;
+    color: {{ theme_relbartextcolor }};
+}
+
+div.related a {
+    color: {{ theme_relbarlinkcolor }};
+}
+
+div.sphinxsidebar {
+    {%- if theme_stickysidebar|tobool %}
+    top: 30px;
+    bottom: 0;
+    margin: 0;
+    position: fixed;
+    overflow: auto;
+    height: auto;
+    {%- endif %}
+    {%- if theme_rightsidebar|tobool %}
+    float: right;
+    {%- if theme_stickysidebar|tobool %}
+    right: 0;
+    {%- endif %}
+    {%- endif %}
+}
+
+{%- if theme_stickysidebar|tobool %}
+/* this is nice, but it it leads to hidden headings when jumping
+   to an anchor */
+/*
+div.related {
+    position: fixed;
+}
+
+div.documentwrapper {
+    margin-top: 30px;
+}
+*/
+{%- endif %}
+
+div.sphinxsidebar h3 {
+    font-family: {{ theme_headfont }};
+    color: {{ theme_sidebartextcolor }};
+    font-size: 1.4em;
+    font-weight: normal;
+    margin: 0;
+    padding: 0;
+}
+
+div.sphinxsidebar h3 a {
+    color: {{ theme_sidebartextcolor }};
+}
+
+div.sphinxsidebar h4 {
+    font-family: {{ theme_headfont }};
+    color: {{ theme_sidebartextcolor }};
+    font-size: 1.3em;
+    font-weight: normal;
+    margin: 5px 0 0 0;
+    padding: 0;
+}
+
+div.sphinxsidebar p {
+    color: {{ theme_sidebartextcolor }};
+}
+
+div.sphinxsidebar p.topless {
+    margin: 5px 10px 10px 10px;
+}
+
+div.sphinxsidebar ul {
+    margin: 10px;
+    padding: 0;
+    color: {{ theme_sidebartextcolor }};
+}
+
+div.sphinxsidebar a {
+    color: {{ theme_sidebarlinkcolor }};
+}
+
+div.sphinxsidebar input {
+    border: 1px solid {{ theme_sidebarlinkcolor }};
+    font-family: sans-serif;
+    font-size: 1em;
+}
+
+{% if theme_collapsiblesidebar|tobool %}
+/* for collapsible sidebar */
+div#sidebarbutton {
+    background-color: {{ theme_sidebarbtncolor }};
+}
+{% endif %}
+
+/* -- hyperlink styles ------------------------------------------------------ */
+
+a {
+    color: {{ theme_linkcolor }};
+    text-decoration: none;
+}
+
+a:visited {
+    color: {{ theme_visitedlinkcolor }};
+    text-decoration: none;
+}
+
+a:hover {
+    text-decoration: underline;
+}
+
+{% if theme_externalrefs|tobool %}
+a.external {
+   text-decoration: none;
+   border-bottom: 1px dashed {{ theme_linkcolor }};
+}
+
+a.external:hover {
+   text-decoration: none;
+   border-bottom: none;
+}
+
+a.external:visited {
+    text-decoration: none;
+    border-bottom: 1px dashed {{ theme_visitedlinkcolor }};
+}
+{% endif %}
+
+/* -- body styles ----------------------------------------------------------- */
+
+div.body h1,
+div.body h2,
+div.body h3,
+div.body h4,
+div.body h5,
+div.body h6 {
+    font-family: {{ theme_headfont }};
+    background-color: {{ theme_headbgcolor }};
+    font-weight: normal;
+    color: {{ theme_headtextcolor }};
+    border-bottom: 1px solid #ccc;
+    margin: 20px -20px 10px -20px;
+    padding: 3px 0 3px 10px;
+}
+
+div.body h1 { margin-top: 0; font-size: 200%; }
+div.body h2 { font-size: 160%; }
+div.body h3 { font-size: 140%; }
+div.body h4 { font-size: 120%; }
+div.body h5 { font-size: 110%; }
+div.body h6 { font-size: 100%; }
+
+a.headerlink {
+    color: {{ theme_headlinkcolor }};
+    font-size: 0.8em;
+    padding: 0 4px 0 4px;
+    text-decoration: none;
+}
+
+a.headerlink:hover {
+    background-color: {{ theme_headlinkcolor }};
+    color: white;
+}
+
+div.body p, div.body dd, div.body li {
+    text-align: justify;
+    line-height: 130%;
+}
+
+div.admonition p.admonition-title + p {
+    display: inline;
+}
+
+div.admonition p {
+    margin-bottom: 5px;
+}
+
+div.admonition pre {
+    margin-bottom: 5px;
+}
+
+div.admonition ul, div.admonition ol {
+    margin-bottom: 5px;
+}
+
+div.note {
+    background-color: #eee;
+    border: 1px solid #ccc;
+}
+
+div.seealso {
+    background-color: #ffc;
+    border: 1px solid #ff6;
+}
+
+nav.contents,
+aside.topic,
+div.topic {
+    background-color: #eee;
+}
+
+div.warning {
+    background-color: #ffe4e4;
+    border: 1px solid #f66;
+}
+
+p.admonition-title {
+    display: inline;
+}
+
+p.admonition-title:after {
+    content: ":";
+}
+
+pre {
+    padding: 5px;
+    background-color: {{ theme_codebgcolor }};
+    color: {{ theme_codetextcolor }};
+    line-height: 120%;
+    border: 1px solid #ac9;
+    border-left: none;
+    border-right: none;
+}
+
+code {
+    background-color: #ecf0f3;
+    padding: 0 1px 0 1px;
+    font-size: 0.95em;
+}
+
+th {
+    background-color: #ede;
+}
+
+.warning code {
+    background: #efc2c2;
+}
+
+.note code {
+    background: #d6d6d6;
+}
+
+.viewcode-back {
+    font-family: {{ theme_bodyfont }};
+}
+
+div.viewcode-block:target {
+    background-color: #f4debf;
+    border-top: 1px solid #ac9;
+    border-bottom: 1px solid #ac9;
+}

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/pyramid/static/pyramid.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/pyramid/static/pyramid.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/scrolls/layout.html -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/scrolls/layout.html Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/scrolls/static/scrolls.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/scrolls/static/scrolls.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/scrolls/static/theme_extras.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/scrolls/static/theme_extras.js Changed

@@ -1,26 +1,12 @@
-$(function() {
-
-  var
-    toc = $('#toc').show(),
-    items = $('#toc > ul').hide();
-
-  $('#toc h3')
-    .click(function() {
-      if (items.is(':visible')) {
-        items.animate({
-          height:     'hide',
-          opacity:    'hide'
-        }, 300, function() {
-          toc.removeClass('expandedtoc');
-        });
-      }
-      else {
-        items.animate({
-          height:     'show',
-          opacity:    'show'
-        }, 400);
-        toc.addClass('expandedtoc');
-      }
-    });
-
-});
+const initialiseThemeExtras = () => {
+  const toc = document.getElementById("toc")
+  toc.style.display = ""
+  const items = toc.getElementsByTagName("ul")0
+  items.style.display = "none"
+    toc.getElementsByTagName("h3").addEventListener("click", () => {
+      if (items.style.display !== "none") toc.classList.remove("expandedtoc")
+      else toc.classList.add("expandedtoc");
+    })
+}
+if (document.readyState !== "loading") initialiseThemeExtras()
+else document.addEventListener("DOMContentLoaded", initialiseThemeExtras)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/sphinxdoc/static/sphinxdoc.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/sphinxdoc/static/sphinxdoc.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/themes/traditional/static/traditional.css_t -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/themes/traditional/static/traditional.css_t Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/theming.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/theming.py Changed

@@ -1,25 +1,20 @@
-"""
-    sphinx.theming
-    ~~~~~~~~~~~~~~
+"""Theming support for HTML builders."""
 
-    Theming support for HTML builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import configparser
 import os
 import shutil
+import sys
 import tempfile
 from os import path
-from typing import TYPE_CHECKING, Any, Dict, List
+from typing import TYPE_CHECKING, Any
 from zipfile import ZipFile
 
-try:  # Python < 3.10 (backport)
-    from importlib_metadata import entry_points
-except ImportError:
+if sys.version_info >= (3, 10):
     from importlib.metadata import entry_points
+else:
+    from importlib_metadata import entry_points
 
 from sphinx import package_dir
 from sphinx.errors import ThemeError
@@ -56,7 +51,7 @@
 
     This class supports both theme directory and theme archive (zipped theme)."""
 
-    def __init__(self, name: str, theme_path: str, factory: "HTMLThemeFactory") -> None:
+    def __init__(self, name: str, theme_path: str, factory: HTMLThemeFactory) -> None:
         self.name = name
         self.base = None
         self.rootdir = None
@@ -72,7 +67,7 @@
             extract_zip(theme_path, self.themedir)
 
         self.config = configparser.RawConfigParser()
-        self.config.read(path.join(self.themedir, THEMECONF))
+        self.config.read(path.join(self.themedir, THEMECONF), encoding='utf-8')
 
         try:
             inherit = self.config.get('theme', 'inherit')
@@ -88,7 +83,7 @@
                 raise ThemeError(__('no theme named %r found, inherited by %r') %
                                  (inherit, name)) from exc
 
-    def get_theme_dirs(self) -> Liststr:
+    def get_theme_dirs(self) -> liststr:
         """Return a list of theme directories, beginning with this theme's,
         then the base theme's, then that one's base theme's, etc.
         """
@@ -110,10 +105,9 @@
             if default is NODEFAULT:
                 raise ThemeError(__('setting %s.%s occurs in none of the '
                                     'searched theme configs') % (section, name)) from exc
-            else:
-                return default
+            return default
 
-    def get_options(self, overrides: Dictstr, Any = {}) -> Dictstr, Any:
+    def get_options(self, overrides: dictstr, Any = {}) -> dictstr, Any:
         """Return a dictionary of theme options and their values."""
         if self.base:
             options = self.base.get_options()
@@ -156,7 +150,7 @@
 class HTMLThemeFactory:
     """A factory class for HTML Themes."""
 
-    def __init__(self, app: "Sphinx") -> None:
+    def __init__(self, app: Sphinx) -> None:
         self.app = app
         self.themes = app.registry.html_themes
         self.load_builtin_themes()
@@ -189,15 +183,6 @@
         import alabaster
         self.themes'alabaster' = path.join(alabaster.get_path(), 'alabaster')
 
-    def load_sphinx_rtd_theme(self) -> None:
-        """Load sphinx_rtd_theme theme (if installed)."""
-        try:
-            import sphinx_rtd_theme
-            theme_path = sphinx_rtd_theme.get_html_theme_path()
-            self.themes'sphinx_rtd_theme' = path.join(theme_path, 'sphinx_rtd_theme')
-        except ImportError:
-            pass
-
     def load_external_theme(self, name: str) -> None:
         """Try to load a theme using entry_points.
 
@@ -213,9 +198,9 @@
         except KeyError:
             pass
 
-    def find_themes(self, theme_path: str) -> Dictstr, str:
+    def find_themes(self, theme_path: str) -> dictstr, str:
         """Search themes from specified directory."""
-        themes: Dictstr, str = {}
+        themes: dictstr, str = {}
         if not path.isdir(theme_path):
             return themes
 
@@ -239,12 +224,6 @@
         if name not in self.themes:
             self.load_extra_theme(name)
 
-        if name not in self.themes and name == 'sphinx_rtd_theme':
-            # sphinx_rtd_theme (< 0.2.5)  # RemovedInSphinx60Warning
-            logger.warning(__('sphinx_rtd_theme (< 0.3.0) found. '
-                              'It will not be available since Sphinx-6.0'))
-            self.load_sphinx_rtd_theme()
-
         if name not in self.themes:
             raise ThemeError(__('no theme named %r found (missing theme.conf?)') % name)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/__init__.py Changed

@@ -1,20 +1,13 @@
-"""
-    sphinx.transforms
-    ~~~~~~~~~~~~~~~~~
+"""Docutils transforms used by Sphinx when reading documents."""
 
-    Docutils transforms used by Sphinx when reading documents.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 import unicodedata
-import warnings
-from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Tuple, cast
+from typing import TYPE_CHECKING, Any, Generator, cast
 
 from docutils import nodes
-from docutils.nodes import Element, Node, Text
+from docutils.nodes import Node, Text
 from docutils.transforms import Transform, Transformer
 from docutils.transforms.parts import ContentsFilter
 from docutils.transforms.universal import SmartQuotes
@@ -23,12 +16,11 @@
 
 from sphinx import addnodes
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx60Warning
 from sphinx.locale import _, __
-from sphinx.util import docutils, logging
+from sphinx.util import logging
 from sphinx.util.docutils import new_document
 from sphinx.util.i18n import format_date
-from sphinx.util.nodes import NodeMatcher, apply_source_workaround, is_smartquotable
+from sphinx.util.nodes import apply_source_workaround, is_smartquotable
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -53,12 +45,12 @@
     """
 
     @property
-    def app(self) -> "Sphinx":
+    def app(self) -> Sphinx:
         """Reference to the :class:`.Sphinx` object."""
         return self.env.app
 
     @property
-    def env(self) -> "BuildEnvironment":
+    def env(self) -> BuildEnvironment:
         """Reference to the :class:`.BuildEnvironment` object."""
         return self.document.settings.env
 
@@ -74,9 +66,9 @@
     """
 
     document: nodes.document
-    env: Optional"BuildEnvironment" = None
+    env: BuildEnvironment | None = None
 
-    def set_environment(self, env: "BuildEnvironment") -> None:
+    def set_environment(self, env: BuildEnvironment) -> None:
         self.env = env
 
     def apply_transforms(self) -> None:
@@ -116,7 +108,7 @@
                     # special handling: can also specify a strftime format
                     text = format_date(self.config.today_fmt or _('%b %d, %Y'),
                                        language=self.config.language)
-                ref.replace_self(nodes.Text(text, text))
+                ref.replace_self(nodes.Text(text))
 
 
 class MoveModuleTargets(SphinxTransform):
@@ -245,7 +237,7 @@
         def is_translatable_node(node: Node) -> bool:
             return isinstance(node, tuple(target_nodes))
 
-        for node in self.document.findall(is_translatable_node):  # type: Element
+        for node in self.document.findall(is_translatable_node):  # type: nodes.Element
             node'translatable' = True
 
 
@@ -281,23 +273,6 @@
             node'classes'.append('doctest')
 
 
-class FigureAligner(SphinxTransform):
-    """
-    Align figures to center by default.
-    """
-    default_priority = 700
-
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        warnings.warn('FigureAilgner is deprecated.',
-                      RemovedInSphinx60Warning)
-        super().__init__(*args, **kwargs)
-
-    def apply(self, **kwargs: Any) -> None:
-        matcher = NodeMatcher(nodes.table, nodes.figure)
-        for node in self.document.findall(matcher):  # type: Element
-            node.setdefault('align', 'default')
-
-
 class FilterSystemMessages(SphinxTransform):
     """Filter system messages from a doctree."""
     default_priority = 999
@@ -345,39 +320,34 @@
         if self.document.settings.smart_quotes is False:
             # disabled by 3rd party extension (workaround)
             return False
-        elif self.config.smartquotes is False:
+        if self.config.smartquotes is False:
             # disabled by confval smartquotes
             return False
-        elif self.app.builder.name in builders:
+        if self.app.builder.name in builders:
             # disabled by confval smartquotes_excludes'builders'
             return False
-        elif self.config.language in languages:
+        if self.config.language in languages:
             # disabled by confval smartquotes_excludes'languages'
             return False
 
         # confirm selected language supports smart_quotes or not
         language = self.env.settings'language_code'
-        for tag in normalize_language_tag(language):
-            if tag in smartchars.quotes:
-                return True
-        else:
-            return False
+        return any(
+            tag in smartchars.quotes
+            for tag in normalize_language_tag(language)
+        )
 
-    def get_tokens(self, txtnodes: ListText) -> GeneratorTuplestr, str, None, None:
+    def get_tokens(self, txtnodes: listText) -> Generatortuplestr, str, None, None:
         # A generator that yields ``(texttype, nodetext)`` tuples for a list
         # of "Text" nodes (interface to ``smartquotes.educate_tokens()``).
         for txtnode in txtnodes:
             if is_smartquotable(txtnode):
-                if docutils.__version_info__ >= (0, 16):
-                    # SmartQuotes uses backslash escapes instead of null-escapes
-                    text = re.sub(r'(?<=\x00)(-\\\'".`)', r'\\\1', str(txtnode))
-                else:
-                    text = txtnode.astext()
-
-                yield ('plain', text)
+                # SmartQuotes uses backslash escapes instead of null-escapes
+                text = re.sub(r'(?<=\x00)(-\\\'".`)', r'\\\1', str(txtnode))
+                yield 'plain', text
             else:
                 # skip smart quotes
-                yield ('literal', txtnode.astext())
+                yield 'literal', txtnode.astext()
 
 
 class DoctreeReadEvent(SphinxTransform):
@@ -396,7 +366,7 @@
         for node in self.document.findall(addnodes.manpage):
             manpage = ' '.join(str(x) for x in node.children
                                 if isinstance(x, nodes.Text))
-            pattern = r'^(?P<path>(?P<page>.+)$\.(?P<section>1-9\w*)?$?)$'  # noqa
+            pattern = r'^(?P<path>(?P<page>.+)$\.(?P<section>1-9\w*)?$?)$'
             info = {'path': manpage,
                     'page': manpage,
                     'section': ''}
@@ -420,11 +390,11 @@
                     definition_list,
                     key=lambda item: unicodedata.normalize(
                         'NFD',
-                        cast(nodes.term, item)0.astext().lower())
+                        cast(nodes.term, item)0.astext().lower()),
                 )
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_transform(ApplySourceWorkaround)
     app.add_transform(ExtraTranslatableNodes)
     app.add_transform(DefaultSubstitutions)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/compact_bullet_list.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/compact_bullet_list.py Changed

@@ -1,14 +1,8 @@
-"""
-    sphinx.transforms.compact_bullet_list
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Docutils transforms used by Sphinx when reading documents."""
 
-    Docutils transforms used by Sphinx when reading documents.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, List, cast
+from typing import Any, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -32,7 +26,7 @@
         pass
 
     def visit_list_item(self, node: nodes.list_item) -> None:
-        children: ListNode = 
+        children: listNode = 
         for child in node.children:
             if not isinstance(child, nodes.Invisible):
                 children.append(child)
@@ -84,7 +78,7 @@
                     item.replace(para, compact_para)
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_transform(RefOnlyBulletListTransform)
 
     return {

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/i18n.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/i18n.py Changed

@@ -1,21 +1,15 @@
-"""
-    sphinx.transforms.i18n
-    ~~~~~~~~~~~~~~~~~~~~~~
+"""Docutils transforms used by Sphinx when reading documents."""
 
-    Docutils transforms used by Sphinx when reading documents.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import contextlib
 from os import path
+from re import DOTALL, match
 from textwrap import indent
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Type, TypeVar
+from typing import TYPE_CHECKING, Any, Sequence, TypeVar
 
 from docutils import nodes
 from docutils.io import StringInput
-from docutils.nodes import Element
-from docutils.utils import relative_path
 
 from sphinx import addnodes
 from sphinx.config import Config
@@ -25,8 +19,13 @@
 from sphinx.transforms import SphinxTransform
 from sphinx.util import get_filetype, logging, split_index_msg
 from sphinx.util.i18n import docname_to_domain
-from sphinx.util.nodes import (IMAGE_TYPE_NODES, LITERAL_TYPE_NODES, NodeMatcher,
-                               extract_messages, is_pending_meta, traverse_translatable_index)
+from sphinx.util.nodes import (
+    IMAGE_TYPE_NODES,
+    LITERAL_TYPE_NODES,
+    NodeMatcher,
+    extract_messages,
+    traverse_translatable_index,
+)
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -44,8 +43,8 @@
 N = TypeVar('N', bound=nodes.Node)
 
 
-def publish_msgstr(app: "Sphinx", source: str, source_path: str, source_line: int,
-                   config: Config, settings: Any) -> Element:
+def publish_msgstr(app: Sphinx, source: str, source_path: str, source_line: int,
+                   config: Config, settings: Any) -> nodes.Element:
     """Publish msgstr (single line) into docutils document
 
     :param sphinx.application.Sphinx app: sphinx application
@@ -60,7 +59,7 @@
     try:
         # clear rst_prolog temporarily
         rst_prolog = config.rst_prolog
-        config.rst_prolog = None  # type: ignore
+        config.rst_prolog = None  # type: ignoreattr-defined
 
         from sphinx.io import SphinxI18nReader
         reader = SphinxI18nReader()
@@ -69,17 +68,23 @@
         parser = app.registry.create_source_parser(app, filetype)
         doc = reader.read(
             source=StringInput(source=source,
-                               source_path="%s:%s:<translated>" % (source_path, source_line)),
+                               source_path=f"{source_path}:{source_line}:<translated>"),
             parser=parser,
             settings=settings,
         )
-        try:
-            doc = doc0  # type: ignore
-        except IndexError:  # empty node
-            pass
+        with contextlib.suppress(IndexError):  # empty node
+            return doc0  # type: ignorereturn-value
         return doc
     finally:
-        config.rst_prolog = rst_prolog  # type: ignore
+        config.rst_prolog = rst_prolog  # type: ignoreattr-defined
+
+
+def parse_noqa(source: str) -> tuplestr, bool:
+    m = match(r"(.*)(?<!\\)#\s*noqa\s*$", source, DOTALL)
+    if m:
+        return m.group(1), True
+    else:
+        return source, False
 
 
 class PreserveTranslatableMessages(SphinxTransform):
@@ -93,6 +98,238 @@
             node.preserve_original_messages()
 
 
+class _NodeUpdater:
+    """Contains logic for updating one node with the translated content."""
+
+    def __init__(
+        self, node: nodes.Element, patch: nodes.Element, document: nodes.document, noqa: bool,
+    ) -> None:
+        self.node: nodes.Element = node
+        self.patch: nodes.Element = patch
+        self.document: nodes.document = document
+        self.noqa: bool = noqa
+
+    def compare_references(self, old_refs: Sequencenodes.Element,
+                           new_refs: Sequencenodes.Element,
+                           warning_msg: str) -> None:
+        """Warn about mismatches between references in original and translated content."""
+        # FIXME: could use a smarter strategy than len(old_refs) == len(new_refs)
+        if not self.noqa and len(old_refs) != len(new_refs):
+            old_ref_rawsources = ref.rawsource for ref in old_refs
+            new_ref_rawsources = ref.rawsource for ref in new_refs
+            logger.warning(warning_msg.format(old_ref_rawsources, new_ref_rawsources),
+                           location=self.node, type='i18n', subtype='inconsistent_references')
+
+    def update_title_mapping(self) -> bool:
+        processed = False  # skip flag
+
+        # update title(section) target name-id mapping
+        if isinstance(self.node, nodes.title) and isinstance(self.node.parent, nodes.section):
+            section_node = self.node.parent
+            new_name = nodes.fully_normalize_name(self.patch.astext())
+            old_name = nodes.fully_normalize_name(self.node.astext())
+
+            if old_name != new_name:
+                # if name would be changed, replace node names and
+                # document nameids mapping with new name.
+                names = section_node.setdefault('names', )
+                names.append(new_name)
+                # Original section name (reference target name) should be kept to refer
+                # from other nodes which is still not translated or uses explicit target
+                # name like "`text to display <explicit target name_>`_"..
+                # So, `old_name` is still exist in `names`.
+
+                _id = self.document.nameids.get(old_name, None)
+                explicit = self.document.nametypes.get(old_name, None)
+
+                # * if explicit: _id is label. title node need another id.
+                # * if not explicit:
+                #
+                #   * if _id is None:
+                #
+                #     _id is None means:
+                #
+                #     1. _id was not provided yet.
+                #
+                #     2. _id was duplicated.
+                #
+                #        old_name entry still exists in nameids and
+                #        nametypes for another duplicated entry.
+                #
+                #   * if _id is provided: below process
+                if _id:
+                    if not explicit:
+                        # _id was not duplicated.
+                        # remove old_name entry from document ids database
+                        # to reuse original _id.
+                        self.document.nameids.pop(old_name, None)
+                        self.document.nametypes.pop(old_name, None)
+                        self.document.ids.pop(_id, None)
+
+                    # re-entry with new named section node.
+                    #
+                    # Note: msgnode that is a second parameter of the
+                    # `note_implicit_target` is not necessary here because
+                    # section_node has been noted previously on rst parsing by
+                    # `docutils.parsers.rst.states.RSTState.new_subsection()`
+                    # and already has `system_message` if needed.
+                    self.document.note_implicit_target(section_node)
+
+                # replace target's refname to new target name
+                matcher = NodeMatcher(nodes.target, refname=old_name)
+                for old_target in self.document.findall(matcher):  # type: nodes.target
+                    old_target'refname' = new_name
+
+                processed = True
+
+        return processed
+
+    def update_autofootnote_references(self) -> None:
+        # auto-numbered foot note reference should use original 'ids'.
+        def list_replace_or_append(lst: listN, old: N, new: N) -> None:
+            if old in lst:
+                lstlst.index(old) = new
+            else:
+                lst.append(new)
+
+        is_autofootnote_ref = NodeMatcher(nodes.footnote_reference, auto=Any)
+        old_foot_refs: listnodes.footnote_reference = 
+            *self.node.findall(is_autofootnote_ref)
+        new_foot_refs: listnodes.footnote_reference = 
+            *self.patch.findall(is_autofootnote_ref)
+        self.compare_references(old_foot_refs, new_foot_refs,
+                                __('inconsistent footnote references in translated message.' +
+                                   ' original: {0}, translated: {1}'))
+        old_foot_namerefs: dictstr, listnodes.footnote_reference = {}
+        for r in old_foot_refs:
+            old_foot_namerefs.setdefault(r.get('refname'), ).append(r)
+        for newf in new_foot_refs:
+            refname = newf.get('refname')
+            refs = old_foot_namerefs.get(refname, )
+            if not refs:
+                newf.parent.remove(newf)
+                continue
+
+            oldf = refs.pop(0)
+            newf'ids' = oldf'ids'
+            for id in newf'ids':
+                self.document.idsid = newf
+
+            if newf'auto' == 1:
+                # autofootnote_refs
+                list_replace_or_append(self.document.autofootnote_refs, oldf, newf)
+            else:
+                # symbol_footnote_refs
+                list_replace_or_append(self.document.symbol_footnote_refs, oldf, newf)
+
+            if refname:
+                footnote_refs = self.document.footnote_refs.setdefault(refname, )
+                list_replace_or_append(footnote_refs, oldf, newf)
+
+                refnames = self.document.refnames.setdefault(refname, )
+                list_replace_or_append(refnames, oldf, newf)
+
+    def update_refnamed_references(self) -> None:
+        # reference should use new (translated) 'refname'.
+        # * reference target ".. _Python: ..." is not translatable.
+        # * use translated refname for section refname.
+        # * inline reference "`Python <...>`_" has no 'refname'.
+        is_refnamed_ref = NodeMatcher(nodes.reference, refname=Any)
+        old_refs: listnodes.reference = *self.node.findall(is_refnamed_ref)
+        new_refs: listnodes.reference = *self.patch.findall(is_refnamed_ref)
+        self.compare_references(old_refs, new_refs,
+                                __('inconsistent references in translated message.' +
+                                   ' original: {0}, translated: {1}'))
+        old_ref_names = r'refname' for r in old_refs
+        new_ref_names = r'refname' for r in new_refs
+        orphans = *({*old_ref_names} - {*new_ref_names})
+        for newr in new_refs:
+            if not self.document.has_name(newr'refname'):
+                # Maybe refname is translated but target is not translated.
+                # Note: multiple translated refnames break link ordering.
+                if orphans:
+                    newr'refname' = orphans.pop(0)
+                else:
+                    # orphan refnames is already empty!
+                    # reference number is same in new_refs and old_refs.
+                    pass
+
+            self.document.note_refname(newr)
+
+    def update_refnamed_footnote_references(self) -> None:
+        # refnamed footnote should use original 'ids'.
+        is_refnamed_footnote_ref = NodeMatcher(nodes.footnote_reference, refname=Any)
+        old_foot_refs: listnodes.footnote_reference = *self.node.findall(
+            is_refnamed_footnote_ref)
+        new_foot_refs: listnodes.footnote_reference = *self.patch.findall(
+            is_refnamed_footnote_ref)
+        refname_ids_map: dictstr, liststr = {}
+        self.compare_references(old_foot_refs, new_foot_refs,
+                                __('inconsistent footnote references in translated message.' +
+                                   ' original: {0}, translated: {1}'))
+        for oldf in old_foot_refs:
+            refname_ids_map.setdefault(oldf"refname", ).append(oldf"ids")
+        for newf in new_foot_refs:
+            refname = newf"refname"
+            if refname_ids_map.get(refname):
+                newf"ids" = refname_ids_maprefname.pop(0)
+
+    def update_citation_references(self) -> None:
+        # citation should use original 'ids'.
+        is_citation_ref = NodeMatcher(nodes.citation_reference, refname=Any)
+        old_cite_refs: listnodes.citation_reference = *self.node.findall(is_citation_ref)
+        new_cite_refs: listnodes.citation_reference = *self.patch.findall(is_citation_ref)
+        self.compare_references(old_cite_refs, new_cite_refs,
+                                __('inconsistent citation references in translated message.' +
+                                   ' original: {0}, translated: {1}'))
+        refname_ids_map: dictstr, liststr = {}
+        for oldc in old_cite_refs:
+            refname_ids_map.setdefault(oldc"refname", ).append(oldc"ids")
+        for newc in new_cite_refs:
+            refname = newc"refname"
+            if refname_ids_map.get(refname):
+                newc"ids" = refname_ids_maprefname.pop()
+
+    def update_pending_xrefs(self) -> None:
+        # Original pending_xref'reftarget' contain not-translated
+        # target name, new pending_xref must use original one.
+        # This code restricts to change ref-targets in the translation.
+        old_xrefs = *self.node.findall(addnodes.pending_xref)
+        new_xrefs = *self.patch.findall(addnodes.pending_xref)
+        self.compare_references(old_xrefs, new_xrefs,
+                                __('inconsistent term references in translated message.' +
+                                   ' original: {0}, translated: {1}'))
+
+        xref_reftarget_map = {}
+
+        def get_ref_key(node: addnodes.pending_xref) -> tuplestr, str, str | None:
+            case = node"refdomain", node"reftype"
+            if case == ('std', 'term'):
+                return None
+            else:
+                return (
+                    node"refdomain",
+                    node"reftype",
+                    node'reftarget',)
+
+        for old in old_xrefs:
+            key = get_ref_key(old)
+            if key:
+                xref_reftarget_mapkey = old.attributes
+        for new in new_xrefs:
+            key = get_ref_key(new)
+            # Copy attributes to keep original node behavior. Especially
+            # copying 'reftarget', 'py:module', 'py:class' are needed.
+            for k, v in xref_reftarget_map.get(key, {}).items():
+                if k not in EXCLUDED_PENDING_XREF_ATTRIBUTES:
+                    newk = v
+
+    def update_leaves(self) -> None:
+        for child in self.patch.children:
+            child.parent = self.node
+        self.node.children = self.patch.children
+
+
 class Locale(SphinxTransform):
     """
     Replace translatable nodes with their translated doctree.
@@ -103,11 +340,7 @@
         settings, source = self.document.settings, self.document'source'
         msgstr = ''
 
-        # XXX check if this is reliable
-        assert source.startswith(self.env.srcdir)
-        docname = path.splitext(relative_path(path.join(self.env.srcdir, 'dummy'),
-                                              source))0
-        textdomain = docname_to_domain(docname, self.config.gettext_compact)
+        textdomain = docname_to_domain(self.env.docname, self.config.gettext_compact)
 
         # fetch translations
         dirs = path.join(self.env.srcdir, directory)
@@ -119,6 +352,14 @@
         # phase1: replace reference ids with translated names
         for node, msg in extract_messages(self.document):
             msgstr = catalog.gettext(msg)
+
+            # There is no point in having #noqa on literal blocks because
+            # they cannot contain references.  Recognizing it would just
+            # completely prevent escaping the #noqa.  Outside of literal
+            # blocks, one can always write \#noqa.
+            if not isinstance(node, LITERAL_TYPE_NODES):
+                msgstr, _ = parse_noqa(msgstr)
+
             # XXX add marker to untranslated parts
             if not msgstr or msgstr == msg or not msgstr.strip():
                 # as-of-yet untranslated
@@ -139,87 +380,29 @@
 
             patch = publish_msgstr(self.app, msgstr, source,
                                    node.line, self.config, settings)
+            # FIXME: no warnings about inconsistent references in this part
             # XXX doctest and other block markup
             if not isinstance(patch, nodes.paragraph):
                 continue  # skip for now
 
-            processed = False  # skip flag
-
-            # update title(section) target name-id mapping
-            if isinstance(node, nodes.title) and isinstance(node.parent, nodes.section):
-                section_node = node.parent
-                new_name = nodes.fully_normalize_name(patch.astext())
-                old_name = nodes.fully_normalize_name(node.astext())
-
-                if old_name != new_name:
-                    # if name would be changed, replace node names and
-                    # document nameids mapping with new name.
-                    names = section_node.setdefault('names', )
-                    names.append(new_name)
-                    # Original section name (reference target name) should be kept to refer
-                    # from other nodes which is still not translated or uses explicit target
-                    # name like "`text to display <explicit target name_>`_"..
-                    # So, `old_name` is still exist in `names`.
-
-                    _id = self.document.nameids.get(old_name, None)
-                    explicit = self.document.nametypes.get(old_name, None)
-
-                    # * if explicit: _id is label. title node need another id.
-                    # * if not explicit:
-                    #
-                    #   * if _id is None:
-                    #
-                    #     _id is None means:
-                    #
-                    #     1. _id was not provided yet.
-                    #
-                    #     2. _id was duplicated.
-                    #
-                    #        old_name entry still exists in nameids and
-                    #        nametypes for another duplicated entry.
-                    #
-                    #   * if _id is provided: below process
-                    if _id:
-                        if not explicit:
-                            # _id was not duplicated.
-                            # remove old_name entry from document ids database
-                            # to reuse original _id.
-                            self.document.nameids.pop(old_name, None)
-                            self.document.nametypes.pop(old_name, None)
-                            self.document.ids.pop(_id, None)
-
-                        # re-entry with new named section node.
-                        #
-                        # Note: msgnode that is a second parameter of the
-                        # `note_implicit_target` is not necessary here because
-                        # section_node has been noted previously on rst parsing by
-                        # `docutils.parsers.rst.states.RSTState.new_subsection()`
-                        # and already has `system_message` if needed.
-                        self.document.note_implicit_target(section_node)
-
-                    # replace target's refname to new target name
-                    matcher = NodeMatcher(nodes.target, refname=old_name)
-                    for old_target in self.document.findall(matcher):  # type: nodes.target
-                        old_target'refname' = new_name
-
-                    processed = True
+            updater = _NodeUpdater(node, patch, self.document, noqa=False)
+            processed = updater.update_title_mapping()
 
             # glossary terms update refid
             if isinstance(node, nodes.term):
                 for _id in node'ids':
                     parts = split_term_classifiers(msgstr)
-                    patch = publish_msgstr(self.app, parts0, source,
-                                           node.line, self.config, settings)
-                    patch = make_glossary_term(self.env, patch, parts1,
-                                               source, node.line, _id,
-                                               self.document)
+                    patch = publish_msgstr(
+                        self.app, parts0, source, node.line, self.config, settings,
+                    )
+                    updater.patch = make_glossary_term(
+                        self.env, patch, parts1, source, node.line, _id, self.document,
+                    )
                     processed = True
 
             # update leaves with processed nodes
             if processed:
-                for child in patch.children:
-                    child.parent = node
-                node.children = patch.children
+                updater.update_leaves()
                 node'translated' = True  # to avoid double translation
 
         # phase2: translation
@@ -228,22 +411,23 @@
                 continue  # skip if the node is already translated by phase1
 
             msgstr = catalog.gettext(msg)
+            noqa = False
+
+            # See above.
+            if not isinstance(node, LITERAL_TYPE_NODES):
+                msgstr, noqa = parse_noqa(msgstr)
+
             # XXX add marker to untranslated parts
             if not msgstr or msgstr == msg:  # as-of-yet untranslated
                 continue
 
             # update translatable nodes
             if isinstance(node, addnodes.translatable):
-                node.apply_translated_message(msg, msgstr)  # type: ignore
+                node.apply_translated_message(msg, msgstr)  # type: ignoreattr-defined
                 continue
 
             # update meta nodes
-            if isinstance(node, nodes.pending) and is_pending_meta(node):
-                # docutils-0.17 or older
-                node.details'nodes'0'content' = msgstr
-                continue
-            elif isinstance(node, addnodes.docutils_meta):
-                # docutils-0.18+
+            if isinstance(node, nodes.meta):  # type: ignoreattr-defined
                 node'content' = msgstr
                 continue
 
@@ -273,16 +457,15 @@
 
             patch = publish_msgstr(self.app, msgstr, source,
                                    node.line, self.config, settings)
-
             # Structural Subelements phase2
             if isinstance(node, nodes.title):
                 # get <title> node that placed as a first child
                 patch = patch.next_node()
 
             # ignore unexpected markups in translation message
-            unexpected: TupleTypeElement, ... = (
+            unexpected: tupletypenodes.Element, ... = (
                 nodes.paragraph,    # expected form of translation
-                nodes.title         # generated by above "Subelements phase2"
+                nodes.title,        # generated by above "Subelements phase2"
             )
 
             # following types are expected if
@@ -293,160 +476,13 @@
             if not isinstance(patch, unexpected):
                 continue  # skip
 
-            # auto-numbered foot note reference should use original 'ids'.
-            def list_replace_or_append(lst: ListN, old: N, new: N) -> None:
-                if old in lst:
-                    lstlst.index(old) = new
-                else:
-                    lst.append(new)
-
-            is_autofootnote_ref = NodeMatcher(nodes.footnote_reference, auto=Any)
-            old_foot_refs: Listnodes.footnote_reference = list(node.findall(is_autofootnote_ref))  # NOQA
-            new_foot_refs: Listnodes.footnote_reference = list(patch.findall(is_autofootnote_ref))  # NOQA
-            if len(old_foot_refs) != len(new_foot_refs):
-                old_foot_ref_rawsources = ref.rawsource for ref in old_foot_refs
-                new_foot_ref_rawsources = ref.rawsource for ref in new_foot_refs
-                logger.warning(__('inconsistent footnote references in translated message.' +
-                                  ' original: {0}, translated: {1}')
-                               .format(old_foot_ref_rawsources, new_foot_ref_rawsources),
-                               location=node)
-            old_foot_namerefs: Dictstr, Listnodes.footnote_reference = {}
-            for r in old_foot_refs:
-                old_foot_namerefs.setdefault(r.get('refname'), ).append(r)
-            for newf in new_foot_refs:
-                refname = newf.get('refname')
-                refs = old_foot_namerefs.get(refname, )
-                if not refs:
-                    newf.parent.remove(newf)
-                    continue
-
-                oldf = refs.pop(0)
-                newf'ids' = oldf'ids'
-                for id in newf'ids':
-                    self.document.idsid = newf
-
-                if newf'auto' == 1:
-                    # autofootnote_refs
-                    list_replace_or_append(self.document.autofootnote_refs, oldf, newf)
-                else:
-                    # symbol_footnote_refs
-                    list_replace_or_append(self.document.symbol_footnote_refs, oldf, newf)
-
-                if refname:
-                    footnote_refs = self.document.footnote_refs.setdefault(refname, )
-                    list_replace_or_append(footnote_refs, oldf, newf)
-
-                    refnames = self.document.refnames.setdefault(refname, )
-                    list_replace_or_append(refnames, oldf, newf)
-
-            # reference should use new (translated) 'refname'.
-            # * reference target ".. _Python: ..." is not translatable.
-            # * use translated refname for section refname.
-            # * inline reference "`Python <...>`_" has no 'refname'.
-            is_refnamed_ref = NodeMatcher(nodes.reference, refname=Any)
-            old_refs: Listnodes.reference = list(node.findall(is_refnamed_ref))
-            new_refs: Listnodes.reference = list(patch.findall(is_refnamed_ref))
-            if len(old_refs) != len(new_refs):
-                old_ref_rawsources = ref.rawsource for ref in old_refs
-                new_ref_rawsources = ref.rawsource for ref in new_refs
-                logger.warning(__('inconsistent references in translated message.' +
-                                  ' original: {0}, translated: {1}')
-                               .format(old_ref_rawsources, new_ref_rawsources),
-                               location=node)
-            old_ref_names = r'refname' for r in old_refs
-            new_ref_names = r'refname' for r in new_refs
-            orphans = list(set(old_ref_names) - set(new_ref_names))
-            for newr in new_refs:
-                if not self.document.has_name(newr'refname'):
-                    # Maybe refname is translated but target is not translated.
-                    # Note: multiple translated refnames break link ordering.
-                    if orphans:
-                        newr'refname' = orphans.pop(0)
-                    else:
-                        # orphan refnames is already empty!
-                        # reference number is same in new_refs and old_refs.
-                        pass
-
-                self.document.note_refname(newr)
-
-            # refnamed footnote should use original 'ids'.
-            is_refnamed_footnote_ref = NodeMatcher(nodes.footnote_reference, refname=Any)
-            old_foot_refs = list(node.findall(is_refnamed_footnote_ref))
-            new_foot_refs = list(patch.findall(is_refnamed_footnote_ref))
-            refname_ids_map: Dictstr, Liststr = {}
-            if len(old_foot_refs) != len(new_foot_refs):
-                old_foot_ref_rawsources = ref.rawsource for ref in old_foot_refs
-                new_foot_ref_rawsources = ref.rawsource for ref in new_foot_refs
-                logger.warning(__('inconsistent footnote references in translated message.' +
-                                  ' original: {0}, translated: {1}')
-                               .format(old_foot_ref_rawsources, new_foot_ref_rawsources),
-                               location=node)
-            for oldf in old_foot_refs:
-                refname_ids_map.setdefault(oldf"refname", ).append(oldf"ids")
-            for newf in new_foot_refs:
-                refname = newf"refname"
-                if refname_ids_map.get(refname):
-                    newf"ids" = refname_ids_maprefname.pop(0)
-
-            # citation should use original 'ids'.
-            is_citation_ref = NodeMatcher(nodes.citation_reference, refname=Any)
-            old_cite_refs: Listnodes.citation_reference = list(node.findall(is_citation_ref))
-            new_cite_refs: Listnodes.citation_reference = list(patch.findall(is_citation_ref))  # NOQA
-            refname_ids_map = {}
-            if len(old_cite_refs) != len(new_cite_refs):
-                old_cite_ref_rawsources = ref.rawsource for ref in old_cite_refs
-                new_cite_ref_rawsources = ref.rawsource for ref in new_cite_refs
-                logger.warning(__('inconsistent citation references in translated message.' +
-                                  ' original: {0}, translated: {1}')
-                               .format(old_cite_ref_rawsources, new_cite_ref_rawsources),
-                               location=node)
-            for oldc in old_cite_refs:
-                refname_ids_map.setdefault(oldc"refname", ).append(oldc"ids")
-            for newc in new_cite_refs:
-                refname = newc"refname"
-                if refname_ids_map.get(refname):
-                    newc"ids" = refname_ids_maprefname.pop()
-
-            # Original pending_xref'reftarget' contain not-translated
-            # target name, new pending_xref must use original one.
-            # This code restricts to change ref-targets in the translation.
-            old_xrefs = list(node.findall(addnodes.pending_xref))
-            new_xrefs = list(patch.findall(addnodes.pending_xref))
-            xref_reftarget_map = {}
-            if len(old_xrefs) != len(new_xrefs):
-                old_xref_rawsources = xref.rawsource for xref in old_xrefs
-                new_xref_rawsources = xref.rawsource for xref in new_xrefs
-                logger.warning(__('inconsistent term references in translated message.' +
-                                  ' original: {0}, translated: {1}')
-                               .format(old_xref_rawsources, new_xref_rawsources),
-                               location=node)
-
-            def get_ref_key(node: addnodes.pending_xref) -> OptionalTuplestr, str, str:
-                case = node"refdomain", node"reftype"
-                if case == ('std', 'term'):
-                    return None
-                else:
-                    return (
-                        node"refdomain",
-                        node"reftype",
-                        node'reftarget',)
-
-            for old in old_xrefs:
-                key = get_ref_key(old)
-                if key:
-                    xref_reftarget_mapkey = old.attributes
-            for new in new_xrefs:
-                key = get_ref_key(new)
-                # Copy attributes to keep original node behavior. Especially
-                # copying 'reftarget', 'py:module', 'py:class' are needed.
-                for k, v in xref_reftarget_map.get(key, {}).items():
-                    if k not in EXCLUDED_PENDING_XREF_ATTRIBUTES:
-                        newk = v
-
-            # update leaves
-            for child in patch.children:
-                child.parent = node
-            node.children = patch.children
+            updater = _NodeUpdater(node, patch, self.document, noqa)
+            updater.update_autofootnote_references()
+            updater.update_refnamed_references()
+            updater.update_refnamed_footnote_references()
+            updater.update_citation_references()
+            updater.update_pending_xrefs()
+            updater.update_leaves()
 
             # for highlighting that expects .rawsource and .astext() are same.
             if isinstance(node, LITERAL_TYPE_NODES):
@@ -461,7 +497,7 @@
         if 'index' in self.config.gettext_additional_targets:
             # Extract and translate messages for index entries.
             for node, entries in traverse_translatable_index(self.document):
-                new_entries: ListTuplestr, str, str, str, str = 
+                new_entries: listtuplestr, str, str, str, str = 
                 for type, msg, tid, main, _key in entries:
                     msg_parts = split_index_msg(type, msg)
                     msgstr_parts = 
@@ -477,7 +513,8 @@
                 node'entries' = new_entries
 
         # remove translated attribute that is used for avoiding double translation.
-        for translated in self.document.findall(NodeMatcher(translated=Any)):  # type: Element  # NOQA
+        matcher = NodeMatcher(translated=Any)
+        for translated in self.document.findall(matcher):  # type: nodes.Element
             translated.delattr('translated')
 
 
@@ -498,7 +535,7 @@
             inline.parent += inline.children
 
 
-def setup(app: "Sphinx") -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_transform(PreserveTranslatableMessages)
     app.add_transform(Locale)
     app.add_transform(RemoveTranslatableInline)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/post_transforms/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/post_transforms/__init__.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.transforms.post_transforms
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Docutils transforms used by Sphinx."""
 
-    Docutils transforms used by Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import Any, Dict, List, Optional, Sequence, Tuple, Type, cast
+from typing import Any, Sequence, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -35,8 +29,8 @@
     They resolve references, convert images, do special transformation for each output
     formats and so on.  This class helps to implement these post transforms.
     """
-    builders: Tuplestr, ... = ()
-    formats: Tuplestr, ... = ()
+    builders: tuplestr, ... = ()
+    formats: tuplestr, ... = ()
 
     def apply(self, **kwargs: Any) -> None:
         if self.is_supported():
@@ -107,7 +101,7 @@
                 newnode = None
 
             if newnode:
-                newnodes: ListNode = newnode
+                newnodes: listNode = newnode
             else:
                 newnodes = contnode
                 if newnode is None and isinstance(node0, addnodes.pending_xref_condition):
@@ -120,11 +114,13 @@
 
             node.replace_self(newnodes)
 
-    def resolve_anyref(self, refdoc: str, node: pending_xref, contnode: Element) -> Element:
+    def resolve_anyref(
+        self, refdoc: str, node: pending_xref, contnode: Element,
+    ) -> Element | None:
         """Resolve reference generated by the "any" role."""
         stddomain = self.env.get_domain('std')
         target = node'reftarget'
-        results: ListTuplestr, Element = 
+        results: listtuplestr, Element = 
         # first, try resolving as :doc:
         doc_ref = stddomain.resolve_xref(self.env, refdoc, self.app.builder,
                                          'doc', target, node, contnode)
@@ -146,16 +142,16 @@
                     res = domain.resolve_xref(self.env, refdoc, self.app.builder,
                                               role, target, node, contnode)
                     if res and len(res) > 0 and isinstance(res0, nodes.Element):
-                        results.append(('%s:%s' % (domain.name, role), res))
+                        results.append((f'{domain.name}:{role}', res))
         # now, see how many matches we got...
         if not results:
             return None
         if len(results) > 1:
             def stringify(name: str, node: Element) -> str:
                 reftitle = node.get('reftitle', node.astext())
-                return ':%s:`%s`' % (name, reftitle)
+                return f':{name}:`{reftitle}`'
             candidates = ' or '.join(stringify(name, role) for name, role in results)
-            logger.warning(__('more than one target found for \'any\' cross-'
+            logger.warning(__("more than one target found for 'any' cross-"
                               'reference %r: could be %s'), target, candidates,
                            location=node)
         res_role, newnode = results0
@@ -170,11 +166,11 @@
         return newnode
 
     def warn_missing_reference(self, refdoc: str, typ: str, target: str,
-                               node: pending_xref, domain: OptionalDomain) -> None:
+                               node: pending_xref, domain: Domain | None) -> None:
         warn = node.get('refwarn')
         if self.config.nitpicky:
             warn = True
-            dtype = '%s:%s' % (domain.name, typ) if domain else typ
+            dtype = f'{domain.name}:{typ}' if domain else typ
             if self.config.nitpick_ignore:
                 if (dtype, target) in self.config.nitpick_ignore:
                     warn = False
@@ -184,11 +180,14 @@
                     warn = False
             if self.config.nitpick_ignore_regex:
                 def matches_ignore(entry_type: str, entry_target: str) -> bool:
-                    for ignore_type, ignore_target in self.config.nitpick_ignore_regex:
-                        if re.fullmatch(ignore_type, entry_type) and \
-                           re.fullmatch(ignore_target, entry_target):
-                            return True
-                    return False
+                    return any(
+                        (
+                            re.fullmatch(ignore_type, entry_type)
+                            and re.fullmatch(ignore_target, entry_target)
+                        )
+                        for ignore_type, ignore_target
+                        in self.config.nitpick_ignore_regex
+                    )
                 if matches_ignore(dtype, target):
                     warn = False
                 # for "std" types also try without domain name
@@ -209,14 +208,13 @@
             msg = __('%r reference target not found: %s') % (typ, target)
         logger.warning(msg, location=node, type='ref', subtype=typ)
 
-    def find_pending_xref_condition(self, node: pending_xref, conditions: Sequencestr
-                                    ) -> OptionalListNode:
+    def find_pending_xref_condition(self, node: pending_xref, conditions: Sequencestr,
+                                    ) -> listNode | None:
         for condition in conditions:
             matched = find_pending_xref_condition(node, condition)
             if matched:
                 return matched.children
-        else:
-            return None
+        return None
 
 
 class OnlyNodeTransform(SphinxPostTransform):
@@ -235,11 +233,15 @@
     default_priority = 200
 
     def run(self, **kwargs: Any) -> None:
-        def has_visitor(translator: Typenodes.NodeVisitor, node: TypeElement) -> bool:
+        def has_visitor(translator: typenodes.NodeVisitor, node: typeElement) -> bool:
             return hasattr(translator, "visit_%s" % node.__name__)
 
         translator = self.app.builder.get_translator_class()
-        if isinstance(translator, SphinxTranslator):
+        if translator is None:
+            # do nothing if no translator class is specified (e.g., on a dummy builder)
+            return
+
+        if issubclass(translator, SphinxTranslator):
             # subclass of SphinxTranslator supports desc_sig_element nodes automatically.
             return
 
@@ -268,7 +270,7 @@
                 node'classes'.append(node.parent'domain')
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_post_transform(ReferencesResolver)
     app.add_post_transform(OnlyNodeTransform)
     app.add_post_transform(SigElementFallbackTransform)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/post_transforms/code.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/post_transforms/code.py Changed

@@ -1,15 +1,9 @@
-"""
-    sphinx.transforms.post_transforms.code
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""transforms for code-blocks."""
 
-    transforms for code-blocks.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import sys
-from typing import Any, Dict, List, NamedTuple
+from typing import Any, NamedTuple
 
 from docutils import nodes
 from docutils.nodes import Node, TextElement
@@ -32,7 +26,7 @@
     Apply highlight_language to all literal_block nodes.
 
     This refers both :confval:`highlight_language` setting and
-    :rst:dir:`highlightlang` directive.  After processing, this transform
+    :rst:dir:`highlight` directive.  After processing, this transform
     removes ``highlightlang`` node from doctree.
     """
     default_priority = 400
@@ -49,7 +43,7 @@
 class HighlightLanguageVisitor(nodes.NodeVisitor):
     def __init__(self, document: nodes.document, default_language: str) -> None:
         self.default_setting = HighlightSetting(default_language, False, sys.maxsize)
-        self.settings: ListHighlightSetting = 
+        self.settings: listHighlightSetting = 
         super().__init__(document)
 
     def unknown_visit(self, node: Node) -> None:
@@ -117,9 +111,9 @@
             return False  # skip parsed-literal node
 
         language = node.get('language')
-        if language in ('pycon', 'pycon3'):
+        if language in {'pycon', 'pycon3'}:
             return True
-        elif language in ('py', 'py3', 'python', 'python3', 'default'):
+        elif language in {'py', 'python', 'py3', 'python3', 'default'}:
             return node.rawsource.startswith('>>>')
         elif language == 'guess':
             try:
@@ -131,7 +125,7 @@
         return False
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_post_transform(HighlightLanguageTransform)
     app.add_post_transform(TrimDoctestFlagsTransform)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/post_transforms/images.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/post_transforms/images.py Changed

@@ -1,24 +1,19 @@
-"""
-    sphinx.transforms.post_transforms.images
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""Docutils transforms used by Sphinx."""
 
-    Docutils transforms used by Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import re
 from math import ceil
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 from docutils import nodes
 
 from sphinx.application import Sphinx
 from sphinx.locale import __
 from sphinx.transforms import SphinxTransform
-from sphinx.util import epoch_to_rfc1123, logging, requests, rfc1123_to_epoch, sha1
+from sphinx.util import logging, requests, sha1
+from sphinx.util.http_date import epoch_to_rfc1123, rfc1123_to_epoch
 from sphinx.util.images import get_image_extension, guess_mimetype, parse_data_uri
 from sphinx.util.osutil import ensuredir
 
@@ -51,10 +46,9 @@
     def match(self, node: nodes.image) -> bool:
         if self.app.builder.supported_image_types == :
             return False
-        elif self.app.builder.supported_remote_images:
+        if self.app.builder.supported_remote_images:
             return False
-        else:
-            return '://' in node'uri'
+        return '://' in node'uri'
 
     def handle(self, node: nodes.image) -> None:
         try:
@@ -117,10 +111,9 @@
     def match(self, node: nodes.image) -> bool:
         if self.app.builder.supported_remote_images == :
             return False
-        elif self.app.builder.supported_data_uri_images is True:
+        if self.app.builder.supported_data_uri_images is True:
             return False
-        else:
-            return node'uri'.startswith('data:')
+        return node'uri'.startswith('data:')
 
     def handle(self, node: nodes.image) -> None:
         image = parse_data_uri(node'uri')
@@ -178,7 +171,7 @@
     #:
     #: .. todo:: This should be refactored not to store the state without class
     #:           variable.
-    available: Optionalbool = None
+    available: bool | None = None
 
     #: A conversion rules the image converter supports.
     #: It is represented as a list of pair of source image format (mimetype) and
@@ -189,7 +182,7 @@
     #:         ('image/gif', 'image/png'),
     #:         ('application/pdf', 'image/png'),
     #:     
-    conversion_rules: ListTuplestr, str = 
+    conversion_rules: listtuplestr, str = 
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
@@ -197,13 +190,12 @@
     def match(self, node: nodes.image) -> bool:
         if not self.app.builder.supported_image_types:
             return False
-        elif set(self.guess_mimetypes(node)) & set(self.app.builder.supported_image_types):
-            # builder supports the image; no need to convert
+        if '?' in node'candidates':
             return False
-        elif node'uri'.startswith('data:'):
-            # all data URI MIME types are assumed to be supported
+        if set(self.guess_mimetypes(node)) & set(self.app.builder.supported_image_types):
+            # builder supports the image; no need to convert
             return False
-        elif self.available is None:
+        if self.available is None:
             # store the value to the class variable to share it during the build
             self.__class__.available = self.is_available()
 
@@ -211,12 +203,9 @@
             return False
         else:
             rule = self.get_conversion_rule(node)
-            if rule:
-                return True
-            else:
-                return False
+            return bool(rule)
 
-    def get_conversion_rule(self, node: nodes.image) -> Tuplestr, str:
+    def get_conversion_rule(self, node: nodes.image) -> tuplestr, str:
         for candidate in self.guess_mimetypes(node):
             for supported in self.app.builder.supported_image_types:
                 rule = (candidate, supported)
@@ -229,7 +218,7 @@
         """Return the image converter is available or not."""
         raise NotImplementedError()
 
-    def guess_mimetypes(self, node: nodes.image) -> Liststr:
+    def guess_mimetypes(self, node: nodes.image) -> liststr:
         if '?' in node'candidates':
             return 
         elif '*' in node'candidates':
@@ -245,7 +234,8 @@
         else:
             srcpath = node'candidates''*'
 
-        filename = get_filename_for(srcpath, _to)
+        filename = self.env.imagessrcpath1
+        filename = get_filename_for(filename, _to)
         ensuredir(self.imagedir)
         destpath = os.path.join(self.imagedir, filename)
 
@@ -269,7 +259,7 @@
         raise NotImplementedError()
 
 
-def setup(app: Sphinx) -> Dictstr, Any:
+def setup(app: Sphinx) -> dictstr, Any:
     app.add_post_transform(ImageDownloader)
     app.add_post_transform(DataURIExtractor)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/transforms/references.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/transforms/references.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/__init__.py Changed

@@ -1,54 +1,51 @@
-"""
-    sphinx.util
-    ~~~~~~~~~~~
+"""Utility functions for Sphinx."""
 
-    Utility functions for Sphinx.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import functools
 import hashlib
 import os
 import posixpath
 import re
 import sys
-import tempfile
-import traceback
-import unicodedata
-import warnings
-from datetime import datetime
 from importlib import import_module
 from os import path
-from time import mktime, strptime
-from typing import (IO, TYPE_CHECKING, Any, Callable, Dict, Iterable, Iterator, List, Optional,
-                    Pattern, Set, Tuple, Type)
+from typing import IO, Any
 from urllib.parse import parse_qsl, quote_plus, urlencode, urlsplit, urlunsplit
 
-from sphinx.deprecation import RemovedInSphinx50Warning
-from sphinx.errors import ExtensionError, FiletypeNotFoundError, SphinxParallelError
+from sphinx.errors import ExtensionError, FiletypeNotFoundError
 from sphinx.locale import __
+from sphinx.util import display as _display
+from sphinx.util import exceptions as _exceptions
+from sphinx.util import http_date as _http_date
 from sphinx.util import logging
-from sphinx.util.console import bold, colorize, strip_colors, term_width_line  # type: ignore
-from sphinx.util.matching import patfilter  # noqa
-from sphinx.util.nodes import (caption_ref_re, explicit_title_re,  # noqa
-                               nested_parse_with_titles, split_explicit_title)
+from sphinx.util import osutil as _osutil
+from sphinx.util.console import strip_colors  # NoQA: F401
+from sphinx.util.matching import patfilter  # noqa: F401
+from sphinx.util.nodes import (  # noqa: F401
+    caption_ref_re,
+    explicit_title_re,
+    nested_parse_with_titles,
+    split_explicit_title,
+)
+
 # import other utilities; partly for backwards compatibility, so don't
 # prune unused ones indiscriminately
-from sphinx.util.osutil import (SEP, copyfile, copytimes, ensuredir, make_filename,  # noqa
-                                movefile, mtimes_of_files, os_path, relative_uri)
-from sphinx.util.typing import PathMatcher
-
-if TYPE_CHECKING:
-    from sphinx.application import Sphinx
-
+from sphinx.util.osutil import (  # noqa: F401
+    SEP,
+    copyfile,
+    copytimes,
+    ensuredir,
+    make_filename,
+    mtimes_of_files,
+    os_path,
+    relative_uri,
+)
 
 logger = logging.getLogger(__name__)
 
 # Generally useful regular expressions.
-ws_re: Pattern = re.compile(r'\s+')
-url_re: Pattern = re.compile(r'(?P<schema>.+)://.*')
+ws_re: re.Pattern = re.compile(r'\s+')
+url_re: re.Pattern = re.compile(r'(?P<schema>.+)://.*')
 
 
 # High-level utility functions.
@@ -58,47 +55,12 @@
         posixpath.join('/' + basedocname, '..', docname))1:
 
 
-def path_stabilize(filepath: str) -> str:
-    "Normalize path separator and unicode string"
-    newpath = filepath.replace(os.path.sep, SEP)
-    return unicodedata.normalize('NFC', newpath)
-
-
-def get_matching_files(dirname: str,
-                       exclude_matchers: TuplePathMatcher, ... = ()) -> Iterablestr:  # NOQA
-    """Get all file names in a directory, recursively.
-
-    Exclude files and dirs matching some matcher in *exclude_matchers*.
-    """
-    # dirname is a normalized absolute path.
-    dirname = path.normpath(path.abspath(dirname))
-
-    for root, dirs, files in os.walk(dirname, followlinks=True):
-        relativeroot = path.relpath(root, dirname)
-        if relativeroot == ".":
-            relativeroot = ""  # suppress dirname for files on the target dir
-
-        qdirs = enumerate(path_stabilize(path.join(relativeroot, dn))
-                          for dn in dirs)  # type: IterableTupleint, str
-        qfiles = enumerate(path_stabilize(path.join(relativeroot, fn))
-                           for fn in files)  # type: IterableTupleint, str
-        for matcher in exclude_matchers:
-            qdirs = entry for entry in qdirs if not matcher(entry1)
-            qfiles = entry for entry in qfiles if not matcher(entry1)
-
-        dirs: = sorted(dirsi for (i, _) in qdirs)
-
-        for _i, filename in sorted(qfiles):
-            yield filename
-
-
-def get_filetype(source_suffix: Dictstr, str, filename: str) -> str:
+def get_filetype(source_suffix: dictstr, str, filename: str) -> str:
     for suffix, filetype in source_suffix.items():
         if filename.endswith(suffix):
             # If default filetype (None), considered as restructuredtext.
             return filetype or 'restructuredtext'
-    else:
-        raise FiletypeNotFoundError
+    raise FiletypeNotFoundError
 
 
 class FilenameUniqDict(dict):
@@ -108,7 +70,7 @@
     appear in.  Used for images and downloadable files in the environment.
     """
     def __init__(self) -> None:
-        self._existing: Setstr = set()
+        self._existing: setstr = set()
 
     def add_file(self, docname: str, newfile: str) -> str:
         if newfile in self:
@@ -119,7 +81,7 @@
         i = 0
         while uniquename in self._existing:
             i += 1
-            uniquename = '%s%s%s' % (base, i, ext)
+            uniquename = f'{base}{i}{ext}'
         selfnewfile = ({docname}, uniquename)
         self._existing.add(uniquename)
         return uniquename
@@ -131,46 +93,38 @@
                 del selffilename
                 self._existing.discard(unique)
 
-    def merge_other(self, docnames: Setstr, other: Dictstr, TupleSetstr, Any) -> None:
+    def merge_other(self, docnames: setstr, other: dictstr, tuplesetstr, Any) -> None:
         for filename, (docs, _unique) in other.items():
             for doc in docs & set(docnames):
                 self.add_file(doc, filename)
 
-    def __getstate__(self) -> Setstr:
+    def __getstate__(self) -> setstr:
         return self._existing
 
-    def __setstate__(self, state: Setstr) -> None:
+    def __setstate__(self, state: setstr) -> None:
         self._existing = state
 
 
 def md5(data=b'', **kwargs):
     """Wrapper around hashlib.md5
 
-    Attempt call with 'usedforsecurity=False' if we get a ValueError, which happens when
-    OpenSSL FIPS mode is enabled:
-    ValueError: error:060800A3:digital envelope routines:EVP_DigestInit_ex:disabled for fips
-
-    See: https://github.com/sphinx-doc/sphinx/issues/7611
+    Attempt call with 'usedforsecurity=False' if supported.
     """
 
-    try:
-        return hashlib.md5(data, **kwargs)
-    except ValueError:
-        return hashlib.md5(data, **kwargs, usedforsecurity=False)  # type: ignore
+    if sys.version_info:2 > (3, 8):
+        return hashlib.md5(data, usedforsecurity=False)
+    return hashlib.md5(data, **kwargs)
 
 
 def sha1(data=b'', **kwargs):
     """Wrapper around hashlib.sha1
 
-    Attempt call with 'usedforsecurity=False' if we get a ValueError
-
-    See: https://github.com/sphinx-doc/sphinx/issues/7611
+    Attempt call with 'usedforsecurity=False' if supported.
     """
 
-    try:
-        return hashlib.sha1(data, **kwargs)
-    except ValueError:
-        return hashlib.sha1(data, **kwargs, usedforsecurity=False)  # type: ignore
+    if sys.version_info:2 > (3, 8):
+        return hashlib.sha1(data, usedforsecurity=False)
+    return hashlib.sha1(data, **kwargs)
 
 
 class DownloadFiles(dict):
@@ -183,7 +137,7 @@
     def add_file(self, docname: str, filename: str) -> str:
         if filename not in self:
             digest = md5(filename.encode()).hexdigest()
-            dest = '%s/%s' % (digest, os.path.basename(filename))
+            dest = f'{digest}/{os.path.basename(filename)}'
             selffilename = (set(), dest)
 
         selffilename0.add(docname)
@@ -195,61 +149,13 @@
             if not docs:
                 del selffilename
 
-    def merge_other(self, docnames: Setstr, other: Dictstr, TupleSetstr, Any) -> None:
+    def merge_other(self, docnames: setstr, other: dictstr, tuplesetstr, Any) -> None:
         for filename, (docs, _dest) in other.items():
             for docname in docs & set(docnames):
                 self.add_file(docname, filename)
 
 
-_DEBUG_HEADER = '''\
-# Sphinx version: %s
-# Python version: %s (%s)
-# Docutils version: %s %s
-# Jinja2 version: %s
-# Last messages:
-%s
-# Loaded extensions:
-'''
-
-
-def save_traceback(app: "Sphinx") -> str:
-    """Save the current exception's traceback in a temporary file."""
-    import platform
-
-    import docutils
-    import jinja2
-
-    import sphinx
-    exc = sys.exc_info()1
-    if isinstance(exc, SphinxParallelError):
-        exc_format = '(Error in parallel process)\n' + exc.traceback
-    else:
-        exc_format = traceback.format_exc()
-    fd, path = tempfile.mkstemp('.log', 'sphinx-err-')
-    last_msgs = ''
-    if app is not None:
-        last_msgs = '\n'.join(
-            '#   %s' % strip_colors(s).strip()
-            for s in app.messagelog)
-    os.write(fd, (_DEBUG_HEADER %
-                  (sphinx.__display_version__,
-                   platform.python_version(),
-                   platform.python_implementation(),
-                   docutils.__version__, docutils.__version_details__,
-                   jinja2.__version__,
-                   last_msgs)).encode())
-    if app is not None:
-        for ext in app.extensions.values():
-            modfile = getattr(ext.module, '__file__', 'unknown')
-            if ext.version != 'builtin':
-                os.write(fd, ('#   %s (%s) from %s\n' %
-                              (ext.name, ext.version, modfile)).encode())
-    os.write(fd, exc_format.encode())
-    os.close(fd)
-    return path
-
-
-def get_full_modname(modname: str, attribute: str) -> str:
+def get_full_modname(modname: str, attribute: str) -> str | None:
     if modname is None:
         # Prevents a TypeError: if the last getattr() call will return None
         # then it's better to return it directly
@@ -276,7 +182,7 @@
     def __init__(self, docname: str) -> None:
         self.docname = docname
 
-    def __call__(self, error: UnicodeDecodeError) -> Tuplestr, int:
+    def __call__(self, error: UnicodeDecodeError) -> tuplestr, int:
         linestart = error.object.rfind(b'\n', 0, error.start)
         lineend = error.object.find(b'\n', error.start)
         if lineend == -1:
@@ -311,18 +217,18 @@
             self.stream2.flush()
 
 
-def parselinenos(spec: str, total: int) -> Listint:
+def parselinenos(spec: str, total: int) -> listint:
     """Parse a line number spec (such as "1,2,4-6") and return a list of
     wanted line numbers.
     """
-    items = list()
+    items = 
     parts = spec.split(',')
     for part in parts:
         try:
             begend = part.strip().split('-')
             if '', '' == begend:
                 raise ValueError
-            elif len(begend) == 1:
+            if len(begend) == 1:
                 items.append(int(begend0) - 1)
             elif len(begend) == 2:
                 start = int(begend0 or 1)  # left half open (cf. -10)
@@ -338,41 +244,15 @@
     return items
 
 
-def force_decode(string: str, encoding: str) -> str:
-    """Forcibly get a unicode string out of a bytestring."""
-    warnings.warn('force_decode() is deprecated.',
-                  RemovedInSphinx50Warning, stacklevel=2)
-    if isinstance(string, bytes):
-        try:
-            if encoding:
-                string = string.decode(encoding)
-            else:
-                # try decoding with utf-8, should only work for real UTF-8
-                string = string.decode()
-        except UnicodeError:
-            # last resort -- can't fail
-            string = string.decode('latin1')
-    return string
-
-
-def rpartition(s: str, t: str) -> Tuplestr, str:
-    """Similar to str.rpartition from 2.5, but doesn't return the separator."""
-    warnings.warn('rpartition() is now deprecated.', RemovedInSphinx50Warning, stacklevel=2)
-    i = s.rfind(t)
-    if i != -1:
-        return s:i, si + len(t):
-    return '', s
-
-
-def split_into(n: int, type: str, value: str) -> Liststr:
+def split_into(n: int, type: str, value: str) -> liststr:
     """Split an index entry into a given number of parts at semicolons."""
     parts = x.strip() for x in value.split(';', n - 1)
     if sum(1 for part in parts if part) < n:
-        raise ValueError('invalid %s index entry %r' % (type, value))
+        raise ValueError(f'invalid {type} index entry {value!r}')
     return parts
 
 
-def split_index_msg(type: str, value: str) -> Liststr:
+def split_index_msg(type: str, value: str) -> liststr:
     # new entry types must be listed in directives/other.py!
     if type == 'single':
         try:
@@ -383,28 +263,15 @@
         result = split_into(2, 'pair', value)
     elif type == 'triple':
         result = split_into(3, 'triple', value)
-    elif type == 'see':
-        result = split_into(2, 'see', value)
-    elif type == 'seealso':
+    elif type in {'see', 'seealso'}:
         result = split_into(2, 'see', value)
     else:
-        raise ValueError('invalid %s index entry %r' % (type, value))
+        raise ValueError(f'invalid {type} index entry {value!r}')
 
     return result
 
 
-def format_exception_cut_frames(x: int = 1) -> str:
-    """Format an exception with traceback, but only the last x frames."""
-    typ, val, tb = sys.exc_info()
-    # res = 'Traceback (most recent call last):\n'
-    res: Liststr = 
-    tbres = traceback.format_tb(tb)
-    res += tbres-x:
-    res += traceback.format_exception_only(typ, val)
-    return ''.join(res)
-
-
-def import_object(objname: str, source: str = None) -> Any:
+def import_object(objname: str, source: str | None = None) -> Any:
     """Import python object by qualname."""
     try:
         objpath = objname.split('.')
@@ -422,15 +289,14 @@
         if source:
             raise ExtensionError('Could not import %s (needed for %s)' %
                                  (objname, source), exc) from exc
-        else:
-            raise ExtensionError('Could not import %s' % objname, exc) from exc
+        raise ExtensionError('Could not import %s' % objname, exc) from exc
 
 
-def split_full_qualified_name(name: str) -> TupleOptionalstr, str:
+def split_full_qualified_name(name: str) -> tuplestr | None, str:
     """Split full qualified name to a pair of modname and qualname.
 
     A qualname is an abbreviation for "Qualified name" introduced at PEP-3155
-    (https://www.python.org/dev/peps/pep-3155/).  It is a dotted path name
+    (https://peps.python.org/pep-3155/).  It is a dotted path name
     from the module top-level.
 
     A "full" qualified name means a string containing both module name and
@@ -460,133 +326,46 @@
     split = list(urlsplit(uri))
     split1 = split1.encode('idna').decode('ascii')
     split2 = quote_plus(split2.encode(), '/')
-    query = list((q, v.encode()) for (q, v) in parse_qsl(split3))
+    query = (q, v.encode()) for (q, v) in parse_qsl(split3)
     split3 = urlencode(query)
     return urlunsplit(split)
 
 
 def isurl(url: str) -> bool:
     """Check *url* is URL or not."""
-    if url and '://' in url:
-        return True
-    else:
-        return False
-
-
-def display_chunk(chunk: Any) -> str:
-    if isinstance(chunk, (list, tuple)):
-        if len(chunk) == 1:
-            return str(chunk0)
-        return '%s .. %s' % (chunk0, chunk-1)
-    return str(chunk)
-
-
-def old_status_iterator(iterable: Iterable, summary: str, color: str = "darkgreen",
-                        stringify_func: CallableAny, str = display_chunk) -> Iterator:
-    l = 0
-    for item in iterable:
-        if l == 0:
-            logger.info(bold(summary), nonl=True)
-            l = 1
-        logger.info(stringify_func(item), color=color, nonl=True)
-        logger.info(" ", nonl=True)
-        yield item
-    if l == 1:
-        logger.info('')
-
-
-# new version with progress info
-def status_iterator(iterable: Iterable, summary: str, color: str = "darkgreen",
-                    length: int = 0, verbosity: int = 0,
-                    stringify_func: CallableAny, str = display_chunk) -> Iterable:
-    if length == 0:
-        yield from old_status_iterator(iterable, summary, color, stringify_func)
-        return
-    l = 0
-    summary = bold(summary)
-    for item in iterable:
-        l += 1
-        s = '%s%3d%% %s' % (summary, 100 * l / length, colorize(color, stringify_func(item)))
-        if verbosity:
-            s += '\n'
-        else:
-            s = term_width_line(s)
-        logger.info(s, nonl=True)
-        yield item
-    if l > 0:
-        logger.info('')
-
-
-class SkipProgressMessage(Exception):
-    pass
-
-
-class progress_message:
-    def __init__(self, message: str) -> None:
-        self.message = message
-
-    def __enter__(self) -> None:
-        logger.info(bold(self.message + '... '), nonl=True)
-
-    def __exit__(self, exc_type: TypeException, exc_value: Exception, traceback: Any) -> bool:  # NOQA
-        if isinstance(exc_value, SkipProgressMessage):
-            logger.info(__('skipped'))
-            if exc_value.args:
-                logger.info(*exc_value.args)
-            return True
-        elif exc_type:
-            logger.info(__('failed'))
-        else:
-            logger.info(__('done'))
-
-        return False
-
-    def __call__(self, f: Callable) -> Callable:
-        @functools.wraps(f)
-        def wrapper(*args: Any, **kwargs: Any) -> Any:
-            with self:
-                return f(*args, **kwargs)
-
-        return wrapper
-
-
-def epoch_to_rfc1123(epoch: float) -> str:
-    """Convert datetime format epoch to RFC1123."""
-    from babel.dates import format_datetime
-
-    dt = datetime.fromtimestamp(epoch)
-    fmt = 'EEE, dd LLL yyyy hh:mm:ss'
-    return format_datetime(dt, fmt, locale='en') + ' GMT'
-
-
-def rfc1123_to_epoch(rfc1123: str) -> float:
-    return mktime(strptime(rfc1123, '%a, %d %b %Y %H:%M:%S %Z'))
-
-
-def xmlname_checker() -> Pattern:
-    # https://www.w3.org/TR/REC-xml/#NT-Name
-    name_start_chars = 
-        ':', 'A', 'Z', '_', 'a', 'z', '\u00C0', '\u00D6',
-        '\u00D8', '\u00F6', '\u00F8', '\u02FF', '\u0370', '\u037D',
-        '\u037F', '\u1FFF', '\u200C', '\u200D', '\u2070', '\u218F',
-        '\u2C00', '\u2FEF', '\u3001', '\uD7FF', '\uF900', '\uFDCF',
-        '\uFDF0', '\uFFFD', '\U00010000', '\U000EFFFF'
-
-    name_chars = 
-        "\\-", "\\.", '0', '9', '\u00B7', '\u0300', '\u036F',
-        '\u203F', '\u2040'
-    
-
-    def convert(entries: Any, splitter: str = '|') -> str:
-        results = 
-        for entry in entries:
-            if isinstance(entry, list):
-                results.append('%s' % convert(entry, '-'))
-            else:
-                results.append(entry)
-        return splitter.join(results)
+    return bool(url) and '://' in url
+
+
+def _xml_name_checker():
+    # to prevent import cycles
+    from sphinx.builders.epub3 import _XML_NAME_PATTERN
+
+    return _XML_NAME_PATTERN
+
+
+# deprecated name -> (object to return, canonical path or empty string)
+_DEPRECATED_OBJECTS = {
+    'path_stabilize': (_osutil.path_stabilize, 'sphinx.util.osutil.path_stabilize'),
+    'display_chunk': (_display.display_chunk, 'sphinx.util.display.display_chunk'),
+    'status_iterator': (_display.status_iterator, 'sphinx.util.display.status_iterator'),
+    'SkipProgressMessage': (_display.SkipProgressMessage,
+                            'sphinx.util.display.SkipProgressMessage'),
+    'progress_message': (_display.progress_message, 'sphinx.http_date.epoch_to_rfc1123'),
+    'epoch_to_rfc1123': (_http_date.epoch_to_rfc1123, 'sphinx.http_date.rfc1123_to_epoch'),
+    'rfc1123_to_epoch': (_http_date.rfc1123_to_epoch, 'sphinx.http_date.rfc1123_to_epoch'),
+    'save_traceback': (_exceptions.save_traceback, 'sphinx.exceptions.save_traceback'),
+    'format_exception_cut_frames': (_exceptions.format_exception_cut_frames,
+                                    'sphinx.exceptions.format_exception_cut_frames'),
+    'xmlname_checker': (_xml_name_checker, 'sphinx.builders.epub3._XML_NAME_PATTERN'),
+}
+
+
+def __getattr__(name):
+    if name not in _DEPRECATED_OBJECTS:
+        raise AttributeError(f'module {__name__!r} has no attribute {name!r}')
+
+    from sphinx.deprecation import _deprecation_warning
 
-    start_chars_regex = convert(name_start_chars)
-    name_chars_regex = convert(name_chars)
-    return re.compile('(%s)(%s|%s)*' % (
-        start_chars_regex, start_chars_regex, name_chars_regex))
+    deprecated_object, canonical_name = _DEPRECATED_OBJECTSname
+    _deprecation_warning(__name__, name, canonical_name, remove=(8, 0))
+    return deprecated_object

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/build_phase.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/build_phase.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/cfamily.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/cfamily.py Changed

@@ -1,20 +1,15 @@
-"""
-    sphinx.util.cfamily
-    ~~~~~~~~~~~~~~~~~~~
+"""Utility functions common to the C and C++ domains."""
 
-    Utility functions common to the C and C++ domains.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 from copy import deepcopy
-from typing import Any, Callable, List, Match, Optional, Pattern, Tuple, Union
+from typing import Any, Callable
 
 from docutils import nodes
 from docutils.nodes import TextElement
 
+from sphinx import addnodes
 from sphinx.config import Config
 from sphinx.util import logging
 
@@ -23,21 +18,21 @@
 StringifyTransform = CallableAny, str
 
 
-_whitespace_re = re.compile(r'(?u)\s+')
+_whitespace_re = re.compile(r'\s+')
 anon_identifier_re = re.compile(r'(@a-zA-Z0-9_)a-zA-Z0-9_*\b')
-identifier_re = re.compile(r'''(?x)
+identifier_re = re.compile(r'''
     (   # This 'extends' _anon_identifier_re with the ordinary identifiers,
         # make sure they are in sync.
         (~?\ba-zA-Z_)  # ordinary identifiers
     |   (@a-zA-Z0-9_)  # our extension for names of anonymous entities
     )
     a-zA-Z0-9_*\b
-''')
+''', flags=re.VERBOSE)
 integer_literal_re = re.compile(r'1-90-9*(\'0-9+)*')
 octal_literal_re = re.compile(r'00-7*(\'0-7+)*')
 hex_literal_re = re.compile(r'0xX0-9a-fA-F+(\'0-9a-fA-F+)*')
 binary_literal_re = re.compile(r'0bB01+(\'01+)*')
-integers_literal_suffix_re = re.compile(r'''(?x)
+integers_literal_suffix_re = re.compile(r'''
     # unsigned and/or (long) long, in any order, but at least one of them
     (
         (uU    (lL  |  (ll)  |  (LL))?)
@@ -46,8 +41,8 @@
     )\b
     # the ending word boundary is important for distinguishing
     # between suffixes and UDLs in C++
-''')
-float_literal_re = re.compile(r'''(?x)
+''', flags=re.VERBOSE)
+float_literal_re = re.compile(r'''
     +-?(
     # decimal
       (0-9+(\'0-9+)*eE+-?0-9+(\'0-9+)*)
@@ -59,10 +54,10 @@
         0-9a-fA-F+(\'0-9a-fA-F+)*(pP+-?0-9a-fA-F+(\'0-9a-fA-F+)*)?)
     | (0xX0-9a-fA-F+(\'0-9a-fA-F+)*\.(pP+-?0-9a-fA-F+(\'0-9a-fA-F+)*)?)
     )
-''')
+''', flags=re.VERBOSE)
 float_literal_suffix_re = re.compile(r'fFlL\b')
 # the ending word boundary is important for distinguishing between suffixes and UDLs in C++
-char_literal_re = re.compile(r'''(?x)
+char_literal_re = re.compile(r'''
     ((?:u8)|u|U|L)?
     '(
       (?:^\\')
@@ -74,7 +69,7 @@
       | (?:U0-9a-fA-F{8})
       ))
     )'
-''')
+''', flags=re.VERBOSE)
 
 
 def verify_description_mode(mode: str) -> None:
@@ -134,12 +129,13 @@
         return "" + self.arg + ""
 
     def describe_signature(self, signode: TextElement) -> None:
-        txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode.append(addnodes.desc_sig_punctuation('', ''))
+        signode.append(nodes.Text(self.arg))
+        signode.append(addnodes.desc_sig_punctuation('', ''))
 
 
 class ASTGnuAttribute(ASTBaseBase):
-    def __init__(self, name: str, args: Optional"ASTBaseParenExprList") -> None:
+    def __init__(self, name: str, args: ASTBaseParenExprList | None) -> None:
         self.name = name
         self.args = args
 
@@ -151,7 +147,7 @@
 
 
 class ASTGnuAttributeList(ASTAttribute):
-    def __init__(self, attrs: ListASTGnuAttribute) -> None:
+    def __init__(self, attrs: listASTGnuAttribute) -> None:
         self.attrs = attrs
 
     def _stringify(self, transform: StringifyTransform) -> str:
@@ -167,7 +163,7 @@
 
     def describe_signature(self, signode: TextElement) -> None:
         txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode.append(nodes.Text(txt))
 
 
 class ASTIdAttribute(ASTAttribute):
@@ -180,7 +176,7 @@
         return self.id
 
     def describe_signature(self, signode: TextElement) -> None:
-        signode.append(nodes.Text(self.id, self.id))
+        signode.append(nodes.Text(self.id))
 
 
 class ASTParenAttribute(ASTAttribute):
@@ -195,7 +191,31 @@
 
     def describe_signature(self, signode: TextElement) -> None:
         txt = str(self)
-        signode.append(nodes.Text(txt, txt))
+        signode.append(nodes.Text(txt))
+
+
+class ASTAttributeList(ASTBaseBase):
+    def __init__(self, attrs: listASTAttribute) -> None:
+        self.attrs = attrs
+
+    def __len__(self) -> int:
+        return len(self.attrs)
+
+    def __add__(self, other: ASTAttributeList) -> ASTAttributeList:
+        return ASTAttributeList(self.attrs + other.attrs)
+
+    def _stringify(self, transform: StringifyTransform) -> str:
+        return ' '.join(transform(attr) for attr in self.attrs)
+
+    def describe_signature(self, signode: TextElement) -> None:
+        if len(self.attrs) == 0:
+            return
+        self.attrs0.describe_signature(signode)
+        if len(self.attrs) == 1:
+            return
+        for attr in self.attrs1::
+            signode.append(addnodes.desc_sig_space())
+            attr.describe_signature(signode)
 
 
 ################################################################################
@@ -216,22 +236,22 @@
 
 class BaseParser:
     def __init__(self, definition: str, *,
-                 location: Unionnodes.Node, Tuplestr, int, str,
-                 config: "Config") -> None:
+                 location: nodes.Node | tuplestr, int | str,
+                 config: Config) -> None:
         self.definition = definition.strip()
         self.location = location  # for warnings
         self.config = config
 
         self.pos = 0
         self.end = len(self.definition)
-        self.last_match: Match = None
-        self._previous_state: Tupleint, Match = (0, None)
-        self.otherErrors: ListDefinitionError = 
+        self.last_match: re.Match = None
+        self._previous_state: tupleint, re.Match = (0, None)
+        self.otherErrors: listDefinitionError = 
 
         # in our tests the following is set to False to capture bad parsing
         self.allowFallbackExpressionParsing = True
 
-    def _make_multi_error(self, errors: ListAny, header: str) -> DefinitionError:
+    def _make_multi_error(self, errors: listAny, header: str) -> DefinitionError:
         if len(errors) == 1:
             if len(header) > 0:
                 return DefinitionError(header + '\n' + str(errors00))
@@ -260,7 +280,7 @@
     def status(self, msg: str) -> None:
         # for debugging
         indicator = '-' * self.pos + '^'
-        print("%s\n%s\n%s" % (msg, self.definition, indicator))
+        print(f"{msg}\n{self.definition}\n{indicator}")
 
     def fail(self, msg: str) -> None:
         errors = 
@@ -277,7 +297,7 @@
     def warn(self, msg: str) -> None:
         logger.warning(msg, location=self.location)
 
-    def match(self, regex: Pattern) -> bool:
+    def match(self, regex: re.Pattern) -> bool:
         match = regex.match(self.definition, self.pos)
         if match is not None:
             self._previous_state = (self.pos, self.last_match)
@@ -353,15 +373,15 @@
     def paren_attributes(self):
         raise NotImplementedError
 
-    def _parse_balanced_token_seq(self, end: Liststr) -> str:
+    def _parse_balanced_token_seq(self, end: liststr) -> str:
         # TODO: add handling of string literals and similar
         brackets = {'(': ')', '': '', '{': '}'}
         startPos = self.pos
-        symbols: Liststr = 
+        symbols: liststr = 
         while not self.eof:
             if len(symbols) == 0 and self.current_char in end:
                 break
-            if self.current_char in brackets.keys():
+            if self.current_char in brackets:
                 symbols.append(bracketsself.current_char)
             elif len(symbols) > 0 and self.current_char == symbols-1:
                 symbols.pop()
@@ -373,7 +393,7 @@
                       % startPos)
         return self.definitionstartPos:self.pos
 
-    def _parse_attribute(self) -> OptionalASTAttribute:
+    def _parse_attribute(self) -> ASTAttribute | None:
         self.skip_ws()
         # try C++11 style
         startPos = self.pos
@@ -403,10 +423,9 @@
                     attrs.append(ASTGnuAttribute(name, exprs))
                 if self.skip_string_and_ws(','):
                     continue
-                elif self.skip_string_and_ws(')'):
+                if self.skip_string_and_ws(')'):
                     break
-                else:
-                    self.fail("Expected identifier, ')', or ',' in __attribute__.")
+                self.fail("Expected identifier, ')', or ',' in __attribute__.")
             if not self.skip_string_and_ws(')'):
                 self.fail("Expected ')' after '__attribute__((...)'")
             return ASTGnuAttributeList(attrs)
@@ -429,5 +448,14 @@
 
         return None
 
-    def _parse_paren_expression_list(self) -> ASTBaseParenExprList:
+    def _parse_attribute_list(self) -> ASTAttributeList:
+        res = 
+        while True:
+            attr = self._parse_attribute()
+            if attr is None:
+                break
+            res.append(attr)
+        return ASTAttributeList(res)
+
+    def _parse_paren_expression_list(self) -> ASTBaseParenExprList | None:
         raise NotImplementedError

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/console.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/console.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.util.console
-    ~~~~~~~~~~~~~~~~~~~
+"""Format colored console output."""
 
-    Format colored console output.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import re
+import shutil
 import sys
-from typing import Dict, Pattern
 
 try:
     # check if colorama is installed to support color on Windows
@@ -20,8 +14,8 @@
     colorama = None
 
 
-_ansi_re: Pattern = re.compile('\x1b\\(\\d\\d;){0,2}\\d\\dm')
-codes: Dictstr, str = {}
+_ansi_re: re.Pattern = re.compile('\x1b\\(\\d\\d;){0,2}\\d\\dm')
+codes: dictstr, str = {}
 
 
 def terminal_safe(s: str) -> str:
@@ -30,18 +24,8 @@
 
 
 def get_terminal_width() -> int:
-    """Borrowed from the py lib."""
-    try:
-        import fcntl
-        import struct
-        import termios
-        call = fcntl.ioctl(0, termios.TIOCGWINSZ, struct.pack('hhhh', 0, 0, 0, 0))
-        height, width = struct.unpack('hhhh', call):2
-        terminal_width = width
-    except Exception:
-        # FALLBACK
-        terminal_width = int(os.environ.get('COLUMNS', "80")) - 1
-    return terminal_width
+    """Return the width of the terminal in columns."""
+    return shutil.get_terminal_size().columns - 1
 
 
 _tw: int = get_terminal_width()
@@ -57,9 +41,13 @@
 
 
 def color_terminal() -> bool:
+    if 'NO_COLOR' in os.environ:
+        return False
     if sys.platform == 'win32' and colorama is not None:
         colorama.init()
         return True
+    if 'FORCE_COLOR' in os.environ:
+        return True
     if not hasattr(sys.stdout, 'isatty'):
         return False
     if not sys.stdout.isatty():

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/display.py Added

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+import functools
+from typing import Any, Callable, Iterable, Iterator, TypeVar
+
+from sphinx.locale import __
+from sphinx.util import logging
+from sphinx.util.console import bold, colorize, term_width_line  # type: ignore
+
+if False:
+    from types import TracebackType
+
+logger = logging.getLogger(__name__)
+
+
+def display_chunk(chunk: Any) -> str:
+    if isinstance(chunk, (list, tuple)):
+        if len(chunk) == 1:
+            return str(chunk0)
+        return f'{chunk0} .. {chunk-1}'
+    return str(chunk)
+
+
+T = TypeVar('T')
+
+
+def status_iterator(
+    iterable: IterableT,
+    summary: str,
+    color: str = 'darkgreen',
+    length: int = 0,
+    verbosity: int = 0,
+    stringify_func: CallableAny, str = display_chunk,
+) -> IteratorT:
+    if length == 0:
+        logger.info(bold(summary), nonl=True)
+    for i, item in enumerate(iterable, start=1):
+        item_str = colorize(color, stringify_func(item))
+        if length == 0:
+            logger.info(item_str, nonl=True)
+            logger.info(' ', nonl=True)
+        else:
+            s = f'{bold(summary)}{int(100 * i / length): >3d}% {item_str}'
+            if verbosity:
+                logger.info(s + '\n', nonl=True)
+            else:
+                logger.info(term_width_line(s), nonl=True)
+        yield item
+    logger.info('')
+
+
+class SkipProgressMessage(Exception):
+    pass
+
+
+class progress_message:
+    def __init__(self, message: str) -> None:
+        self.message = message
+
+    def __enter__(self) -> None:
+        logger.info(bold(self.message + '... '), nonl=True)
+
+    def __exit__(
+        self,
+        typ: typeBaseException | None,
+        val: BaseException | None,
+        tb: TracebackType | None,
+    ) -> bool:
+        if isinstance(val, SkipProgressMessage):
+            logger.info(__('skipped'))
+            if val.args:
+                logger.info(*val.args)
+            return True
+        elif val:
+            logger.info(__('failed'))
+        else:
+            logger.info(__('done'))
+
+        return False
+
+    def __call__(self, f: Callable) -> Callable:
+        @functools.wraps(f)
+        def wrapper(*args: Any, **kwargs: Any) -> Any:
+            with self:
+                return f(*args, **kwargs)
+
+        return wrapper

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/docfields.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/docfields.py Changed

@@ -1,14 +1,11 @@
-"""
-    sphinx.util.docfields
-    ~~~~~~~~~~~~~~~~~~~~~
-
-    "Doc fields" are reST field lists in object descriptions that will
-    be domain-specifically transformed to a more appealing presentation.
+"""Utility code for "Doc fields".
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+"Doc fields" are reST field lists in object descriptions that will
+be domain-specifically transformed to a more appealing presentation.
 """
-from typing import TYPE_CHECKING, Any, Dict, List, Tuple, Type, Union, cast
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, List, Tuple, cast
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -55,7 +52,7 @@
     is_grouped = False
     is_typed = False
 
-    def __init__(self, name: str, names: Tuplestr, ... = (), label: str = None,
+    def __init__(self, name: str, names: tuplestr, ... = (), label: str = None,
                  has_arg: bool = True, rolename: str = None, bodyrolename: str = None) -> None:
         self.name = name
         self.names = names
@@ -65,7 +62,7 @@
         self.bodyrolename = bodyrolename
 
     def make_xref(self, rolename: str, domain: str, target: str,
-                  innernode: TypeTextlikeNode = addnodes.literal_emphasis,
+                  innernode: typeTextlikeNode = addnodes.literal_emphasis,
                   contnode: Node = None, env: BuildEnvironment = None,
                   inliner: Inliner = None, location: Node = None) -> Node:
         # note: for backwards compatibility env is last, but not optional
@@ -91,17 +88,17 @@
         return nodes.inline(target, '', *ns)
 
     def make_xrefs(self, rolename: str, domain: str, target: str,
-                   innernode: TypeTextlikeNode = addnodes.literal_emphasis,
+                   innernode: typeTextlikeNode = addnodes.literal_emphasis,
                    contnode: Node = None, env: BuildEnvironment = None,
-                   inliner: Inliner = None, location: Node = None) -> ListNode:
+                   inliner: Inliner = None, location: Node = None) -> listNode:
         return self.make_xref(rolename, domain, target, innernode, contnode,
                                env, inliner, location)
 
-    def make_entry(self, fieldarg: str, content: ListNode) -> Tuplestr, ListNode:
+    def make_entry(self, fieldarg: str, content: listNode) -> tuplestr, listNode:
         return (fieldarg, content)
 
-    def make_field(self, types: Dictstr, ListNode, domain: str,
-                   item: Tuple, env: BuildEnvironment = None,
+    def make_field(self, types: dictstr, listNode, domain: str,
+                   item: tuple, env: BuildEnvironment = None,
                    inliner: Inliner = None, location: Node = None) -> nodes.field:
         fieldarg, content = item
         fieldname = nodes.field_name('', self.label)
@@ -138,13 +135,13 @@
     is_grouped = True
     list_type = nodes.bullet_list
 
-    def __init__(self, name: str, names: Tuplestr, ... = (), label: str = None,
+    def __init__(self, name: str, names: tuplestr, ... = (), label: str = None,
                  rolename: str = None, can_collapse: bool = False) -> None:
         super().__init__(name, names, label, True, rolename)
         self.can_collapse = can_collapse
 
-    def make_field(self, types: Dictstr, ListNode, domain: str,
-                   items: Tuple, env: BuildEnvironment = None,
+    def make_field(self, types: dictstr, listNode, domain: str,
+                   items: tuple, env: BuildEnvironment = None,
                    inliner: Inliner = None, location: Node = None) -> nodes.field:
         fieldname = nodes.field_name('', self.label)
         listnode = self.list_type()
@@ -187,15 +184,15 @@
     """
     is_typed = True
 
-    def __init__(self, name: str, names: Tuplestr, ... = (), typenames: Tuplestr, ... = (),
+    def __init__(self, name: str, names: tuplestr, ... = (), typenames: tuplestr, ... = (),
                  label: str = None, rolename: str = None, typerolename: str = None,
                  can_collapse: bool = False) -> None:
         super().__init__(name, names, label, rolename, can_collapse)
         self.typenames = typenames
         self.typerolename = typerolename
 
-    def make_field(self, types: Dictstr, ListNode, domain: str,
-                   items: Tuple, env: BuildEnvironment = None,
+    def make_field(self, types: dictstr, listNode, domain: str,
+                   items: tuple, env: BuildEnvironment = None,
                    inliner: Inliner = None, location: Node = None) -> nodes.field:
         def handle_item(fieldarg: str, content: str) -> nodes.paragraph:
             par = nodes.paragraph()
@@ -236,9 +233,9 @@
     Transforms field lists in "doc field" syntax into better-looking
     equivalents, using the field type definitions given on a domain.
     """
-    typemap: Dictstr, TupleField, bool
+    typemap: dictstr, tupleField, bool
 
-    def __init__(self, directive: "ObjectDescription") -> None:
+    def __init__(self, directive: ObjectDescription) -> None:
         self.directive = directive
 
         self.typemap = directive.get_field_type_map()
@@ -254,9 +251,9 @@
         """Transform a single field list *node*."""
         typemap = self.typemap
 
-        entries: ListUnionnodes.field, TupleField, Any, Node = 
-        groupindices: Dictstr, int = {}
-        types: Dictstr, Dict = {}
+        entries: listnodes.field | tupleField, Any, Node = 
+        groupindices: dictstr, int = {}
+        types: dictstr, dict = {}
 
         # step 1: traverse all fields and collect field types and content
         for field in cast(Listnodes.field, node):
@@ -298,7 +295,7 @@
                         self.directive.domain,
                         target,
                         contnode=content0,
-                        env=self.directive.state.document.settings.env
+                        env=self.directive.state.document.settings.env,
                     )
                     if _is_single_paragraph(field_body):
                         paragraph = cast(nodes.paragraph, field_body0)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/docstrings.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/docstrings.py Changed

@@ -1,29 +1,19 @@
-"""
-    sphinx.util.docstrings
-    ~~~~~~~~~~~~~~~~~~~~~~
+"""Utilities for docstring processing."""
 
-    Utilities for docstring processing.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 import sys
-import warnings
-from typing import Dict, List, Tuple
 
 from docutils.parsers.rst.states import Body
 
-from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
-
 field_list_item_re = re.compile(Body.patterns'field_marker')
 
 
-def separate_metadata(s: str) -> Tuplestr, Dictstr, str:
+def separate_metadata(s: str) -> tuplestr, dictstr, str:
     """Separate docstring into metadata and others."""
     in_other_element = False
-    metadata: Dictstr, str = {}
+    metadata: dictstr, str = {}
     lines = 
 
     if not s:
@@ -49,43 +39,27 @@
     return '\n'.join(lines), metadata
 
 
-def extract_metadata(s: str) -> Dictstr, str:
-    warnings.warn("extract_metadata() is deprecated.",
-                  RemovedInSphinx60Warning, stacklevel=2)
-
-    docstring, metadata = separate_metadata(s)
-    return metadata
-
-
-def prepare_docstring(s: str, ignore: int = None, tabsize: int = 8) -> Liststr:
+def prepare_docstring(s: str, tabsize: int = 8) -> liststr:
     """Convert a docstring into lines of parseable reST.  Remove common leading
-    indentation, where the indentation of a given number of lines (usually just
-    one) is ignored.
+    indentation, where the indentation of the first line is ignored.
 
     Return the docstring as a list of lines usable for inserting into a docutils
     ViewList (used as argument of nested_parse().)  An empty line is added to
     act as a separator between this docstring and following content.
     """
-    if ignore is None:
-        ignore = 1
-    else:
-        warnings.warn("The 'ignore' argument to prepare_docstring() is deprecated.",
-                      RemovedInSphinx50Warning, stacklevel=2)
-
     lines = s.expandtabs(tabsize).splitlines()
     # Find minimum indentation of any non-blank lines after ignored lines.
     margin = sys.maxsize
-    for line in linesignore::
+    for line in lines1::
         content = len(line.lstrip())
         if content:
             indent = len(line) - content
             margin = min(margin, indent)
-    # Remove indentation from ignored lines.
-    for i in range(ignore):
-        if i < len(lines):
-            linesi = linesi.lstrip()
+    # Remove indentation from the first line.
+    if len(lines):
+        lines0 = lines0.lstrip()
     if margin < sys.maxsize:
-        for i in range(ignore, len(lines)):
+        for i in range(1, len(lines)):
             linesi = linesimargin:
     # Remove any leading blank lines.
     while lines and not lines0:
@@ -96,7 +70,7 @@
     return lines
 
 
-def prepare_commentdoc(s: str) -> Liststr:
+def prepare_commentdoc(s: str) -> liststr:
     """Extract documentation comment lines (starting with #:) and return them
     as a list of lines.  Returns an empty list if there is no documentation.
     """

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/docutils.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/docutils.py Changed

@@ -1,21 +1,13 @@
-"""
-    sphinx.util.docutils
-    ~~~~~~~~~~~~~~~~~~~~
+"""Utility functions for docutils."""
 
-    Utility functions for docutils.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import re
 from contextlib import contextmanager
 from copy import copy
 from os import path
-from types import ModuleType
-from typing import (IO, TYPE_CHECKING, Any, Callable, Dict, Generator, List, Optional, Set,
-                    Tuple, Type, cast)
+from typing import IO, TYPE_CHECKING, Any, Callable, Generator, cast
 
 import docutils
 from docutils import nodes
@@ -25,7 +17,7 @@
 from docutils.parsers.rst.states import Inliner
 from docutils.statemachine import State, StateMachine, StringList
 from docutils.utils import Reporter, unescape
-from packaging import version
+from docutils.writers._html_base import HTMLTranslator
 
 from sphinx.errors import SphinxError
 from sphinx.locale import _, __
@@ -36,13 +28,32 @@
 report_re = re.compile('^(.+?:(?:\\d+)?): \$(DEBUG|INFO|WARNING|ERROR|SEVERE)/(\\d+)?\$ ')
 
 if TYPE_CHECKING:
+    from types import ModuleType
+
+    from docutils.frontend import Values
+
     from sphinx.builders import Builder
     from sphinx.config import Config
     from sphinx.environment import BuildEnvironment
 
+# deprecated name -> (object to return, canonical path or empty string)
+_DEPRECATED_OBJECTS = {
+    '__version_info__': (docutils.__version_info__, 'docutils.__version_info__'),
+}
+
+
+def __getattr__(name):
+    if name not in _DEPRECATED_OBJECTS:
+        raise AttributeError(f'module {__name__!r} has no attribute {name!r}')
 
-__version_info__ = version.parse(docutils.__version__).release
-additional_nodes: SetTypeElement = set()
+    from sphinx.deprecation import _deprecation_warning
+
+    deprecated_object, canonical_name = _DEPRECATED_OBJECTSname
+    _deprecation_warning(__name__, name, canonical_name, remove=(7, 0))
+    return deprecated_object
+
+
+additional_nodes: settypeElement = set()
 
 
 @contextmanager
@@ -67,7 +78,7 @@
     return name in directives._directives  # type: ignore
 
 
-def register_directive(name: str, directive: TypeDirective) -> None:
+def register_directive(name: str, directive: typeDirective) -> None:
     """Register a directive to docutils.
 
     This modifies global state of docutils.  So it is better to use this
@@ -95,12 +106,12 @@
     roles._roles.pop(name, None)  # type: ignore
 
 
-def is_node_registered(node: TypeElement) -> bool:
+def is_node_registered(node: typeElement) -> bool:
     """Check the *node* is already registered."""
     return hasattr(nodes.GenericNodeVisitor, 'visit_' + node.__name__)
 
 
-def register_node(node: TypeElement) -> None:
+def register_node(node: typeElement) -> None:
     """Register a node to docutils.
 
     This modifies global state of some visitors.  So it is better to use this
@@ -111,7 +122,7 @@
         additional_nodes.add(node)
 
 
-def unregister_node(node: TypeElement) -> None:
+def unregister_node(node: typeElement) -> None:
     """Unregister a node from docutils.
 
     This is inverse of ``nodes._add_nodes_class_names()``.
@@ -144,7 +155,31 @@
 
 
 @contextmanager
-def using_user_docutils_conf(confdir: Optionalstr) -> GeneratorNone, None, None:
+def patched_rst_get_language() -> GeneratorNone, None, None:
+    """Patch docutils.parsers.rst.languages.get_language().
+    Starting from docutils 0.17, get_language() in ``rst.languages``
+    also has a reporter, which needs to be disabled temporarily.
+
+    This should also work for old versions of docutils,
+    because reporter is none by default.
+
+    refs: https://github.com/sphinx-doc/sphinx/issues/10179
+    """
+    from docutils.parsers.rst.languages import get_language
+
+    def patched_get_language(language_code: str, reporter: Reporter = None) -> Any:
+        return get_language(language_code)
+
+    try:
+        docutils.parsers.rst.languages.get_language = patched_get_language
+        yield
+    finally:
+        # restore original implementations
+        docutils.parsers.rst.languages.get_language = get_language
+
+
+@contextmanager
+def using_user_docutils_conf(confdir: str | None) -> GeneratorNone, None, None:
     """Let docutils know the location of ``docutils.conf`` for Sphinx."""
     try:
         docutilsconfig = os.environ.get('DOCUTILSCONFIG', None)
@@ -160,9 +195,45 @@
 
 
 @contextmanager
-def patch_docutils(confdir: Optionalstr = None) -> GeneratorNone, None, None:
+def du19_footnotes() -> GeneratorNone, None, None:
+    def visit_footnote(self, node):
+        label_style = self.settings.footnote_references
+        if not isinstance(node.previous_sibling(), type(node)):
+            self.body.append(f'<aside class="footnote-list {label_style}">\n')
+        self.body.append(self.starttag(node, 'aside',
+                                       classes=node.tagname, label_style,
+                                       role="note"))
+
+    def depart_footnote(self, node):
+        self.body.append('</aside>\n')
+        if not isinstance(node.next_node(descend=False, siblings=True),
+                          type(node)):
+            self.body.append('</aside>\n')
+
+    old_visit_footnote = HTMLTranslator.visit_footnote
+    old_depart_footnote = HTMLTranslator.depart_footnote
+
+    # Only apply on Docutils 0.18 or 0.18.1, as 0.17 and earlier used a <dl> based
+    # approach, and 0.19 and later use the fixed approach by default.
+    if docutils.__version_info__:2 == (0, 18):
+        HTMLTranslator.visit_footnote = visit_footnote  # type: ignoremethod-assign
+        HTMLTranslator.depart_footnote = depart_footnote  # type: ignoremethod-assign
+
+    try:
+        yield
+    finally:
+        if docutils.__version_info__:2 == (0, 18):
+            HTMLTranslator.visit_footnote = old_visit_footnote  # type: ignoremethod-assign
+            HTMLTranslator.depart_footnote = old_depart_footnote  # type: ignoremethod-assign
+
+
+@contextmanager
+def patch_docutils(confdir: str | None = None) -> GeneratorNone, None, None:
     """Patch to docutils temporarily."""
-    with patched_get_language(), using_user_docutils_conf(confdir):
+    with patched_get_language(), \
+         patched_rst_get_language(), \
+         using_user_docutils_conf(confdir), \
+         du19_footnotes():
         yield
 
 
@@ -180,7 +251,9 @@
     def __enter__(self) -> None:
         self.enable()
 
-    def __exit__(self, exc_type: TypeException, exc_value: Exception, traceback: Any) -> None:  # NOQA
+    def __exit__(
+        self, exc_type: typeException, exc_value: Exception, traceback: Any,
+    ) -> None:
         self.disable()
 
     def enable(self) -> None:
@@ -195,12 +268,13 @@
         roles.role = self.role_func
 
     def directive(self,
-                  directive_name: str, language_module: ModuleType, document: nodes.document
-                  ) -> TupleOptionalTypeDirective, Listsystem_message:
+                  directive_name: str, language_module: ModuleType, document: nodes.document,
+                  ) -> tupletypeDirective | None, listsystem_message:
         return self.directive_func(directive_name, language_module, document)
 
-    def role(self, role_name: str, language_module: ModuleType, lineno: int, reporter: Reporter
-             ) -> TupleRoleFunction, Listsystem_message:
+    def role(
+        self, role_name: str, language_module: ModuleType, lineno: int, reporter: Reporter,
+    ) -> tupleRoleFunction, listsystem_message:
         return self.role_func(role_name, language_module, lineno, reporter)
 
 
@@ -212,7 +286,7 @@
     """Monkey-patch directive and role dispatch, so that domain-specific
     markup takes precedence.
     """
-    def __init__(self, env: "BuildEnvironment") -> None:
+    def __init__(self, env: BuildEnvironment) -> None:
         self.env = env
         super().__init__()
 
@@ -247,15 +321,16 @@
         raise ElementLookupError
 
     def directive(self,
-                  directive_name: str, language_module: ModuleType, document: nodes.document
-                  ) -> TupleOptionalTypeDirective, Listsystem_message:
+                  directive_name: str, language_module: ModuleType, document: nodes.document,
+                  ) -> tupletypeDirective | None, listsystem_message:
         try:
             return self.lookup_domain_element('directive', directive_name)
         except ElementLookupError:
             return super().directive(directive_name, language_module, document)
 
-    def role(self, role_name: str, language_module: ModuleType, lineno: int, reporter: Reporter
-             ) -> TupleRoleFunction, Listsystem_message:
+    def role(
+        self, role_name: str, language_module: ModuleType, lineno: int, reporter: Reporter,
+    ) -> tupleRoleFunction, listsystem_message:
         try:
             return self.lookup_domain_element('role', role_name)
         except ElementLookupError:
@@ -275,7 +350,7 @@
 
 class LoggingReporter(Reporter):
     @classmethod
-    def from_reporter(cls, reporter: Reporter) -> "LoggingReporter":
+    def from_reporter(cls, reporter: Reporter) -> LoggingReporter:
         """Create an instance of LoggingReporter from other reporter object."""
         return cls(reporter.source, reporter.report_level, reporter.halt_level,
                    reporter.debug_flag, reporter.error_handler)
@@ -295,10 +370,6 @@
         super().__init__('', 999, 4)
 
 
-def is_html5_writer_available() -> bool:
-    return __version_info__ > (0, 13, 0)
-
-
 @contextmanager
 def switch_source_input(state: State, content: StringList) -> GeneratorNone, None, None:
     """Switch current source input of state temporarily."""
@@ -309,7 +380,7 @@
         # replace it by new one
         state_machine = StateMachine(, None)
         state_machine.input_lines = content
-        state.memo.reporter.get_source_and_line = state_machine.get_source_and_line  # type: ignore  # NOQA
+        state.memo.reporter.get_source_and_line = state_machine.get_source_and_line  # type: ignore  # noqa: E501
 
         yield
     finally:
@@ -322,6 +393,7 @@
 
     def __init__(self, **kwargs: Any) -> None:
         self.overwrite_if_changed = kwargs.pop('overwrite_if_changed', False)
+        kwargs.setdefault('encoding', 'utf-8')
         super().__init__(**kwargs)
 
     def write(self, data: str) -> str:
@@ -345,16 +417,16 @@
     """
 
     @property
-    def env(self) -> "BuildEnvironment":
+    def env(self) -> BuildEnvironment:
         """Reference to the :class:`.BuildEnvironment` object."""
         return self.state.document.settings.env
 
     @property
-    def config(self) -> "Config":
+    def config(self) -> Config:
         """Reference to the :class:`.Config` object."""
         return self.env.config
 
-    def get_source_info(self) -> Tuplestr, int:
+    def get_source_info(self) -> tuplestr, int:
         """Get source and line number."""
         return self.state_machine.get_source_and_line(self.lineno)
 
@@ -380,14 +452,14 @@
     text: str           #: The interpreted text content.
     lineno: int         #: The line number where the interpreted text begins.
     inliner: Inliner    #: The ``docutils.parsers.rst.states.Inliner`` object.
-    options: Dict       #: A dictionary of directive options for customization
+    options: dict       #: A dictionary of directive options for customization
                         #: (from the "role" directive).
-    content: Liststr  #: A list of strings, the directive content for customization
+    content: liststr  #: A list of strings, the directive content for customization
                         #: (from the "role" directive).
 
     def __call__(self, name: str, rawtext: str, text: str, lineno: int,
-                 inliner: Inliner, options: Dict = {}, content: Liststr = 
-                 ) -> TupleListNode, Listsystem_message:
+                 inliner: Inliner, options: dict = {}, content: liststr = ,
+                 ) -> tuplelistNode, listsystem_message:
         self.rawtext = rawtext
         self.text = unescape(text)
         self.lineno = lineno
@@ -407,20 +479,20 @@
 
         return self.run()
 
-    def run(self) -> TupleListNode, Listsystem_message:
+    def run(self) -> tuplelistNode, listsystem_message:
         raise NotImplementedError
 
     @property
-    def env(self) -> "BuildEnvironment":
+    def env(self) -> BuildEnvironment:
         """Reference to the :class:`.BuildEnvironment` object."""
         return self.inliner.document.settings.env
 
     @property
-    def config(self) -> "Config":
+    def config(self) -> Config:
         """Reference to the :class:`.Config` object."""
         return self.env.config
 
-    def get_source_info(self, lineno: int = None) -> Tuplestr, int:
+    def get_source_info(self, lineno: int = None) -> tuplestr, int:
         if lineno is None:
             lineno = self.lineno
         return self.inliner.reporter.get_source_and_line(lineno)  # type: ignore
@@ -449,8 +521,8 @@
     explicit_title_re = re.compile(r'^(.+?)\s*(?<!\x00)<(.*?)>$', re.DOTALL)
 
     def __call__(self, name: str, rawtext: str, text: str, lineno: int,
-                 inliner: Inliner, options: Dict = {}, content: Liststr = 
-                 ) -> TupleListNode, Listsystem_message:
+                 inliner: Inliner, options: dict = {}, content: liststr = ,
+                 ) -> tuplelistNode, listsystem_message:
         # if the first character is a bang, don't cross-reference at all
         self.disabled = text.startswith('!')
 
@@ -479,7 +551,7 @@
               This class is strongly coupled with Sphinx.
     """
 
-    def __init__(self, document: nodes.document, builder: "Builder") -> None:
+    def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document)
         self.builder = builder
         self.config = builder.config
@@ -523,19 +595,9 @@
         logger.warning(__('unknown node type: %r'), node, location=node)
 
 
-# Node.findall() is a new interface to traverse a doctree since docutils-0.18.
-# This applies a patch docutils-0.17 or older to be available Node.findall()
-# method to use it from our codebase.
-if __version_info__ < (0, 18):
-    def findall(self, *args, **kwargs):
-        return iter(self.traverse(*args, **kwargs))
-
-    Node.findall = findall  # type: ignore
-
-
 # cache a vanilla instance of nodes.document
 # Used in new_document() function
-__document_cache__: Optionalnodes.document = None
+__document_cache__: tupleValues, Reporter
 
 
 def new_document(source_path: str, settings: Any = None) -> nodes.document:
@@ -546,15 +608,18 @@
     This makes an instantiation of document nodes much faster.
     """
     global __document_cache__
-    if __document_cache__ is None:
-        __document_cache__ = docutils.utils.new_document(source_path)
+    try:
+        cached_settings, reporter = __document_cache__
+    except NameError:
+        doc = docutils.utils.new_document(source_path)
+        __document_cache__ = cached_settings, reporter = doc.settings, doc.reporter
 
     if settings is None:
-        # Make a copy of ``settings`` from cache to accelerate instantiation
-        settings = copy(__document_cache__.settings)
+        # Make a copy of the cached settings to accelerate instantiation
+        settings = copy(cached_settings)
 
     # Create a new instance of nodes.document using cached reporter
     from sphinx import addnodes
-    document = addnodes.document(settings, __document_cache__.reporter, source=source_path)
+    document = addnodes.document(settings, reporter, source=source_path)
     document.note_source(source_path, -1)
     return document

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/exceptions.py Added

@@ -0,0 +1,67 @@
+from __future__ import annotations
+
+import sys
+import traceback
+from tempfile import NamedTemporaryFile
+from typing import TYPE_CHECKING
+
+from sphinx.errors import SphinxParallelError
+from sphinx.util.console import strip_colors
+
+if TYPE_CHECKING:
+    from sphinx.application import Sphinx
+
+
+def save_traceback(app: Sphinx | None, exc: BaseException) -> str:
+    """Save the given exception's traceback in a temporary file."""
+    import platform
+
+    import docutils
+    import jinja2
+    import pygments
+
+    import sphinx
+
+    if isinstance(exc, SphinxParallelError):
+        exc_format = '(Error in parallel process)\n' + exc.traceback
+    else:
+        exc_format = traceback.format_exc()
+
+    if app is None:
+        last_msgs = exts_list = ''
+    else:
+        extensions = app.extensions.values()
+        last_msgs = '\n'.join(f'#   {strip_colors(s).strip()}' for s in app.messagelog)
+        exts_list = '\n'.join(f'#   {ext.name} ({ext.version})' for ext in extensions
+                              if ext.version != 'builtin')
+
+    with NamedTemporaryFile('w', suffix='.log', prefix='sphinx-err-', delete=False) as f:
+        f.write(f"""\
+# Platform:         {sys.platform}; ({platform.platform()})
+# Sphinx version:   {sphinx.__display_version__}
+# Python version:   {platform.python_version()} ({platform.python_implementation()})
+# Docutils version: {docutils.__version__}
+# Jinja2 version:   {jinja2.__version__}
+# Pygments version: {pygments.__version__}
+
+# Last messages:
+{last_msgs}
+
+# Loaded extensions:
+{exts_list}
+
+# Traceback:
+{exc_format}
+""")
+    return f.name
+
+
+def format_exception_cut_frames(x: int = 1) -> str:
+    """Format an exception with traceback, but only the last x frames."""
+    typ, val, tb = sys.exc_info()
+    # res = 'Traceback (most recent call last):\n'
+    res: liststr = 
+    tbres = traceback.format_tb(tb)
+    res += tbres-x:
+    res += traceback.format_exception_only(typ, val)
+    return ''.join(res)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/fileutil.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/fileutil.py Changed

@@ -1,16 +1,10 @@
-"""
-    sphinx.util.fileutil
-    ~~~~~~~~~~~~~~~~~~~~
+"""File utility functions for Sphinx."""
 
-    File utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import posixpath
-from typing import TYPE_CHECKING, Callable, Dict
+from typing import TYPE_CHECKING, Callable
 
 from docutils.utils import relative_path
 
@@ -22,7 +16,8 @@
 
 
 def copy_asset_file(source: str, destination: str,
-                    context: Dict = None, renderer: "BaseRenderer" = None) -> None:
+                    context: dict | None = None,
+                    renderer: BaseRenderer | None = None) -> None:
     """Copy an asset file to destination.
 
     On copying, it expands the template variables if context argument is given and
@@ -55,8 +50,8 @@
 
 
 def copy_asset(source: str, destination: str, excluded: PathMatcher = lambda path: False,
-               context: Dict = None, renderer: "BaseRenderer" = None,
-               onerror: Callablestr, Exception, None = None) -> None:
+               context: dict | None = None, renderer: BaseRenderer | None = None,
+               onerror: Callablestr, Exception, None | None = None) -> None:
     """Copy asset files to destination recursively.
 
     On copying, it expands the template variables if context argument is given and

_service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/http_date.py Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/i18n.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/i18n.py Changed

@@ -1,18 +1,12 @@
-"""
-    sphinx.util.i18n
-    ~~~~~~~~~~~~~~~~
+"""Builder superclass for all builders."""
 
-    Builder superclass for all builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import re
 from datetime import datetime, timezone
 from os import path
-from typing import TYPE_CHECKING, Callable, Generator, List, NamedTuple, Optional, Tuple, Union
+from typing import TYPE_CHECKING, Callable, Generator, NamedTuple
 
 import babel.dates
 from babel.messages.mofile import write_mo
@@ -77,7 +71,7 @@
 class CatalogRepository:
     """A repository for message catalogs."""
 
-    def __init__(self, basedir: str, locale_dirs: Liststr,
+    def __init__(self, basedir: str, locale_dirs: liststr,
                  language: str, encoding: str) -> None:
         self.basedir = basedir
         self._locale_dirs = locale_dirs
@@ -98,7 +92,7 @@
                 logger.verbose(__('locale_dir %s does not exists'), locale_path)
 
     @property
-    def pofiles(self) -> GeneratorTuplestr, str, None, None:
+    def pofiles(self) -> Generatortuplestr, str, None, None:
         for locale_dir in self.locale_dirs:
             basedir = path.join(locale_dir, self.language, 'LC_MESSAGES')
             for root, dirnames, filenames in os.walk(basedir):
@@ -119,7 +113,7 @@
             yield CatalogInfo(basedir, domain, self.encoding)
 
 
-def docname_to_domain(docname: str, compaction: Unionbool, str) -> str:
+def docname_to_domain(docname: str, compaction: bool | str) -> str:
     """Convert docname to domain for catalogs."""
     if isinstance(compaction, str):
         return compaction
@@ -173,11 +167,8 @@
 date_format_re = re.compile('(%s)' % '|'.join(date_format_mappings))
 
 
-def babel_format_date(date: datetime, format: str, locale: Optionalstr,
+def babel_format_date(date: datetime, format: str, locale: str,
                       formatter: Callable = babel.dates.format_date) -> str:
-    if locale is None:
-        locale = 'en'
-
     # Check if we have the tzinfo attribute. If not we cannot do any time
     # related formats.
     if not hasattr(date, 'tzinfo'):
@@ -194,7 +185,9 @@
         return format
 
 
-def format_date(format: str, date: datetime = None, language: Optionalstr = None) -> str:
+def format_date(
+    format: str, *, date: datetime | None = None, language: str,
+) -> str:
     if date is None:
         # If time is not specified, try to use $SOURCE_DATE_EPOCH variable
         # See https://wiki.debian.org/ReproducibleBuilds/TimestampsProposal
@@ -228,12 +221,9 @@
     return "".join(result)
 
 
-def get_image_filename_for_language(filename: str, env: "BuildEnvironment") -> str:
-    if not env.config.language:
-        return filename
-
+def get_image_filename_for_language(filename: str, env: BuildEnvironment) -> str:
     filename_format = env.config.figure_language_filename
-    d = dict()
+    d = {}
     d'root', d'ext' = path.splitext(filename)
     dirname = path.dirname(d'root')
     if dirname and not dirname.endswith(path.sep):
@@ -251,10 +241,7 @@
         raise SphinxError('Invalid figure_language_filename: %r' % exc) from exc
 
 
-def search_image_for_language(filename: str, env: "BuildEnvironment") -> str:
-    if not env.config.language:
-        return filename
-
+def search_image_for_language(filename: str, env: BuildEnvironment) -> str:
     translated = get_image_filename_for_language(filename, env)
     _, abspath = env.relfn2path(translated)
     if path.exists(abspath):

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/images.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/images.py Changed

@@ -1,35 +1,31 @@
-"""
-    sphinx.util.images
-    ~~~~~~~~~~~~~~~~~~
+"""Image utility functions for Sphinx."""
 
-    Image utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import base64
-import imghdr
-from collections import OrderedDict
 from os import path
-from typing import IO, BinaryIO, NamedTuple, Optional, Tuple
+from typing import TYPE_CHECKING, NamedTuple
 
 import imagesize
 
+if TYPE_CHECKING:
+    from os import PathLike
+
 try:
     from PIL import Image
 except ImportError:
     Image = None
 
-mime_suffixes = OrderedDict(
-    ('.gif', 'image/gif'),
-    ('.jpg', 'image/jpeg'),
-    ('.png', 'image/png'),
-    ('.pdf', 'application/pdf'),
-    ('.svg', 'image/svg+xml'),
-    ('.svgz', 'image/svg+xml'),
-    ('.ai', 'application/illustrator'),
-)
+mime_suffixes = {
+    '.gif': 'image/gif',
+    '.jpg': 'image/jpeg',
+    '.png': 'image/png',
+    '.pdf': 'application/pdf',
+    '.svg': 'image/svg+xml',
+    '.svgz': 'image/svg+xml',
+    '.ai': 'application/illustrator',
+}
+_suffix_from_mime = {v: k for k, v in reversed(mime_suffixes.items())}
 
 
 class DataURI(NamedTuple):
@@ -38,7 +34,7 @@
     data: bytes
 
 
-def get_image_size(filename: str) -> OptionalTupleint, int:
+def get_image_size(filename: str) -> tupleint, int | None:
     try:
         size = imagesize.get(filename)
         if size0 == -1:
@@ -55,34 +51,28 @@
         return None
 
 
-def guess_mimetype_for_stream(stream: IO, default: Optionalstr = None) -> Optionalstr:
-    imgtype = imghdr.what(stream)
-    if imgtype:
-        return 'image/' + imgtype
-    else:
-        return default
-
-
-def guess_mimetype(filename: str = '', default: Optionalstr = None) -> Optionalstr:
-    _, ext = path.splitext(filename.lower())
+def guess_mimetype(
+    filename: PathLikestr | str = '',
+    default: str | None = None,
+) -> str | None:
+    ext = path.splitext(filename)1.lower()
     if ext in mime_suffixes:
         return mime_suffixesext
-    elif path.exists(filename):
-        with open(filename, 'rb') as f:
-            return guess_mimetype_for_stream(f, default=default)
-
+    if path.exists(filename):
+        try:
+            imgtype = _image_type_from_file(filename)
+        except ValueError:
+            pass
+        else:
+            return 'image/' + imgtype
     return default
 
 
-def get_image_extension(mimetype: str) -> Optionalstr:
-    for ext, _mimetype in mime_suffixes.items():
-        if mimetype == _mimetype:
-            return ext
-
-    return None
+def get_image_extension(mimetype: str) -> str | None:
+    return _suffix_from_mime.get(mimetype)
 
 
-def parse_data_uri(uri: str) -> OptionalDataURI:
+def parse_data_uri(uri: str) -> DataURI | None:
     if not uri.startswith('data:'):
         return None
 
@@ -103,17 +93,43 @@
     return DataURI(mimetype, charset, image_data)
 
 
-def test_svg(h: bytes, f: OptionalBinaryIO) -> Optionalstr:
-    """An additional imghdr library helper; test the header is SVG's or not."""
-    try:
-        if '<svg' in h.decode().lower():
-            return 'svg+xml'
-    except UnicodeDecodeError:
-        pass
+def _image_type_from_file(filename: PathLikestr | str) -> str:
+    with open(filename, 'rb') as f:
+        header = f.read(32)  # 32 bytes
+
+    # Bitmap
+    # https://en.wikipedia.org/wiki/BMP_file_format#Bitmap_file_header
+    if header.startswith(b'BM'):
+        return 'bmp'
+
+    # GIF
+    # https://en.wikipedia.org/wiki/GIF#File_format
+    if header.startswith((b'GIF87a', b'GIF89a')):
+        return 'gif'
+
+    # JPEG data
+    # https://en.wikipedia.org/wiki/JPEG_File_Interchange_Format#File_format_structure
+    if header.startswith(b'\xFF\xD8'):
+        return 'jpeg'
+
+    # Portable Network Graphics
+    # https://en.wikipedia.org/wiki/PNG#File_header
+    if header.startswith(b'\x89PNG\r\n\x1A\n'):
+        return 'png'
+
+    # Scalable Vector Graphics
+    # https://svgwg.org/svg2-draft/struct.html
+    if b'<svg' in header.lower():
+        return 'svg+xml'
 
-    return None
+    # TIFF
+    # https://en.wikipedia.org/wiki/TIFF#Byte_order
+    if header.startswith((b'MM', b'II')):
+        return 'tiff'
 
+    # WebP
+    # https://en.wikipedia.org/wiki/WebP#Technology
+    if header.startswith(b'RIFF') and header8:12 == b'WEBP':
+        return 'webp'
 
-# install test_svg() to imghdr
-# refs: https://docs.python.org/3.6/library/imghdr.html#imghdr.tests
-imghdr.tests.append(test_svg)
+    raise ValueError('Could not detect image type!')

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/inspect.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/inspect.py Changed

@@ -1,13 +1,8 @@
-"""
-    sphinx.util.inspect
-    ~~~~~~~~~~~~~~~~~~~
+"""Helpers for inspecting Python modules."""
 
-    Helpers for inspecting Python modules.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import ast
 import builtins
 import contextlib
 import enum
@@ -16,100 +11,35 @@
 import sys
 import types
 import typing
-import warnings
-from functools import partial, partialmethod
+from functools import cached_property, partial, partialmethod, singledispatchmethod
 from importlib import import_module
-from inspect import Parameter, isclass, ismethod, ismethoddescriptor, ismodule  # NOQA
+from inspect import (  # noqa: F401
+    Parameter,
+    isasyncgenfunction,
+    isclass,
+    ismethod,
+    ismethoddescriptor,
+    ismodule,
+)
 from io import StringIO
-from types import ModuleType
-from typing import Any, Callable, Dict, Mapping, Optional, Sequence, Tuple, Type, cast
+from types import (
+    ClassMethodDescriptorType,
+    MethodDescriptorType,
+    MethodType,
+    ModuleType,
+    WrapperDescriptorType,
+)
+from typing import Any, Callable, Dict, Mapping, Sequence, cast
 
-from sphinx.deprecation import RemovedInSphinx50Warning
-from sphinx.pycode.ast import ast  # for py36-37
 from sphinx.pycode.ast import unparse as ast_unparse
 from sphinx.util import logging
-from sphinx.util.typing import ForwardRef
-from sphinx.util.typing import stringify as stringify_annotation
-
-if sys.version_info > (3, 7):
-    from types import ClassMethodDescriptorType, MethodDescriptorType, WrapperDescriptorType
-else:
-    ClassMethodDescriptorType = type(object.__init__)
-    MethodDescriptorType = type(str.join)
-    WrapperDescriptorType = type(dict.__dict__'fromkeys')
-
-if False:
-    # For type annotation
-    from typing import Type  # NOQA
+from sphinx.util.typing import ForwardRef, stringify_annotation
 
 logger = logging.getLogger(__name__)
 
 memory_address_re = re.compile(r' at 0x0-9a-f{8,16}(?=>)', re.IGNORECASE)
 
 
-# Copied from the definition of inspect.getfullargspec from Python master,
-# and modified to remove the use of special flags that break decorated
-# callables and bound methods in the name of backwards compatibility. Used
-# under the terms of PSF license v2, which requires the above statement
-# and the following:
-#
-#   Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
-#   2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017 Python Software
-#   Foundation; All Rights Reserved
-def getargspec(func: Callable) -> Any:
-    """Like inspect.getfullargspec but supports bound methods, and wrapped
-    methods."""
-    warnings.warn('sphinx.ext.inspect.getargspec() is deprecated',
-                  RemovedInSphinx50Warning, stacklevel=2)
-
-    sig = inspect.signature(func)
-
-    args = 
-    varargs = None
-    varkw = None
-    kwonlyargs = 
-    defaults = ()
-    annotations = {}
-    defaults = ()
-    kwdefaults = {}
-
-    if sig.return_annotation is not sig.empty:
-        annotations'return' = sig.return_annotation
-
-    for param in sig.parameters.values():
-        kind = param.kind
-        name = param.name
-
-        if kind is Parameter.POSITIONAL_ONLY:
-            args.append(name)
-        elif kind is Parameter.POSITIONAL_OR_KEYWORD:
-            args.append(name)
-            if param.default is not param.empty:
-                defaults += (param.default,)  # type: ignore
-        elif kind is Parameter.VAR_POSITIONAL:
-            varargs = name
-        elif kind is Parameter.KEYWORD_ONLY:
-            kwonlyargs.append(name)
-            if param.default is not param.empty:
-                kwdefaultsname = param.default
-        elif kind is Parameter.VAR_KEYWORD:
-            varkw = name
-
-        if param.annotation is not param.empty:
-            annotationsname = param.annotation
-
-    if not kwdefaults:
-        # compatibility with 'func.__kwdefaults__'
-        kwdefaults = None
-
-    if not defaults:
-        # compatibility with 'func.__defaults__'
-        defaults = None
-
-    return inspect.FullArgSpec(args, varargs, varkw, defaults,
-                               kwonlyargs, kwdefaults, annotations)
-
-
 def unwrap(obj: Any) -> Any:
     """Get an original object from wrapped object (wrapped functions)."""
     try:
@@ -123,7 +53,7 @@
         return obj
 
 
-def unwrap_all(obj: Any, *, stop: Callable = None) -> Any:
+def unwrap_all(obj: Any, *, stop: Callable | None = None) -> Any:
     """
     Get an original object from wrapped object (unwrapping partials, wrapped
     functions, and other decorators).
@@ -131,19 +61,17 @@
     while True:
         if stop and stop(obj):
             return obj
-        elif ispartial(obj):
+        if ispartial(obj):
             obj = obj.func
         elif inspect.isroutine(obj) and hasattr(obj, '__wrapped__'):
-            obj = obj.__wrapped__  # type: ignore
-        elif isclassmethod(obj):
-            obj = obj.__func__
-        elif isstaticmethod(obj):
+            obj = obj.__wrapped__
+        elif isclassmethod(obj) or isstaticmethod(obj):
             obj = obj.__func__
         else:
             return obj
 
 
-def getall(obj: Any) -> OptionalSequencestr:
+def getall(obj: Any) -> Sequencestr | None:
     """Get __all__ attribute of the module as dict.
 
     Return None if given *obj* does not have __all__.
@@ -177,16 +105,16 @@
         return {}
 
 
-def getmro(obj: Any) -> TupleType, ...:
+def getmro(obj: Any) -> tupletype, ...:
     """Get __mro__ from given *obj* safely."""
     __mro__ = safe_getattr(obj, '__mro__', None)
     if isinstance(__mro__, tuple):
         return __mro__
     else:
-        return tuple()
+        return ()
 
 
-def getorigbases(obj: Any) -> OptionalTupleAny, ...:
+def getorigbases(obj: Any) -> tupleAny, ... | None:
     """Get __orig_bases__ from *obj* safely."""
     if not inspect.isclass(obj):
         return None
@@ -201,7 +129,7 @@
         return None
 
 
-def getslots(obj: Any) -> OptionalDict:
+def getslots(obj: Any) -> dict | None:
     """Get __slots__ attribute of the class as dict.
 
     Return None if gienv *obj* does not have __slots__.
@@ -226,15 +154,12 @@
 
 def isNewType(obj: Any) -> bool:
     """Check the if object is a kind of NewType."""
-    if sys.version_info >= (3, 10):
+    if sys.version_info:2 >= (3, 10):
         return isinstance(obj, typing.NewType)
     else:
         __module__ = safe_getattr(obj, '__module__', None)
         __qualname__ = safe_getattr(obj, '__qualname__', None)
-        if __module__ == 'typing' and __qualname__ == 'NewType.<locals>.new_type':
-            return True
-        else:
-            return False
+        return __module__ == 'typing' and __qualname__ == 'NewType.<locals>.new_type'
 
 
 def isenumclass(x: Any) -> bool:
@@ -263,13 +188,13 @@
     return isinstance(obj, (partial, partialmethod))
 
 
-def isclassmethod(obj: Any, cls: Any = None, name: str = None) -> bool:
+def isclassmethod(obj: Any, cls: Any = None, name: str | None = None) -> bool:
     """Check if the object is classmethod."""
     if isinstance(obj, classmethod):
         return True
-    elif inspect.ismethod(obj) and obj.__self__ is not None and isclass(obj.__self__):
+    if inspect.ismethod(obj) and obj.__self__ is not None and isclass(obj.__self__):
         return True
-    elif cls and name:
+    if cls and name:
         placeholder = object()
         for basecls in getmro(cls):
             meth = basecls.__dict__.get(name, placeholder)
@@ -279,7 +204,7 @@
     return False
 
 
-def isstaticmethod(obj: Any, cls: Any = None, name: str = None) -> bool:
+def isstaticmethod(obj: Any, cls: Any = None, name: str | None = None) -> bool:
     """Check if the object is staticmethod."""
     if isinstance(obj, staticmethod):
         return True
@@ -290,20 +215,17 @@
         for basecls in getattr(cls, '__mro__', cls):
             meth = basecls.__dict__.get(name)
             if meth:
-                if isinstance(meth, staticmethod):
-                    return True
-                else:
-                    return False
+                return isinstance(meth, staticmethod)
 
     return False
 
 
 def isdescriptor(x: Any) -> bool:
     """Check if the object is some kind of descriptor."""
-    for item in '__get__', '__set__', '__delete__':
-        if callable(safe_getattr(x, item, None)):
-            return True
-    return False
+    return any(
+        callable(safe_getattr(x, item, None))
+        for item in '__get__', '__set__', '__delete__'
+    )
 
 
 def isabstractmethod(obj: Any) -> bool:
@@ -311,6 +233,11 @@
     return safe_getattr(obj, '__isabstractmethod__', False) is True
 
 
+def isboundmethod(method: MethodType) -> bool:
+    """Check if the method is a bound method."""
+    return safe_getattr(method, '__self__', None) is not None
+
+
 def is_cython_function_or_method(obj: Any) -> bool:
     """Check if the object is a function or method in cython."""
     try:
@@ -324,50 +251,41 @@
     if inspect.isdatadescriptor(obj):
         # data descriptor is kind of attribute
         return True
-    elif isdescriptor(obj):
+    if isdescriptor(obj):
         # non data descriptor
         unwrapped = unwrap(obj)
         if isfunction(unwrapped) or isbuiltin(unwrapped) or inspect.ismethod(unwrapped):
             # attribute must not be either function, builtin and method
             return False
-        elif is_cython_function_or_method(unwrapped):
+        if is_cython_function_or_method(unwrapped):
             # attribute must not be either function and method (for cython)
             return False
-        elif inspect.isclass(unwrapped):
+        if inspect.isclass(unwrapped):
             # attribute must not be a class
             return False
-        elif isinstance(unwrapped, (ClassMethodDescriptorType,
-                                    MethodDescriptorType,
-                                    WrapperDescriptorType)):
+        if isinstance(unwrapped, (ClassMethodDescriptorType,
+                                  MethodDescriptorType,
+                                  WrapperDescriptorType)):
             # attribute must not be a method descriptor
             return False
-        elif type(unwrapped).__name__ == "instancemethod":
+        if type(unwrapped).__name__ == "instancemethod":
             # attribute must not be an instancemethod (C-API)
             return False
-        else:
-            return True
-    else:
-        return False
+        return True
+    return False
 
 
 def is_singledispatch_function(obj: Any) -> bool:
     """Check if the object is singledispatch function."""
-    if (inspect.isfunction(obj) and
+    return (inspect.isfunction(obj) and
             hasattr(obj, 'dispatch') and
             hasattr(obj, 'register') and
-            obj.dispatch.__module__ == 'functools'):  # type: ignore
-        return True
-    else:
-        return False
+            obj.dispatch.__module__ == 'functools')
 
 
 def is_singledispatch_method(obj: Any) -> bool:
     """Check if the object is singledispatch method."""
-    try:
-        from functools import singledispatchmethod  # type: ignore
-        return isinstance(obj, singledispatchmethod)
-    except ImportError:  # py36-37
-        return False
+    return isinstance(obj, singledispatchmethod)
 
 
 def isfunction(obj: Any) -> bool:
@@ -393,53 +311,28 @@
             # staticmethod, classmethod and partial method are not a wrapped coroutine-function
             # Note: Since 3.10, staticmethod and classmethod becomes a kind of wrappers
             return False
-        elif hasattr(obj, '__wrapped__'):
-            return True
-        else:
-            return False
+        return hasattr(obj, '__wrapped__')
 
     obj = unwrap_all(obj, stop=iswrappedcoroutine)
-    if hasattr(obj, '__code__') and inspect.iscoroutinefunction(obj):
-        # check obj.__code__ because iscoroutinefunction() crashes for custom method-like
-        # objects (see https://github.com/sphinx-doc/sphinx/issues/6605)
-        return True
-    else:
-        return False
-
-
-def isasyncgenfunction(obj: Any) -> bool:
-    """Check if the object is async-gen function."""
-    if hasattr(obj, '__code__') and inspect.isasyncgenfunction(obj):
-        # check obj.__code__ because isasyncgenfunction() crashes for custom method-like
-        # objects on python3.7 (see https://github.com/sphinx-doc/sphinx/issues/9838)
-        return True
-    else:
-        return False
+    return inspect.iscoroutinefunction(obj)
 
 
 def isproperty(obj: Any) -> bool:
     """Check if the object is property."""
-    if sys.version_info >= (3, 8):
-        from functools import cached_property  # cached_property is available since py3.8
-        if isinstance(obj, cached_property):
-            return True
-
-    return isinstance(obj, property)
+    return isinstance(obj, (property, cached_property))
 
 
 def isgenericalias(obj: Any) -> bool:
     """Check if the object is GenericAlias."""
-    if (hasattr(typing, '_GenericAlias') and  # only for py37+
-            isinstance(obj, typing._GenericAlias)):  # type: ignore
+    if isinstance(obj, typing._GenericAlias):  # type: ignore
         return True
-    elif (hasattr(types, 'GenericAlias') and  # only for py39+
-          isinstance(obj, types.GenericAlias)):  # type: ignore
+    if (hasattr(types, 'GenericAlias')  # only for py39+
+            and isinstance(obj, types.GenericAlias)):
         return True
-    elif (hasattr(typing, '_SpecialGenericAlias') and  # for py39+
-            isinstance(obj, typing._SpecialGenericAlias)):  # type: ignore
+    if (hasattr(typing, '_SpecialGenericAlias')  # for py39+
+            and isinstance(obj, typing._SpecialGenericAlias)):
         return True
-    else:
-        return False
+    return False
 
 
 def safe_getattr(obj: Any, name: str, *defargs: Any) -> Any:
@@ -492,7 +385,7 @@
             return "frozenset({%s})" % ", ".join(object_description(x)
                                                  for x in sorted_values)
     elif isinstance(object, enum.Enum):
-        return "%s.%s" % (object.__class__.__name__, object.name)
+        return f"{object.__class__.__name__}.{object.name}"
 
     try:
         s = repr(object)
@@ -555,15 +448,21 @@
     def __eq__(self, other: Any) -> bool:
         return self.name == other
 
+    def __hash__(self) -> int:
+        return hash(self.name)
+
+    def __repr__(self) -> str:
+        return self.name
+
 
 class TypeAliasModule:
     """Pseudo module class for autodoc_type_aliases."""
 
-    def __init__(self, modname: str, mapping: Dictstr, str) -> None:
+    def __init__(self, modname: str, mapping: dictstr, str) -> None:
         self.__modname = modname
         self.__mapping = mapping
 
-        self.__module: OptionalModuleType = None
+        self.__module: ModuleType | None = None
 
     def __getattr__(self, name: str) -> Any:
         fullname = '.'.join(filter(None, self.__modname, name))
@@ -595,7 +494,7 @@
     This enables to look up nested modules and classes like `mod1.mod2.Class`.
     """
 
-    def __init__(self, mapping: Dictstr, str) -> None:
+    def __init__(self, mapping: dictstr, str) -> None:
         self.__mapping = mapping
 
     def __getitem__(self, key: str) -> Any:
@@ -623,40 +522,23 @@
     return False
 
 
-def signature(subject: Callable, bound_method: bool = False, follow_wrapped: bool = None,
-              type_aliases: Dict = {}) -> inspect.Signature:
+def signature(subject: Callable, bound_method: bool = False, type_aliases: dict = {},
+              ) -> inspect.Signature:
     """Return a Signature object for the given *subject*.
 
     :param bound_method: Specify *subject* is a bound method or not
-    :param follow_wrapped: Same as ``inspect.signature()``.
     """
 
-    if follow_wrapped is None:
-        follow_wrapped = True
-    else:
-        warnings.warn('The follow_wrapped argument of sphinx.util.inspect.signature() is '
-                      'deprecated', RemovedInSphinx50Warning, stacklevel=2)
-
     try:
-        try:
-            if _should_unwrap(subject):
-                signature = inspect.signature(subject)
-            else:
-                signature = inspect.signature(subject, follow_wrapped=follow_wrapped)
-        except ValueError:
-            # follow built-in wrappers up (ex. functools.lru_cache)
+        if _should_unwrap(subject):
             signature = inspect.signature(subject)
-        parameters = list(signature.parameters.values())
-        return_annotation = signature.return_annotation
-    except IndexError:
-        # Until python 3.6.4, cpython has been crashed on inspection for
-        # partialmethods not having any arguments.
-        # https://bugs.python.org/issue33009
-        if hasattr(subject, '_partialmethod'):
-            parameters = 
-            return_annotation = Parameter.empty
         else:
-            raise
+            signature = inspect.signature(subject, follow_wrapped=True)
+    except ValueError:
+        # follow built-in wrappers up (ex. functools.lru_cache)
+        signature = inspect.signature(subject)
+    parameters = list(signature.parameters.values())
+    return_annotation = signature.return_annotation
 
     try:
         # Resolve annotations using ``get_type_hints()`` and type_aliases.
@@ -696,17 +578,18 @@
                              __validate_parameters__=False)
 
 
-def evaluate_signature(sig: inspect.Signature, globalns: Dict = None, localns: Dict = None
+def evaluate_signature(sig: inspect.Signature, globalns: dict | None = None,
+                       localns: dict | None = None,
                        ) -> inspect.Signature:
     """Evaluate unresolved type annotations in a signature object."""
-    def evaluate_forwardref(ref: ForwardRef, globalns: Dict, localns: Dict) -> Any:
+    def evaluate_forwardref(ref: ForwardRef, globalns: dict, localns: dict) -> Any:
         """Evaluate a forward reference."""
-        if sys.version_info > (3, 9):
+        if sys.version_info:2 >= (3, 9):
             return ref._evaluate(globalns, localns, frozenset())
         else:
             return ref._evaluate(globalns, localns)
 
-    def evaluate(annotation: Any, globalns: Dict, localns: Dict) -> Any:
+    def evaluate(annotation: Any, globalns: dict, localns: dict) -> Any:
         """Evaluate unresolved type annotation."""
         try:
             if isinstance(annotation, str):
@@ -795,20 +678,21 @@
         # PEP-570: Separator for Positional Only Parameter: /
         args.append('/')
 
+    concatenated_args = ', '.join(args)
     if (sig.return_annotation is Parameter.empty or
             show_annotation is False or
             show_return_annotation is False):
-        return '(%s)' % ', '.join(args)
+        return f'({concatenated_args})'
     else:
         annotation = stringify_annotation(sig.return_annotation, mode)
-        return '(%s) -> %s' % (', '.join(args), annotation)
+        return f'({concatenated_args}) -> {annotation}'
 
 
 def signature_from_str(signature: str) -> inspect.Signature:
     """Create a Signature object from string."""
     code = 'def func' + signature + ': pass'
     module = ast.parse(code)
-    function = cast(ast.FunctionDef, module.body0)  # type: ignore
+    function = cast(ast.FunctionDef, module.body0)
 
     return signature_from_ast(function, code)
 
@@ -819,7 +703,7 @@
     defaults = list(args.defaults)
     params = 
     if hasattr(args, "posonlyargs"):
-        posonlyargs = len(args.posonlyargs)  # type: ignore
+        posonlyargs = len(args.posonlyargs)
         positionals = posonlyargs + len(args.args)
     else:
         posonlyargs = 0
@@ -829,7 +713,7 @@
         defaults.insert(0, Parameter.empty)  # type: ignore
 
     if hasattr(args, "posonlyargs"):
-        for i, arg in enumerate(args.posonlyargs):  # type: ignore
+        for i, arg in enumerate(args.posonlyargs):
             if defaultsi is Parameter.empty:
                 default = Parameter.empty
             else:
@@ -843,7 +727,9 @@
         if defaultsi + posonlyargs is Parameter.empty:
             default = Parameter.empty
         else:
-            default = DefaultValue(ast_unparse(defaultsi + posonlyargs, code))  # type: ignore  # NOQA
+            default = DefaultValue(
+                ast_unparse(defaultsi + posonlyargs, code),  # type: ignore
+            )
 
         annotation = ast_unparse(arg.annotation, code) or Parameter.empty
         params.append(Parameter(arg.arg, Parameter.POSITIONAL_OR_KEYWORD,
@@ -855,7 +741,10 @@
                                 annotation=annotation))
 
     for i, arg in enumerate(args.kwonlyargs):
-        default = ast_unparse(args.kw_defaultsi, code) or Parameter.empty  # type: ignore
+        if args.kw_defaultsi is None:
+            default = Parameter.empty
+        else:
+            default = DefaultValue(ast_unparse(args.kw_defaultsi, code))  # type: ignore
         annotation = ast_unparse(arg.annotation, code) or Parameter.empty
         params.append(Parameter(arg.arg, Parameter.KEYWORD_ONLY, default=default,
                                 annotation=annotation))
@@ -870,8 +759,13 @@
     return inspect.Signature(params, return_annotation=return_annotation)
 
 
-def getdoc(obj: Any, attrgetter: Callable = safe_getattr,
-           allow_inherited: bool = False, cls: Any = None, name: str = None) -> str:
+def getdoc(
+    obj: Any,
+    attrgetter: Callable = safe_getattr,
+    allow_inherited: bool = False,
+    cls: Any = None,
+    name: str | None = None,
+) -> str | None:
     """Get the docstring for the object.
 
     This tries to obtain the docstring for some kind of objects additionally:
@@ -880,7 +774,7 @@
     * inherited docstring
     * inherited decorated methods
     """
-    def getdoc_internal(obj: Any, attrgetter: Callable = safe_getattr) -> Optionalstr:
+    def getdoc_internal(obj: Any, attrgetter: Callable = safe_getattr) -> str | None:
         doc = attrgetter(obj, '__doc__', None)
         if isinstance(doc, str):
             return doc
@@ -891,7 +785,7 @@
         for basecls in getmro(cls):
             meth = basecls.__dict__.get(name)
             if meth and hasattr(meth, '__func__'):
-                doc = getdoc(meth.__func__)
+                doc: str | None = getdoc(meth.__func__)
                 if doc is not None or not allow_inherited:
                     return doc

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/inventory.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/inventory.py Changed

@@ -1,19 +1,13 @@
-"""
-    sphinx.util.inventory
-    ~~~~~~~~~~~~~~~~~~~~~
+"""Inventory utility functions for Sphinx."""
+from __future__ import annotations
 
-    Inventory utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
 import os
 import re
 import zlib
 from typing import IO, TYPE_CHECKING, Callable, Iterator
 
 from sphinx.util import logging
-from sphinx.util.typing import Inventory
+from sphinx.util.typing import Inventory, InventoryItem
 
 BUFSIZE = 16 * 1024
 logger = logging.getLogger(__name__)
@@ -120,8 +114,8 @@
 
         for line in stream.read_compressed_lines():
             # be careful to handle names with embedded spaces correctly
-            m = re.match(r'(?x)(.+?)\s+(\S+)\s+(-?\d+)\s+?(\S*)\s+(.*)',
-                         line.rstrip())
+            m = re.match(r'(.+?)\s+(\S+)\s+(-?\d+)\s+?(\S*)\s+(.*)',
+                         line.rstrip(), flags=re.VERBOSE)
             if not m:
                 continue
             name, type, prio, location, dispname = m.groups()
@@ -139,12 +133,12 @@
             if location.endswith('$'):
                 location = location:-1 + name
             location = join(uri, location)
-            invdata.setdefault(type, {})name = (projname, version,
-                                                  location, dispname)
+            inv_item: InventoryItem = projname, version, location, dispname
+            invdata.setdefault(type, {})name = inv_item
         return invdata
 
     @classmethod
-    def dump(cls, filename: str, env: "BuildEnvironment", builder: "Builder") -> None:
+    def dump(cls, filename: str, env: BuildEnvironment, builder: Builder) -> None:
         def escape(string: str) -> str:
             return re.sub("\\s+", " ", string)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/logging.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/logging.py Changed

@@ -1,18 +1,12 @@
-"""
-    sphinx.util.logging
-    ~~~~~~~~~~~~~~~~~~~
+"""Logging utility functions for Sphinx."""
 
-    Logging utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import logging
 import logging.handlers
 from collections import defaultdict
 from contextlib import contextmanager
-from typing import IO, TYPE_CHECKING, Any, Dict, Generator, List, Optional, Tuple, Type, Union
+from typing import IO, TYPE_CHECKING, Any, Generator
 
 from docutils import nodes
 from docutils.nodes import Node
@@ -20,6 +14,7 @@
 
 from sphinx.errors import SphinxWarning
 from sphinx.util.console import colorize
+from sphinx.util.osutil import abspath
 
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
@@ -28,8 +23,7 @@
 NAMESPACE = 'sphinx'
 VERBOSE = 15
 
-LEVEL_NAMES: Dictstr, int = defaultdict(lambda: logging.WARNING)
-LEVEL_NAMES.update({
+LEVEL_NAMES: defaultdictstr, int = defaultdict(lambda: logging.WARNING, {
     'CRITICAL': logging.CRITICAL,
     'SEVERE': logging.CRITICAL,
     'ERROR': logging.ERROR,
@@ -39,22 +33,20 @@
     'DEBUG': logging.DEBUG,
 })
 
-VERBOSITY_MAP: Dictint, int = defaultdict(lambda: 0)
-VERBOSITY_MAP.update({
+VERBOSITY_MAP: defaultdictint, int = defaultdict(lambda: logging.NOTSET, {
     0: logging.INFO,
     1: VERBOSE,
     2: logging.DEBUG,
 })
 
-COLOR_MAP = defaultdict(lambda: 'blue',
-                        {
-                            logging.ERROR: 'darkred',
-                            logging.WARNING: 'red',
-                            logging.DEBUG: 'darkgray'
-                        })
+COLOR_MAP: defaultdictint, str = defaultdict(lambda: 'blue', {
+    logging.ERROR: 'darkred',
+    logging.WARNING: 'red',
+    logging.DEBUG: 'darkgray',
+})
 
 
-def getLogger(name: str) -> "SphinxLoggerAdapter":
+def getLogger(name: str) -> SphinxLoggerAdapter:
     """Get logger wrapped by :class:`sphinx.util.logging.SphinxLoggerAdapter`.
 
     Sphinx logger always uses ``sphinx.*`` namespace to be independent from
@@ -76,7 +68,7 @@
     return SphinxLoggerAdapter(logger, {})
 
 
-def convert_serializable(records: Listlogging.LogRecord) -> None:
+def convert_serializable(records: listlogging.LogRecord) -> None:
     """Convert LogRecord serializable."""
     for r in records:
         # extract arguments to a message and clear them
@@ -85,7 +77,7 @@
 
         location = getattr(r, 'location', None)
         if isinstance(location, nodes.Node):
-            r.location = get_node_location(location)  # type: ignore
+            r.location = get_node_location(location)
 
 
 class SphinxLogRecord(logging.LogRecord):
@@ -97,7 +89,7 @@
         message = super().getMessage()
         location = getattr(self, 'location', None)
         if location:
-            message = '%s: %s%s' % (location, self.prefix, message)
+            message = f'{location}: {self.prefix}{message}'
         elif self.prefix not in message:
             message = self.prefix + message
 
@@ -125,7 +117,9 @@
     """LoggerAdapter allowing ``type`` and ``subtype`` keywords."""
     KEYWORDS = 'type', 'subtype', 'location', 'nonl', 'color', 'once'
 
-    def log(self, level: Unionint, str, msg: str, *args: Any, **kwargs: Any) -> None:  # type: ignore # NOQA
+    def log(  # type: ignoreoverride
+        self, level: int | str, msg: str, *args: Any, **kwargs: Any,
+    ) -> None:
         if isinstance(level, int):
             super().log(level, msg, *args, **kwargs)
         else:
@@ -135,7 +129,7 @@
     def verbose(self, msg: str, *args: Any, **kwargs: Any) -> None:
         self.log(VERBOSE, msg, *args, **kwargs)
 
-    def process(self, msg: str, kwargs: Dict) -> Tuplestr, Dict:  # type: ignore
+    def process(self, msg: str, kwargs: dict) -> tuplestr, dict:  # type: ignore
         extra = kwargs.setdefault('extra', {})
         for keyword in self.KEYWORDS:
             if keyword in kwargs:
@@ -170,7 +164,7 @@
 class MemoryHandler(logging.handlers.BufferingHandler):
     """Handler buffering all logs."""
 
-    buffer: Listlogging.LogRecord
+    buffer: listlogging.LogRecord
 
     def __init__(self) -> None:
         super().__init__(-1)
@@ -192,7 +186,7 @@
         finally:
             self.release()
 
-    def clear(self) -> Listlogging.LogRecord:
+    def clear(self) -> listlogging.LogRecord:
         buffer, self.buffer = self.buffer, 
         return buffer
 
@@ -342,7 +336,7 @@
 
 class LogCollector:
     def __init__(self) -> None:
-        self.logs: Listlogging.LogRecord = 
+        self.logs: listlogging.LogRecord = 
 
     @contextmanager
     def collect(self) -> GeneratorNone, None, None:
@@ -356,18 +350,15 @@
     """Filter error and warning messages."""
 
     def filter(self, record: logging.LogRecord) -> bool:
-        if record.levelno < logging.WARNING:
-            return True
-        else:
-            return False
+        return record.levelno < logging.WARNING
 
 
-def is_suppressed_warning(type: str, subtype: str, suppress_warnings: Liststr) -> bool:
+def is_suppressed_warning(type: str, subtype: str, suppress_warnings: liststr) -> bool:
     """Check whether the warning is suppressed or not."""
     if type is None:
         return False
 
-    subtarget: Optionalstr
+    subtarget: str | None
 
     for warning_type in suppress_warnings:
         if '.' in warning_type:
@@ -384,13 +375,13 @@
 class WarningSuppressor(logging.Filter):
     """Filter logs by `suppress_warnings`."""
 
-    def __init__(self, app: "Sphinx") -> None:
+    def __init__(self, app: Sphinx) -> None:
         self.app = app
         super().__init__()
 
     def filter(self, record: logging.LogRecord) -> bool:
-        type = getattr(record, 'type', None)
-        subtype = getattr(record, 'subtype', None)
+        type = getattr(record, 'type', '')
+        subtype = getattr(record, 'subtype', '')
 
         try:
             suppress_warnings = self.app.config.suppress_warnings
@@ -408,7 +399,7 @@
 class WarningIsErrorFilter(logging.Filter):
     """Raise exception if warning emitted."""
 
-    def __init__(self, app: "Sphinx") -> None:
+    def __init__(self, app: Sphinx) -> None:
         self.app = app
         super().__init__()
 
@@ -439,7 +430,7 @@
     """Disable WarningIsErrorFilter if this filter installed."""
 
     def filter(self, record: logging.LogRecord) -> bool:
-        record.skip_warningsiserror = True  # type: ignore
+        record.skip_warningsiserror = True
         return True
 
 
@@ -461,7 +452,7 @@
 
     def __init__(self, name: str = '') -> None:
         super().__init__(name)
-        self.messages: Dictstr, List = {}
+        self.messages: dictstr, list = {}
 
     def filter(self, record: logging.LogRecord) -> bool:
         once = getattr(record, 'once', '')
@@ -482,9 +473,9 @@
     * Make a instance of SphinxLogRecord
     * docname to path if location given
     """
-    LogRecordClass: Typelogging.LogRecord
+    LogRecordClass: typelogging.LogRecord
 
-    def __init__(self, app: "Sphinx") -> None:
+    def __init__(self, app: Sphinx) -> None:
         self.app = app
         super().__init__()
 
@@ -496,16 +487,17 @@
         location = getattr(record, 'location', None)
         if isinstance(location, tuple):
             docname, lineno = location
-            if docname and lineno:
-                record.location = '%s:%s' % (self.app.env.doc2path(docname), lineno)
-            elif docname:
-                record.location = '%s' % self.app.env.doc2path(docname)
+            if docname:
+                if lineno:
+                    record.location = f'{self.app.env.doc2path(docname)}:{lineno}'
+                else:
+                    record.location = f'{self.app.env.doc2path(docname)}'
             else:
                 record.location = None
         elif isinstance(location, nodes.Node):
             record.location = get_node_location(location)
         elif location and ':' not in location:
-            record.location = '%s' % self.app.env.doc2path(location)
+            record.location = f'{self.app.env.doc2path(location)}'
 
         return True
 
@@ -520,16 +512,17 @@
     LogRecordClass = SphinxWarningLogRecord
 
 
-def get_node_location(node: Node) -> Optionalstr:
-    (source, line) = get_source_line(node)
+def get_node_location(node: Node) -> str | None:
+    source, line = get_source_line(node)
+    if source:
+        source = abspath(source)
     if source and line:
-        return "%s:%s" % (source, line)
-    elif source:
-        return "%s:" % source
-    elif line:
-        return "<unknown>:%s" % line
-    else:
-        return None
+        return f"{source}:{line}"
+    if source:
+        return f"{source}:"
+    if line:
+        return f"<unknown>:{line}"
+    return None
 
 
 class ColorizeFormatter(logging.Formatter):
@@ -566,14 +559,14 @@
 
 class LastMessagesWriter:
     """Stream writer storing last 10 messages in memory to save trackback"""
-    def __init__(self, app: "Sphinx", stream: IO) -> None:
+    def __init__(self, app: Sphinx, stream: IO) -> None:
         self.app = app
 
     def write(self, data: str) -> None:
         self.app.messagelog.append(data)
 
 
-def setup(app: "Sphinx", status: IO, warning: IO) -> None:
+def setup(app: Sphinx, status: IO, warning: IO) -> None:
     """Setup root logger for Sphinx"""
     logger = logging.getLogger(NAMESPACE)
     logger.setLevel(logging.DEBUG)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/matching.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/matching.py Changed

@@ -1,17 +1,12 @@
-"""
-    sphinx.util.matching
-    ~~~~~~~~~~~~~~~~~~~~
+"""Pattern-matching utility functions for Sphinx."""
 
-    Pattern-matching utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import os.path
 import re
-from typing import Callable, Dict, Iterable, List, Match, Optional, Pattern
+from typing import Callable, Iterable, Iterator
 
-from sphinx.util.osutil import canon_path
+from sphinx.util.osutil import canon_path, path_stabilize
 
 
 def _translate_pattern(pat: str) -> str:
@@ -54,13 +49,15 @@
                     stuff = '^/' + stuff1:
                 elif stuff0 == '^':
                     stuff = '\\' + stuff
-                res = '%s%s' % (res, stuff)
+                res = f'{res}{stuff}'
         else:
             res += re.escape(c)
     return res + '$'
 
 
-def compile_matchers(patterns: Liststr) -> ListCallablestr, OptionalMatchstr:
+def compile_matchers(
+    patterns: Iterablestr,
+) -> listCallablestr, re.Matchstr | None:
     return re.compile(_translate_pattern(pat)).match for pat in patterns
 
 
@@ -71,9 +68,9 @@
           For example, "**/index.rst" matches with "index.rst"
     """
 
-    def __init__(self, patterns: Liststr) -> None:
-        expanded = pat3: for pat in patterns if pat.startswith('**/')
-        self.patterns = compile_matchers(patterns + expanded)
+    def __init__(self, exclude_patterns: Iterablestr) -> None:
+        expanded = pat3: for pat in exclude_patterns if pat.startswith('**/')
+        self.patterns = compile_matchers(list(exclude_patterns) + expanded)
 
     def __call__(self, string: str) -> bool:
         return self.match(string)
@@ -86,10 +83,10 @@
 DOTFILES = Matcher('**/.*')
 
 
-_pat_cache: Dictstr, Pattern = {}
+_pat_cache: dictstr, re.Pattern = {}
 
 
-def patmatch(name: str, pat: str) -> OptionalMatchstr:
+def patmatch(name: str, pat: str) -> re.Matchstr | None:
     """Return if name matches the regular expression (pattern)
     ``pat```. Adapted from fnmatch module."""
     if pat not in _pat_cache:
@@ -97,7 +94,7 @@
     return _pat_cachepat.match(name)
 
 
-def patfilter(names: Iterablestr, pat: str) -> Liststr:
+def patfilter(names: Iterablestr, pat: str) -> liststr:
     """Return the subset of the list ``names`` that match
     the regular expression (pattern) ``pat``.
 
@@ -107,3 +104,63 @@
         _pat_cachepat = re.compile(_translate_pattern(pat))
     match = _pat_cachepat.match
     return list(filter(match, names))
+
+
+def get_matching_files(
+    dirname: str,
+    include_patterns: Iterablestr = ("**",),
+    exclude_patterns: Iterablestr = (),
+) -> Iteratorstr:
+    """Get all file names in a directory, recursively.
+
+    Filter file names by the glob-style include_patterns and exclude_patterns.
+    The default values include all files ("**") and exclude nothing ("").
+
+    Only files matching some pattern in *include_patterns* are included, and
+    exclusions from *exclude_patterns* take priority over inclusions.
+
+    """
+    # dirname is a normalized absolute path.
+    dirname = os.path.normpath(os.path.abspath(dirname))
+
+    exclude_matchers = compile_matchers(exclude_patterns)
+    include_matchers = compile_matchers(include_patterns)
+
+    for root, dirs, files in os.walk(dirname, followlinks=True):
+        relative_root = os.path.relpath(root, dirname)
+        if relative_root == ".":
+            relative_root = ""  # suppress dirname for files on the target dir
+
+        # Filter files
+        included_files = 
+        for entry in sorted(files):
+            entry = path_stabilize(os.path.join(relative_root, entry))
+            keep = False
+            for matcher in include_matchers:
+                if matcher(entry):
+                    keep = True
+                    break  # break the inner loop
+
+            for matcher in exclude_matchers:
+                if matcher(entry):
+                    keep = False
+                    break  # break the inner loop
+
+            if keep:
+                included_files.append(entry)
+
+        # Filter directories
+        filtered_dirs = 
+        for dir_name in sorted(dirs):
+            normalised = path_stabilize(os.path.join(relative_root, dir_name))
+            for matcher in exclude_matchers:
+                if matcher(normalised):
+                    break  # break the inner loop
+            else:
+                # if the loop didn't break
+                filtered_dirs.append(dir_name)
+
+        dirs: = filtered_dirs
+
+        # Yield filtered files
+        yield from included_files

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/math.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/math.py Changed

@@ -1,23 +1,17 @@
-"""
-    sphinx.util.math
-    ~~~~~~~~~~~~~~~~
+"""Utility functions for math."""
 
-    Utility functions for math.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 from docutils import nodes
 
-from sphinx.builders.html import HTMLTranslator
+from sphinx.builders.html import HTML5Translator
 
 
-def get_node_equation_number(writer: HTMLTranslator, node: nodes.math_block) -> str:
+def get_node_equation_number(writer: HTML5Translator, node: nodes.math_block) -> str:
     if writer.builder.config.math_numfig and writer.builder.config.numfig:
         figtype = 'displaymath'
         if writer.builder.name == 'singlehtml':
-            key = "%s/%s" % (writer.docnames-1, figtype)
+            key = f"{writer.docnames-1}/{figtype}"
         else:
             key = figtype
 
@@ -28,7 +22,7 @@
         return node'number'
 
 
-def wrap_displaymath(text: str, label: str, numbering: bool) -> str:
+def wrap_displaymath(text: str, label: str | None, numbering: bool) -> str:
     def is_equation(part: str) -> str:
         return part.strip()
 
@@ -60,4 +54,5 @@
         for part in parts:
             equations.append('%s\\\\\n' % part.strip())
 
-    return '%s\n%s%s' % (begin, ''.join(equations), end)
+    concatenated_equations = ''.join(equations)
+    return f'{begin}\n{concatenated_equations}{end}'

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/nodes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/nodes.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.util.nodes
-    ~~~~~~~~~~~~~~~~~
+"""Docutils node-related utility functions for Sphinx."""
 
-    Docutils node-related utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import contextlib
 import re
 import unicodedata
-from typing import (TYPE_CHECKING, Any, Callable, Iterable, List, Optional, Set, Tuple, Type,
-                    Union, cast)
+from typing import TYPE_CHECKING, Any, Callable, Iterable
 
 from docutils import nodes
 from docutils.nodes import Element, Node
@@ -53,13 +47,14 @@
     A special value ``typing.Any`` matches any kind of node-attributes.  For example,
     following example searches ``reference`` node having ``refdomain`` attributes::
 
-        from typing import Any
+        from __future__ import annotations
+from typing import Any
         matcher = NodeMatcher(nodes.reference, refdomain=Any)
         doctree.findall(matcher)
         # => <reference ...>, <reference ...>, ...
     """
 
-    def __init__(self, *node_classes: TypeNode, **attrs: Any) -> None:
+    def __init__(self, *node_classes: typeNode, **attrs: Any) -> None:
         self.classes = node_classes
         self.attrs = attrs
 
@@ -96,7 +91,7 @@
     :param nodes.Node node: target node
     :return: full module dotted path
     """
-    return '{}.{}'.format(node.__module__, node.__class__.__name__)
+    return f'{node.__module__}.{node.__class__.__name__}'
 
 
 def repr_domxml(node: Node, length: int = 80) -> str:
@@ -158,7 +153,8 @@
 
     # workaround: literal_block under bullet list (#4913)
     if isinstance(node, nodes.literal_block) and node.source is None:
-        node.source = get_node_source(node)
+        with contextlib.suppress(ValueError):
+            node.source = get_node_source(node)
 
     # workaround: recommonmark-0.2.0 doesn't set rawsource attribute
     if not node.rawsource:
@@ -176,7 +172,10 @@
     ))):
         logger.debug('i18n PATCH: %r to have source and line: %s',
                      get_full_module_name(node), repr_domxml(node))
-        node.source = get_node_source(node) or ''
+        try:
+            node.source = get_node_source(node)
+        except ValueError:
+            node.source = ''
         node.line = 0  # need fix docutils to get `node.line`
         return
 
@@ -190,14 +189,6 @@
 )
 
 
-def is_pending_meta(node: Node) -> bool:
-    if (isinstance(node, nodes.pending) and
-       isinstance(node.details.get('nodes', None)0, addnodes.meta)):
-        return True
-    else:
-        return False
-
-
 def is_translatable(node: Node) -> bool:
     if isinstance(node, addnodes.translatable):
         return True
@@ -233,11 +224,7 @@
             return False
         return True
 
-    if is_pending_meta(node) or isinstance(node, addnodes.meta):
-        # docutils-0.17 or older
-        return True
-    elif isinstance(node, addnodes.docutils_meta):
-        # docutils-0.18+
+    if isinstance(node, nodes.meta):  # type: ignore
         return True
 
     return False
@@ -252,12 +239,9 @@
 IMAGE_TYPE_NODES = (
     nodes.image,
 )
-META_TYPE_NODES = (
-    addnodes.meta,
-)
 
 
-def extract_messages(doctree: Element) -> IterableTupleElement, str:
+def extract_messages(doctree: Element) -> IterabletupleElement, str:
     """Extract translatable messages from a document tree."""
     for node in doctree.findall(is_translatable):  # type: Element
         if isinstance(node, addnodes.translatable):
@@ -275,14 +259,7 @@
                 msg = '.. image:: %s' % node'uri'
             else:
                 msg = ''
-        elif isinstance(node, META_TYPE_NODES):
-            # docutils-0.17 or older
-            msg = node.rawcontent
-        elif isinstance(node, nodes.pending) and is_pending_meta(node):
-            # docutils-0.17 or older
-            msg = node.details'nodes'0.rawcontent
-        elif isinstance(node, addnodes.docutils_meta):
-            # docutils-0.18+
+        elif isinstance(node, nodes.meta):  # type: ignore
             msg = node"content"
         else:
             msg = node.rawsource.replace('\n', ' ').strip()
@@ -292,18 +269,18 @@
             yield node, msg
 
 
-def get_node_source(node: Element) -> Optionalstr:
+def get_node_source(node: Element) -> str:
     for pnode in traverse_parent(node):
         if pnode.source:
             return pnode.source
-    return None
+    raise ValueError("node source not found")
 
 
-def get_node_line(node: Element) -> Optionalint:
+def get_node_line(node: Element) -> int:
     for pnode in traverse_parent(node):
         if pnode.line:
             return pnode.line
-    return None
+    raise ValueError("node line not found")
 
 
 def traverse_parent(node: Element, cls: Any = None) -> IterableElement:
@@ -313,7 +290,7 @@
         node = node.parent
 
 
-def get_prev_node(node: Node) -> OptionalNode:
+def get_prev_node(node: Node) -> Node | None:
     pos = node.parent.index(node)
     if pos > 0:
         return node.parentpos - 1
@@ -321,7 +298,9 @@
         return None
 
 
-def traverse_translatable_index(doctree: Element) -> IterableTupleElement, List"IndexEntry":  # NOQA
+def traverse_translatable_index(
+    doctree: Element,
+) -> IterabletupleElement, listIndexEntry:
     """Traverse translatable index node from a document tree."""
     matcher = NodeMatcher(addnodes.index, inline=False)
     for node in doctree.findall(matcher):  # type: addnodes.index
@@ -332,7 +311,8 @@
         yield node, entries
 
 
-def nested_parse_with_titles(state: Any, content: StringList, node: Node) -> str:
+def nested_parse_with_titles(state: Any, content: StringList, node: Node,
+                             content_offset: int = 0) -> str:
     """Version of state.nested_parse() that allows titles and does not require
     titles to have the same decoration as the calling document.
 
@@ -345,7 +325,7 @@
     state.memo.title_styles = 
     state.memo.section_level = 0
     try:
-        return state.nested_parse(content, 0, node, match_titles=1)
+        return state.nested_parse(content, content_offset, node, match_titles=1)
     finally:
         state.memo.title_styles = surrounding_title_styles
         state.memo.section_level = surrounding_section_level
@@ -361,7 +341,7 @@
     return node.astext()
 
 
-def split_explicit_title(text: str) -> Tuplebool, str, str:
+def split_explicit_title(text: str) -> tuplebool, str, str:
     """Split role content into title and target, if given."""
     match = explicit_title_re.match(text)
     if match:
@@ -374,11 +354,11 @@
 
 
 
-def process_index_entry(entry: str, targetid: str
-                        ) -> ListTuplestr, str, str, str, Optionalstr:
+def process_index_entry(entry: str, targetid: str,
+                        ) -> listtuplestr, str, str, str, str | None:
     from sphinx.domains.python import pairindextypes
 
-    indexentries: ListTuplestr, str, str, str, Optionalstr = 
+    indexentries: listtuplestr, str, str, str, str | None = 
     entry = entry.strip()
     oentry = entry
     main = ''
@@ -413,14 +393,14 @@
     return indexentries
 
 
-def inline_all_toctrees(builder: "Builder", docnameset: Setstr, docname: str,
-                        tree: nodes.document, colorfunc: Callable, traversed: Liststr
+def inline_all_toctrees(builder: Builder, docnameset: setstr, docname: str,
+                        tree: nodes.document, colorfunc: Callable, traversed: liststr,
                         ) -> nodes.document:
     """Inline all toctrees in the *tree*.
 
     Record all docnames in *docnameset*, and output docnames with *colorfunc*.
     """
-    tree = cast(nodes.document, tree.deepcopy())
+    tree = tree.deepcopy()
     for toctreenode in list(tree.findall(addnodes.toctree)):
         newnodes = 
         includefiles = map(str, toctreenode'includefiles')
@@ -520,8 +500,8 @@
 }
 
 
-def make_id(env: "BuildEnvironment", document: nodes.document,
-            prefix: str = '', term: str = None) -> str:
+def make_id(env: BuildEnvironment, document: nodes.document,
+            prefix: str = '', term: str | None = None) -> str:
     """Generate an appropriate node_id for given *prefix* and *term*."""
     node_id = None
     if prefix:
@@ -546,19 +526,19 @@
     return node_id
 
 
-def find_pending_xref_condition(node: addnodes.pending_xref, condition: str
-                                ) -> OptionalElement:
+def find_pending_xref_condition(node: addnodes.pending_xref, condition: str,
+                                ) -> Element | None:
     """Pick matched pending_xref_condition node up from the pending_xref."""
     for subnode in node:
         if (isinstance(subnode, addnodes.pending_xref_condition) and
                 subnode.get('condition') == condition):
             return subnode
-    else:
-        return None
+    return None
 
 
-def make_refnode(builder: "Builder", fromdocname: str, todocname: str, targetid: str,
-                 child: UnionNode, ListNode, title: str = None) -> nodes.reference:
+def make_refnode(builder: Builder, fromdocname: str, todocname: str, targetid: str | None,
+                 child: Node | listNode, title: str | None = None,
+                 ) -> nodes.reference:
     """Shortcut to create a reference node."""
     node = nodes.reference('', '', internal=True)
     if fromdocname == todocname and targetid:
@@ -585,8 +565,9 @@
 
 
 def copy_source_info(src: Element, dst: Element) -> None:
-    dst.source = get_node_source(src)
-    dst.line = get_node_line(src)
+    with contextlib.suppress(ValueError):
+        dst.source = get_node_source(src)
+        dst.line = get_node_line(src)
 
 
 NON_SMARTQUOTABLE_PARENT_NODES = (
@@ -605,7 +586,7 @@
     for pnode in traverse_parent(node.parent):
         if isinstance(pnode, NON_SMARTQUOTABLE_PARENT_NODES):
             return False
-        elif pnode.get('support_smartquotes', None) is False:
+        if pnode.get('support_smartquotes', None) is False:
             return False
 
     if getattr(node, 'support_smartquotes', None) is False:
@@ -614,7 +595,7 @@
     return True
 
 
-def process_only_nodes(document: Node, tags: "Tags") -> None:
+def process_only_nodes(document: Node, tags: Tags) -> None:
     """Filter ``only`` nodes which do not match *tags*."""
     for node in document.findall(addnodes.only):
         try:
@@ -634,17 +615,16 @@
                 node.replace_self(nodes.comment())
 
 
-def _new_copy(self: Element) -> Element:
-    """monkey-patch Element.copy to copy the rawsource and line
-    for docutils-0.16 or older versions.
+def _copy_except__document(self: Element) -> Element:
+    """Monkey-patch ```nodes.Element.copy``` to not copy the ``_document``
+    attribute.
 
-    refs: https://sourceforge.net/p/docutils/patches/165/
+    xref: https://github.com/sphinx-doc/sphinx/issues/11116#issuecomment-1376767086
     """
-    newnode = self.__class__(self.rawsource, **self.attributes)
-    if isinstance(self, nodes.Element):
-        newnode.source = self.source
-        newnode.line = self.line
+    newnode = self.__class__(rawsource=self.rawsource, **self.attributes)
+    newnode.source = self.source
+    newnode.line = self.line
     return newnode
 
 
-nodes.Element.copy = _new_copy  # type: ignore
+nodes.Element.copy = _copy_except__document  # type: ignore

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/osutil.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/osutil.py Changed

@@ -1,12 +1,6 @@
-"""
-    sphinx.util.osutil
-    ~~~~~~~~~~~~~~~~~~
+"""Operating system-related utility functions for Sphinx."""
 
-    Operating system-related utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import contextlib
 import filecmp
@@ -14,12 +8,12 @@
 import re
 import shutil
 import sys
-import warnings
+import unicodedata
 from io import StringIO
 from os import path
-from typing import Any, Generator, Iterator, List, Optional, Type
+from typing import Any, Iterator
 
-from sphinx.deprecation import RemovedInSphinx50Warning
+from sphinx.deprecation import _deprecation_warning
 
 try:
     # for ALT Linux (#6712)
@@ -45,6 +39,12 @@
     return nativepath.replace(path.sep, SEP)
 
 
+def path_stabilize(filepath: str) -> str:
+    "Normalize path separator and unicode string"
+    new_path = canon_path(filepath)
+    return unicodedata.normalize('NFC', new_path)
+
+
 def relative_uri(base: str, to: str) -> str:
     """Return a relative URL from ``base`` to ``to``."""
     if to.startswith(SEP):
@@ -73,7 +73,7 @@
     os.makedirs(path, exist_ok=True)
 
 
-def mtimes_of_files(dirnames: Liststr, suffix: str) -> Iteratorfloat:
+def mtimes_of_files(dirnames: liststr, suffix: str) -> Iteratorfloat:
     for dirname in dirnames:
         for root, _dirs, files in os.walk(dirname):
             for sfile in files:
@@ -84,19 +84,6 @@
                         pass
 
 
-def movefile(source: str, dest: str) -> None:
-    """Move a file, removing the destination if it exists."""
-    warnings.warn('sphinx.util.osutil.movefile() is deprecated for removal. '
-                  'Please use os.replace() instead.',
-                  RemovedInSphinx50Warning, stacklevel=2)
-    if os.path.exists(dest):
-        try:
-            os.unlink(dest)
-        except OSError:
-            pass
-    os.rename(source, dest)
-
-
 def copytimes(source: str, dest: str) -> None:
     """Copy a file's modification times."""
     st = os.stat(source)
@@ -129,7 +116,7 @@
     return make_filename(project_suffix_re.sub('', project)).lower()
 
 
-def relpath(path: str, start: str = os.curdir) -> str:
+def relpath(path: str, start: str | None = os.curdir) -> str:
     """Return a relative filepath to *path* either from the current directory or
     from an optional *start* directory.
 
@@ -161,14 +148,26 @@
         return pathdir
 
 
+class _chdir:
+    """Remove this fall-back once support for Python 3.10 is removed."""
+    def __init__(self, target_dir: str, /):
+        self.path = target_dir
+        self._dirs: liststr = 
+
+    def __enter__(self):
+        self._dirs.append(os.getcwd())
+        os.chdir(self.path)
+
+    def __exit__(self, _exc_type, _exc_value, _traceback, /):
+        os.chdir(self._dirs.pop())
+
+
 @contextlib.contextmanager
-def cd(target_dir: str) -> GeneratorNone, None, None:
-    cwd = os.getcwd()
-    try:
-        os.chdir(target_dir)
+def cd(target_dir: str) -> IteratorNone:
+    if sys.version_info:2 >= (3, 11):
+        _deprecation_warning(__name__, 'cd', 'contextlib.chdir', remove=(8, 0))
+    with _chdir(target_dir):
         yield
-    finally:
-        os.chdir(cwd)
 
 
 class FileAvoidWrite:
@@ -185,7 +184,7 @@
     """
     def __init__(self, path: str) -> None:
         self._path = path
-        self._io: OptionalStringIO = None
+        self._io: StringIO | None = None
 
     def write(self, data: str) -> None:
         if not self._io:
@@ -211,10 +210,12 @@
         with open(self._path, 'w', encoding='utf-8') as f:
             f.write(buf)
 
-    def __enter__(self) -> "FileAvoidWrite":
+    def __enter__(self) -> FileAvoidWrite:
         return self
 
-    def __exit__(self, exc_type: TypeException, exc_value: Exception, traceback: Any) -> bool:  # NOQA
+    def __exit__(
+        self, exc_type: typeException, exc_value: Exception, traceback: Any,
+    ) -> bool:
         self.close()
         return True

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/parallel.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/parallel.py Changed

@@ -1,30 +1,24 @@
-"""
-    sphinx.util.parallel
-    ~~~~~~~~~~~~~~~~~~~~
+"""Parallel building utilities."""
 
-    Parallel building utilities.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import time
 import traceback
 from math import sqrt
-from typing import Any, Callable, Dict, List, Optional, Sequence
+from typing import Any, Callable, Sequence
 
 try:
     import multiprocessing
+    HAS_MULTIPROCESSING = True
 except ImportError:
-    multiprocessing = None
+    HAS_MULTIPROCESSING = False
 
 from sphinx.errors import SphinxParallelError
 from sphinx.util import logging
 
 logger = logging.getLogger(__name__)
 
-
 # our parallel functionality only works for the forking Process
 parallel_available = multiprocessing and os.name == 'posix'
 
@@ -35,7 +29,9 @@
     def __init__(self, nproc: int = 1) -> None:
         pass
 
-    def add_task(self, task_func: Callable, arg: Any = None, result_func: Callable = None) -> None:  # NOQA
+    def add_task(
+        self, task_func: Callable, arg: Any = None, result_func: Callable | None = None,
+    ) -> None:
         if arg is not None:
             res = task_func(arg)
         else:
@@ -53,15 +49,15 @@
     def __init__(self, nproc: int) -> None:
         self.nproc = nproc
         # (optional) function performed by each task on the result of main task
-        self._result_funcs: Dictint, Callable = {}
+        self._result_funcs: dictint, Callable = {}
         # task arguments
-        self._args: Dictint, OptionalListAny = {}
+        self._args: dictint, listAny | None = {}
         # list of subprocesses (both started and waiting)
-        self._procs: Dictint, multiprocessing.context.ForkProcess = {}
+        self._procs: dictint, Any = {}
         # list of receiving pipe connections of running subprocesses
-        self._precvs: Dictint, Any = {}
+        self._precvs: dictint, Any = {}
         # list of receiving pipe connections of waiting subprocesses
-        self._precvsWaiting: Dictint, Any = {}
+        self._precvsWaiting: dictint, Any = {}
         # number of working subprocesses
         self._pworking = 0
         # task number of each subprocess
@@ -83,13 +79,15 @@
         logging.convert_serializable(collector.logs)
         pipe.send((failed, collector.logs, ret))
 
-    def add_task(self, task_func: Callable, arg: Any = None, result_func: Callable = None) -> None:  # NOQA
+    def add_task(
+        self, task_func: Callable, arg: Any = None, result_func: Callable | None = None,
+    ) -> None:
         tid = self._taskid
         self._taskid += 1
         self._result_funcstid = result_func or (lambda arg, result: None)
         self._argstid = arg
         precv, psend = multiprocessing.Pipe(False)
-        context = multiprocessing.get_context('fork')
+        context: Any = multiprocessing.get_context('fork')
         proc = context.Process(target=self._process, args=(psend, task_func, arg))
         self._procstid = proc
         self._precvsWaitingtid = precv
@@ -100,10 +98,9 @@
             while self._pworking:
                 if not self._join_one():
                     time.sleep(0.02)
-        except Exception:
+        finally:
             # shutdown other child processes on failure
             self.terminate()
-            raise
 
     def terminate(self) -> None:
         for tid in list(self._precvs):
@@ -138,7 +135,7 @@
         return joined_any
 
 
-def make_chunks(arguments: Sequencestr, nproc: int, maxbatch: int = 10) -> ListAny:
+def make_chunks(arguments: Sequencestr, nproc: int, maxbatch: int = 10) -> listAny:
     # determine how many documents to read in one go
     nargs = len(arguments)
     chunksize = nargs // nproc

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/png.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/png.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/requests.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/requests.py Changed

@@ -1,73 +1,33 @@
-"""
-    sphinx.util.requests
-    ~~~~~~~~~~~~~~~~~~~~
+"""Simple requests package loader"""
 
-    Simple requests package loader
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import sys
 import warnings
 from contextlib import contextmanager
-from typing import Any, Generator, Union
+from typing import Any, Generator
 from urllib.parse import urlsplit
 
 import requests
+from urllib3.exceptions import InsecureRequestWarning
 
 import sphinx
 from sphinx.config import Config
-from sphinx.deprecation import RemovedInSphinx50Warning
-
-try:
-    from requests.packages.urllib3.exceptions import SSLError
-except ImportError:
-    # python-requests package in Debian jessie does not provide ``requests.packages.urllib3``.
-    # So try to import the exceptions from urllib3 package.
-    from urllib3.exceptions import SSLError
-
-try:
-    from requests.packages.urllib3.exceptions import InsecureRequestWarning
-except ImportError:
-    try:
-        # for Debian-jessie
-        from urllib3.exceptions import InsecureRequestWarning
-    except ImportError:
-        # for requests < 2.4.0
-        InsecureRequestWarning = None
-
 
 useragent_header = ('User-Agent',
                      'Mozilla/5.0 (X11; Linux x86_64; rv:25.0) Gecko/20100101 Firefox/25.0')
 
 
-def is_ssl_error(exc: Exception) -> bool:
-    """Check an exception is SSLError."""
-    warnings.warn(
-        "is_ssl_error() is outdated and likely returns incorrect results "
-        "for modern versions of Requests.",
-        RemovedInSphinx50Warning)
-    if isinstance(exc, SSLError):
-        return True
-    else:
-        args = getattr(exc, 'args', )
-        if args and isinstance(args0, SSLError):
-            return True
-        else:
-            return False
-
-
 @contextmanager
 def ignore_insecure_warning(**kwargs: Any) -> GeneratorNone, None, None:
     with warnings.catch_warnings():
-        if not kwargs.get('verify') and InsecureRequestWarning:
+        if not kwargs.get('verify'):
             # ignore InsecureRequestWarning if verify=False
             warnings.filterwarnings("ignore", category=InsecureRequestWarning)
         yield
 
 
-def _get_tls_cacert(url: str, config: Config) -> Unionstr, bool:
+def _get_tls_cacert(url: str, config: Config) -> str | bool:
     """Get additional CA cert for a specific URL.
 
     This also returns ``False`` if verification is disabled.

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/rst.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/rst.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.util.rst
-    ~~~~~~~~~~~~~~~
+"""reST helper functions."""
 
-    reST helper functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 from collections import defaultdict
 from contextlib import contextmanager
-from typing import Dict, Generator
+from typing import Generator
 from unicodedata import east_asian_width
 
 from docutils.parsers.rst import roles
@@ -36,7 +30,7 @@
 SECTIONING_CHARS = '=', '-', '~'
 
 # width of characters
-WIDECHARS: Dictstr, str = defaultdict(lambda: "WF")  # WF: Wide + Full-width
+WIDECHARS: dictstr, str = defaultdict(lambda: "WF")  # WF: Wide + Full-width
 WIDECHARS"ja" = "WFA"  # In Japanese, Ambiguous characters also have double width
 
 
@@ -63,7 +57,7 @@
     assert level <= 3
     width = textwidth(text, WIDECHARSenv.language)
     sectioning_char = SECTIONING_CHARSlevel - 1
-    return '%s\n%s' % (text, sectioning_char * width)
+    return f'{text}\n{sectioning_char * width}'
 
 
 @contextmanager
@@ -71,7 +65,7 @@
     if name:
         dummy_reporter = Reporter('', 4, 4)
         role_fn, _ = roles.role(name, english, 0, dummy_reporter)
-        if role_fn:
+        if role_fn:  # type: ignoretruthy-function
             docutils.register_role('', role_fn)
         else:
             logger.warning(__('default role %s not found'), name, location=docname)
@@ -106,7 +100,7 @@
 def append_epilog(content: StringList, epilog: str) -> None:
     """Append a string to content body as epilog."""
     if epilog:
-        if 0 < len(content):
+        if len(content) > 0:
             source, lineno = content.info(-1)
         else:
             source = '<generated>'

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/tags.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/tags.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/template.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/template.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.util.template
-    ~~~~~~~~~~~~~~~~~~~~
+"""Templates utility functions for Sphinx."""
 
-    Templates utility functions for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 from functools import partial
 from os import path
-from typing import Callable, Dict, List, Tuple, Union
+from typing import Any, Callable
 
 from jinja2 import TemplateNotFound
 from jinja2.environment import Environment
@@ -25,20 +19,20 @@
 
 
 class BaseRenderer:
-    def __init__(self, loader: BaseLoader = None) -> None:
+    def __init__(self, loader: BaseLoader | None = None) -> None:
         self.env = SandboxedEnvironment(loader=loader, extensions='jinja2.ext.i18n')
         self.env.filters'repr' = repr
         self.env.install_gettext_translations(get_translator())
 
-    def render(self, template_name: str, context: Dict) -> str:
+    def render(self, template_name: str, context: dictstr, Any) -> str:
         return self.env.get_template(template_name).render(context)
 
-    def render_string(self, source: str, context: Dict) -> str:
+    def render_string(self, source: str, context: dictstr, Any) -> str:
         return self.env.from_string(source).render(context)
 
 
 class FileRenderer(BaseRenderer):
-    def __init__(self, search_path: Unionstr, Liststr) -> None:
+    def __init__(self, search_path: str | liststr) -> None:
         if isinstance(search_path, str):
             search_path = search_path
         else:
@@ -49,25 +43,27 @@
         super().__init__(loader)
 
     @classmethod
-    def render_from_file(cls, filename: str, context: Dict) -> str:
+    def render_from_file(cls, filename: str, context: dictstr, Any) -> str:
         dirname = os.path.dirname(filename)
         basename = os.path.basename(filename)
         return cls(dirname).render(basename, context)
 
 
 class SphinxRenderer(FileRenderer):
-    def __init__(self, template_path: Unionstr, Liststr = None) -> None:
+    def __init__(self, template_path: None | str | liststr = None) -> None:
         if template_path is None:
             template_path = os.path.join(package_dir, 'templates')
         super().__init__(template_path)
 
     @classmethod
-    def render_from_file(cls, filename: str, context: Dict) -> str:
+    def render_from_file(cls, filename: str, context: dictstr, Any) -> str:
         return FileRenderer.render_from_file(filename, context)
 
 
 class LaTeXRenderer(SphinxRenderer):
-    def __init__(self, template_path: str = None, latex_engine: str = None) -> None:
+    def __init__(
+        self, template_path: str | None = None, latex_engine: str | None = None,
+    ) -> None:
         if template_path is None:
             template_path = os.path.join(package_dir, 'templates', 'latex')
         super().__init__(template_path)
@@ -89,7 +85,9 @@
 
 
 class ReSTRenderer(SphinxRenderer):
-    def __init__(self, template_path: Unionstr, Liststr = None, language: str = None) -> None:  # NOQA
+    def __init__(
+        self, template_path: None | str | liststr = None, language: str | None = None,
+    ) -> None:
         super().__init__(template_path)
 
         # add language to environment
@@ -104,8 +102,8 @@
 class SphinxTemplateLoader(BaseLoader):
     """A loader supporting template inheritance"""
 
-    def __init__(self, confdir: str, templates_paths: Liststr,
-                 system_templates_paths: Liststr) -> None:
+    def __init__(self, confdir: str, templates_paths: liststr,
+                 system_templates_paths: liststr) -> None:
         self.loaders = 
         self.sysloaders = 
 
@@ -118,7 +116,7 @@
             self.loaders.append(loader)
             self.sysloaders.append(loader)
 
-    def get_source(self, environment: Environment, template: str) -> Tuplestr, str, Callable:
+    def get_source(self, environment: Environment, template: str) -> tuplestr, str, Callable:
         if template.startswith('!'):
             # search a template from ``system_templates_paths``
             loaders = self.sysloaders

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/texescape.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/texescape.py Changed

@@ -1,15 +1,8 @@
-"""
-    sphinx.util.texescape
-    ~~~~~~~~~~~~~~~~~~~~~
+"""TeX escaping helper."""
 
-    TeX escaping helper.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
-from typing import Dict
 
 tex_replacements = 
     # map TeX special chars
@@ -100,15 +93,15 @@
 # %, {, }, \, #, and ~ are the only ones which must be replaced by _ character
 # It would be simpler to define it entirely here rather than in init().
 # Unicode replacements are superfluous, as idescape() uses backslashreplace
-tex_replace_map: Dictint, str = {}
+tex_replace_map: dictint, str = {}
 
-_tex_escape_map: Dictint, str = {}
-_tex_escape_map_without_unicode: Dictint, str = {}
-_tex_hlescape_map: Dictint, str = {}
-_tex_hlescape_map_without_unicode: Dictint, str = {}
+_tex_escape_map: dictint, str = {}
+_tex_escape_map_without_unicode: dictint, str = {}
+_tex_hlescape_map: dictint, str = {}
+_tex_hlescape_map_without_unicode: dictint, str = {}
 
 
-def escape(s: str, latex_engine: str = None) -> str:
+def escape(s: str, latex_engine: str | None = None) -> str:
     """Escape text for LaTeX output."""
     if latex_engine in ('lualatex', 'xelatex'):
         # unicode based LaTeX engine
@@ -117,7 +110,7 @@
         return s.translate(_tex_escape_map)
 
 
-def hlescape(s: str, latex_engine: str = None) -> str:
+def hlescape(s: str, latex_engine: str | None = None) -> str:
     """Escape text for LaTeX highlighter."""
     if latex_engine in ('lualatex', 'xelatex'):
         # unicode based LaTeX engine

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/util/typing.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/util/typing.py Changed

@@ -1,48 +1,21 @@
-"""
-    sphinx.util.typing
-    ~~~~~~~~~~~~~~~~~~
+"""The composite types for Sphinx."""
 
-    The composite types for Sphinx.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import sys
 import typing
 from struct import Struct
 from types import TracebackType
-from typing import Any, Callable, Dict, Generator, List, Optional, Tuple, Type, TypeVar, Union
+from typing import Any, Callable, Dict, ForwardRef, List, Tuple, TypeVar, Union
 
 from docutils import nodes
 from docutils.parsers.rst.states import Inliner
 
-from sphinx.deprecation import RemovedInSphinx60Warning, deprecated_alias
-
-if sys.version_info > (3, 7):
-    from typing import ForwardRef
-else:
-    from typing import _ForwardRef  # type: ignore
-
-    class ForwardRef:
-        """A pseudo ForwardRef class for py36."""
-        def __init__(self, arg: Any, is_argument: bool = True) -> None:
-            self.arg = arg
-
-        def _evaluate(self, globalns: Dict, localns: Dict) -> Any:
-            ref = _ForwardRef(self.arg)
-            return ref._eval_type(globalns, localns)
-
 try:
     from types import UnionType  # type: ignore  # python 3.10 or above
 except ImportError:
     UnionType = None
 
-if False:
-    # For type annotation
-    from typing import Type  # NOQA # for python3.5.1
-
-
 # builtin classes that have incorrect __module__
 INVALID_BUILTIN_CLASSES = {
     Struct: 'struct.Struct',  # Before Python 3.9
@@ -50,6 +23,14 @@
 }
 
 
+def is_invalid_builtin_class(obj: Any) -> bool:
+    """Check *obj* is an invalid built-in class."""
+    try:
+        return obj in INVALID_BUILTIN_CLASSES
+    except TypeError:  # unhashable type
+        return False
+
+
 # Text like nodes which are initialized with text and rawsource
 TextlikeNode = Unionnodes.Text, nodes.TextElement
 
@@ -70,12 +51,20 @@
 TitleGetter = Callablenodes.Node, str
 
 # inventory data on memory
-InventoryItem = Tuplestr, str, str, str
+InventoryItem = Tuple
+    str,  # project name
+    str,  # project version
+    str,  # URL
+    str,  # display name
+
 Inventory = Dictstr, Dictstr, InventoryItem
 
 
-def get_type_hints(obj: Any, globalns: Dict = None, localns: Dict = None) -> Dictstr, Any:
-    """Return a dictionary containing type hints for a function, method, module or class object.
+def get_type_hints(
+    obj: Any, globalns: dictstr, Any | None = None, localns: dict | None = None,
+) -> dictstr, Any:
+    """Return a dictionary containing type hints for a function, method, module or class
+    object.
 
     This is a simple wrapper of `typing.get_type_hints()` that does not raise an error on
     runtime.
@@ -105,7 +94,7 @@
     return modname == 'typing' and isinstance(typ, TypeVar)
 
 
-def restify(cls: OptionalType, mode: str = 'fully-qualified-except-typing') -> str:
+def restify(cls: type | None, mode: str = 'fully-qualified-except-typing') -> str:
     """Convert python class to a reST reference.
 
     :param mode: Specify a method how annotations will be stringified.
@@ -116,6 +105,7 @@
                  'smart'
                      Show the name of the annotation.
     """
+    from sphinx.ext.autodoc.mock import ismock, ismockmodule  # lazy loading
     from sphinx.util import inspect  # lazy loading
 
     if mode == 'smart':
@@ -130,12 +120,16 @@
             return '...'
         elif isinstance(cls, str):
             return cls
-        elif cls in INVALID_BUILTIN_CLASSES:
-            return ':py:class:`%s%s`' % (modprefix, INVALID_BUILTIN_CLASSEScls)
+        elif ismockmodule(cls):
+            return f':py:class:`{modprefix}{cls.__name__}`'
+        elif ismock(cls):
+            return f':py:class:`{modprefix}{cls.__module__}.{cls.__name__}`'
+        elif is_invalid_builtin_class(cls):
+            return f':py:class:`{modprefix}{INVALID_BUILTIN_CLASSEScls}`'
         elif inspect.isNewType(cls):
-            if sys.version_info > (3, 10):
+            if sys.version_info:2 >= (3, 10):
                 # newtypes have correct module info since Python 3.10+
-                return ':py:class:`%s%s.%s`' % (modprefix, cls.__module__, cls.__name__)
+                return f':py:class:`{modprefix}{cls.__module__}.{cls.__name__}`'
             else:
                 return ':py:class:`%s`' % cls.__name__
         elif UnionType and isinstance(cls, UnionType):
@@ -146,185 +140,84 @@
                 return ' | '.join(restify(a, mode) for a in cls.__args__)
         elif cls.__module__ in ('__builtin__', 'builtins'):
             if hasattr(cls, '__args__'):
-                return ':py:class:`%s`\\ %s' % (
-                    cls.__name__,
-                    ', '.join(restify(arg, mode) for arg in cls.__args__),
-                )
+                concatenated_args = ', '.join(restify(arg, mode) for arg in cls.__args__)
+                return fr':py:class:`{cls.__name__}`\ {concatenated_args}'
             else:
                 return ':py:class:`%s`' % cls.__name__
-        else:
-            if sys.version_info >= (3, 7):  # py37+
-                return _restify_py37(cls, mode)
+        elif (inspect.isgenericalias(cls)
+              and cls.__module__ == 'typing'
+              and cls.__origin__ is Union):  # type: ignoreattr-defined
+            if (len(cls.__args__) > 1  # type: ignoreattr-defined
+                    and cls.__args__-1 is NoneType):  # type: ignoreattr-defined
+                if len(cls.__args__) > 2:  # type: ignoreattr-defined
+                    args = ', '.join(restify(a, mode)
+                                     for a in cls.__args__:-1)  # type: ignoreattr-defined
+                    return ':py:obj:`~typing.Optional`\\ :obj:`~typing.Union`\\ %s' % args
+                else:
+                    return ':py:obj:`~typing.Optional`\\ %s' % restify(
+                        cls.__args__0, mode)  # type: ignoreattr-defined
             else:
-                return _restify_py36(cls, mode)
-    except (AttributeError, TypeError):
-        return inspect.object_description(cls)
-
-
-def _restify_py37(cls: OptionalType, mode: str = 'fully-qualified-except-typing') -> str:
-    """Convert python class to a reST reference."""
-    from sphinx.util import inspect  # lazy loading
-
-    if mode == 'smart':
-        modprefix = '~'
-    else:
-        modprefix = ''
-
-    if (inspect.isgenericalias(cls) and
-            cls.__module__ == 'typing' and cls.__origin__ is Union):
-        # Union
-        if len(cls.__args__) > 1 and cls.__args__-1 is NoneType:
-            if len(cls.__args__) > 2:
-                args = ', '.join(restify(a, mode) for a in cls.__args__:-1)
-                return ':py:obj:`~typing.Optional`\\ :obj:`~typing.Union`\\ %s' % args
+                args = ', '.join(restify(a, mode)
+                                 for a in cls.__args__)  # type: ignoreattr-defined
+                return ':py:obj:`~typing.Union`\\ %s' % args
+        elif inspect.isgenericalias(cls):
+            if isinstance(cls.__origin__, typing._SpecialForm):  # type: ignoreattr-defined
+                text = restify(cls.__origin__, mode)  # type: ignore
+            elif getattr(cls, '_name', None):
+                cls_name = cls._name  # type: ignoreattr-defined
+                if cls.__module__ == 'typing':
+                    text = f':py:class:`~{cls.__module__}.{cls_name}`'
+                else:
+                    text = f':py:class:`{modprefix}{cls.__module__}.{cls_name}`'
             else:
-                return ':py:obj:`~typing.Optional`\\ %s' % restify(cls.__args__0, mode)
-        else:
-            args = ', '.join(restify(a, mode) for a in cls.__args__)
-            return ':py:obj:`~typing.Union`\\ %s' % args
-    elif inspect.isgenericalias(cls):
-        if isinstance(cls.__origin__, typing._SpecialForm):
-            text = restify(cls.__origin__, mode)  # type: ignore
-        elif getattr(cls, '_name', None):
+                text = restify(cls.__origin__, mode)  # type: ignoreattr-defined
+
+            origin = getattr(cls, '__origin__', None)
+            if not hasattr(cls, '__args__'):  # NoQA: SIM114
+                pass
+            elif all(is_system_TypeVar(a) for a in cls.__args__):
+                # Suppress arguments if all system defined TypeVars (ex. DictKT, VT)
+                pass
+            elif (cls.__module__ == 'typing'
+                  and cls._name == 'Callable'):  # type: ignoreattr-defined
+                args = ', '.join(restify(a, mode) for a in cls.__args__:-1)
+                text += fr"\ {args}, {restify(cls.__args__-1, mode)}"
+            elif cls.__module__ == 'typing' and getattr(origin, '_name', None) == 'Literal':
+                text += r"\ %s" % ', '.join(repr(a) for a in cls.__args__)
+            elif cls.__args__:
+                text += r"\ %s" % ", ".join(restify(a, mode) for a in cls.__args__)
+
+            return text
+        elif isinstance(cls, typing._SpecialForm):
+            return f':py:obj:`~{cls.__module__}.{cls._name}`'  # type: ignoreattr-defined
+        elif sys.version_info:2 >= (3, 11) and cls is typing.Any:
+            # handle bpo-46998
+            return f':py:obj:`~{cls.__module__}.{cls.__name__}`'
+        elif hasattr(cls, '__qualname__'):
             if cls.__module__ == 'typing':
-                text = ':py:class:`~%s.%s`' % (cls.__module__, cls._name)
+                return f':py:class:`~{cls.__module__}.{cls.__qualname__}`'
             else:
-                text = ':py:class:`%s%s.%s`' % (modprefix, cls.__module__, cls._name)
-        else:
-            text = restify(cls.__origin__, mode)
-
-        origin = getattr(cls, '__origin__', None)
-        if not hasattr(cls, '__args__'):
-            pass
-        elif all(is_system_TypeVar(a) for a in cls.__args__):
-            # Suppress arguments if all system defined TypeVars (ex. DictKT, VT)
-            pass
-        elif cls.__module__ == 'typing' and cls._name == 'Callable':
-            args = ', '.join(restify(a, mode) for a in cls.__args__:-1)
-            text += r"\ %s, %s" % (args, restify(cls.__args__-1, mode))
-        elif cls.__module__ == 'typing' and getattr(origin, '_name', None) == 'Literal':
-            text += r"\ %s" % ', '.join(repr(a) for a in cls.__args__)
-        elif cls.__args__:
-            text += r"\ %s" % ", ".join(restify(a, mode) for a in cls.__args__)
-
-        return text
-    elif isinstance(cls, typing._SpecialForm):
-        return ':py:obj:`~%s.%s`' % (cls.__module__, cls._name)
-    elif hasattr(cls, '__qualname__'):
-        if cls.__module__ == 'typing':
-            return ':py:class:`~%s.%s`' % (cls.__module__, cls.__qualname__)
-        else:
-            return ':py:class:`%s%s.%s`' % (modprefix, cls.__module__, cls.__qualname__)
-    elif isinstance(cls, ForwardRef):
-        return ':py:class:`%s`' % cls.__forward_arg__
-    else:
-        # not a class (ex. TypeVar)
-        if cls.__module__ == 'typing':
-            return ':py:obj:`~%s.%s`' % (cls.__module__, cls.__name__)
-        else:
-            return ':py:obj:`%s%s.%s`' % (modprefix, cls.__module__, cls.__name__)
-
-
-def _restify_py36(cls: OptionalType, mode: str = 'fully-qualified-except-typing') -> str:
-    if mode == 'smart':
-        modprefix = '~'
-    else:
-        modprefix = ''
-
-    module = getattr(cls, '__module__', None)
-    if module == 'typing':
-        if getattr(cls, '_name', None):
-            qualname = cls._name
-        elif getattr(cls, '__qualname__', None):
-            qualname = cls.__qualname__
-        elif getattr(cls, '__forward_arg__', None):
-            qualname = cls.__forward_arg__
-        elif getattr(cls, '__origin__', None):
-            qualname = stringify(cls.__origin__)  # ex. Union
+                return f':py:class:`{modprefix}{cls.__module__}.{cls.__qualname__}`'
+        elif isinstance(cls, ForwardRef):
+            return ':py:class:`%s`' % cls.__forward_arg__
         else:
-            qualname = repr(cls).replace('typing.', '')
-    elif hasattr(cls, '__qualname__'):
-        qualname = '%s%s.%s' % (modprefix, module, cls.__qualname__)
-    else:
-        qualname = repr(cls)
-
-    if (isinstance(cls, typing.TupleMeta) and  # type: ignore
-            not hasattr(cls, '__tuple_params__')):
-        if module == 'typing':
-            reftext = ':py:class:`~typing.%s`' % qualname
-        else:
-            reftext = ':py:class:`%s%s`' % (modprefix, qualname)
-
-        params = cls.__args__
-        if params:
-            param_str = ', '.join(restify(p, mode) for p in params)
-            return reftext + '\\ %s' % param_str
-        else:
-            return reftext
-    elif isinstance(cls, typing.GenericMeta):
-        if module == 'typing':
-            reftext = ':py:class:`~typing.%s`' % qualname
-        else:
-            reftext = ':py:class:`%s%s`' % (modprefix, qualname)
-
-        if cls.__args__ is None or len(cls.__args__) <= 2:
-            params = cls.__args__
-        elif cls.__origin__ == Generator:
-            params = cls.__args__
-        else:  # typing.Callable
-            args = ', '.join(restify(arg, mode) for arg in cls.__args__:-1)
-            result = restify(cls.__args__-1, mode)
-            return reftext + '\\ %s, %s' % (args, result)
-
-        if params:
-            param_str = ', '.join(restify(p, mode) for p in params)
-            return reftext + '\\ %s' % (param_str)
-        else:
-            return reftext
-    elif (hasattr(cls, '__origin__') and
-          cls.__origin__ is typing.Union):
-        params = cls.__args__
-        if params is not None:
-            if len(params) > 1 and params-1 is NoneType:
-                if len(params) > 2:
-                    param_str = ", ".join(restify(p, mode) for p in params:-1)
-                    return (':py:obj:`~typing.Optional`\\ '
-                            ':py:obj:`~typing.Union`\\ %s' % param_str)
-                else:
-                    return ':py:obj:`~typing.Optional`\\ %s' % restify(params0, mode)
+            # not a class (ex. TypeVar)
+            if cls.__module__ == 'typing':
+                return f':py:obj:`~{cls.__module__}.{cls.__name__}`'
             else:
-                param_str = ', '.join(restify(p, mode) for p in params)
-                return ':py:obj:`~typing.Union`\\ %s' % param_str
-        else:
-            return ':py:obj:`Union`'
-    elif hasattr(cls, '__qualname__'):
-        if cls.__module__ == 'typing':
-            return ':py:class:`~%s.%s`' % (cls.__module__, cls.__qualname__)
-        else:
-            return ':py:class:`%s%s.%s`' % (modprefix, cls.__module__, cls.__qualname__)
-    elif hasattr(cls, '_name'):
-        # SpecialForm
-        if cls.__module__ == 'typing':
-            return ':py:obj:`~%s.%s`' % (cls.__module__, cls._name)
-        else:
-            return ':py:obj:`%s%s.%s`' % (modprefix, cls.__module__, cls._name)
-    elif hasattr(cls, '__name__'):
-        # not a class (ex. TypeVar)
-        if cls.__module__ == 'typing':
-            return ':py:obj:`~%s.%s`' % (cls.__module__, cls.__name__)
-        else:
-            return ':py:obj:`%s%s.%s`' % (modprefix, cls.__module__, cls.__name__)
-    else:
-        # others (ex. Any)
-        if cls.__module__ == 'typing':
-            return ':py:obj:`~%s.%s`' % (cls.__module__, qualname)
-        else:
-            return ':py:obj:`%s%s.%s`' % (modprefix, cls.__module__, qualname)
+                return f':py:obj:`{modprefix}{cls.__module__}.{cls.__name__}`'
+    except (AttributeError, TypeError):
+        return inspect.object_description(cls)
 
 
-def stringify(annotation: Any, mode: str = 'fully-qualified-except-typing') -> str:
+def stringify_annotation(
+    annotation: Any,
+    /,
+    mode: str = 'fully-qualified-except-typing',
+) -> str:
     """Stringify type annotation object.
 
+    :param annotation: The annotation to stringified.
     :param mode: Specify a method how annotations will be stringified.
 
                  'fully-qualified-except-typing'
@@ -335,12 +228,22 @@
                  'fully-qualified'
                      Show the module name and qualified name of the annotation.
     """
-    from sphinx.util import inspect  # lazy loading
+    from sphinx.ext.autodoc.mock import ismock, ismockmodule  # lazy loading
+    from sphinx.util.inspect import isNewType  # lazy loading
+
+    if mode not in {'fully-qualified-except-typing', 'fully-qualified', 'smart'}:
+        raise ValueError("'mode' must be one of 'fully-qualified-except-typing', "
+                         f"'fully-qualified', or 'smart'; got {mode!r}.")
 
     if mode == 'smart':
-        modprefix = '~'
+        module_prefix = '~'
     else:
-        modprefix = ''
+        module_prefix = ''
+
+    annotation_qualname = getattr(annotation, '__qualname__', '')
+    annotation_module = getattr(annotation, '__module__', '')
+    annotation_name = getattr(annotation, '__name__', '')
+    annotation_module_is_typing = annotation_module == 'typing'
 
     if isinstance(annotation, str):
         if annotation.startswith("'") and annotation.endswith("'"):
@@ -349,184 +252,110 @@
         else:
             return annotation
     elif isinstance(annotation, TypeVar):
-        if (annotation.__module__ == 'typing' and
-                mode in ('fully-qualified-except-typing', 'smart')):
-            return annotation.__name__
+        if annotation_module_is_typing and mode in {'fully-qualified-except-typing', 'smart'}:
+            return annotation_name
         else:
-            return modprefix + '.'.join(annotation.__module__, annotation.__name__)
-    elif inspect.isNewType(annotation):
-        if sys.version_info > (3, 10):
+            return module_prefix + f'{annotation_module}.{annotation_name}'
+    elif isNewType(annotation):
+        if sys.version_info:2 >= (3, 10):
             # newtypes have correct module info since Python 3.10+
-            return modprefix + '%s.%s' % (annotation.__module__, annotation.__name__)
+            return module_prefix + f'{annotation_module}.{annotation_name}'
         else:
-            return annotation.__name__
+            return annotation_name
     elif not annotation:
         return repr(annotation)
     elif annotation is NoneType:
         return 'None'
-    elif annotation in INVALID_BUILTIN_CLASSES:
-        return modprefix + INVALID_BUILTIN_CLASSESannotation
+    elif ismockmodule(annotation):
+        return module_prefix + annotation_name
+    elif ismock(annotation):
+        return module_prefix + f'{annotation_module}.{annotation_name}'
+    elif is_invalid_builtin_class(annotation):
+        return module_prefix + INVALID_BUILTIN_CLASSESannotation
     elif str(annotation).startswith('typing.Annotated'):  # for py310+
         pass
-    elif (getattr(annotation, '__module__', None) == 'builtins' and
-          getattr(annotation, '__qualname__', None)):
+    elif annotation_module == 'builtins' and annotation_qualname:
         if hasattr(annotation, '__args__'):  # PEP 585 generic
             return repr(annotation)
         else:
-            return annotation.__qualname__
+            return annotation_qualname
     elif annotation is Ellipsis:
         return '...'
 
-    if sys.version_info >= (3, 7):  # py37+
-        return _stringify_py37(annotation, mode)
+    module_prefix = f'{annotation_module}.'
+    annotation_forward_arg = getattr(annotation, '__forward_arg__', None)
+    if annotation_qualname or (annotation_module_is_typing and not annotation_forward_arg):
+        if mode == 'smart':
+            module_prefix = '~' + module_prefix
+        if annotation_module_is_typing and mode == 'fully-qualified-except-typing':
+            module_prefix = ''
     else:
-        return _stringify_py36(annotation, mode)
-
-
-def _stringify_py37(annotation: Any, mode: str = 'fully-qualified-except-typing') -> str:
-    """stringify() for py37+."""
-    module = getattr(annotation, '__module__', None)
-    modprefix = ''
-    if module == 'typing' and getattr(annotation, '__forward_arg__', None):
-        qualname = annotation.__forward_arg__
-    elif module == 'typing':
-        if getattr(annotation, '_name', None):
-            qualname = annotation._name
-        elif getattr(annotation, '__qualname__', None):
-            qualname = annotation.__qualname__
-        else:
-            qualname = stringify(annotation.__origin__).replace('typing.', '')  # ex. Union
+        module_prefix = ''
 
-        if mode == 'smart':
-            modprefix = '~%s.' % module
-        elif mode == 'fully-qualified':
-            modprefix = '%s.' % module
-    elif hasattr(annotation, '__qualname__'):
-        if mode == 'smart':
-            modprefix = '~%s.' % module
+    if annotation_module_is_typing:
+        if annotation_forward_arg:
+            # handle ForwardRefs
+            qualname = annotation_forward_arg
         else:
-            modprefix = '%s.' % module
-        qualname = annotation.__qualname__
+            _name = getattr(annotation, '_name', '')
+            if _name:
+                qualname = _name
+            elif annotation_qualname:
+                qualname = annotation_qualname
+            else:
+                qualname = stringify_annotation(
+                    annotation.__origin__, 'fully-qualified-except-typing',
+                ).replace('typing.', '')  # ex. Union
+    elif annotation_qualname:
+        qualname = annotation_qualname
     elif hasattr(annotation, '__origin__'):
         # instantiated generic provided by a user
-        qualname = stringify(annotation.__origin__, mode)
-    elif UnionType and isinstance(annotation, UnionType):  # types.Union (for py3.10+)
-        qualname = 'types.Union'
+        qualname = stringify_annotation(annotation.__origin__, mode)
+    elif UnionType and isinstance(annotation, UnionType):  # types.UnionType (for py3.10+)
+        qualname = 'types.UnionType'
     else:
         # we weren't able to extract the base type, appending arguments would
         # only make them appear twice
         return repr(annotation)
 
-    if getattr(annotation, '__args__', None):
-        if not isinstance(annotation.__args__, (list, tuple)):
+    annotation_args = getattr(annotation, '__args__', None)
+    if annotation_args:
+        if not isinstance(annotation_args, (list, tuple)):
             # broken __args__ found
             pass
-        elif qualname in ('Optional', 'Union'):
-            if len(annotation.__args__) > 1 and annotation.__args__-1 is NoneType:
-                if len(annotation.__args__) > 2:
-                    args = ', '.join(stringify(a, mode) for a in annotation.__args__:-1)
-                    return '%sOptional%sUnion%s' % (modprefix, modprefix, args)
-                else:
-                    return '%sOptional%s' % (modprefix,
-                                               stringify(annotation.__args__0, mode))
-            else:
-                args = ', '.join(stringify(a, mode) for a in annotation.__args__)
-                return '%sUnion%s' % (modprefix, args)
-        elif qualname == 'types.Union':
-            if len(annotation.__args__) > 1 and None in annotation.__args__:
-                args = ' | '.join(stringify(a) for a in annotation.__args__ if a)
-                return '%sOptional%s' % (modprefix, args)
-            else:
-                return ' | '.join(stringify(a) for a in annotation.__args__)
+        elif qualname in {'Optional', 'Union', 'types.UnionType'}:
+            return ' | '.join(stringify_annotation(a, mode) for a in annotation_args)
         elif qualname == 'Callable':
-            args = ', '.join(stringify(a, mode) for a in annotation.__args__:-1)
-            returns = stringify(annotation.__args__-1, mode)
-            return '%s%s%s, %s' % (modprefix, qualname, args, returns)
+            args = ', '.join(stringify_annotation(a, mode) for a in annotation_args:-1)
+            returns = stringify_annotation(annotation_args-1, mode)
+            return f'{module_prefix}Callable{args}, {returns}'
         elif qualname == 'Literal':
-            args = ', '.join(repr(a) for a in annotation.__args__)
-            return '%s%s%s' % (modprefix, qualname, args)
+            args = ', '.join(repr(a) for a in annotation_args)
+            return f'{module_prefix}Literal{args}'
         elif str(annotation).startswith('typing.Annotated'):  # for py39+
-            return stringify(annotation.__args__0, mode)
-        elif all(is_system_TypeVar(a) for a in annotation.__args__):
+            return stringify_annotation(annotation_args0, mode)
+        elif all(is_system_TypeVar(a) for a in annotation_args):
             # Suppress arguments if all system defined TypeVars (ex. DictKT, VT)
-            return modprefix + qualname
+            return module_prefix + qualname
         else:
-            args = ', '.join(stringify(a, mode) for a in annotation.__args__)
-            return '%s%s%s' % (modprefix, qualname, args)
-
-    return modprefix + qualname
-
-
-def _stringify_py36(annotation: Any, mode: str = 'fully-qualified-except-typing') -> str:
-    """stringify() for py36."""
-    module = getattr(annotation, '__module__', None)
-    modprefix = ''
-    if module == 'typing' and getattr(annotation, '__forward_arg__', None):
-        qualname = annotation.__forward_arg__
-    elif module == 'typing':
-        if getattr(annotation, '_name', None):
-            qualname = annotation._name
-        elif getattr(annotation, '__qualname__', None):
-            qualname = annotation.__qualname__
-        elif getattr(annotation, '__origin__', None):
-            qualname = stringify(annotation.__origin__)  # ex. Union
-        else:
-            qualname = repr(annotation).replace('typing.', '')
+            args = ', '.join(stringify_annotation(a, mode) for a in annotation_args)
+            return f'{module_prefix}{qualname}{args}'
+
+    return module_prefix + qualname
+
+
+# deprecated name -> (object to return, canonical path or empty string)
+_DEPRECATED_OBJECTS = {
+    'stringify': (stringify_annotation, 'sphinx.util.typing.stringify_annotation'),
+}
 
-        if mode == 'smart':
-            modprefix = '~%s.' % module
-        elif mode == 'fully-qualified':
-            modprefix = '%s.' % module
-    elif hasattr(annotation, '__qualname__'):
-        if mode == 'smart':
-            modprefix = '~%s.' % module
-        else:
-            modprefix = '%s.' % module
-        qualname = annotation.__qualname__
-    else:
-        qualname = repr(annotation)
-
-    if (isinstance(annotation, typing.TupleMeta) and  # type: ignore
-            not hasattr(annotation, '__tuple_params__')):  # for Python 3.6
-        params = annotation.__args__
-        if params:
-            param_str = ', '.join(stringify(p, mode) for p in params)
-            return '%s%s%s' % (modprefix, qualname, param_str)
-        else:
-            return modprefix + qualname
-    elif isinstance(annotation, typing.GenericMeta):
-        params = None
-        if annotation.__args__ is None or len(annotation.__args__) <= 2:  # type: ignore  # NOQA
-            params = annotation.__args__  # type: ignore
-        elif annotation.__origin__ == Generator:  # type: ignore
-            params = annotation.__args__  # type: ignore
-        else:  # typing.Callable
-            args = ', '.join(stringify(arg, mode) for arg
-                             in annotation.__args__:-1)  # type: ignore
-            result = stringify(annotation.__args__-1)  # type: ignore
-            return '%s%s%s, %s' % (modprefix, qualname, args, result)
-        if params is not None:
-            param_str = ', '.join(stringify(p, mode) for p in params)
-            return '%s%s%s' % (modprefix, qualname, param_str)
-    elif (hasattr(annotation, '__origin__') and
-          annotation.__origin__ is typing.Union):
-        params = annotation.__args__
-        if params is not None:
-            if len(params) > 1 and params-1 is NoneType:
-                if len(params) > 2:
-                    param_str = ", ".join(stringify(p, mode) for p in params:-1)
-                    return '%sOptional%sUnion%s' % (modprefix, modprefix, param_str)
-                else:
-                    return '%sOptional%s' % (modprefix, stringify(params0, mode))
-            else:
-                param_str = ', '.join(stringify(p, mode) for p in params)
-                return '%sUnion%s' % (modprefix, param_str)
 
-    return modprefix + qualname
+def __getattr__(name):
+    if name not in _DEPRECATED_OBJECTS:
+        raise AttributeError(f'module {__name__!r} has no attribute {name!r}')
 
+    from sphinx.deprecation import _deprecation_warning
 
-deprecated_alias('sphinx.util.typing',
-                 {
-                     'DirectiveOption': Callablestr, Any,
-                 },
-                 RemovedInSphinx60Warning)
+    deprecated_object, canonical_name = _DEPRECATED_OBJECTSname
+    _deprecation_warning(__name__, name, canonical_name, remove=(8, 0))
+    return deprecated_object

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/versioning.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/versioning.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/html.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/html.py Changed

@@ -1,73 +1,38 @@
-"""
-    sphinx.writers.html
-    ~~~~~~~~~~~~~~~~~~~
+"""docutils writers handling Sphinx' custom nodes."""
 
-    docutils writers handling Sphinx' custom nodes.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from typing import TYPE_CHECKING, cast
 
-import copy
-import os
-import posixpath
-import re
-import urllib.parse
-import warnings
-from typing import TYPE_CHECKING, Iterable, Tuple, cast
-
-from docutils import nodes
-from docutils.nodes import Element, Node, Text
-from docutils.writers.html4css1 import HTMLTranslator as BaseTranslator
 from docutils.writers.html4css1 import Writer
 
-from sphinx import addnodes
-from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
-from sphinx.locale import _, __, admonitionlabels
 from sphinx.util import logging
-from sphinx.util.docutils import SphinxTranslator
-from sphinx.util.images import get_image_size
+from sphinx.writers.html5 import HTML5Translator
 
 if TYPE_CHECKING:
     from sphinx.builders.html import StandaloneHTMLBuilder
 
 
 logger = logging.getLogger(__name__)
+HTMLTranslator = HTML5Translator
 
 # A good overview of the purpose behind these classes can be found here:
 # http://www.arnebrodowski.de/blog/write-your-own-restructuredtext-writer.html
 
 
-def multiply_length(length: str, scale: int) -> str:
-    """Multiply *length* (width or height) by *scale*."""
-    matched = re.match(r'^(\d*\.?\d*)\s*(\S*)$', length)
-    if not matched:
-        return length
-    elif scale == 100:
-        return length
-    else:
-        amount, unit = matched.groups()
-        result = float(amount) * scale / 100
-        return "%s%s" % (int(result), unit)
-
-
 class HTMLWriter(Writer):
 
-    # override embed-stylesheet default value to 0.
-    settings_spec = copy.deepcopy(Writer.settings_spec)
-    for _setting in settings_spec2:
-        if '--embed-stylesheet' in _setting1:
-            _setting2'default' = 0
+    # override embed-stylesheet default value to False.
+    settings_default_overrides = {"embed_stylesheet": False}
 
-    def __init__(self, builder: "StandaloneHTMLBuilder") -> None:
+    def __init__(self, builder: StandaloneHTMLBuilder) -> None:
         super().__init__()
         self.builder = builder
 
     def translate(self) -> None:
         # sadly, this is mostly copied from parent class
         visitor = self.builder.create_translator(self.document, self.builder)
-        self.visitor = cast(HTMLTranslator, visitor)
+        self.visitor = cast(HTML5Translator, visitor)
         self.document.walkabout(visitor)
         self.output = self.visitor.astext()
         for attr in ('head_prefix', 'stylesheet', 'head', 'body_prefix',
@@ -77,819 +42,3 @@
                      'html_subtitle', 'html_body', ):
             setattr(self, attr, getattr(visitor, attr, None))
         self.clean_meta = ''.join(self.visitor.meta2:)
-
-
-class HTMLTranslator(SphinxTranslator, BaseTranslator):
-    """
-    Our custom HTML translator.
-    """
-
-    builder: "StandaloneHTMLBuilder" = None
-
-    def __init__(self, document: nodes.document, builder: Builder) -> None:
-        super().__init__(document, builder)
-
-        self.highlighter = self.builder.highlighter
-        self.docnames = self.builder.current_docname  # for singlehtml builder
-        self.manpages_url = self.config.manpages_url
-        self.protect_literal_text = 0
-        self.secnumber_suffix = self.config.html_secnumber_suffix
-        self.param_separator = ''
-        self.optional_param_level = 0
-        self._table_row_indices = 0
-        self._fieldlist_row_indices = 0
-        self.required_params_left = 0
-
-    def visit_start_of_file(self, node: Element) -> None:
-        # only occurs in the single-file builder
-        self.docnames.append(node'docname')
-        self.body.append('<span id="document-%s"></span>' % node'docname')
-
-    def depart_start_of_file(self, node: Element) -> None:
-        self.docnames.pop()
-
-    #############################################################
-    # Domain-specific object descriptions
-    #############################################################
-
-    # Top-level nodes for descriptions
-    ##################################
-
-    def visit_desc(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dl'))
-
-    def depart_desc(self, node: Element) -> None:
-        self.body.append('</dl>\n\n')
-
-    def visit_desc_signature(self, node: Element) -> None:
-        # the id is set automatically
-        self.body.append(self.starttag(node, 'dt'))
-        self.protect_literal_text += 1
-
-    def depart_desc_signature(self, node: Element) -> None:
-        self.protect_literal_text -= 1
-        if not node.get('is_multiline'):
-            self.add_permalink_ref(node, _('Permalink to this definition'))
-        self.body.append('</dt>\n')
-
-    def visit_desc_signature_line(self, node: Element) -> None:
-        pass
-
-    def depart_desc_signature_line(self, node: Element) -> None:
-        if node.get('add_permalink'):
-            # the permalink info is on the parent desc_signature node
-            self.add_permalink_ref(node.parent, _('Permalink to this definition'))
-        self.body.append('<br />')
-
-    def visit_desc_content(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dd', ''))
-
-    def depart_desc_content(self, node: Element) -> None:
-        self.body.append('</dd>')
-
-    def visit_desc_inline(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'span', ''))
-
-    def depart_desc_inline(self, node: Element) -> None:
-        self.body.append('</span>')
-
-    # Nodes for high-level structure in signatures
-    ##############################################
-
-    def visit_desc_name(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', ''))
-
-    def depart_desc_name(self, node: Element) -> None:
-        self.body.append('</code>')
-
-    def visit_desc_addname(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'code', ''))
-
-    def depart_desc_addname(self, node: Element) -> None:
-        self.body.append('</code>')
-
-    def visit_desc_type(self, node: Element) -> None:
-        pass
-
-    def depart_desc_type(self, node: Element) -> None:
-        pass
-
-    def visit_desc_returns(self, node: Element) -> None:
-        self.body.append(' <span class="sig-return">')
-        self.body.append('<span class="sig-return-icon">&#x2192;</span>')
-        self.body.append(' <span class="sig-return-typehint">')
-
-    def depart_desc_returns(self, node: Element) -> None:
-        self.body.append('</span></span>')
-
-    def visit_desc_parameterlist(self, node: Element) -> None:
-        self.body.append('<span class="sig-paren">(</span>')
-        self.first_param = 1
-        self.optional_param_level = 0
-        # How many required parameters are left.
-        self.required_params_left = sum(isinstance(c, addnodes.desc_parameter)
-                                         for c in node.children)
-        self.param_separator = node.child_text_separator
-
-    def depart_desc_parameterlist(self, node: Element) -> None:
-        self.body.append('<span class="sig-paren">)</span>')
-
-    # If required parameters are still to come, then put the comma after
-    # the parameter.  Otherwise, put the comma before.  This ensures that
-    # signatures like the following render correctly (see issue #1001):
-    #
-    #     foo(a, b, c, d)
-    #
-    def visit_desc_parameter(self, node: Element) -> None:
-        if self.first_param:
-            self.first_param = 0
-        elif not self.required_params_left:
-            self.body.append(self.param_separator)
-        if self.optional_param_level == 0:
-            self.required_params_left -= 1
-        if not node.hasattr('noemph'):
-            self.body.append('<em>')
-
-    def depart_desc_parameter(self, node: Element) -> None:
-        if not node.hasattr('noemph'):
-            self.body.append('</em>')
-        if self.required_params_left:
-            self.body.append(self.param_separator)
-
-    def visit_desc_optional(self, node: Element) -> None:
-        self.optional_param_level += 1
-        self.body.append('<span class="optional"></span>')
-
-    def depart_desc_optional(self, node: Element) -> None:
-        self.optional_param_level -= 1
-        self.body.append('<span class="optional"></span>')
-
-    def visit_desc_annotation(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'em', '', CLASS='property'))
-
-    def depart_desc_annotation(self, node: Element) -> None:
-        self.body.append('</em>')
-
-    ##############################################
-
-    def visit_versionmodified(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'div', CLASS=node'type'))
-
-    def depart_versionmodified(self, node: Element) -> None:
-        self.body.append('</div>\n')
-
-    # overwritten
-    def visit_reference(self, node: Element) -> None:
-        atts = {'class': 'reference'}
-        if node.get('internal') or 'refuri' not in node:
-            atts'class' += ' internal'
-        else:
-            atts'class' += ' external'
-        if 'refuri' in node:
-            atts'href' = node'refuri' or '#'
-            if self.settings.cloak_email_addresses and atts'href'.startswith('mailto:'):
-                atts'href' = self.cloak_mailto(atts'href')
-                self.in_mailto = True
-        else:
-            assert 'refid' in node, \
-                   'References must have "refuri" or "refid" attribute.'
-            atts'href' = '#' + node'refid'
-        if not isinstance(node.parent, nodes.TextElement):
-            assert len(node) == 1 and isinstance(node0, nodes.image)
-            atts'class' += ' image-reference'
-        if 'reftitle' in node:
-            atts'title' = node'reftitle'
-        if 'target' in node:
-            atts'target' = node'target'
-        self.body.append(self.starttag(node, 'a', '', **atts))
-
-        if node.get('secnumber'):
-            self.body.append(('%s' + self.secnumber_suffix) %
-                             '.'.join(map(str, node'secnumber')))
-
-    def visit_number_reference(self, node: Element) -> None:
-        self.visit_reference(node)
-
-    def depart_number_reference(self, node: Element) -> None:
-        self.depart_reference(node)
-
-    # overwritten -- we don't want source comments to show up in the HTML
-    def visit_comment(self, node: Element) -> None:  # type: ignore
-        raise nodes.SkipNode
-
-    # overwritten
-    def visit_admonition(self, node: Element, name: str = '') -> None:
-        self.body.append(self.starttag(
-            node, 'div', CLASS=('admonition ' + name)))
-        if name:
-            node.insert(0, nodes.title(name, admonitionlabelsname))
-        self.set_first_last(node)
-
-    def visit_seealso(self, node: Element) -> None:
-        self.visit_admonition(node, 'seealso')
-
-    def depart_seealso(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def get_secnumber(self, node: Element) -> Tupleint, ...:
-        if node.get('secnumber'):
-            return node'secnumber'
-        elif isinstance(node.parent, nodes.section):
-            if self.builder.name == 'singlehtml':
-                docname = self.docnames-1
-                anchorname = "%s/#%s" % (docname, node.parent'ids'0)
-                if anchorname not in self.builder.secnumbers:
-                    anchorname = "%s/" % docname  # try first heading which has no anchor
-            else:
-                anchorname = '#' + node.parent'ids'0
-                if anchorname not in self.builder.secnumbers:
-                    anchorname = ''  # try first heading which has no anchor
-
-            if self.builder.secnumbers.get(anchorname):
-                return self.builder.secnumbersanchorname
-
-        return None
-
-    def add_secnumber(self, node: Element) -> None:
-        secnumber = self.get_secnumber(node)
-        if secnumber:
-            self.body.append('<span class="section-number">%s</span>' %
-                             ('.'.join(map(str, secnumber)) + self.secnumber_suffix))
-
-    def add_fignumber(self, node: Element) -> None:
-        def append_fignumber(figtype: str, figure_id: str) -> None:
-            if self.builder.name == 'singlehtml':
-                key = "%s/%s" % (self.docnames-1, figtype)
-            else:
-                key = figtype
-
-            if figure_id in self.builder.fignumbers.get(key, {}):
-                self.body.append('<span class="caption-number">')
-                prefix = self.config.numfig_format.get(figtype)
-                if prefix is None:
-                    msg = __('numfig_format is not defined for %s') % figtype
-                    logger.warning(msg)
-                else:
-                    numbers = self.builder.fignumberskeyfigure_id
-                    self.body.append(prefix % '.'.join(map(str, numbers)) + ' ')
-                    self.body.append('</span>')
-
-        figtype = self.builder.env.domains'std'.get_enumerable_node_type(node)
-        if figtype:
-            if len(node'ids') == 0:
-                msg = __('Any IDs not assigned for %s node') % node.tagname
-                logger.warning(msg, location=node)
-            else:
-                append_fignumber(figtype, node'ids'0)
-
-    def add_permalink_ref(self, node: Element, title: str) -> None:
-        if node'ids' and self.config.html_permalinks and self.builder.add_permalinks:
-            format = '<a class="headerlink" href="#%s" title="%s">%s</a>'
-            self.body.append(format % (node'ids'0, title,
-                                       self.config.html_permalinks_icon))
-
-    def generate_targets_for_listing(self, node: Element) -> None:
-        """Generate hyperlink targets for listings.
-
-        Original visit_bullet_list(), visit_definition_list() and visit_enumerated_list()
-        generates hyperlink targets inside listing tags (<ul>, <ol> and <dl>) if multiple
-        IDs are assigned to listings.  That is invalid DOM structure.
-        (This is a bug of docutils <= 0.12)
-
-        This exports hyperlink targets before listings to make valid DOM structure.
-        """
-        for id in node'ids'1::
-            self.body.append('<span id="%s"></span>' % id)
-            node'ids'.remove(id)
-
-    # overwritten
-    def visit_bullet_list(self, node: Element) -> None:
-        if len(node) == 1 and isinstance(node0, addnodes.toctree):
-            # avoid emitting empty <ul></ul>
-            raise nodes.SkipNode
-        self.generate_targets_for_listing(node)
-        super().visit_bullet_list(node)
-
-    # overwritten
-    def visit_enumerated_list(self, node: Element) -> None:
-        self.generate_targets_for_listing(node)
-        super().visit_enumerated_list(node)
-
-    # overwritten
-    def visit_definition(self, node: Element) -> None:
-        # don't insert </dt> here.
-        self.body.append(self.starttag(node, 'dd', ''))
-
-    # overwritten
-    def depart_definition(self, node: Element) -> None:
-        self.body.append('</dd>\n')
-
-    # overwritten
-    def visit_classifier(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'span', '', CLASS='classifier'))
-
-    # overwritten
-    def depart_classifier(self, node: Element) -> None:
-        self.body.append('</span>')
-
-        next_node: Node = node.next_node(descend=False, siblings=True)
-        if not isinstance(next_node, nodes.classifier):
-            # close `<dt>` tag at the tail of classifiers
-            self.body.append('</dt>')
-
-    # overwritten
-    def visit_term(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'dt', ''))
-
-    # overwritten
-    def depart_term(self, node: Element) -> None:
-        next_node: Node = node.next_node(descend=False, siblings=True)
-        if isinstance(next_node, nodes.classifier):
-            # Leave the end tag to `self.depart_classifier()`, in case
-            # there's a classifier.
-            pass
-        else:
-            if isinstance(node.parent.parent.parent, addnodes.glossary):
-                # add permalink if glossary terms
-                self.add_permalink_ref(node, _('Permalink to this term'))
-
-            self.body.append('</dt>')
-
-    # overwritten
-    def visit_title(self, node: Element) -> None:
-        if isinstance(node.parent, addnodes.compact_paragraph) and node.parent.get('toctree'):
-            self.body.append(self.starttag(node, 'p', '', CLASS='caption', ROLE='heading'))
-            self.body.append('<span class="caption-text">')
-            self.context.append('</span></p>\n')
-        else:
-            super().visit_title(node)
-        self.add_secnumber(node)
-        self.add_fignumber(node.parent)
-        if isinstance(node.parent, nodes.table):
-            self.body.append('<span class="caption-text">')
-
-    def depart_title(self, node: Element) -> None:
-        close_tag = self.context-1
-        if (self.config.html_permalinks and self.builder.add_permalinks and
-           node.parent.hasattr('ids') and node.parent'ids'):
-            # add permalink anchor
-            if close_tag.startswith('</h'):
-                self.add_permalink_ref(node.parent, _('Permalink to this headline'))
-            elif close_tag.startswith('</a></h'):
-                self.body.append('</a><a class="headerlink" href="#%s" ' %
-                                 node.parent'ids'0 +
-                                 'title="%s">%s' % (
-                                     _('Permalink to this headline'),
-                                     self.config.html_permalinks_icon))
-            elif isinstance(node.parent, nodes.table):
-                self.body.append('</span>')
-                self.add_permalink_ref(node.parent, _('Permalink to this table'))
-        elif isinstance(node.parent, nodes.table):
-            self.body.append('</span>')
-
-        super().depart_title(node)
-
-    # overwritten
-    def visit_literal_block(self, node: Element) -> None:
-        if node.rawsource != node.astext():
-            # most probably a parsed-literal block -- don't highlight
-            return super().visit_literal_block(node)
-
-        lang = node.get('language', 'default')
-        linenos = node.get('linenos', False)
-        highlight_args = node.get('highlight_args', {})
-        highlight_args'force' = node.get('force', False)
-        opts = self.config.highlight_options.get(lang, {})
-
-        if linenos and self.config.html_codeblock_linenos_style:
-            linenos = self.config.html_codeblock_linenos_style
-
-        highlighted = self.highlighter.highlight_block(
-            node.rawsource, lang, opts=opts, linenos=linenos,
-            location=node, **highlight_args
-        )
-        starttag = self.starttag(node, 'div', suffix='',
-                                 CLASS='highlight-%s notranslate' % lang)
-        self.body.append(starttag + highlighted + '</div>\n')
-        raise nodes.SkipNode
-
-    def visit_caption(self, node: Element) -> None:
-        if isinstance(node.parent, nodes.container) and node.parent.get('literal_block'):
-            self.body.append('<div class="code-block-caption">')
-        else:
-            super().visit_caption(node)
-        self.add_fignumber(node.parent)
-        self.body.append(self.starttag(node, 'span', '', CLASS='caption-text'))
-
-    def depart_caption(self, node: Element) -> None:
-        self.body.append('</span>')
-
-        # append permalink if available
-        if isinstance(node.parent, nodes.container) and node.parent.get('literal_block'):
-            self.add_permalink_ref(node.parent, _('Permalink to this code'))
-        elif isinstance(node.parent, nodes.figure):
-            self.add_permalink_ref(node.parent, _('Permalink to this image'))
-        elif node.parent.get('toctree'):
-            self.add_permalink_ref(node.parent.parent, _('Permalink to this toctree'))
-
-        if isinstance(node.parent, nodes.container) and node.parent.get('literal_block'):
-            self.body.append('</div>\n')
-        else:
-            super().depart_caption(node)
-
-    def visit_doctest_block(self, node: Element) -> None:
-        self.visit_literal_block(node)
-
-    # overwritten to add the <div> (for XHTML compliance)
-    def visit_block_quote(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'blockquote') + '<div>')
-
-    def depart_block_quote(self, node: Element) -> None:
-        self.body.append('</div></blockquote>\n')
-
-    # overwritten
-    def visit_literal(self, node: Element) -> None:
-        if 'kbd' in node'classes':
-            self.body.append(self.starttag(node, 'kbd', '',
-                                           CLASS='docutils literal notranslate'))
-        else:
-            self.body.append(self.starttag(node, 'code', '',
-                                           CLASS='docutils literal notranslate'))
-            self.protect_literal_text += 1
-
-    def depart_literal(self, node: Element) -> None:
-        if 'kbd' in node'classes':
-            self.body.append('</kbd>')
-        else:
-            self.protect_literal_text -= 1
-            self.body.append('</code>')
-
-    def visit_productionlist(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'pre'))
-        names = 
-        productionlist = cast(Iterableaddnodes.production, node)
-        for production in productionlist:
-            names.append(production'tokenname')
-        maxlen = max(len(name) for name in names)
-        lastname = None
-        for production in productionlist:
-            if production'tokenname':
-                lastname = production'tokenname'.ljust(maxlen)
-                self.body.append(self.starttag(production, 'strong', ''))
-                self.body.append(lastname + '</strong> ::= ')
-            elif lastname is not None:
-                self.body.append('%s     ' % (' ' * len(lastname)))
-            production.walkabout(self)
-            self.body.append('\n')
-        self.body.append('</pre>\n')
-        raise nodes.SkipNode
-
-    def depart_productionlist(self, node: Element) -> None:
-        pass
-
-    def visit_production(self, node: Element) -> None:
-        pass
-
-    def depart_production(self, node: Element) -> None:
-        pass
-
-    def visit_centered(self, node: Element) -> None:
-        self.body.append(self.starttag(node, 'p', CLASS="centered") +
-                         '<strong>')
-
-    def depart_centered(self, node: Element) -> None:
-        self.body.append('</strong></p>')
-
-    # overwritten
-    def should_be_compact_paragraph(self, node: Node) -> bool:
-        """Determine if the <p> tags around paragraph can be omitted."""
-        if isinstance(node.parent, addnodes.desc_content):
-            # Never compact desc_content items.
-            return False
-        if isinstance(node.parent, addnodes.versionmodified):
-            # Never compact versionmodified nodes.
-            return False
-        return super().should_be_compact_paragraph(node)
-
-    def visit_compact_paragraph(self, node: Element) -> None:
-        pass
-
-    def depart_compact_paragraph(self, node: Element) -> None:
-        pass
-
-    def visit_download_reference(self, node: Element) -> None:
-        atts = {'class': 'reference download',
-                'download': ''}
-
-        if not self.builder.download_support:
-            self.context.append('')
-        elif 'refuri' in node:
-            atts'class' += ' external'
-            atts'href' = node'refuri'
-            self.body.append(self.starttag(node, 'a', '', **atts))
-            self.context.append('</a>')
-        elif 'filename' in node:
-            atts'class' += ' internal'
-            atts'href' = posixpath.join(self.builder.dlpath,
-                                          urllib.parse.quote(node'filename'))
-            self.body.append(self.starttag(node, 'a', '', **atts))
-            self.context.append('</a>')
-        else:
-            self.context.append('')
-
-    def depart_download_reference(self, node: Element) -> None:
-        self.body.append(self.context.pop())
-
-    # overwritten
-    def visit_figure(self, node: Element) -> None:
-        # set align=default if align not specified to give a default style
-        node.setdefault('align', 'default')
-
-        return super().visit_figure(node)
-
-    # overwritten
-    def visit_image(self, node: Element) -> None:
-        olduri = node'uri'
-        # rewrite the URI if the environment knows about it
-        if olduri in self.builder.images:
-            node'uri' = posixpath.join(self.builder.imgpath,
-                                         self.builder.imagesolduri)
-
-        if 'scale' in node:
-            # Try to figure out image height and width.  Docutils does that too,
-            # but it tries the final file name, which does not necessarily exist
-            # yet at the time the HTML file is written.
-            if not ('width' in node and 'height' in node):
-                size = get_image_size(os.path.join(self.builder.srcdir, olduri))
-                if size is None:
-                    logger.warning(__('Could not obtain image size. :scale: option is ignored.'),  # NOQA
-                                   location=node)
-                else:
-                    if 'width' not in node:
-                        node'width' = str(size0)
-                    if 'height' not in node:
-                        node'height' = str(size1)
-
-        uri = node'uri'
-        if uri.lower().endswith(('svg', 'svgz')):
-            atts = {'src': uri}
-            if 'width' in node:
-                atts'width' = node'width'
-            if 'height' in node:
-                atts'height' = node'height'
-            if 'scale' in node:
-                if 'width' in atts:
-                    atts'width' = multiply_length(atts'width', node'scale')
-                if 'height' in atts:
-                    atts'height' = multiply_length(atts'height', node'scale')
-            atts'alt' = node.get('alt', uri)
-            if 'align' in node:
-                atts'class' = 'align-%s' % node'align'
-            self.body.append(self.emptytag(node, 'img', '', **atts))
-            return
-
-        super().visit_image(node)
-
-    # overwritten
-    def depart_image(self, node: Element) -> None:
-        if node'uri'.lower().endswith(('svg', 'svgz')):
-            pass
-        else:
-            super().depart_image(node)
-
-    def visit_toctree(self, node: Element) -> None:
-        # this only happens when formatting a toc from env.tocs -- in this
-        # case we don't want to include the subtree
-        raise nodes.SkipNode
-
-    def visit_index(self, node: Element) -> None:
-        raise nodes.SkipNode
-
-    def visit_tabular_col_spec(self, node: Element) -> None:
-        raise nodes.SkipNode
-
-    def visit_glossary(self, node: Element) -> None:
-        pass
-
-    def depart_glossary(self, node: Element) -> None:
-        pass
-
-    def visit_acks(self, node: Element) -> None:
-        pass
-
-    def depart_acks(self, node: Element) -> None:
-        pass
-
-    def visit_hlist(self, node: Element) -> None:
-        self.body.append('<table class="hlist"><tr>')
-
-    def depart_hlist(self, node: Element) -> None:
-        self.body.append('</tr></table>\n')
-
-    def visit_hlistcol(self, node: Element) -> None:
-        self.body.append('<td>')
-
-    def depart_hlistcol(self, node: Element) -> None:
-        self.body.append('</td>')
-
-    def visit_option_group(self, node: Element) -> None:
-        super().visit_option_group(node)
-        self.context-2 = self.context-2.replace('&nbsp;', '&#160;')
-
-    # overwritten
-    def visit_Text(self, node: Text) -> None:
-        text = node.astext()
-        encoded = self.encode(text)
-        if self.protect_literal_text:
-            # moved here from base class's visit_literal to support
-            # more formatting in literal nodes
-            for token in self.words_and_spaces.findall(encoded):
-                if token.strip():
-                    # protect literal text from line wrapping
-                    self.body.append('<span class="pre">%s</span>' % token)
-                elif token in ' \n':
-                    # allow breaks at whitespace
-                    self.body.append(token)
-                else:
-                    # protect runs of multiple spaces; the last one can wrap
-                    self.body.append('&#160;' * (len(token) - 1) + ' ')
-        else:
-            if self.in_mailto and self.settings.cloak_email_addresses:
-                encoded = self.cloak_email(encoded)
-            self.body.append(encoded)
-
-    def visit_note(self, node: Element) -> None:
-        self.visit_admonition(node, 'note')
-
-    def depart_note(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_warning(self, node: Element) -> None:
-        self.visit_admonition(node, 'warning')
-
-    def depart_warning(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_attention(self, node: Element) -> None:
-        self.visit_admonition(node, 'attention')
-
-    def depart_attention(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_caution(self, node: Element) -> None:
-        self.visit_admonition(node, 'caution')
-
-    def depart_caution(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_danger(self, node: Element) -> None:
-        self.visit_admonition(node, 'danger')
-
-    def depart_danger(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_error(self, node: Element) -> None:
-        self.visit_admonition(node, 'error')
-
-    def depart_error(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_hint(self, node: Element) -> None:
-        self.visit_admonition(node, 'hint')
-
-    def depart_hint(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_important(self, node: Element) -> None:
-        self.visit_admonition(node, 'important')
-
-    def depart_important(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_tip(self, node: Element) -> None:
-        self.visit_admonition(node, 'tip')
-
-    def depart_tip(self, node: Element) -> None:
-        self.depart_admonition(node)
-
-    def visit_literal_emphasis(self, node: Element) -> None:
-        return self.visit_emphasis(node)
-
-    def depart_literal_emphasis(self, node: Element) -> None:
-        return self.depart_emphasis(node)
-
-    def visit_literal_strong(self, node: Element) -> None:
-        return self.visit_strong(node)
-
-    def depart_literal_strong(self, node: Element) -> None:
-        return self.depart_strong(node)
-
-    def visit_abbreviation(self, node: Element) -> None:
-        attrs = {}
-        if node.hasattr('explanation'):
-            attrs'title' = node'explanation'
-        self.body.append(self.starttag(node, 'abbr', '', **attrs))
-
-    def depart_abbreviation(self, node: Element) -> None:
-        self.body.append('</abbr>')
-
-    def visit_manpage(self, node: Element) -> None:
-        self.visit_literal_emphasis(node)
-        if self.manpages_url:
-            node'refuri' = self.manpages_url.format(**node.attributes)
-            self.visit_reference(node)
-
-    def depart_manpage(self, node: Element) -> None:
-        if self.manpages_url:
-            self.depart_reference(node)
-        self.depart_literal_emphasis(node)
-
-    # overwritten to add even/odd classes
-
-    def visit_table(self, node: Element) -> None:
-        self._table_row_indices.append(0)
-
-        # set align=default if align not specified to give a default style
-        node.setdefault('align', 'default')
-
-        return super().visit_table(node)
-
-    def depart_table(self, node: Element) -> None:
-        self._table_row_indices.pop()
-        super().depart_table(node)
-
-    def visit_row(self, node: Element) -> None:
-        self._table_row_indices-1 += 1
-        if self._table_row_indices-1 % 2 == 0:
-            node'classes'.append('row-even')
-        else:
-            node'classes'.append('row-odd')
-        self.body.append(self.starttag(node, 'tr', ''))
-        node.column = 0  # type: ignore
-
-    def visit_entry(self, node: Element) -> None:
-        super().visit_entry(node)
-        if self.body-1 == '&nbsp;':
-            self.body-1 = '&#160;'
-
-    def visit_field_list(self, node: Element) -> None:
-        self._fieldlist_row_indices.append(0)
-        return super().visit_field_list(node)
-
-    def depart_field_list(self, node: Element) -> None:
-        self._fieldlist_row_indices.pop()
-        return super().depart_field_list(node)
-
-    def visit_field(self, node: Element) -> None:
-        self._fieldlist_row_indices-1 += 1
-        if self._fieldlist_row_indices-1 % 2 == 0:
-            node'classes'.append('field-even')
-        else:
-            node'classes'.append('field-odd')
-        self.body.append(self.starttag(node, 'tr', '', CLASS='field'))
-
-    def visit_field_name(self, node: Element) -> None:
-        context_count = len(self.context)
-        super().visit_field_name(node)
-        if context_count != len(self.context):
-            self.context-1 = self.context-1.replace('&nbsp;', '&#160;')
-
-    def visit_math(self, node: Element, math_env: str = '') -> None:
-        name = self.builder.math_renderer_name
-        visit, _ = self.builder.app.registry.html_inline_math_renderersname
-        visit(self, node)
-
-    def depart_math(self, node: Element, math_env: str = '') -> None:
-        name = self.builder.math_renderer_name
-        _, depart = self.builder.app.registry.html_inline_math_renderersname
-        if depart:
-            depart(self, node)
-
-    def visit_math_block(self, node: Element, math_env: str = '') -> None:
-        name = self.builder.math_renderer_name
-        visit, _ = self.builder.app.registry.html_block_math_renderersname
-        visit(self, node)
-
-    def depart_math_block(self, node: Element, math_env: str = '') -> None:
-        name = self.builder.math_renderer_name
-        _, depart = self.builder.app.registry.html_block_math_renderersname
-        if depart:
-            depart(self, node)
-
-    @property
-    def permalink_text(self) -> str:
-        warnings.warn('HTMLTranslator.permalink_text is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self.config.html_permalinks_icon
-
-    @property
-    def _fieldlist_row_index(self):
-        warnings.warn('_fieldlist_row_index is deprecated',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        return self._fieldlist_row_indices-1
-
-    @property
-    def _table_row_index(self):
-        warnings.warn('_table_row_index is deprecated',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        return self._table_row_indices-1

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/html5.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/html5.py Changed

@@ -1,19 +1,12 @@
-"""
-    sphinx.writers.html5
-    ~~~~~~~~~~~~~~~~~~~~
+"""Experimental docutils writers for HTML5 handling Sphinx's custom nodes."""
 
-    Experimental docutils writers for HTML5 handling Sphinx's custom nodes.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import os
 import posixpath
 import re
 import urllib.parse
-import warnings
-from typing import TYPE_CHECKING, Iterable, Set, Tuple, cast
+from typing import TYPE_CHECKING, Iterable, cast
 
 from docutils import nodes
 from docutils.nodes import Element, Node, Text
@@ -21,7 +14,6 @@
 
 from sphinx import addnodes
 from sphinx.builders import Builder
-from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
 from sphinx.locale import _, __, admonitionlabels
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxTranslator
@@ -42,12 +34,11 @@
     matched = re.match(r'^(\d*\.?\d*)\s*(\S*)$', length)
     if not matched:
         return length
-    elif scale == 100:
+    if scale == 100:
         return length
-    else:
-        amount, unit = matched.groups()
-        result = float(amount) * scale / 100
-        return "%s%s" % (int(result), unit)
+    amount, unit = matched.groups()
+    result = float(amount) * scale / 100
+    return f"{int(result)}{unit}"
 
 
 class HTML5Translator(SphinxTranslator, BaseTranslator):
@@ -55,11 +46,11 @@
     Our custom HTML translator.
     """
 
-    builder: "StandaloneHTMLBuilder" = None
+    builder: StandaloneHTMLBuilder
     # Override docutils.writers.html5_polyglot:HTMLTranslator
     # otherwise, nodes like <inline classes="s">...</inline> will be
     # converted to <s>...</s> by `visit_inline`.
-    supported_inline_tags: Setstr = set()
+    supported_inline_tags: setstr = set()
 
     def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
@@ -230,7 +221,7 @@
                    'References must have "refuri" or "refid" attribute.'
             atts'href' = '#' + node'refid'
         if not isinstance(node.parent, nodes.TextElement):
-            assert len(node) == 1 and isinstance(node0, nodes.image)
+            assert len(node) == 1 and isinstance(node0, nodes.image)  # NoQA: PT018
             atts'class' += ' image-reference'
         if 'reftitle' in node:
             atts'title' = node'reftitle'
@@ -259,20 +250,23 @@
         if name:
             node.insert(0, nodes.title(name, admonitionlabelsname))
 
+    def depart_admonition(self, node: Element | None = None) -> None:
+        self.body.append('</div>\n')
+
     def visit_seealso(self, node: Element) -> None:
         self.visit_admonition(node, 'seealso')
 
     def depart_seealso(self, node: Element) -> None:
         self.depart_admonition(node)
 
-    def get_secnumber(self, node: Element) -> Tupleint, ...:
+    def get_secnumber(self, node: Element) -> tupleint, ... | None:
         if node.get('secnumber'):
             return node'secnumber'
 
         if isinstance(node.parent, nodes.section):
             if self.builder.name == 'singlehtml':
                 docname = self.docnames-1
-                anchorname = "%s/#%s" % (docname, node.parent'ids'0)
+                anchorname = "{}/#{}".format(docname, node.parent'ids'0)
                 if anchorname not in self.builder.secnumbers:
                     anchorname = "%s/" % docname  # try first heading which has no anchor
             else:
@@ -294,7 +288,7 @@
     def add_fignumber(self, node: Element) -> None:
         def append_fignumber(figtype: str, figure_id: str) -> None:
             if self.builder.name == 'singlehtml':
-                key = "%s/%s" % (self.docnames-1, figtype)
+                key = f"{self.docnames-1}/{figtype}"
             else:
                 key = figtype
 
@@ -389,12 +383,12 @@
                 node.parent.hasattr('ids') and node.parent'ids'):
             # add permalink anchor
             if close_tag.startswith('</h'):
-                self.add_permalink_ref(node.parent, _('Permalink to this headline'))
+                self.add_permalink_ref(node.parent, _('Permalink to this heading'))
             elif close_tag.startswith('</a></h'):
                 self.body.append('</a><a class="headerlink" href="#%s" ' %
                                  node.parent'ids'0 +
-                                 'title="%s">%s' % (
-                                     _('Permalink to this headline'),
+                                 'title="{}">{}'.format(
+                                     _('Permalink to this heading'),
                                      self.config.html_permalinks_icon))
             elif isinstance(node.parent, nodes.table):
                 self.body.append('</span>')
@@ -421,7 +415,7 @@
 
         highlighted = self.highlighter.highlight_block(
             node.rawsource, lang, opts=opts, linenos=linenos,
-            location=node, **highlight_args
+            location=node, **highlight_args,
         )
         starttag = self.starttag(node, 'div', suffix='',
                                  CLASS='highlight-%s notranslate' % lang)
@@ -467,10 +461,25 @@
         if 'kbd' in node'classes':
             self.body.append(self.starttag(node, 'kbd', '',
                                            CLASS='docutils literal notranslate'))
-        else:
+            return
+        lang = node.get("language", None)
+        if 'code' not in node'classes' or not lang:
             self.body.append(self.starttag(node, 'code', '',
                                            CLASS='docutils literal notranslate'))
             self.protect_literal_text += 1
+            return
+
+        opts = self.config.highlight_options.get(lang, {})
+        highlighted = self.highlighter.highlight_block(
+            node.astext(), lang, opts=opts, location=node, nowrap=True)
+        starttag = self.starttag(
+            node,
+            "code",
+            suffix="",
+            CLASS="docutils literal highlight highlight-%s" % lang,
+        )
+        self.body.append(starttag + highlighted.strip() + "</code>")
+        raise nodes.SkipNode
 
     def depart_literal(self, node: Element) -> None:
         if 'kbd' in node'classes':
@@ -557,7 +566,7 @@
         # rewrite the URI if the environment knows about it
         if olduri in self.builder.images:
             node'uri' = posixpath.join(self.builder.imgpath,
-                                         self.builder.imagesolduri)
+                                         urllib.parse.quote(self.builder.imagesolduri))
 
         if 'scale' in node:
             # Try to figure out image height and width.  Docutils does that too,
@@ -566,8 +575,10 @@
             if not ('width' in node and 'height' in node):
                 size = get_image_size(os.path.join(self.builder.srcdir, olduri))
                 if size is None:
-                    logger.warning(__('Could not obtain image size. :scale: option is ignored.'),  # NOQA
-                                   location=node)
+                    logger.warning(
+                        __('Could not obtain image size. :scale: option is ignored.'),
+                        location=node,
+                    )
                 else:
                     if 'width' not in node:
                         node'width' = str(size0)
@@ -797,7 +808,7 @@
     def depart_math(self, node: Element, math_env: str = '') -> None:
         name = self.builder.math_renderer_name
         _, depart = self.builder.app.registry.html_inline_math_renderersname
-        if depart:
+        if depart:  # type: ignoretruthy-function
             depart(self, node)
 
     def visit_math_block(self, node: Element, math_env: str = '') -> None:
@@ -808,38 +819,5 @@
     def depart_math_block(self, node: Element, math_env: str = '') -> None:
         name = self.builder.math_renderer_name
         _, depart = self.builder.app.registry.html_block_math_renderersname
-        if depart:
+        if depart:  # type: ignoretruthy-function
             depart(self, node)
-
-    @property
-    def permalink_text(self) -> str:
-        warnings.warn('HTMLTranslator.permalink_text is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        return self.config.html_permalinks_icon
-
-    def generate_targets_for_table(self, node: Element) -> None:
-        """Generate hyperlink targets for tables.
-
-        Original visit_table() generates hyperlink targets inside table tags
-        (<table>) if multiple IDs are assigned to listings.
-        That is invalid DOM structure.  (This is a bug of docutils <= 0.13.1)
-
-        This exports hyperlink targets before tables to make valid DOM structure.
-        """
-        warnings.warn('generate_targets_for_table() is deprecated',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        for id in node'ids'1::
-            self.body.append('<span id="%s"></span>' % id)
-            node'ids'.remove(id)
-
-    @property
-    def _fieldlist_row_index(self):
-        warnings.warn('_fieldlist_row_index is deprecated',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        return self._fieldlist_row_indices-1
-
-    @property
-    def _table_row_index(self):
-        warnings.warn('_table_row_index is deprecated',
-                      RemovedInSphinx60Warning, stacklevel=2)
-        return self._table_row_indices-1

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/latex.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/latex.py Changed

@@ -1,27 +1,20 @@
-"""
-    sphinx.writers.latex
-    ~~~~~~~~~~~~~~~~~~~~
-
-    Custom docutils writer for LaTeX.
-
-    Much of this code is adapted from Dave Kuhlman's "docpy" writer from his
-    docutils sandbox.
+"""Custom docutils writer for LaTeX.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Much of this code is adapted from Dave Kuhlman's "docpy" writer from his
+docutils sandbox.
 """
 
+from __future__ import annotations
+
 import re
-import warnings
 from collections import defaultdict
 from os import path
-from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Set, Tuple, cast
+from typing import TYPE_CHECKING, Any, Iterable, cast
 
 from docutils import nodes, writers
 from docutils.nodes import Element, Node, Text
 
 from sphinx import addnodes, highlighting
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.domains import IndexEntry
 from sphinx.domains.std import StandardDomain
 from sphinx.errors import SphinxError
@@ -79,23 +72,17 @@
         ('Document class', '--docclass', {'default': 'manual'}),
         ('Author', '--author', {'default': ''}),
     ))
-    settings_defaults: Dict = {}
+    settings_defaults: dictstr, Any = {}
 
     output = None
 
-    def __init__(self, builder: "LaTeXBuilder") -> None:
+    def __init__(self, builder: LaTeXBuilder) -> None:
         super().__init__()
         self.builder = builder
         self.theme: Theme = None
 
     def translate(self) -> None:
-        try:
-            visitor = self.builder.create_translator(self.document, self.builder, self.theme)
-        except TypeError:
-            warnings.warn('LaTeXTranslator now takes 3rd argument; "theme".',
-                          RemovedInSphinx50Warning, stacklevel=2)
-            visitor = self.builder.create_translator(self.document, self.builder)
-
+        visitor = self.builder.create_translator(self.document, self.builder, self.theme)
         self.document.walkabout(visitor)
         self.output = cast(LaTeXTranslator, visitor).astext()
 
@@ -106,25 +93,41 @@
     """A table data"""
 
     def __init__(self, node: Element) -> None:
-        self.header: Liststr = 
-        self.body: Liststr = 
+        self.header: liststr = 
+        self.body: liststr = 
         self.align = node.get('align', 'default')
-        self.classes: Liststr = node.get('classes', )
+        self.classes: liststr = node.get('classes', )
+        self.styles: liststr = 
+        if 'standard' in self.classes:
+            self.styles.append('standard')
+        elif 'borderless' in self.classes:
+            self.styles.append('borderless')
+        elif 'booktabs' in self.classes:
+            self.styles.append('booktabs')
+        if 'nocolorrows' in self.classes:
+            self.styles.append('nocolorrows')
+        elif 'colorrows' in self.classes:
+            self.styles.append('colorrows')
         self.colcount = 0
         self.colspec: str = None
-        self.colwidths: Listint = 
+        self.colsep: str = None
+        if 'booktabs' in self.styles or 'borderless' in self.styles:
+            self.colsep = ''
+        elif 'standard' in self.styles:
+            self.colsep = '|'
+        self.colwidths: listint = 
         self.has_problematic = False
         self.has_oldproblematic = False
         self.has_verbatim = False
-        self.caption: Liststr = None
-        self.stubs: Listint = 
+        self.caption: liststr = None
+        self.stubs: listint = 
 
         # current position
         self.col = 0
         self.row = 0
 
         # A dict mapping a table location to a cell_id (cell = rectangular area)
-        self.cells: DictTupleint, int, int = defaultdict(int)
+        self.cells: dicttupleint, int, int = defaultdict(int)
         self.cell_id = 0  # last assigned cell_id
 
     def is_longtable(self) -> bool:
@@ -156,23 +159,30 @@
 
         This is what LaTeX calls the 'preamble argument' of the used table environment.
 
-        .. note:: the ``\\X`` and ``T`` column type specifiers are defined in ``sphinx.sty``.
+        .. note::
+
+           The ``\\X`` and ``T`` column type specifiers are defined in
+           ``sphinxlatextables.sty``.
         """
         if self.colspec:
             return self.colspec
-        elif self.colwidths and 'colwidths-given' in self.classes:
+
+        _colsep = self.colsep
+        if self.colwidths and 'colwidths-given' in self.classes:
             total = sum(self.colwidths)
             colspecs = r'\X{%d}{%d}' % (width, total) for width in self.colwidths
-            return '{|%s|}' % '|'.join(colspecs) + CR
+            return f'{{{_colsep}{_colsep.join(colspecs)}{_colsep}}}' + CR
         elif self.has_problematic:
-            return r'{|*{%d}{\X{1}{%d}|}}' % (self.colcount, self.colcount) + CR
+            return r'{%s*{%d}{\X{1}{%d}%s}}' % (_colsep, self.colcount,
+                                                self.colcount, _colsep) + CR
         elif self.get_table_type() == 'tabulary':
             # sphinx.sty sets T to be J by default.
-            return '{|' + ('T|' * self.colcount) + '}' + CR
+            return '{' + _colsep + (('T' + _colsep) * self.colcount) + '}' + CR
         elif self.has_oldproblematic:
-            return r'{|*{%d}{\X{1}{%d}|}}' % (self.colcount, self.colcount) + CR
+            return r'{%s*{%d}{\X{1}{%d}%s}}' % (_colsep, self.colcount,
+                                                self.colcount, _colsep) + CR
         else:
-            return '{|' + ('l|' * self.colcount) + '}' + CR
+            return '{' + _colsep + (('l' + _colsep) * self.colcount) + '}' + CR
 
     def add_cell(self, height: int, width: int) -> None:
         """Adds a new cell to a table.
@@ -185,7 +195,9 @@
                 assert self.cells(self.row + row, self.col + col) == 0
                 self.cells(self.row + row, self.col + col) = self.cell_id
 
-    def cell(self, row: int = None, col: int = None) -> "TableCell":
+    def cell(
+        self, row: int | None = None, col: int | None = None,
+    ) -> TableCell | None:
         """Returns a cell object (i.e. rectangular area) containing given position.
 
         If no option arguments: ``row`` or ``col`` are given, the current position;
@@ -265,30 +277,23 @@
         elif unit == "%":
             res = r"%.5f\linewidth" % (amount_float / 100.0)
         else:
-            res = "%.5f%s" % (amount_float, unit)
+            res = f"{amount_float:.5f}{unit}"
     return res
 
 
 class LaTeXTranslator(SphinxTranslator):
-    builder: "LaTeXBuilder" = None
+    builder: LaTeXBuilder
 
     secnumdepth = 2  # legacy sphinxhowto.cls uses this, whereas article.cls
     # default is originally 3. For book/report, 2 is already LaTeX default.
     ignore_missing_images = False
 
-    # sphinx specific document classes
-    docclasses = ('howto', 'manual')
-
-    def __init__(self, document: nodes.document, builder: "LaTeXBuilder",
-                 theme: "Theme" = None) -> None:
+    def __init__(self, document: nodes.document, builder: LaTeXBuilder,
+                 theme: Theme) -> None:
         super().__init__(document, builder)
-        self.body: Liststr = 
+        self.body: liststr = 
         self.theme = theme
 
-        if theme is None:
-            warnings.warn('LaTeXTranslator now takes 3rd argument; "theme".',
-                          RemovedInSphinx50Warning, stacklevel=2)
-
         # flags
         self.in_title = 0
         self.in_production_list = 0
@@ -304,6 +309,7 @@
         self.in_parsed_literal = 0
         self.compact_list = 0
         self.first_param = 0
+        self.in_desc_signature = False
 
         sphinxpkgoptions = 
 
@@ -312,30 +318,8 @@
 
         # initial section names
         self.sectionnames = LATEXSECTIONNAMES:
-
-        if self.theme:
-            # new style: control sectioning via theme's setting
-            #
-            # .. note:: template variables(elements) are already assigned in builder
-            docclass = self.theme.docclass
-            if self.theme.toplevel_sectioning == 'section':
-                self.sectionnames.remove('chapter')
-        else:
-            # old style: sectioning control is hard-coded
-            # but some have other interface in config file
-            self.elements'wrapperclass' = self.format_docclass(self.settings.docclass)
-
-            # we assume LaTeX class provides \chapter command except in case
-            # of non-Japanese 'howto' case
-            if document.get('docclass') == 'howto':
-                docclass = self.config.latex_docclass.get('howto', 'article')
-                if docclass0 == 'j':  # Japanese class...
-                    pass
-                else:
-                    self.sectionnames.remove('chapter')
-            else:
-                docclass = self.config.latex_docclass.get('manual', 'report')
-            self.elements'docclass' = docclass
+        if self.theme.toplevel_sectioning == 'section':
+            self.sectionnames.remove('chapter')
 
         # determine top section level
         self.top_sectionlevel = 1
@@ -345,7 +329,7 @@
                     self.sectionnames.index(self.config.latex_toplevel_sectioning)
             except ValueError:
                 logger.warning(__('unknown %r toplevel_sectioning for class %r') %
-                               (self.config.latex_toplevel_sectioning, docclass))
+                               (self.config.latex_toplevel_sectioning, self.theme.docclass))
 
         if self.config.numfig:
             self.numfig_secnum_depth = self.config.numfig_secnum_depth
@@ -368,7 +352,7 @@
         if self.config.numfig and self.config.math_numfig:
             sphinxpkgoptions.append('mathnumfig')
 
-        if (self.config.language not in {None, 'en', 'ja'} and
+        if (self.config.language not in {'en', 'ja'} and
                 'fncychap' not in self.config.latex_elements):
             # use Sonny style if any language specified (except English)
             self.elements'fncychap' = (r'\usepackageSonny{fncychap}' + CR +
@@ -376,7 +360,7 @@
                                          r'\ChTitleVar{\Large\normalfont\sffamily}')
 
         self.babel = self.builder.babel
-        if self.config.language and not self.babel.is_supported_language():
+        if not self.babel.is_supported_language():
             # emit warning if specified language is invalid
             # (only emitting, nothing changed to processing)
             logger.warning(__('no Babel option known for language %r'),
@@ -425,37 +409,29 @@
 
         self.highlighter = highlighting.PygmentsBridge('latex', self.config.pygments_style,
                                                        latex_engine=self.config.latex_engine)
-        self.context: ListAny = 
-        self.descstack: Liststr = 
-        self.tables: ListTable = 
-        self.next_table_colspec: str = None
-        self.bodystack: ListListstr = 
-        self.footnote_restricted: Element = None
-        self.pending_footnotes: Listnodes.footnote_reference = 
-        self.curfilestack: Liststr = 
-        self.handled_abbrs: Setstr = set()
-
-    def pushbody(self, newbody: Liststr) -> None:
+        self.context: listAny = 
+        self.descstack: liststr = 
+        self.tables: listTable = 
+        self.next_table_colspec: str | None = None
+        self.bodystack: listliststr = 
+        self.footnote_restricted: Element | None = None
+        self.pending_footnotes: listnodes.footnote_reference = 
+        self.curfilestack: liststr = 
+        self.handled_abbrs: setstr = set()
+
+    def pushbody(self, newbody: liststr) -> None:
         self.bodystack.append(self.body)
         self.body = newbody
 
-    def popbody(self) -> Liststr:
+    def popbody(self) -> liststr:
         body = self.body
         self.body = self.bodystack.pop()
         return body
 
-    def format_docclass(self, docclass: str) -> str:
-        """Prepends prefix to sphinx document classes"""
-        warnings.warn('LaTeXWriter.format_docclass() is deprecated.',
-                      RemovedInSphinx50Warning, stacklevel=2)
-        if docclass in self.docclasses:
-            docclass = 'sphinx' + docclass
-        return docclass
-
     def astext(self) -> str:
         self.elements.update({
             'body': ''.join(self.body),
-            'indices': self.generate_indices()
+            'indices': self.generate_indices(),
         })
         return self.render('latex.tex_t', self.elements)
 
@@ -493,10 +469,10 @@
             prefix = ''
             suffix = ''
 
-        return r'%s\renewcommand{%s}{%s}%s' % (prefix, command, definition, suffix) + CR
+        return fr'{prefix}\renewcommand{{{command}}}{{{definition}}}{suffix}' + CR
 
     def generate_indices(self) -> str:
-        def generate(content: ListTuplestr, ListIndexEntry, collapsed: bool) -> None:
+        def generate(content: listtuplestr, listIndexEntry, collapsed: bool) -> None:
             ret.append(r'\begin{sphinxtheindex}' + CR)
             ret.append(r'\let\bigletter\sphinxstyleindexlettergroup' + CR)
             for i, (letter, entries) in enumerate(content):
@@ -521,7 +497,7 @@
         if indices_config:
             for domain in self.builder.env.domains.values():
                 for indexcls in domain.indices:
-                    indexname = '%s-%s' % (domain.name, indexcls.name)
+                    indexname = f'{domain.name}-{indexcls.name}'
                     if isinstance(indices_config, list):
                         if indexname not in indices_config:
                             continue
@@ -534,7 +510,7 @@
 
         return ''.join(ret)
 
-    def render(self, template_name: str, variables: Dict) -> str:
+    def render(self, template_name: str, variables: dictstr, Any) -> str:
         renderer = LaTeXRenderer(latex_engine=self.config.latex_engine)
         for template_dir in self.config.templates_path:
             template = path.join(self.builder.confdir, template_dir,
@@ -545,7 +521,7 @@
         return renderer.render(template_name, variables)
 
     @property
-    def table(self) -> Table:
+    def table(self) -> Table | None:
         """Get current table."""
         if self.tables:
             return self.tables-1
@@ -571,6 +547,7 @@
 
     def visit_start_of_file(self, node: Element) -> None:
         self.curfilestack.append(node'docname')
+        self.body.append(CR + r'\sphinxstepscope' + CR)
 
     def depart_start_of_file(self, node: Element) -> None:
         self.curfilestack.pop()
@@ -637,7 +614,7 @@
         if isinstance(parent, addnodes.seealso):
             # the environment already handles this
             raise nodes.SkipNode
-        elif isinstance(parent, nodes.section):
+        if isinstance(parent, nodes.section):
             if self.this_is_the_title:
                 if len(node.children) != 1 and not isinstance(node.children0,
                                                               nodes.Text):
@@ -649,17 +626,16 @@
                     self.elements'title' = self.escape(node.astext())
                 self.this_is_the_title = 0
                 raise nodes.SkipNode
-            else:
-                short = ''
-                if any(node.findall(nodes.image)):
-                    short = ('%s' % self.escape(' '.join(clean_astext(node).split())))
-
-                try:
-                    self.body.append(r'\%s%s{' % (self.sectionnamesself.sectionlevel, short))
-                except IndexError:
-                    # just use "subparagraph", it's not numbered anyway
-                    self.body.append(r'\%s%s{' % (self.sectionnames-1, short))
-                self.context.append('}' + CR + self.hypertarget_to(node.parent))
+            short = ''
+            if any(node.findall(nodes.image)):
+                short = ('%s' % self.escape(' '.join(clean_astext(node).split())))
+
+            try:
+                self.body.append(fr'\{self.sectionnamesself.sectionlevel}{short}{{')
+            except IndexError:
+                # just use "subparagraph", it's not numbered anyway
+                self.body.append(fr'\{self.sectionnames-1}{short}{{')
+            self.context.append('}' + CR + self.hypertarget_to(node.parent))
         elif isinstance(parent, nodes.topic):
             self.body.append(r'\sphinxstyletopictitle{')
             self.context.append('}' + CR)
@@ -715,6 +691,9 @@
             self.table.has_problematic = True
 
     def depart_desc(self, node: Element) -> None:
+        if self.in_desc_signature:
+            self.body.append(CR + r'\pysigstopsignatures')
+            self.in_desc_signature = False
         if self.config.latex_show_urls == 'footnote':
             self.body.append(CR + r'\end{fulllineitems}\end{savenotes}' + BLANKLINE)
         else:
@@ -723,32 +702,33 @@
     def _visit_signature_line(self, node: Element) -> None:
         for child in node:
             if isinstance(child, addnodes.desc_parameterlist):
-                self.body.append(r'\pysiglinewithargsret{')
+                self.body.append(CR + r'\pysiglinewithargsret{')
                 break
         else:
-            self.body.append(r'\pysigline{')
+            self.body.append(CR + r'\pysigline{')
 
     def _depart_signature_line(self, node: Element) -> None:
         self.body.append('}')
 
     def visit_desc_signature(self, node: Element) -> None:
+        hyper = ''
         if node.parent'objtype' != 'describe' and node'ids':
-            hyper = self.hypertarget(node'ids'0)
-        else:
-            hyper = ''
+            for id in node'ids':
+                hyper += self.hypertarget(id)
         self.body.append(hyper)
+        if not self.in_desc_signature:
+            self.in_desc_signature = True
+            self.body.append(CR + r'\pysigstartsignatures')
         if not node.get('is_multiline'):
             self._visit_signature_line(node)
         else:
-            self.body.append('%' + CR)
-            self.body.append(r'\pysigstartmultiline' + CR)
+            self.body.append(CR + r'\pysigstartmultiline')
 
     def depart_desc_signature(self, node: Element) -> None:
         if not node.get('is_multiline'):
             self._depart_signature_line(node)
         else:
-            self.body.append('%' + CR)
-            self.body.append(r'\pysigstopmultiline')
+            self.body.append(CR + r'\pysigstopmultiline')
 
     def visit_desc_signature_line(self, node: Element) -> None:
         self._visit_signature_line(node)
@@ -757,7 +737,9 @@
         self._depart_signature_line(node)
 
     def visit_desc_content(self, node: Element) -> None:
-        pass
+        assert self.in_desc_signature
+        self.body.append(CR + r'\pysigstopsignatures')
+        self.in_desc_signature = False
 
     def depart_desc_content(self, node: Element) -> None:
         pass
@@ -814,7 +796,7 @@
         else:
             self.first_param = 0
         if not node.hasattr('noemph'):
-            self.body.append(r'\emph{')
+            self.body.append(r'\sphinxparam{')
 
     def depart_desc_parameter(self, node: Element) -> None:
         if not node.hasattr('noemph'):
@@ -836,11 +818,12 @@
 
     def visit_seealso(self, node: Element) -> None:
         self.body.append(BLANKLINE)
-        self.body.append(r'\sphinxstrong{%s:}' % admonitionlabels'seealso' + CR)
-        self.body.append(r'\nopagebreak' + BLANKLINE)
+        self.body.append(r'\begin{sphinxseealso}{%s:}' % admonitionlabels'seealso' + CR)
 
     def depart_seealso(self, node: Element) -> None:
         self.body.append(BLANKLINE)
+        self.body.append(r'\end{sphinxseealso}')
+        self.body.append(BLANKLINE)
 
     def visit_rubric(self, node: Element) -> None:
         if len(node) == 1 and node.astext() in ('Footnotes', _('Footnotes')):
@@ -856,16 +839,14 @@
     def visit_footnote(self, node: Element) -> None:
         self.in_footnote += 1
         label = cast(nodes.label, node0)
-        if 'auto' not in node:
-            self.body.append(r'\sphinxstepexplicit ')
         if self.in_parsed_literal:
             self.body.append(r'\begin{footnote}%s' % label.astext())
         else:
             self.body.append('%' + CR)
             self.body.append(r'\begin{footnote}%s' % label.astext())
-        if 'auto' not in node:
-            self.body.append(r'\phantomsection'
-                             r'\label{\thesphinxscope.%s}%%' % label.astext() + CR)
+        if 'referred' in node:
+            # TODO: in future maybe output a latex macro with backrefs here
+            pass
         self.body.append(r'\sphinxAtStartFootnote' + CR)
 
     def depart_footnote(self, node: Element) -> None:
@@ -889,18 +870,28 @@
                 raise UnsupportedError(
                     '%s:%s: longtable does not support nesting a table.' %
                     (self.curfilestack-1, node.line or ''))
-            else:
-                # change type of parent table to tabular
-                # see https://groups.google.com/d/msg/sphinx-users/7m3NeOBixeo/9LKP2B4WBQAJ
-                self.table.has_problematic = True
+            # change type of parent table to tabular
+            # see https://groups.google.com/d/msg/sphinx-users/7m3NeOBixeo/9LKP2B4WBQAJ
+            self.table.has_problematic = True
         elif len(self.tables) > 2:
             raise UnsupportedError(
                 '%s:%s: deeply nested tables are not implemented.' %
                 (self.curfilestack-1, node.line or ''))
 
         self.tables.append(Table(node))
+        if self.table.colsep is None:
+            self.table.colsep = '' if (
+                'booktabs' in self.builder.config.latex_table_style or
+                'borderless' in self.builder.config.latex_table_style
+            ) else '|'
         if self.next_table_colspec:
             self.table.colspec = '{%s}' % self.next_table_colspec + CR
+            if '|' in self.table.colspec:
+                self.table.styles.append('vlines')
+                self.table.colsep = '|'
+            else:
+                self.table.styles.append('novlines')
+                self.table.colsep = ''
             if 'colwidths-given' in node.get('classes', ):
                 logger.info(__('both tabularcolumns and :widths: option are given. '
                                ':widths: is ignored.'), location=node)
@@ -910,7 +901,7 @@
         labels = self.hypertarget_to(node)
         table_type = self.table.get_table_type()
         table = self.render(table_type + '.tex_t',
-                            dict(table=self.table, labels=labels))
+                            {'table': self.table, 'labels': labels})
         self.body.append(BLANKLINE)
         self.body.append(table)
         self.body.append(CR)
@@ -938,6 +929,8 @@
         self.pushbody(self.table.header)
 
     def depart_thead(self, node: Element) -> None:
+        if self.body and self.body-1 == r'\sphinxhline':
+            self.body.pop()
         self.popbody()
 
     def visit_tbody(self, node: Element) -> None:
@@ -945,42 +938,55 @@
         self.pushbody(self.table.body)
 
     def depart_tbody(self, node: Element) -> None:
+        if self.body and self.body-1 == r'\sphinxhline':
+            self.body.pop()
         self.popbody()
 
     def visit_row(self, node: Element) -> None:
         self.table.col = 0
-
+        _colsep = self.table.colsep
         # fill columns if the row starts with the bottom of multirow cell
         while True:
             cell = self.table.cell(self.table.row, self.table.col)
             if cell is None:  # not a bottom of multirow cell
                 break
-            else:  # a bottom of multirow cell
-                self.table.col += cell.width
-                if cell.col:
-                    self.body.append('&')
-                if cell.width == 1:
-                    # insert suitable strut for equalizing row heights in given multirow
-                    self.body.append(r'\sphinxtablestrut{%d}' % cell.cell_id)
-                else:  # use \multicolumn for wide multirow cell
-                    self.body.append(r'\multicolumn{%d}{|l|}{\sphinxtablestrut{%d}}' %
-                                     (cell.width, cell.cell_id))
+            # a bottom of multirow cell
+            self.table.col += cell.width
+            if cell.col:
+                self.body.append('&')
+            if cell.width == 1:
+                # insert suitable strut for equalizing row heights in given multirow
+                self.body.append(r'\sphinxtablestrut{%d}' % cell.cell_id)
+            else:  # use \multicolumn for wide multirow cell
+                self.body.append(r'\multicolumn{%d}{%sl%s}{\sphinxtablestrut{%d}}' %
+                                 (cell.width, _colsep, _colsep, cell.cell_id))
 
     def depart_row(self, node: Element) -> None:
         self.body.append(r'\\' + CR)
         cells = self.table.cell(self.table.row, i) for i in range(self.table.colcount)
         underlined = cell.row + cell.height == self.table.row + 1 for cell in cells
         if all(underlined):
-            self.body.append(r'\hline')
+            self.body.append(r'\sphinxhline')
         else:
             i = 0
             underlined.extend(False)  # sentinel
-            while i < len(underlined):
-                if underlinedi is True:
-                    j = underlinedi:.index(False)
-                    self.body.append(r'\cline{%d-%d}' % (i + 1, i + j))
-                    i += j
+            if underlined0 is False:
+                i = 1
+                while i < self.table.colcount and underlinedi is False:
+                    if cellsi - 1.cell_id != cellsi.cell_id:
+                        self.body.append(r'\sphinxvlinecrossing{%d}' % i)
+                    i += 1
+            while i < self.table.colcount:
+                # each time here underlinedi is True
+                j = underlinedi:.index(False)
+                self.body.append(r'\sphinxcline{%d-%d}' % (i + 1, i + j))
+                i += j
                 i += 1
+                while i < self.table.colcount and underlinedi is False:
+                    if cellsi - 1.cell_id != cellsi.cell_id:
+                        self.body.append(r'\sphinxvlinecrossing{%d}' % i)
+                    i += 1
+            self.body.append(r'\sphinxfixclines{%d}' % self.table.colcount)
         self.table.row += 1
 
     def visit_entry(self, node: Element) -> None:
@@ -989,12 +995,14 @@
         self.table.add_cell(node.get('morerows', 0) + 1, node.get('morecols', 0) + 1)
         cell = self.table.cell()
         context = ''
+        _colsep = self.table.colsep
         if cell.width > 1:
             if self.config.latex_use_latex_multicolumn:
                 if self.table.col == 0:
-                    self.body.append(r'\multicolumn{%d}{|l|}{%%' % cell.width + CR)
+                    self.body.append(r'\multicolumn{%d}{%sl%s}{%%' %
+                                     (cell.width, _colsep, _colsep) + CR)
                 else:
-                    self.body.append(r'\multicolumn{%d}{l|}{%%' % cell.width + CR)
+                    self.body.append(r'\multicolumn{%d}{l%s}{%%' % (cell.width, _colsep) + CR)
                 context = '}%' + CR
             else:
                 self.body.append(r'\sphinxstartmulticolumn{%d}%%' % cell.width + CR)
@@ -1034,23 +1042,24 @@
 
         cell = self.table.cell()
         self.table.col += cell.width
+        _colsep = self.table.colsep
 
         # fill columns if next ones are a bottom of wide-multirow cell
         while True:
             nextcell = self.table.cell()
             if nextcell is None:  # not a bottom of multirow cell
                 break
-            else:  # a bottom part of multirow cell
-                self.table.col += nextcell.width
-                self.body.append('&')
-                if nextcell.width == 1:
-                    # insert suitable strut for equalizing row heights in multirow
-                    # they also serve to clear colour panels which would hide the text
-                    self.body.append(r'\sphinxtablestrut{%d}' % nextcell.cell_id)
-                else:
-                    # use \multicolumn for wide multirow cell
-                    self.body.append(r'\multicolumn{%d}{l|}{\sphinxtablestrut{%d}}' %
-                                     (nextcell.width, nextcell.cell_id))
+            # a bottom part of multirow cell
+            self.body.append('&')
+            if nextcell.width == 1:
+                # insert suitable strut for equalizing row heights in multirow
+                # they also serve to clear colour panels which would hide the text
+                self.body.append(r'\sphinxtablestrut{%d}' % nextcell.cell_id)
+            else:
+                # use \multicolumn for not first row of wide multirow cell
+                self.body.append(r'\multicolumn{%d}{l%s}{\sphinxtablestrut{%d}}' %
+                                 (nextcell.width, _colsep, nextcell.cell_id))
+            self.table.col += nextcell.width
 
     def visit_acks(self, node: Element) -> None:
         # this is a list in the source, but should be rendered as a
@@ -1075,7 +1084,7 @@
     def visit_enumerated_list(self, node: Element) -> None:
         def get_enumtype(node: Element) -> str:
             enumtype = node.get('enumtype', 'arabic')
-            if 'alpha' in enumtype and 26 < node.get('start', 0) + len(node):
+            if 'alpha' in enumtype and (node.get('start', 0) + len(node)) > 26:
                 # fallback to arabic if alphabet counter overflows
                 enumtype = 'arabic'
 
@@ -1135,8 +1144,8 @@
             ctx = r'\phantomsection'
             for node_id in node'ids':
                 ctx += self.hypertarget(node_id, anchor=False)
-        ctx += r'} \leavevmode'
-        self.body.append(r'\item{')
+        ctx += r'}'
+        self.body.append(r'\sphinxlineitem{')
         self.context.append(ctx)
 
     def depart_term(self, node: Element) -> None:
@@ -1229,7 +1238,7 @@
         # self.body.append(r'\columnbreak\n')
         pass
 
-    def latex_image_length(self, width_str: str, scale: int = 100) -> str:
+    def latex_image_length(self, width_str: str, scale: int = 100) -> str | None:
         try:
             return rstdim_to_latexdim(width_str, scale)
         except ValueError:
@@ -1241,8 +1250,8 @@
         return isinstance(node.parent, nodes.TextElement)
 
     def visit_image(self, node: Element) -> None:
-        pre: Liststr =   # in reverse order
-        post: Liststr = 
+        pre: liststr =   # in reverse order
+        post: liststr = 
         include_graphics_options = 
         has_hyperlink = isinstance(node.parent, nodes.reference)
         if has_hyperlink:
@@ -1309,14 +1318,17 @@
         if include_graphics_options:
             options = '%s' % ','.join(include_graphics_options)
         base, ext = path.splitext(uri)
+
         if self.in_title and base:
             # Lowercase tokens forcely because some fncychap themes capitalize
             # the options of \sphinxincludegraphics unexpectedly (ex. WIDTH=...).
-            self.body.append(r'\lowercase{\sphinxincludegraphics%s}{{%s}%s}' %
-                             (options, base, ext))
+            cmd = fr'\lowercase{{\sphinxincludegraphics{options}}}{{{{{base}}}{ext}}}'
         else:
-            self.body.append(r'\sphinxincludegraphics%s{{%s}%s}' %
-                             (options, base, ext))
+            cmd = fr'\sphinxincludegraphics{options}{{{{{base}}}{ext}}}'
+        # escape filepath for includegraphics, https://tex.stackexchange.com/a/202714/41112
+        if '#' in base:
+            cmd = r'{\catcode`\#=12' + cmd + '}'
+        self.body.append(cmd)
         self.body.extend(post)
 
     def depart_image(self, node: Element) -> None:
@@ -1350,7 +1362,10 @@
             self.body.append(r'\begin{wrapfigure}{%s}{%s}' %
                              ('r' if node'align' == 'right' else 'l', length or '0pt') + CR)
             self.body.append(r'\centering')
-            self.context.append(r'\end{wrapfigure}' + CR)
+            self.context.append(r'\end{wrapfigure}' +
+                                BLANKLINE +
+                                r'\mbox{}\par\vskip-\dimexpr\baselineskip+\parskip\relax' +
+                                CR)  # avoid disappearance if no text next issues/11079
         elif self.in_minipage:
             self.body.append(CR + r'\begin{center}')
             self.context.append(r'\end{center}' + CR)
@@ -1460,7 +1475,7 @@
         domain = cast(StandardDomain, self.builder.env.get_domain('std'))
         if isinstance(next_node, HYPERLINK_SUPPORT_NODES):
             return
-        elif domain.get_enumerable_node_type(next_node) and domain.get_numfig_title(next_node):
+        if domain.get_enumerable_node_type(next_node) and domain.get_numfig_title(next_node):
             return
 
         if 'refuri' in node:
@@ -1474,7 +1489,26 @@
                 pass
             else:
                 add_target(node'refid')
-        for id in node'ids':
+        # Temporary fix for https://github.com/sphinx-doc/sphinx/issues/11093
+        # TODO: investigate if a more elegant solution exists (see comments of #11093)
+        if node.get('ismod', False):
+            # Detect if the previous nodes are label targets. If so, remove
+            # the refid thereof from node'ids' to avoid duplicated ids.
+            def has_dup_label(sib: Node | None) -> bool:
+                return isinstance(sib, nodes.target) and sib.get('refid') in node'ids'
+
+            prev = get_prev_node(node)
+            if has_dup_label(prev):
+                ids = node'ids':  # copy to avoid side-effects
+                while has_dup_label(prev):
+                    ids.remove(prev'refid')  # type: ignore
+                    prev = get_prev_node(prev)
+            else:
+                ids = iter(node'ids')  # read-only iterator
+        else:
+            ids = iter(node'ids')  # read-only iterator
+
+        for id in ids:
             add_target(id)
 
     def depart_target(self, node: Element) -> None:
@@ -1515,20 +1549,20 @@
             try:
                 if type == 'single':
                     try:
-                        p1, p2 = escape(x) for x in split_into(2, 'single', string)
+                        p1, p2 = (escape(x) for x in split_into(2, 'single', string))
                         P1, P2 = style(p1), style(p2)
-                        self.body.append(r'\index{%s@%s!%s@%s%s}' % (p1, P1, p2, P2, m))
+                        self.body.append(fr'\index{{{p1}@{P1}!{p2}@{P2}{m}}}')
                     except ValueError:
                         p = escape(split_into(1, 'single', string)0)
                         P = style(p)
-                        self.body.append(r'\index{%s@%s%s}' % (p, P, m))
+                        self.body.append(fr'\index{{{p}@{P}{m}}}')
                 elif type == 'pair':
-                    p1, p2 = escape(x) for x in split_into(2, 'pair', string)
+                    p1, p2 = (escape(x) for x in split_into(2, 'pair', string))
                     P1, P2 = style(p1), style(p2)
                     self.body.append(r'\index{%s@%s!%s@%s%s}\index{%s@%s!%s@%s%s}' %
                                      (p1, P1, p2, P2, m, p2, P2, p1, P1, m))
                 elif type == 'triple':
-                    p1, p2, p3 = escape(x) for x in split_into(3, 'triple', string)
+                    p1, p2, p3 = (escape(x) for x in split_into(3, 'triple', string))
                     P1, P2, P3 = style(p1), style(p2), style(p3)
                     self.body.append(
                         r'\index{%s@%s!%s %s@%s %s%s}'
@@ -1538,13 +1572,13 @@
                          p2, P2, p3, p1, P3, P1, m,
                          p3, P3, p1, p2, P1, P2, m))
                 elif type == 'see':
-                    p1, p2 = escape(x) for x in split_into(2, 'see', string)
+                    p1, p2 = (escape(x) for x in split_into(2, 'see', string))
                     P1 = style(p1)
-                    self.body.append(r'\index{%s@%s|see{%s}}' % (p1, P1, p2))
+                    self.body.append(fr'\index{{{p1}@{P1}|see{{{p2}}}}}')
                 elif type == 'seealso':
-                    p1, p2 = escape(x) for x in split_into(2, 'seealso', string)
+                    p1, p2 = (escape(x) for x in split_into(2, 'seealso', string))
                     P1 = style(p1)
-                    self.body.append(r'\index{%s@%s|see{%s}}' % (p1, P1, p2))
+                    self.body.append(fr'\index{{{p1}@{P1}|see{{{p2}}}}}')
                 else:
                     logger.warning(__('unknown index entry type %s found'), type)
             except ValueError as err:
@@ -1578,7 +1612,7 @@
             # references to labels in the same document
             id = self.curfilestack-1 + ':' + uri1:
             self.body.append(self.hyperlink(id))
-            self.body.append(r'\emph{')
+            self.body.append(r'\sphinxsamedocref{')
             if self.config.latex_show_pagerefs and not \
                     self.in_production_list:
                 self.context.append('}}} (%s)' % self.hyperpageref(id))
@@ -1638,7 +1672,7 @@
         else:
             # old style format (cf. "Fig.%{number}")
             text = escape_abbr(title) % (r'\ref{%s}' % self.idescape(id))
-        hyperref = r'\hyperref%s{%s}' % (self.idescape(id), text)
+        hyperref = fr'\hyperref{self.idescape(id)}{{{text}}}'
         self.body.append(hyperref)
 
         raise nodes.SkipNode
@@ -1720,8 +1754,8 @@
 
     def visit_citation(self, node: Element) -> None:
         label = cast(nodes.label, node0)
-        self.body.append(r'\bibitem%s{%s:%s}' % (self.encode(label.astext()),
-                                                   node'docname', node'ids'0))
+        self.body.append(fr'\bibitem{self.encode(label.astext())}'
+                         fr'{{{node"docname"}:{node"ids"0}}}')
 
     def depart_citation(self, node: Element) -> None:
         pass
@@ -1730,7 +1764,7 @@
         if self.in_title:
             pass
         else:
-            self.body.append(r'\sphinxcite{%s:%s}' % (node'docname', node'refname'))
+            self.body.append(fr'\sphinxcite{{{node"docname"}:{node"refname"}}}')
             raise nodes.SkipNode
 
     def depart_citation_reference(self, node: Element) -> None:
@@ -1739,10 +1773,22 @@
     def visit_literal(self, node: Element) -> None:
         if self.in_title:
             self.body.append(r'\sphinxstyleliteralintitle{\sphinxupquote{')
+            return
         elif 'kbd' in node'classes':
             self.body.append(r'\sphinxkeyboard{\sphinxupquote{')
-        else:
+            return
+        lang = node.get("language", None)
+        if 'code' not in node'classes' or not lang:
             self.body.append(r'\sphinxcode{\sphinxupquote{')
+            return
+
+        opts = self.config.highlight_options.get(lang, {})
+        hlcode = self.highlighter.highlight_block(
+            node.astext(), lang, opts=opts, location=node, nowrap=True)
+        self.body.append(r'\sphinxcode{\sphinxupquote{%' + CR
+                         + hlcode.rstrip() + '%' + CR
+                         + '}}')
+        raise nodes.SkipNode
 
     def depart_literal(self, node: Element) -> None:
         self.body.append('}}')
@@ -1759,9 +1805,7 @@
     def visit_footnotetext(self, node: Element) -> None:
         label = cast(nodes.label, node0)
         self.body.append('%' + CR)
-        self.body.append(r'\begin{footnotetext}%s'
-                         r'\phantomsection\label{\thesphinxscope.%s}%%'
-                         % (label.astext(), label.astext()) + CR)
+        self.body.append(r'\begin{footnotetext}%s' % label.astext())
         self.body.append(r'\sphinxAtStartFootnote' + CR)
 
     def depart_footnotetext(self, node: Element) -> None:
@@ -1795,7 +1839,7 @@
 
             hlcode = self.highlighter.highlight_block(
                 node.rawsource, lang, opts=opts, linenos=linenos,
-                location=node, **highlight_args
+                location=node, **highlight_args,
             )
             if self.in_footnote:
                 self.body.append(CR + r'\sphinxSetupCodeBlockInFootnote')
@@ -2044,7 +2088,7 @@
 
     def visit_math_block(self, node: Element) -> None:
         if node.get('label'):
-            label = "equation:%s:%s" % (node'docname', node'label')
+            label = f"equation:{node'docname'}:{node'label'}"
         else:
             label = None
 
@@ -2059,7 +2103,7 @@
         raise nodes.SkipNode
 
     def visit_math_reference(self, node: Element) -> None:
-        label = "equation:%s:%s" % (node'docname', node'target')
+        label = f"equation:{node'docname'}:{node'target'}"
         eqref_format = self.config.math_eqref_format
         if eqref_format:
             try:
@@ -2078,6 +2122,6 @@
 
 # FIXME: Workaround to avoid circular import
 # refs: https://github.com/sphinx-doc/sphinx/issues/5433
-from sphinx.builders.latex.nodes import ( # NOQA isort:skip
+from sphinx.builders.latex.nodes import (  # noqa: E402  # isort:skip
     HYPERLINK_SUPPORT_NODES, captioned_literal_block, footnotetext,
 )

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/manpage.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/manpage.py Changed

@@ -1,17 +1,11 @@
-"""
-    sphinx.writers.manpage
-    ~~~~~~~~~~~~~~~~~~~~~~
+"""Manual page writer, extended for Sphinx custom nodes."""
 
-    Manual page writer, extended for Sphinx custom nodes.
+from __future__ import annotations
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from typing import Any, Dict, Iterable, cast
+from typing import Any, Iterable, cast
 
 from docutils import nodes
-from docutils.nodes import Element, TextElement
+from docutils.nodes import Element
 from docutils.writers.manpage import Translator as BaseTranslator
 from docutils.writers.manpage import Writer
 
@@ -56,7 +50,7 @@
 
     def apply(self, **kwargs: Any) -> None:
         matcher = NodeMatcher(nodes.literal, nodes.emphasis, nodes.strong)
-        for node in list(self.document.findall(matcher)):  # type: TextElement
+        for node in list(self.document.findall(matcher)):  # type: nodes.TextElement
             if any(matcher(subnode) for subnode in node):
                 pos = node.parent.index(node)
                 for subnode in reversed(list(node)):
@@ -76,7 +70,7 @@
     Custom man page translator.
     """
 
-    _docinfo: Dictstr, Any = {}
+    _docinfo: dictstr, Any = {}
 
     def __init__(self, document: nodes.document, builder: Builder) -> None:
         super().__init__(document, builder)
@@ -247,8 +241,7 @@
         if len(node) == 1 and node.astext() in ('Footnotes', _('Footnotes')):
             self.body.append('.SH ' + self.deunicode(node.astext()).upper() + '\n')
             raise nodes.SkipNode
-        else:
-            self.body.append('.sp\n')
+        self.body.append('.sp\n')
 
     def depart_rubric(self, node: Element) -> None:
         self.body.append('\n')
@@ -306,8 +299,7 @@
         self.body.append(self.defs'reference'1)
 
         uri = node.get('refuri', '')
-        if uri.startswith('mailto:') or uri.startswith('http:') or \
-           uri.startswith('https:') or uri.startswith('ftp:'):
+        if uri.startswith(('mailto:', 'http:', 'https:', 'ftp:')):
             # if configured, put the URL after the link
             if self.config.man_show_urls and node.astext() != uri:
                 if uri.startswith('mailto:'):
@@ -420,7 +412,7 @@
     def visit_title(self, node: Element) -> None:
         if isinstance(node.parent, addnodes.seealso):
             self.body.append('.IP "')
-            return
+            return None
         elif isinstance(node.parent, nodes.section):
             if self.section_level == 0:
                 # skip the document title
@@ -434,7 +426,7 @@
     def depart_title(self, node: Element) -> None:
         if isinstance(node.parent, addnodes.seealso):
             self.body.append('"\n')
-            return
+            return None
         return super().depart_title(node)
 
     def visit_raw(self, node: Element) -> None:

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/texinfo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/texinfo.py Changed

@@ -1,25 +1,16 @@
-"""
-    sphinx.writers.texinfo
-    ~~~~~~~~~~~~~~~~~~~~~~
-
-    Custom docutils writer for Texinfo.
+"""Custom docutils writer for Texinfo."""
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import re
 import textwrap
-import warnings
 from os import path
-from typing import (TYPE_CHECKING, Any, Dict, Iterable, Iterator, List, Optional, Pattern, Set,
-                    Tuple, Union, cast)
+from typing import TYPE_CHECKING, Any, Iterable, Iterator, cast
 
 from docutils import nodes, writers
 from docutils.nodes import Element, Node, Text
 
 from sphinx import __display_version__, addnodes
-from sphinx.deprecation import RemovedInSphinx50Warning
 from sphinx.domains import IndexEntry
 from sphinx.domains.index import IndexDomain
 from sphinx.errors import ExtensionError
@@ -60,8 +51,6 @@
 @exampleindent %(exampleindent)s
 @finalout
 %(direntry)s
-@definfoenclose strong,`,'
-@definfoenclose emph,`,'
 @c %%**end of header
 
 @copying
@@ -91,19 +80,19 @@
 """
 
 
-def find_subsections(section: Element) -> Listnodes.section:
+def find_subsections(section: Element) -> listnodes.section:
     """Return a list of subsections for the given ``section``."""
     result = 
     for child in section:
         if isinstance(child, nodes.section):
             result.append(child)
             continue
-        elif isinstance(child, nodes.Element):
+        if isinstance(child, nodes.Element):
             result.extend(find_subsections(child))
     return result
 
 
-def smart_capwords(s: str, sep: str = None) -> str:
+def smart_capwords(s: str, sep: str | None = None) -> str:
     """Like string.capwords() but does not capitalize words that already
     contain a capital letter."""
     words = s.split(sep)
@@ -117,7 +106,7 @@
     """Texinfo writer for generating Texinfo documents."""
     supported = ('texinfo', 'texi')
 
-    settings_spec: Tuplestr, Any, TupleTuplestr, Liststr, Dictstr, str, ... = (
+    settings_spec: tuplestr, Any, tupletuplestr, liststr, dictstr, str, ... = (
         'Texinfo Specific Options', None, (
             ("Name of the Info file", '--texinfo-filename', {'default': ''}),
             ('Dir entry', '--texinfo-dir-entry', {'default': ''}),
@@ -125,13 +114,13 @@
             ('Category', '--texinfo-dir-category', {'default':
                                                       'Miscellaneous'})))
 
-    settings_defaults: Dict = {}
+    settings_defaults: dictstr, Any = {}
 
-    output: str = None
+    output: str
 
     visitor_attributes = ('output', 'fragment')
 
-    def __init__(self, builder: "TexinfoBuilder") -> None:
+    def __init__(self, builder: TexinfoBuilder) -> None:
         super().__init__()
         self.builder = builder
 
@@ -146,8 +135,8 @@
 
 class TexinfoTranslator(SphinxTranslator):
 
-    builder: "TexinfoBuilder" = None
     ignore_missing_images = False
+    builder: TexinfoBuilder
 
     default_elements = {
         'author': '',
@@ -164,39 +153,39 @@
         'title': '',
     }
 
-    def __init__(self, document: nodes.document, builder: "TexinfoBuilder") -> None:
+    def __init__(self, document: nodes.document, builder: TexinfoBuilder) -> None:
         super().__init__(document, builder)
         self.init_settings()
 
-        self.written_ids: Setstr = set()          # node names and anchors in output
+        self.written_ids: setstr = set()          # node names and anchors in output
         # node names and anchors that should be in output
-        self.referenced_ids: Setstr = set()
-        self.indices: ListTuplestr, str =     # (node name, content)
-        self.short_ids: Dictstr, str = {}         # anchors --> short ids
-        self.node_names: Dictstr, str = {}        # node name --> node's name to display
-        self.node_menus: Dictstr, Liststr = {}  # node name --> node's menu entries
-        self.rellinks: Dictstr, Liststr = {}    # node name --> (next, previous, up)
+        self.referenced_ids: setstr = set()
+        self.indices: listtuplestr, str =     # (node name, content)
+        self.short_ids: dictstr, str = {}         # anchors --> short ids
+        self.node_names: dictstr, str = {}        # node name --> node's name to display
+        self.node_menus: dictstr, liststr = {}  # node name --> node's menu entries
+        self.rellinks: dictstr, liststr = {}    # node name --> (next, previous, up)
 
         self.collect_indices()
         self.collect_node_names()
         self.collect_node_menus()
         self.collect_rellinks()
 
-        self.body: Liststr = 
-        self.context: Liststr = 
-        self.descs: Listaddnodes.desc = 
-        self.previous_section: nodes.section = None
+        self.body: liststr = 
+        self.context: liststr = 
+        self.descs: listaddnodes.desc = 
+        self.previous_section: nodes.section | None = None
         self.section_level = 0
         self.seen_title = False
-        self.next_section_ids: Setstr = set()
+        self.next_section_ids: setstr = set()
         self.escape_newlines = 0
         self.escape_hyphens = 0
-        self.curfilestack: Liststr = 
-        self.footnotestack: ListDictstr, ListUnioncollected_footnote, bool =   # NOQA
+        self.curfilestack: liststr = 
+        self.footnotestack: listdictstr, listcollected_footnote | bool = 
         self.in_footnote = 0
         self.in_samp = 0
-        self.handled_abbrs: Setstr = set()
-        self.colwidths: Listint = None
+        self.handled_abbrs: setstr = set()
+        self.colwidths: listint = 
 
     def finish(self) -> None:
         if self.previous_section is None:
@@ -205,13 +194,13 @@
             name, content = index
             pointers = tuple(name + self.rellinksname)
             self.body.append('\n@node %s,%s,%s,%s\n' % pointers)
-            self.body.append('@unnumbered %s\n\n%s\n' % (name, content))
+            self.body.append(f'@unnumbered {name}\n\n{content}\n')
 
         while self.referenced_ids:
             # handle xrefs with missing anchors
             r = self.referenced_ids.pop()
             if r not in self.written_ids:
-                self.body.append('@anchor{%s}@w{%s}\n' % (r, ' ' * 30))
+                self.body.append('@anchor{{{}}}@w{{{}}}\n'.format(r, ' ' * 30))
         self.ensure_eol()
         self.fragment = ''.join(self.body)
         self.elements'body' = self.fragment
@@ -232,7 +221,7 @@
             'copyright': self.escape(self.config.copyright),
             'date': self.escape(self.config.today or
                                 format_date(self.config.today_fmt or _('%b %d, %Y'),
-                                            language=self.config.language))
+                                            language=self.config.language)),
         })
         # title
         title: str = self.settings.title
@@ -294,10 +283,10 @@
     def collect_node_menus(self) -> None:
         """Collect the menu entries for each "node" section."""
         node_menus = self.node_menus
-        targets: ListElement = self.document
+        targets: listElement = self.document
         targets.extend(self.document.findall(nodes.section))
         for node in targets:
-            assert 'node_name' in node and node'node_name'
+            assert 'node_name' in node and node'node_name'  # NoQA: PT018
             entries = s'node_name' for s in find_subsections(node)
             node_menusnode'node_name' = entries
         # try to find a suitable "Top" node
@@ -394,16 +383,19 @@
 
     def format_menu_entry(self, name: str, node_name: str, desc: str) -> str:
         if name == node_name:
-            s = '* %s:: ' % (name,)
+            s = f'* {name}:: '
         else:
-            s = '* %s: %s. ' % (name, node_name)
+            s = f'* {name}: {node_name}. '
         offset = max((24, (len(name) + 4) % 78))
         wdesc = '\n'.join(' ' * offset + l for l in
                           textwrap.wrap(desc, width=78 - offset))
         return s + wdesc.strip() + '\n'
 
-    def add_menu_entries(self, entries: Liststr, reg: Pattern = re.compile(r'\s+---?\s+')
-                         ) -> None:
+    def add_menu_entries(
+        self,
+        entries: liststr,
+        reg: re.Patternstr = re.compile(r'\s+---?\s+'),
+    ) -> None:
         for entry in entries:
             name = self.node_namesentry
             # special formatting for entries that are divided by an em-dash
@@ -464,14 +456,14 @@
         return res
 
     def collect_indices(self) -> None:
-        def generate(content: ListTuplestr, ListIndexEntry, collapsed: bool) -> str:
+        def generate(content: listtuplestr, listIndexEntry, collapsed: bool) -> str:
             ret = '\n@menu\n'
             for _letter, entries in content:
                 for entry in entries:
                     if not entry3:
                         continue
                     name = self.escape_menu(entry0)
-                    sid = self.get_short_id('%s:%s' % (entry2, entry3))
+                    sid = self.get_short_id(f'{entry2}:{entry3}')
                     desc = self.escape_arg(entry6)
                     me = self.format_menu_entry(name, sid, desc)
                     ret.append(me)
@@ -482,7 +474,7 @@
         if indices_config:
             for domain in self.builder.env.domains.values():
                 for indexcls in domain.indices:
-                    indexname = '%s-%s' % (domain.name, indexcls.name)
+                    indexname = f'{domain.name}-{indexcls.name}'
                     if isinstance(indices_config, list):
                         if indexname not in indices_config:
                             continue
@@ -502,7 +494,9 @@
     # this is copied from the latex writer
     # TODO: move this to sphinx.util
 
-    def collect_footnotes(self, node: Element) -> Dictstr, ListUnioncollected_footnote, bool:  # NOQA
+    def collect_footnotes(
+        self, node: Element,
+    ) -> dictstr, listcollected_footnote | bool:
         def footnotes_under(n: Element) -> Iteratornodes.footnote:
             if isinstance(n, nodes.footnote):
                 yield n
@@ -512,7 +506,7 @@
                         continue
                     elif isinstance(c, nodes.Element):
                         yield from footnotes_under(c)
-        fnotes: Dictstr, ListUnioncollected_footnote, bool = {}
+        fnotes: dictstr, listcollected_footnote | bool = {}
         for fn in footnotes_under(node):
             label = cast(nodes.label, fn0)
             num = label.astext().strip()
@@ -547,7 +541,7 @@
         name = self.escape_menu(name)
         sid = self.get_short_id(id)
         if self.config.texinfo_cross_references:
-            self.body.append('@ref{%s,,%s}' % (sid, name))
+            self.body.append(f'@ref{{{sid},,{name}}}')
             self.referenced_ids.add(sid)
             self.referenced_ids.add(self.escape_id(id))
         else:
@@ -622,7 +616,7 @@
             return
         if isinstance(parent, (nodes.Admonition, nodes.sidebar, nodes.topic)):
             raise nodes.SkipNode
-        elif not isinstance(parent, nodes.section):
+        if not isinstance(parent, nodes.section):
             logger.warning(__('encountered title node not in section, topic, table, '
                               'admonition or sidebar'),
                            location=node)
@@ -705,7 +699,7 @@
             if not name or name == uri:
                 self.body.append('@email{%s}' % uri)
             else:
-                self.body.append('@email{%s,%s}' % (uri, name))
+                self.body.append(f'@email{{{uri},{name}}}')
         elif uri.startswith('#'):
             # references to labels in the same document
             id = self.curfilestack-1 + ':' + uri1:
@@ -730,9 +724,9 @@
             id = self.escape_id(id)
             name = self.escape_menu(name)
             if name == id:
-                self.body.append('@ref{%s,,,%s}' % (id, uri))
+                self.body.append(f'@ref{{{id},,,{uri}}}')
             else:
-                self.body.append('@ref{%s,,%s,%s}' % (id, name, uri))
+                self.body.append(f'@ref{{{id},,{name},{uri}}}')
         else:
             uri = self.escape_arg(uri)
             name = self.escape_arg(name)
@@ -742,11 +736,11 @@
             if not name or uri == name:
                 self.body.append('@indicateurl{%s}' % uri)
             elif show_urls == 'inline':
-                self.body.append('@uref{%s,%s}' % (uri, name))
+                self.body.append(f'@uref{{{uri},{name}}}')
             elif show_urls == 'no':
-                self.body.append('@uref{%s,,%s}' % (uri, name))
+                self.body.append(f'@uref{{{uri},,{name}}}')
             else:
-                self.body.append('%s@footnote{%s}' % (name, uri))
+                self.body.append(f'{name}@footnote{{{uri}}}')
         raise nodes.SkipNode
 
     def depart_reference(self, node: Element) -> None:
@@ -777,10 +771,10 @@
         self.ensure_eol()
         self.body.append('@end quotation\n')
 
-    def visit_literal_block(self, node: Element) -> None:
+    def visit_literal_block(self, node: Element | None) -> None:
         self.body.append('\n@example\n')
 
-    def depart_literal_block(self, node: Element) -> None:
+    def depart_literal_block(self, node: Element | None) -> None:
         self.ensure_eol()
         self.body.append('@end example\n')
 
@@ -807,17 +801,21 @@
     # -- Inline
 
     def visit_strong(self, node: Element) -> None:
-        self.body.append('@strong{')
+        self.body.append('`')
 
     def depart_strong(self, node: Element) -> None:
-        self.body.append('}')
+        self.body.append("'")
 
     def visit_emphasis(self, node: Element) -> None:
-        element = 'emph' if not self.in_samp else 'var'
-        self.body.append('@%s{' % element)
+        if self.in_samp:
+            self.body.append('@var{')
+            self.context.append('}')
+        else:
+            self.body.append('`')
+            self.context.append("'")
 
     def depart_emphasis(self, node: Element) -> None:
-        self.body.append('}')
+        self.body.append(self.context.pop())
 
     def is_samp(self, node: Element) -> bool:
         return 'samp' in node'classes'
@@ -1215,7 +1213,7 @@
         width = self.tex_image_length(node.get('width', ''))
         height = self.tex_image_length(node.get('height', ''))
         alt = self.escape_arg(node.get('alt', ''))
-        filename = "%s-figures/%s" % (self.elements'filename':-5, name)  # type: ignore
+        filename = f"{self.elements'filename':-5}-figures/{name}"  # type: ignore
         self.body.append('\n@image{%s,%s,%s,%s,%s}\n' %
                          (filename, width, height, alt, ext1:))
 
@@ -1238,8 +1236,7 @@
         # label numbering is automatically generated by Texinfo
         if self.in_footnote:
             raise nodes.SkipNode
-        else:
-            self.body.append('@w{(')
+        self.body.append('@w{(')
 
     def depart_label(self, node: Element) -> None:
         self.body.append(')} ')
@@ -1410,9 +1407,9 @@
             name = objtype
         # by convention, the deffn category should be capitalized like a title
         category = self.escape_arg(smart_capwords(name))
-        self.body.append('\n%s {%s} ' % (self.at_deffnx, category))
+        self.body.append(f'\n{self.at_deffnx} {{{category}}} ')
         self.at_deffnx = '@deffnx'
-        self.desc_type_name = name
+        self.desc_type_name: str | None = name
 
     def depart_desc_signature(self, node: Element) -> None:
         self.body.append("\n")
@@ -1562,11 +1559,3 @@
         self.body.append('\n\n@example\n%s\n@end example\n\n' %
                          self.escape_arg(node.astext()))
         raise nodes.SkipNode
-
-    @property
-    def desc(self) -> Optionaladdnodes.desc:
-        warnings.warn('TexinfoWriter.desc is deprecated.', RemovedInSphinx50Warning)
-        if len(self.descs):
-            return self.descs-1
-        else:
-            return None

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/text.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/text.py Changed

@@ -1,19 +1,12 @@
-"""
-    sphinx.writers.text
-    ~~~~~~~~~~~~~~~~~~~
+"""Custom docutils writer for plain text."""
+from __future__ import annotations
 
-    Custom docutils writer for plain text.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
 import math
 import os
 import re
 import textwrap
 from itertools import chain, groupby
-from typing import (TYPE_CHECKING, Any, Dict, Generator, Iterable, List, Optional, Set, Tuple,
-                    Union, cast)
+from typing import TYPE_CHECKING, Any, Generator, Iterable, cast
 
 from docutils import nodes, writers
 from docutils.nodes import Element, Text
@@ -33,16 +26,14 @@
     """
     def __init__(self, text: str = "", rowspan: int = 1, colspan: int = 1) -> None:
         self.text = text
-        self.wrapped: Liststr = 
+        self.wrapped: liststr = 
         self.rowspan = rowspan
         self.colspan = colspan
-        self.col: Optionalint = None
-        self.row: Optionalint = None
+        self.col: int | None = None
+        self.row: int | None = None
 
     def __repr__(self) -> str:
-        return "<Cell {!r} {}v{}/{}>{}>".format(
-            self.text, self.row, self.rowspan, self.col, self.colspan
-        )
+        return f"<Cell {self.text!r} {self.row}v{self.rowspan}/{self.col}>{self.colspan}>"
 
     def __hash__(self) -> int:
         return hash((self.col, self.row))
@@ -97,10 +88,10 @@
        +--------+--------+
 
     """
-    def __init__(self, colwidth: Listint = None) -> None:
-        self.lines: ListListCell = 
+    def __init__(self, colwidth: listint = None) -> None:
+        self.lines: listlistCell = 
         self.separator = 0
-        self.colwidth: Listint = (colwidth if colwidth is not None else )
+        self.colwidth: listint = (colwidth if colwidth is not None else )
         self.current_line = 0
         self.current_col = 0
 
@@ -126,13 +117,13 @@
         selfself.current_line, self.current_col = cell
         self.current_col += cell.colspan
 
-    def __getitem__(self, pos: Tupleint, int) -> Cell:
+    def __getitem__(self, pos: tupleint, int) -> Cell:
         line, col = pos
         self._ensure_has_line(line + 1)
         self._ensure_has_column(col + 1)
         return self.lineslinecol
 
-    def __setitem__(self, pos: Tupleint, int, cell: Cell) -> None:
+    def __setitem__(self, pos: tupleint, int, cell: Cell) -> None:
         line, col = pos
         self._ensure_has_line(line + cell.rowspan)
         self._ensure_has_column(col + cell.colspan)
@@ -154,7 +145,7 @@
     def __repr__(self) -> str:
         return "\n".join(repr(line) for line in self.lines)
 
-    def cell_width(self, cell: Cell, source: Listint) -> int:
+    def cell_width(self, cell: Cell, source: listint) -> int:
         """Give the cell width, according to the given source (either
         ``self.colwidth`` or ``self.measured_widths``).
         This takes into account cells spanning multiple columns.
@@ -166,7 +157,7 @@
 
     @property
     def cells(self) -> GeneratorCell, None, None:
-        seen: SetCell = set()
+        seen: setCell = set()
         for line in self.lines:
             for cell in line:
                 if cell and cell not in seen:
@@ -186,7 +177,7 @@
             for col in range(cell.col, cell.col + cell.colspan):
                 self.measured_widthscol = max(self.measured_widthscol, width)
 
-    def physical_lines_for_line(self, line: ListCell) -> int:
+    def physical_lines_for_line(self, line: listCell) -> int:
         """For a given line, compute the number of physical lines it spans
         due to text wrapping.
         """
@@ -199,11 +190,11 @@
         out = 
         self.rewrap()
 
-        def writesep(char: str = "-", lineno: Optionalint = None) -> str:
+        def writesep(char: str = "-", lineno: int | None = None) -> str:
             """Called on the line *before* lineno.
             Called with no *lineno* for the last sep.
             """
-            out: Liststr = 
+            out: liststr = 
             for colno, width in enumerate(self.measured_widths):
                 if (
                     lineno is not None and
@@ -232,7 +223,7 @@
                 for colno, cell in enumerate(line):
                     if cell.col != colno:
                         continue
-                    if lineno != cell.row:
+                    if lineno != cell.row:  # NoQA: SIM114
                         physical_text = ""
                     elif physical_line >= len(cell.wrapped):
                         physical_text = ""
@@ -242,8 +233,8 @@
                     linestr.append(
                         " " +
                         physical_text.ljust(
-                            self.cell_width(cell, self.measured_widths) + 1 + adjust_len
-                        ) + "|"
+                            self.cell_width(cell, self.measured_widths) + 1 + adjust_len,
+                        ) + "|",
                     )
                 out.append("".join(linestr))
         out.append(writesep("-"))
@@ -259,13 +250,13 @@
         r'^\s\w*\w+a-zA-Z-(?=\w+a-zA-Z)|'   # hyphenated words
         r'(?<=\w\!\"\'\&\.\,\?)-{2,}(?=\w))')   # em-dash
 
-    def _wrap_chunks(self, chunks: Liststr) -> Liststr:
+    def _wrap_chunks(self, chunks: liststr) -> liststr:
         """_wrap_chunks(chunks : string) -> string
 
         The original _wrap_chunks uses len() to calculate width.
         This method respects wide/fullwidth characters for width adjustment.
         """
-        lines: Liststr = 
+        lines: liststr = 
         if self.width <= 0:
             raise ValueError("invalid width %r (must be > 0)" % self.width)
 
@@ -306,7 +297,7 @@
 
         return lines
 
-    def _break_word(self, word: str, space_left: int) -> Tuplestr, str:
+    def _break_word(self, word: str, space_left: int) -> tuplestr, str:
         """_break_word(word : string, space_left : int) -> (string, string)
 
         Break line by unicode width instead of len(word).
@@ -318,15 +309,15 @@
                 return word:i - 1, wordi - 1:
         return word, ''
 
-    def _split(self, text: str) -> Liststr:
+    def _split(self, text: str) -> liststr:
         """_split(text : string) -> string
 
         Override original method that only split by 'wordsep_re'.
         This '_split' splits wide-characters into chunks by one character.
         """
-        def split(t: str) -> Liststr:
+        def split(t: str) -> liststr:
             return super(TextWrapper, self)._split(t)
-        chunks: Liststr = 
+        chunks: liststr = 
         for chunk in split(text):
             for w, g in groupby(chunk, column_width):
                 if w == 1:
@@ -335,7 +326,7 @@
                     chunks.extend(list(g))
         return chunks
 
-    def _handle_long_word(self, reversed_chunks: Liststr, cur_line: Liststr,
+    def _handle_long_word(self, reversed_chunks: liststr, cur_line: liststr,
                           cur_len: int, width: int) -> None:
         """_handle_long_word(chunks : string,
                              cur_line : string,
@@ -357,7 +348,7 @@
 STDINDENT = 3
 
 
-def my_wrap(text: str, width: int = MAXWIDTH, **kwargs: Any) -> Liststr:
+def my_wrap(text: str, width: int = MAXWIDTH, **kwargs: Any) -> liststr:
     w = TextWrapper(width=width, **kwargs)
     return w.wrap(text)
 
@@ -365,11 +356,11 @@
 class TextWriter(writers.Writer):
     supported = ('text',)
     settings_spec = ('No options here.', '', ())
-    settings_defaults: Dict = {}
+    settings_defaults: dictstr, Any = {}
 
     output: str = None
 
-    def __init__(self, builder: "TextBuilder") -> None:
+    def __init__(self, builder: TextBuilder) -> None:
         super().__init__()
         self.builder = builder
 
@@ -380,9 +371,9 @@
 
 
 class TextTranslator(SphinxTranslator):
-    builder: "TextBuilder" = None
+    builder: TextBuilder
 
-    def __init__(self, document: nodes.document, builder: "TextBuilder") -> None:
+    def __init__(self, document: nodes.document, builder: TextBuilder) -> None:
         super().__init__(document, builder)
 
         newlines = self.config.text_newlines
@@ -395,9 +386,9 @@
         self.sectionchars = self.config.text_sectionchars
         self.add_secnumbers = self.config.text_add_secnumbers
         self.secnumber_suffix = self.config.text_secnumber_suffix
-        self.states: ListListTupleint, Unionstr, Liststr = 
+        self.states: listlisttupleint, str | liststr = 
         self.stateindent = 0
-        self.list_counter: Listint = 
+        self.list_counter: listint = 
         self.sectionlevel = 0
         self.lineblocklevel = 0
         self.table: Table = None
@@ -409,12 +400,12 @@
         self.states.append()
         self.stateindent.append(indent)
 
-    def end_state(self, wrap: bool = True, end: Liststr = '', first: str = None) -> None:
+    def end_state(self, wrap: bool = True, end: liststr = '', first: str = None) -> None:
         content = self.states.pop()
         maxindent = sum(self.stateindent)
         indent = self.stateindent.pop()
-        result: ListTupleint, Liststr = 
-        toformat: Liststr = 
+        result: listtupleint, liststr = 
+        toformat: liststr = 
 
         def do_format() -> None:
             if not toformat:
@@ -768,7 +759,7 @@
 
     def visit_entry(self, node: Element) -> None:
         self.entry = Cell(
-            rowspan=node.get("morerows", 0) + 1, colspan=node.get("morecols", 0) + 1
+            rowspan=node.get("morerows", 0) + 1, colspan=node.get("morecols", 0) + 1,
         )
         self.new_state(0)

_service:tar_scm:Sphinx-4.4.0.tar.gz/sphinx/writers/xml.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/sphinx/writers/xml.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/conftest.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/conftest.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/ext_napoleon_pep526_data_google.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/ext_napoleon_pep526_data_google.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/ext_napoleon_pep526_data_numpy.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/ext_napoleon_pep526_data_numpy.py Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/js/documentation_options.js Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/js/searchtools.js -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/js/searchtools.js Changed

@@ -30,3 +30,33 @@
   });
 
 });
+
+// This is regression test for https://github.com/sphinx-doc/sphinx/issues/3150
+describe('splitQuery regression tests', () => {
+
+  it('can split English words', () => {
+    const parts = splitQuery('   Hello    World   ')
+    expect(parts).toEqual('Hello', 'World')
+  })
+
+  it('can split special characters', () => {
+    const parts = splitQuery('Pin-Code')
+    expect(parts).toEqual('Pin', 'Code')
+  })
+
+  it('can split Chinese characters', () => {
+    const parts = splitQuery('Hello from 中国 上海')
+    expect(parts).toEqual('Hello', 'from', '中国', '上海')
+  })
+
+  it('can split Emoji (surrogate pair) characters. It should keep emojis.', () => {
+    const parts = splitQuery('😁😁')
+    expect(parts).toEqual('😁😁')
+  })
+
+  it('can split umlauts. It should keep umlauts.', () => {
+    const parts = splitQuery('Löschen Prüfung Abändern ærlig spørsmål')
+    expect(parts).toEqual('Löschen', 'Prüfung', 'Abändern', 'ærlig', 'spørsmål')
+  })
+
+})

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/js/sphinx_highlight.js Added

@@ -0,0 +1,39 @@
+describe('highlightText', function() {
+
+  const cyrillicTerm = 'шеллы';
+  const umlautTerm = 'gänsefüßchen';
+
+  it('should highlight text incl. special characters correctly in HTML', function() {
+    const highlightTestSpan = new DOMParser().parseFromString(
+      '<span>This is the шеллы and Gänsefüßchen test!</span>', 'text/html').body.firstChild
+    _highlightText(highlightTestSpan, cyrillicTerm, 'highlighted');
+    _highlightText(highlightTestSpan, umlautTerm, 'highlighted');
+    const expectedHtmlString =
+      'This is the <span class=\"highlighted\">шеллы</span> and ' +
+      '<span class=\"highlighted\">Gänsefüßchen</span> test!';
+    expect(highlightTestSpan.innerHTML).toEqual(expectedHtmlString);
+  });
+
+  it('should highlight text incl. special characters correctly in SVG', function() {
+    const highlightTestSvg = new DOMParser().parseFromString(
+      '<span id="svg-highlight-test">' +
+        '<svg xmlns="http://www.w3.org/2000/svg" height="50" width="500">' +
+          '<text x="0" y="15">' +
+            'This is the шеллы and Gänsefüßchen test!' +
+          '</text>' +
+        '</svg>' +
+      '</span>', 'text/html').body.firstChild
+    _highlightText(highlightTestSvg, cyrillicTerm, 'highlighted');
+    _highlightText(highlightTestSvg, umlautTerm, 'highlighted');
+    /* Note wild cards and ``toMatch``; allowing for some variability
+       seems to be necessary, even between different FF versions */
+    const expectedSvgString =
+      '<svg xmlns="http://www.w3.org/2000/svg" height="50" width="500">'
+      + '<rect x=".*" y=".*" width=".*" height=".*" class="highlighted"/>'
+      + '<rect x=".*" y=".*" width=".*" height=".*" class="highlighted"/>'
+      + '<text x=".*" y=".*">This is the <tspan>шеллы</tspan> and '
+      + '<tspan>Gänsefüßchen</tspan> test!</text></svg>';
+    expect(new XMLSerializer().serializeToString(highlightTestSvg.firstChild)).toMatch(new RegExp(expectedSvgString));
+  });
+
+});

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-api-set-translator/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-api-set-translator/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-api-set-translator/translator.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-api-set-translator/translator.py Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-apidoc-duplicates/fish_licence/halibut.cpython-38-x86_64-linux-gnu.so Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-apidoc-duplicates/fish_licence/halibut.pyx Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-apidoc-toc/mypackage/main.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-apidoc-toc/mypackage/main.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-autosummary/underscore_module_.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-autosummary/underscore_module_.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-basic/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-basic/index.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-build-html-theme-having-multiple-stylesheets/_themes/mytheme/_static/extra.css Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-build-html-theme-having-multiple-stylesheets/_themes/mytheme/_static/mytheme.css Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-build-html-theme-having-multiple-stylesheets/_themes/mytheme/theme.conf Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-build-html-theme-having-multiple-stylesheets/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-build-html-theme-having-multiple-stylesheets/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-build-html-translator/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-build-html-translator/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-changes/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-changes/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-correct-year/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-correct-year/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directive-code/dedent.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-directive-code/dedent.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-directive-only/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-directive-only/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-domain-py/canonical.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-domain-py/canonical.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-environment-record-dependencies/api.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-environment-record-dependencies/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-environment-record-dependencies/example_module.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-environment-record-dependencies/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/autodoc_dummy_bar.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/autodoc_dummy_bar.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/autodoc_dummy_module.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/autodoc_dummy_module.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/bug2437/autodoc_dummy_foo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/bug2437/autodoc_dummy_foo.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/TYPE_CHECKING.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/__init__.py Changed

@@ -1,7 +1,7 @@
 import enum
 from io import StringIO
 
-from sphinx.util import save_traceback  # NOQA
+from ._functions_to_import import function_to_be_imported
 
 __all__ = 'Class'
 
@@ -33,7 +33,7 @@
     return classmethod(function)
 
 
-class Class(object):
+class Class:
     """Class to document."""
 
     def meth(self):
@@ -96,10 +96,10 @@
     pass
 
 
-class Outer(object):
+class Outer:
     """Foo"""
 
-    class Inner(object):
+    class Inner:
         """Foo"""
 
         def meth(self):
@@ -113,7 +113,7 @@
     """InnerChild docstring"""
 
 
-class DocstringSig(object):
+class DocstringSig:
     def __new__(cls, *new_args, **new_kwargs):
         """__new__(cls, d, e=1) -> DocstringSig
 First line of docstring
@@ -164,12 +164,12 @@
         return self
 
 
-class AttCls(object):
+class AttCls:
     a1 = StrRepr('hello\nworld')
     a2 = None
 
 
-class InstAttCls(object):
+class InstAttCls:
     """Class with documented class and instance attributes."""
 
     #: Doc comment for class attribute InstAttCls.ca1.
@@ -189,7 +189,7 @@
         """Docstring for instance attribute InstAttCls.ia2."""
 
 
-class CustomIter(object):
+class CustomIter:
     def __init__(self):
         """Create a new `CustomIter`."""
         self.values = range(10)

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/_functions_to_import.py Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/annotated.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/annotated.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/autodoc_type_aliases.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/autodoc_type_aliases.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/cached_property.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/cached_property.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/classes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/classes.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/coroutine.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/coroutine.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/descriptor.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/descriptor.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/docstring_signature.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/docstring_signature.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/final.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/final.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/generic_class.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/generic_class.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/genericalias.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/genericalias.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/inheritance.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/inheritance.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/need_mocks.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/need_mocks.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/overload.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/overload.py Changed

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from typing import Any, overload
 
 
@@ -7,7 +9,7 @@
 
 
 @overload
-def sum(x: "float", y: "float" = 0.0) -> "float":
+def sum(x: float, y: float = 0.0) -> float:
     ...
 
 
@@ -29,7 +31,7 @@
         ...
 
     @overload
-    def sum(self, x: "float", y: "float" = 0.0) -> "float":
+    def sum(self, x: float, y: float = 0.0) -> float:
         ...
 
     @overload
@@ -45,11 +47,11 @@
     """docstring"""
 
     @overload
-    def __new__(cls, x: int, y: int) -> "Foo":
+    def __new__(cls, x: int, y: int) -> Foo:
         ...
 
     @overload
-    def __new__(cls, x: "str", y: "str") -> "Foo":
+    def __new__(cls, x: str, y: str) -> Foo:
         ...
 
     def __new__(cls, x, y):
@@ -64,7 +66,7 @@
         ...
 
     @overload
-    def __init__(cls, x: "str", y: "str") -> "None":
+    def __init__(cls, x: str, y: str) -> None:
         ...
 
     def __init__(cls, x, y):
@@ -77,7 +79,7 @@
         ...
 
     @overload
-    def __call__(cls, x: "str", y: "str") -> "Any":
+    def __call__(cls, x: str, y: str) -> Any:
         ...
 
     def __call__(cls, x, y):

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/partialmethod.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/partialmethod.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/pep570.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/pep570.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/preserve_defaults.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/preserve_defaults.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/private.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/private.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/properties.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/properties.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/singledispatch.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/singledispatch.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/singledispatchmethod.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/singledispatchmethod.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/typed_vars.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/typed_vars.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/typehints.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/typehints.py Changed

@@ -1,7 +1,15 @@
-from typing import Any, Tuple, Union
+from __future__ import annotations
+
+import pathlib
+from typing import Any, Tuple, TypeVar, Union
 
 CONST1: int
+#: docstring
 CONST2: int = 1
+#: docstring
+CONST3: pathlib.PurePosixPath = pathlib.PurePosixPath("/a/b/c")
+#: docstring
+T = TypeVar("T", bound=pathlib.PurePosixPath)
 
 
 def incr(a: int, b: int = 1) -> int:
@@ -16,6 +24,7 @@
 class Math:
     CONST1: int
     CONST2: int = 1
+    CONST3: pathlib.PurePosixPath = pathlib.PurePosixPath("/a/b/c")
 
     def __init__(self, s: str, o: Any = None) -> None:
         pass
@@ -42,13 +51,17 @@
     def prop(self) -> int:
         return 0
 
+    @property
+    def path(self) -> pathlib.PurePosixPath:
+        return pathlib.PurePosixPath("/a/b/c")
+
 
-def tuple_args(x: Tupleint, Unionint, str) -> Tupleint, int:
+def tuple_args(x: tupleint, int | str) -> tupleint, int:
     pass
 
 
 class NewAnnotation:
-    def __new__(cls, i: int) -> 'NewAnnotation':
+    def __new__(cls, i: int) -> NewAnnotation:
         pass
 
 
@@ -83,8 +96,10 @@
 class _ClassWithDocumentedInit:
     """Class docstring."""
 
-    def __init__(self, x: int) -> None:
+    def __init__(self, x: int, *args: int, **kwargs: int) -> None:
         """Init docstring.
 
         :param x: Some integer
+        :param args: Some integer
+        :param kwargs: Some integer
         """

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/typevar.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/typevar.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autodoc/target/wrappedfunction.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autodoc/target/wrappedfunction.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-filename-map/autosummary_dummy_module.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-imported_members/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-imported_members/index.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-module_all/autosummary_dummy_package_all/__init__.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-module_all/autosummary_dummy_package_all/autosummary_dummy_module.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-module_all/autosummary_dummy_package_all/extra_dummy_module.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-module_all/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-module_all/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package/module.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-recursive/package/module.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package/module_importfail.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-recursive/package/module_importfail.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package/package/module.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-recursive/package/package/module.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary-recursive/package2/module.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary-recursive/package2/module.py Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary/autosummary_class_module.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary/autosummary_dummy_inherited_module.py Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary/autosummary_dummy_module.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary/autosummary_dummy_module.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary/autosummary_importfail.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary/autosummary_importfail.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-autosummary/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-autosummary/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls-multiple-replacements/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-extlinks-hardcoded-urls/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-ifconfig/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-ifconfig/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-ifconfig/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-ifconfig/index.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-imgmockconverter/1/svgimg.svg Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-imgmockconverter/2/svgimg.svg Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-imgmockconverter/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-imgmockconverter/index.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-imgmockconverter/mocksvgconverter.py Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-inheritance_diagram/example/sphinx.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-inheritance_diagram/example/sphinx.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-inheritance_diagram/test.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-inheritance_diagram/test.py Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-napoleon/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-napoleon/index.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-napoleon/mypackage/__init__.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-napoleon/mypackage/typehints.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-napoleon/typehints.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode-find/not_a_package/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-viewcode-find/not_a_package/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode-find/not_a_package/submodule.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-viewcode-find/not_a_package/submodule.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-viewcode/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode/spam/__init__.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-viewcode/spam/__init__.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode/spam/mod1.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-viewcode/spam/mod1.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-ext-viewcode/spam/mod2.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-ext-viewcode/spam/mod2.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-footnotes/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-footnotes/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-glossary/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-glossary/index.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-image-escape/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-image-escape/img_#1.png Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-image-escape/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-inheritance/dummy/test.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-inheritance/dummy/test.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-inheritance/dummy/test_nested.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-inheritance/dummy/test_nested.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/literalblock.txt -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-intl/literalblock.txt Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-intl/noqa.txt Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/refs.txt -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-intl/refs.txt Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-intl/xx/LC_MESSAGES/literalblock.po -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-intl/xx/LC_MESSAGES/literalblock.po Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-intl/xx/LC_MESSAGES/noqa.po Added

@@ -0,0 +1,46 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C)
+# This file is distributed under the same license as the Sphinx intl <Tests> package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2022-01-16 15:23+0100\n"
+"PO-Revision-Date: 2022-01-16 15:23+0100\n"
+"Last-Translator: Jean Abou Samra <jean@abou-samra.fr>\n"
+"Language-Team: \n"
+"Language: xx\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"X-Generator: Poedit 3.0\n"
+
+#: ../tests/roots/test-intl/noqa.txt:2
+msgid "First section"
+msgstr "FIRST SECTION"
+
+#: ../tests/roots/test-intl/noqa.txt:4
+msgid "Some text with a reference, :ref:`next-section`."
+msgstr "TRANSLATED TEXT WITHOUT REFERENCE. #noqa"
+
+#: ../tests/roots/test-intl/noqa.txt:6
+msgid "Another reference: :ref:`next-section`."
+msgstr ""
+"TEST noqa WHITESPACE INSENSITIVITY.\n"
+"#   \n"
+"   noqa"
+
+#: ../tests/roots/test-intl/noqa.txt:8
+msgid "This should allow to test escaping ``#noqa``."
+msgstr "``#noqa`` IS ESCAPED AT THE END OF THIS STRING. \\#noqa"
+
+#: ../tests/roots/test-intl/noqa.txt:13
+msgid "Next section"
+msgstr "NEXT SECTION WITH PARAGRAPH TO TEST BARE noqa"
+
+# This edge case should not fail.
+#: ../tests/roots/test-intl/noqa.txt:15
+msgid "Some text, again referring to the section: :ref:`next-section`."
+msgstr "#noqa"

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-labels-before-module/automodule1.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-labels-before-module/automodule2a.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-labels-before-module/automodule2b.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-labels-before-module/automodule3.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-labels-before-module/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-labels-before-module/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/complex.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/complex.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/complex_spanning_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/complex_spanning_cell.tex Changed

@@ -14,10 +14,12 @@
 
 
 \begin{savenotes}\sphinxattablestart
+\sphinxthistablewithglobalstyle
+\sphinxthistablewithstandardstyle
 \centering
 \begin{tabulary}{\linewidth}t{|T|T|T|T|T|}
-\hline
-\sphinxmultirow{3}{1}{%
+\sphinxtoprule
+\sphinxtableatstartofbodyhook\sphinxmultirow{3}{1}{%
 \begin{varwidth}t{\sphinxcolwidth{1}{5}}
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
@@ -49,7 +51,7 @@
 \vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
 }%
 \\
-\cline{3-3}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxmultirow{2}{6}{%
+\sphinxvlinecrossing{1}\sphinxcline{3-3}\sphinxvlinecrossing{4}\sphinxfixclines{5}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxmultirow{2}{6}{%
 \begin{varwidth}t{\sphinxcolwidth{1}{5}}
 \sphinxAtStartPar
 cell2\sphinxhyphen{}3
@@ -57,11 +59,11 @@
 \vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
 }%
 &\sphinxtablestrut{4}&\sphinxtablestrut{5}\\
-\cline{5-5}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxtablestrut{6}&\sphinxtablestrut{4}&
+\sphinxvlinecrossing{1}\sphinxvlinecrossing{2}\sphinxvlinecrossing{3}\sphinxcline{5-5}\sphinxfixclines{5}\sphinxtablestrut{1}&\sphinxtablestrut{2}&\sphinxtablestrut{6}&\sphinxtablestrut{4}&
 \sphinxAtStartPar
 cell3\sphinxhyphen{}5
 \\
-\hline
+\sphinxbottomrule
 \end{tabulary}
-\par
+\sphinxtableafterendhook\par
 \sphinxattableend\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/gridtable.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/gridtable.tex Changed

@@ -1,9 +1,11 @@
 \label{\detokenize{complex:grid-table}}
 
 \begin{savenotes}\sphinxattablestart
+\sphinxthistablewithglobalstyle
+\sphinxthistablewithnocolorrowsstyle
 \centering
 \begin{tabulary}{\linewidth}t{|T|T|T|}
-\hline
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -14,7 +16,8 @@
 \sphinxAtStartPar
 header3
 \\
-\hline
+\sphinxmidrule
+\sphinxtableatstartofbodyhook
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
 &\sphinxmultirow{2}{5}{%
@@ -28,7 +31,7 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}3
 \\
-\cline{1-1}\cline{3-3}\sphinxmultirow{2}{7}{%
+\sphinxcline{1-1}\sphinxcline{3-3}\sphinxfixclines{3}\sphinxmultirow{2}{7}{%
 \begin{varwidth}t{\sphinxcolwidth{1}{3}}
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
@@ -39,7 +42,7 @@
 \sphinxAtStartPar
 cell2\sphinxhyphen{}3
 \\
-\cline{2-3}\sphinxtablestrut{7}&\sphinxstartmulticolumn{2}%
+\sphinxcline{2-3}\sphinxfixclines{3}\sphinxtablestrut{7}&\sphinxstartmulticolumn{2}%
 \sphinxmultirow{2}{9}{%
 \begin{varwidth}t{\sphinxcolwidth{2}{3}}
 \sphinxAtStartPar
@@ -52,11 +55,11 @@
 }%
 \sphinxstopmulticolumn
 \\
-\cline{1-1}
+\sphinxcline{1-1}\sphinxfixclines{3}
 \sphinxAtStartPar
 cell4\sphinxhyphen{}1
 &\multicolumn{2}{l|}{\sphinxtablestrut{9}}\\
-\hline\sphinxstartmulticolumn{3}%
+\sphinxhline\sphinxstartmulticolumn{3}%
 \begin{varwidth}t{\sphinxcolwidth{3}{3}}
 \sphinxAtStartPar
 cell5\sphinxhyphen{}1
@@ -64,7 +67,7 @@
 \vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
 \sphinxstopmulticolumn
 \\
-\hline
+\sphinxbottomrule
 \end{tabulary}
-\par
+\sphinxtableafterendhook\par
 \sphinxattableend\end{savenotes}

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/gridtable_with_tabularcolumn.tex Added

@@ -0,0 +1,73 @@
+\label{\detokenize{complex:grid-table-with-tabularcolumns-having-no-vline}}
+
+\begin{savenotes}\sphinxattablestart
+\sphinxthistablewithglobalstyle
+\sphinxthistablewithnovlinesstyle
+\centering
+\begin{tabulary}{\linewidth}t{TTT}
+\sphinxtoprule
+\sphinxstyletheadfamily 
+\sphinxAtStartPar
+header1
+&\sphinxstyletheadfamily 
+\sphinxAtStartPar
+header2
+&\sphinxstyletheadfamily 
+\sphinxAtStartPar
+header3
+\\
+\sphinxmidrule
+\sphinxtableatstartofbodyhook
+\sphinxAtStartPar
+cell1\sphinxhyphen{}1
+&\sphinxmultirow{2}{5}{%
+\begin{varwidth}t{\sphinxcolwidth{1}{3}}
+\sphinxAtStartPar
+cell1\sphinxhyphen{}2
+\par
+\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
+}%
+&
+\sphinxAtStartPar
+cell1\sphinxhyphen{}3
+\\
+\sphinxcline{1-1}\sphinxcline{3-3}\sphinxfixclines{3}\sphinxmultirow{2}{7}{%
+\begin{varwidth}t{\sphinxcolwidth{1}{3}}
+\sphinxAtStartPar
+cell2\sphinxhyphen{}1
+\par
+\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
+}%
+&\sphinxtablestrut{5}&
+\sphinxAtStartPar
+cell2\sphinxhyphen{}3
+\\
+\sphinxcline{2-3}\sphinxfixclines{3}\sphinxtablestrut{7}&\sphinxstartmulticolumn{2}%
+\sphinxmultirow{2}{9}{%
+\begin{varwidth}t{\sphinxcolwidth{2}{3}}
+\sphinxAtStartPar
+cell3\sphinxhyphen{}2\sphinxhyphen{}par1
+
+\sphinxAtStartPar
+cell3\sphinxhyphen{}2\sphinxhyphen{}par2
+\par
+\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
+}%
+\sphinxstopmulticolumn
+\\
+\sphinxcline{1-1}\sphinxfixclines{3}
+\sphinxAtStartPar
+cell4\sphinxhyphen{}1
+&\multicolumn{2}{l}{\sphinxtablestrut{9}}\\
+\sphinxhline\sphinxstartmulticolumn{3}%
+\begin{varwidth}t{\sphinxcolwidth{3}{3}}
+\sphinxAtStartPar
+cell5\sphinxhyphen{}1
+\par
+\vskip-\baselineskip\vbox{\hbox{\strut}}\end{varwidth}%
+\sphinxstopmulticolumn
+\\
+\sphinxbottomrule
+\end{tabulary}
+\sphinxtableafterendhook\par
+\sphinxattableend\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable.tex Changed

@@ -1,7 +1,15 @@
 \label{\detokenize{longtable:longtable}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|l|l|}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\sphinxthistablewithborderlessstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{ll}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +17,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +31,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
@@ -37,19 +49,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_align.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_align.tex Changed

@@ -1,7 +1,14 @@
 \label{\detokenize{longtable:longtable-having-align-option}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}r{|l|l|}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax
+\makeatother
+\begin{longtable}{|l|l|}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +16,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +30,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
@@ -37,19 +48,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_caption.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_caption.tex Changed

@@ -1,9 +1,16 @@
 \label{\detokenize{longtable:longtable-having-caption}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|l|l|}
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|l|l|}
 \sphinxthelongtablecaptionisattop
 \caption{caption for longtable\strut}\label{\detokenize{longtable:id1}}\\*\sphinxlongtablecapskipadjust
-\hline
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -11,12 +18,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -24,14 +32,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
@@ -39,19 +50,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_problematic_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_problematic_cell.tex Changed

@@ -1,7 +1,14 @@
 \label{\detokenize{longtable:longtable-having-problematic-cell}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|*{2}{\X{1}{2}|}}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|*{2}{\X{1}{2}|}}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +16,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +30,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 \begin{itemize}
 \item {} 
 \sphinxAtStartPar
@@ -44,19 +55,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_problematic_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_stub_columns_and_problematic_cell.tex Changed

@@ -1,7 +1,14 @@
 \label{\detokenize{longtable:longtable-having-both-stub-columns-and-problematic-cell}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|*{3}{\X{1}{3}|}}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|*{3}{\X{1}{3}|}}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -12,12 +19,13 @@
 \sphinxAtStartPar
 header3
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{3}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{3}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -28,14 +36,17 @@
 \sphinxAtStartPar
 header3
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{3}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{3}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 \sphinxstyletheadfamily \begin{itemize}
 \item {} 
 \sphinxAtStartPar
@@ -53,7 +64,7 @@
 \sphinxAtStartPar
 notinstub1\sphinxhyphen{}3
 \\
-\hline\sphinxstyletheadfamily 
+\sphinxhline\sphinxstyletheadfamily 
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &\sphinxstyletheadfamily 
@@ -63,5 +74,8 @@
 \sphinxAtStartPar
 cell2\sphinxhyphen{}3
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_verbatim.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_verbatim.tex Changed

@@ -1,7 +1,14 @@
 \label{\detokenize{longtable:longtable-having-verbatim}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|*{2}{\X{1}{2}|}}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|*{2}{\X{1}{2}|}}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +16,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +30,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 
 \begin{sphinxVerbatimintable}commandchars=\\\{\}
 \PYG{n}{hello} \PYG{n}{world}
@@ -38,19 +49,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_widths.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_widths.tex Changed

@@ -1,7 +1,15 @@
 \label{\detokenize{longtable:longtable-having-widths-option}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|\X{30}{100}|\X{70}{100}|}
-\hline\noalign{\phantomsection\label{\detokenize{longtable:namedlongtable}}\label{\detokenize{longtable:mylongtable}}}%
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|\X{30}{100}|\X{70}{100}|}
+\noalign{\phantomsection\label{\detokenize{longtable:namedlongtable}}\label{\detokenize{longtable:mylongtable}}}%
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +17,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +31,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
@@ -37,22 +49,25 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}
 
 \sphinxAtStartPar
 See {\hyperref\detokenize{longtable:mylongtable}{\sphinxcrossref{mylongtable}}}, same as {\hyperref\detokenize{longtable:namedlongtable}{\sphinxcrossref{\DUrole{std,std-ref}{this one}}}}.

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_having_widths_and_problematic_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_having_widths_and_problematic_cell.tex Changed

@@ -1,7 +1,14 @@
 \label{\detokenize{longtable:longtable-having-both-widths-and-problematic-cell}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|\X{30}{100}|\X{70}{100}|}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|\X{30}{100}|\X{70}{100}|}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +16,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +30,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 \begin{itemize}
 \item {} 
 \sphinxAtStartPar
@@ -44,19 +55,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/longtable_with_tabularcolumn.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/longtable_with_tabularcolumn.tex Changed

@@ -1,7 +1,15 @@
 \label{\detokenize{longtable:longtable-with-tabularcolumn}}
 
-\begin{savenotes}\sphinxatlongtablestart\begin{longtable}c{|c|c|}
-\hline
+\begin{savenotes}
+\sphinxatlongtablestart
+\sphinxthistablewithglobalstyle
+\sphinxthistablewithvlinesstyle
+\makeatletter
+  \LTleft \@totalleftmargin plus1fill
+  \LTright\dimexpr\columnwidth-\@totalleftmargin-\linewidth\relax plus1fill
+\makeatother
+\begin{longtable}{|c|c|}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -9,12 +17,13 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endfirsthead
 
-\multicolumn{2}{c}%
-{\makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}}\\
-\hline
+\multicolumn{2}{c}{\sphinxnorowcolor
+    \makebox0pt{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} continued from previous page}}%
+}\\
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -22,14 +31,17 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
 \endhead
 
-\hline
-\multicolumn{2}{r}{\makebox0ptr{\sphinxtablecontinued{continues on next page}}}\\
+\sphinxbottomrule
+\multicolumn{2}{r}{\sphinxnorowcolor
+    \makebox0ptr{\sphinxtablecontinued{continues on next page}}%
+}\\
 \endfoot
 
 \endlastfoot
+\sphinxtableatstartofbodyhook
 
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
@@ -37,19 +49,22 @@
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
-\end{longtable}\sphinxatlongtableend\end{savenotes}
+\sphinxbottomrule
+\end{longtable}
+\sphinxtableafterendhook
+\sphinxatlongtableend
+\end{savenotes}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/simple_table.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/simple_table.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_caption.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_caption.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_problematic_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_problematic_cell.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_stub_columns_and_problematic_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_stub_columns_and_problematic_cell.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_threeparagraphs_cell_in_first_col.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_threeparagraphs_cell_in_first_col.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_verbatim.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_verbatim.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_widths.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_widths.tex Changed

@@ -1,10 +1,13 @@
 \label{\detokenize{tabular:table-having-widths-option}}
 
 \begin{savenotes}\sphinxattablestart
+\sphinxthistablewithglobalstyle
+\sphinxthistablewithbooktabsstyle
+\sphinxthistablewithcolorrowsstyle
 \centering
 \phantomsection\label{\detokenize{tabular:namedtabular}}\label{\detokenize{tabular:mytabular}}\nobreak
-\begin{tabular}t{|\X{30}{100}|\X{70}{100}|}
-\hline
+\begin{tabular}t{\X{30}{100}\X{70}{100}}
+\sphinxtoprule
 \sphinxstyletheadfamily 
 \sphinxAtStartPar
 header1
@@ -12,30 +15,31 @@
 \sphinxAtStartPar
 header2
 \\
-\hline
+\sphinxmidrule
+\sphinxtableatstartofbodyhook
 \sphinxAtStartPar
 cell1\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell1\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell2\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell2\sphinxhyphen{}2
 \\
-\hline
+\sphinxhline
 \sphinxAtStartPar
 cell3\sphinxhyphen{}1
 &
 \sphinxAtStartPar
 cell3\sphinxhyphen{}2
 \\
-\hline
+\sphinxbottomrule
 \end{tabular}
-\par
+\sphinxtableafterendhook\par
 \sphinxattableend\end{savenotes}
 
 \sphinxAtStartPar

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/table_having_widths_and_problematic_cell.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/table_having_widths_and_problematic_cell.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/tabular_having_widths.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/tabular_having_widths.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/tabularcolumn.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/tabularcolumn.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/expects/tabulary_having_widths.tex -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/expects/tabulary_having_widths.tex Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/longtable.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/longtable.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-latex-table/tabular.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-latex-table/tabular.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-anchors-ignore/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-anchors-ignore/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-documents_exclude/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-documents_exclude/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-anchor/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-localserver-anchor/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-https/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-localserver-https/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-warn-redirects/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-localserver-warn-redirects/conf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver-warn-redirects/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-localserver-warn-redirects/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck-localserver/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-localserver/conf.py Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-raw-node/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-raw-node/index.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-too-many-retries/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck-too-many-retries/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-linkcheck/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck/conf.py Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-linkcheck/links.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-local-logo/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-local-logo/index.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-locale/locale1/et/LC_MESSAGES/myext.mo Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-locale/locale1/et/LC_MESSAGES/myext.po Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-object-description-sections/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-object-description-sections/index.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-reST-code-role/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-reST-code-role/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-remote-logo/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-remote-logo/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/autodoc_target.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-root/autodoc_target.py Changed

@@ -19,7 +19,7 @@
         """Exception method."""
 
 
-class CustomDataDescriptor(object):
+class CustomDataDescriptor:
     """Descriptor class docstring."""
 
     def __init__(self, doc):
@@ -56,7 +56,7 @@
     return classmethod(function)
 
 
-class Base(object):
+class Base:
     def inheritedmeth(self):
         """Inherited function."""
 
@@ -136,10 +136,10 @@
     pass
 
 
-class Outer(object):
+class Outer:
     """Foo"""
 
-    class Inner(object):
+    class Inner:
         """Foo"""
 
         def meth(self):
@@ -149,7 +149,7 @@
     factory = dict
 
 
-class DocstringSig(object):
+class DocstringSig:
     def meth(self):
         """meth(FOO, BAR=1) -> BAZ
 First line of docstring
@@ -184,12 +184,12 @@
         return self
 
 
-class AttCls(object):
+class AttCls:
     a1 = StrRepr('hello\nworld')
     a2 = None
 
 
-class InstAttCls(object):
+class InstAttCls:
     """Class with documented class and instance attributes."""
 
     #: Doc comment for class attribute InstAttCls.ca1.

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/conf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-root/conf.py Changed

@@ -20,7 +20,7 @@
 source_suffix = '.txt', '.add', '.foo'
 
 project = 'Sphinx <Tests>'
-copyright = '2010-2016, Georg Brandl & Team'
+copyright = '1234-6789, copyright text credits'
 # If this is changed, remember to update the versionchanges!
 version = '0.6'
 release = '0.6alpha1'
@@ -38,6 +38,78 @@
 html_context = {'hckey': 'hcval', 'hckey_co': 'wrong_hcval_co'}
 
 latex_additional_files = 'svgimg.svg'
+# some random pdf layout parameters to check they don't break build
+latex_elements = {
+    'sphinxsetup': """
+  verbatimwithframe,
+  verbatimwrapslines,
+  verbatimforcewraps,
+  verbatimmaxoverfull=1,
+  verbatimmaxunderfull=5,
+  verbatimhintsturnover=true,
+  verbatimcontinuesalign=l,
+  VerbatimColor={RGB}{242,242,242},
+  VerbatimBorderColor={RGB}{32,32,32},
+  VerbatimHighlightColor={RGB}{200,200,200},
+  pre_box-decoration-break=slice,
+  pre_border-top-left-radius=20pt,
+  pre_border-top-right-radius=0pt,
+  pre_border-bottom-right-radius=20pt,
+  pre_border-bottom-left-radius=0pt,
+  verbatimsep=1pt,
+  pre_padding=5pt,% alias to verbatimsep
+  pre_border-top-width=5pt,
+  pre_border-right-width=10pt,
+  pre_border-bottom-width=15pt,
+  pre_border-left-width=20pt,
+  pre_border-width=3pt,% overrides all previous four
+  verbatimborder=2pt,% alias to pre_border-width
+%
+  shadowrule=1pt,
+  shadowsep=10pt,
+  shadowsize=10pt,
+  div.topic_border-width=2pt,% alias to shadowrule 
+  div.topic_padding=6pt,% alias to shadowsep
+  div.topic_box-shadow=5pt,% overrides/alias shadowsize
+%
+  noteBorderColor={RGB}{204,204,204},
+  hintBorderColor={RGB}{204,204,204},
+  importantBorderColor={RGB}{204,204,204},
+  tipBorderColor={RGB}{204,204,204},
+%
+  noteborder=5pt,
+  hintborder=5pt,
+  importantborder=5pt,
+  tipborder=5pt,
+%
+  warningborder=3pt,
+  cautionborder=3pt,
+  attentionborder=3pt,
+  errorborder=3pt,
+%
+  dangerborder=3pt,
+  div.danger_border-width=10pt,
+  div.danger_background-TeXcolor={rgb}{0,1,0},
+  div.danger_border-TeXcolor={rgb}{0,0,1},
+  div.danger_box-shadow=20pt -20pt,
+  div.danger_box-shadow-TeXcolor={rgb}{0.5,0.5,0.5},
+%
+  warningBorderColor={RGB}{255,119,119},
+  cautionBorderColor={RGB}{255,119,119},
+  attentionBorderColor={RGB}{255,119,119},
+  dangerBorderColor={RGB}{255,119,119},
+  errorBorderColor={RGB}{255,119,119},
+  warningBgColor={RGB}{255,238,238},
+  cautionBgColor={RGB}{255,238,238},
+  attentionBgColor={RGB}{255,238,238},
+  dangerBgColor={RGB}{255,238,238},
+  errorBgColor={RGB}{255,238,238},
+%
+  TableRowColorHeader={rgb}{0,1,0},
+  TableRowColorOdd={rgb}{0.5,0,0},
+  TableRowColorEven={rgb}{0.1,0.1,0.1},
+""",
+}
 
 coverage_c_path = 'special/*.h'
 coverage_c_regexes = {'function': r'^PyAPI_FUNC$.*$\s+(^_\w_+)'}
@@ -46,7 +118,7 @@
             'pyurl': ('http://python.org/%s', None)}
 
 # modify tags from conf.py
-tags.add('confpytag')  # NOQA
+tags.add('confpytag')
 
 
 # -- extension API

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/markup.txt -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-root/markup.txt Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-root/objects.txt -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-root/objects.txt Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-search/index.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-search/index.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-search/nosearch.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-search/nosearch.rst Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-search/tocitem.rst -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-search/tocitem.rst Changed

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-toctree-domain-objects/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-toctree-domain-objects/domains.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-toctree-domain-objects/index.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-toctree-index/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-toctree-index/foo.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-toctree-index/index.rst Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-transforms-post_transforms-keyboard/conf.py Added

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-transforms-post_transforms-keyboard/index.rst Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/roots/test-warnings/autodoc_fodder.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/roots/test-warnings/autodoc_fodder.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_api_translator.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_api_translator.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_application.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_application.py Changed

@@ -1,23 +1,46 @@
-"""
-    test_application
-    ~~~~~~~~~~~~~~~~
-
-    Test the Sphinx class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Sphinx class."""
 
+import shutil
+import sys
+from io import StringIO
+from pathlib import Path
 from unittest.mock import Mock
 
 import pytest
 from docutils import nodes
 
+import sphinx.application
 from sphinx.errors import ExtensionError
-from sphinx.testing.util import strip_escseq
+from sphinx.testing.path import path
+from sphinx.testing.util import SphinxTestApp, strip_escseq
 from sphinx.util import logging
 
 
+def test_instantiation(tmp_path_factory, rootdir: str, monkeypatch):
+    # Given
+    src_dir = tmp_path_factory.getbasetemp() / 'root'
+
+    # special support for sphinx/tests
+    if rootdir and not src_dir.exists():
+        shutil.copytree(Path(str(rootdir)) / 'test-root', src_dir)
+
+    monkeypatch.setattr('sphinx.application.abspath', lambda x: x)
+
+    syspath = sys.path:
+
+    # When
+    app_ = SphinxTestApp(
+        srcdir=path(src_dir),
+        status=StringIO(),
+        warning=StringIO(),
+    )
+    sys.path: = syspath
+    app_.cleanup()
+
+    # Then
+    assert isinstance(app_, sphinx.application.Sphinx)
+
+
 def test_events(app, status, warning):
     def empty():
         pass
@@ -126,7 +149,7 @@
                  app.srcdir / 'subdir/../subdir/excluded.txt'  # not normalized
     app.build(False, filenames)
 
-    expected = 'index', 'img.png', 'subdir/includes', 'subdir/excluded'
+    expected = 'index', 'subdir/includes', 'subdir/excluded'
     app.builder.build.assert_called_with(expected,
                                          method='specific',
-                                         summary='4 source files given on command line')
+                                         summary='3 source files given on command line')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build.py Changed

@@ -1,15 +1,6 @@
-"""
-    test_build
-    ~~~~~~~~~~
-
-    Test all builders.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test all builders."""
 
 import sys
-from textwrap import dedent
 from unittest import mock
 
 import pytest
@@ -25,34 +16,27 @@
     return response
 
 
-@pytest.fixture
+@pytest.fixture()
 def nonascii_srcdir(request, rootdir, sphinx_test_tempdir):
-    # If supported, build in a non-ASCII source dir
+    # Build in a non-ASCII source dir
     test_name = '\u65e5\u672c\u8a9e'
     basedir = sphinx_test_tempdir / request.node.originalname
-    try:
-        srcdir = basedir / test_name
-        if not srcdir.exists():
-            (rootdir / 'test-root').copytree(srcdir)
-    except UnicodeEncodeError:
-        # Now Python 3.7+ follows PEP-540 and uses utf-8 encoding for filesystem by default.
-        # So this error handling will be no longer used (after dropping python 3.6 support).
-        srcdir = basedir / 'all'
-        if not srcdir.exists():
-            (rootdir / 'test-root').copytree(srcdir)
-    else:
-        # add a doc with a non-ASCII file name to the source dir
-        (srcdir / (test_name + '.txt')).write_text(dedent("""
-            nonascii file name page
-            =======================
-            """))
-
-        root_doc = srcdir / 'index.txt'
-        root_doc.write_text(root_doc.read_text() + dedent("""
-                            .. toctree::
-
-                               %(test_name)s/%(test_name)s
-                            """ % {'test_name': test_name}))
+    srcdir = basedir / test_name
+    if not srcdir.exists():
+        (rootdir / 'test-root').copytree(srcdir)
+
+    # add a doc with a non-ASCII file name to the source dir
+    (srcdir / (test_name + '.txt')).write_text("""
+nonascii file name page
+=======================
+""", encoding='utf8')
+
+    root_doc = srcdir / 'index.txt'
+    root_doc.write_text(root_doc.read_text(encoding='utf8') + f"""
+.. toctree::
+
+{test_name}/{test_name}
+""", encoding='utf8')
     return srcdir
 
 
@@ -71,7 +55,7 @@
 
 
 def test_root_doc_not_found(tempdir, make_app):
-    (tempdir / 'conf.py').write_text('')
+    (tempdir / 'conf.py').write_text('', encoding='utf8')
     assert tempdir.listdir() == 'conf.py'
 
     app = make_app('dummy', srcdir=tempdir)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_changes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_changes.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_dirhtml.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_dirhtml.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_build_dirhtml
-    ~~~~~~~~~~~~~~~~~~
-
-    Test dirhtml builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test dirhtml builder."""
 
 import posixpath
 
@@ -25,7 +17,7 @@
     assert (app.outdir / 'foo/foo_2/index.html').exists()
     assert (app.outdir / 'bar/index.html').exists()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert 'href="foo/"' in content
     assert 'href="foo/foo_1/"' in content
     assert 'href="foo/foo_2/"' in content
@@ -36,13 +28,13 @@
         invdata = InventoryFile.load(f, 'path/to', posixpath.join)
 
     assert 'index' in invdata.get('std:doc')
-    assert ('Python', '', 'path/to/', '-') == invdata'std:doc''index'
+    assert invdata'std:doc''index' == ('Python', '', 'path/to/', '-')
 
     assert 'foo/index' in invdata.get('std:doc')
-    assert ('Python', '', 'path/to/foo/', '-') == invdata'std:doc''foo/index'
+    assert invdata'std:doc''foo/index' == ('Python', '', 'path/to/foo/', '-')
 
     assert 'index' in invdata.get('std:label')
-    assert ('Python', '', 'path/to/#index', '-') == invdata'std:label''index'
+    assert invdata'std:label''index' == ('Python', '', 'path/to/#index', '-')
 
     assert 'foo' in invdata.get('std:label')
-    assert ('Python', '', 'path/to/foo/#foo', 'foo/index') == invdata'std:label''foo'
+    assert invdata'std:label''foo' == ('Python', '', 'path/to/foo/#foo', 'foo/index')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_epub.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_epub.py Changed

@@ -1,25 +1,20 @@
-"""
-    test_build_html
-    ~~~~~~~~~~~~~~~
-
-    Test the HTML builder and check output against XPath.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the HTML builder and check output against XPath."""
 
 import os
 import subprocess
-from subprocess import PIPE, CalledProcessError
+from pathlib import Path
+from subprocess import CalledProcessError
 from xml.etree import ElementTree
 
 import pytest
 
+from sphinx.builders.epub3 import _XML_NAME_PATTERN
+
 
 # check given command is runnable
 def runnable(command):
     try:
-        subprocess.run(command, stdout=PIPE, stderr=PIPE, check=True)
+        subprocess.run(command, capture_output=True, check=True)
         return True
     except (OSError, CalledProcessError):
         return False  # command not found or exit with non-zero
@@ -33,7 +28,7 @@
         'ibooks': 'http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/',
         'ncx': 'http://www.daisy.org/z3986/2005/ncx/',
         'xhtml': 'http://www.w3.org/1999/xhtml',
-        'epub': 'http://www.idpf.org/2007/ops'
+        'epub': 'http://www.idpf.org/2007/ops',
     }
 
     def __init__(self, tree):
@@ -41,7 +36,8 @@
 
     @classmethod
     def fromstring(cls, string):
-        return cls(ElementTree.fromstring(string))
+        tree = ElementTree.fromstring(string)  # NoQA: S314  # using known data in tests
+        return cls(tree)
 
     def find(self, match):
         ret = self.tree.find(match, namespaces=self.namespaces)
@@ -64,12 +60,12 @@
 
 @pytest.mark.sphinx('epub', testroot='basic')
 def test_build_epub(app):
-    app.build()
-    assert (app.outdir / 'mimetype').read_text() == 'application/epub+zip'
+    app.builder.build_all()
+    assert (app.outdir / 'mimetype').read_text(encoding='utf8') == 'application/epub+zip'
     assert (app.outdir / 'META-INF' / 'container.xml').exists()
 
     # toc.ncx
-    toc = EPUBElementTree.fromstring((app.outdir / 'toc.ncx').read_text())
+    toc = EPUBElementTree.fromstring((app.outdir / 'toc.ncx').read_text(encoding='utf8'))
     assert toc.find("./ncx:docTitle/ncx:text").text == 'Python'
 
     # toc.ncx / head
@@ -89,7 +85,7 @@
     assert navlabel.text == 'The basic Sphinx documentation for testing'
 
     # content.opf
-    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text())
+    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text(encoding='utf8'))
 
     # content.opf / metadata
     metadata = opf.find("./idpf:metadata")
@@ -141,7 +137,7 @@
     assert reference.get('href') == 'index.xhtml'
 
     # nav.xhtml
-    nav = EPUBElementTree.fromstring((app.outdir / 'nav.xhtml').read_text())
+    nav = EPUBElementTree.fromstring((app.outdir / 'nav.xhtml').read_text(encoding='utf8'))
     assert nav.attrib == {'lang': 'en',
                           '{http://www.w3.org/XML/1998/namespace}lang': 'en'}
     assert nav.find("./xhtml:head/xhtml:title").text == 'Table of Contents'
@@ -161,7 +157,7 @@
     app.build()
 
     # content.opf / metadata
-    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text())
+    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text(encoding='utf8'))
     cover_image = opf.find("./idpf:manifest/idpf:item@href='%s'" % app.config.epub_cover0)
     cover = opf.find("./idpf:metadata/idpf:meta@name='cover'")
     assert cover
@@ -281,10 +277,10 @@
 @pytest.mark.sphinx('epub', testroot='basic')
 def test_epub_writing_mode(app):
     # horizontal (default)
-    app.build()
+    app.builder.build_all()
 
     # horizontal / page-progression-direction
-    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text())
+    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text(encoding='utf8'))
     assert opf.find("./idpf:spine").get('page-progression-direction') == 'ltr'
 
     # horizontal / ibooks:scroll-axis
@@ -292,7 +288,7 @@
     assert metadata.find("./idpf:meta@property='ibooks:scroll-axis'").text == 'vertical'
 
     # horizontal / writing-mode (CSS)
-    css = (app.outdir / '_static' / 'epub.css').read_text()
+    css = (app.outdir / '_static' / 'epub.css').read_text(encoding='utf8')
     assert 'writing-mode: horizontal-tb;' in css
 
     # vertical
@@ -301,7 +297,7 @@
     app.build()
 
     # vertical / page-progression-direction
-    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text())
+    opf = EPUBElementTree.fromstring((app.outdir / 'content.opf').read_text(encoding='utf8'))
     assert opf.find("./idpf:spine").get('page-progression-direction') == 'rtl'
 
     # vertical / ibooks:scroll-axis
@@ -309,7 +305,7 @@
     assert metadata.find("./idpf:meta@property='ibooks:scroll-axis'").text == 'horizontal'
 
     # vertical / writing-mode (CSS)
-    css = (app.outdir / '_static' / 'epub.css').read_text()
+    css = (app.outdir / '_static' / 'epub.css').read_text(encoding='utf8')
     assert 'writing-mode: vertical-rl;' in css
 
 
@@ -317,7 +313,7 @@
 def test_epub_anchor_id(app):
     app.build()
 
-    html = (app.outdir / 'index.xhtml').read_text()
+    html = (app.outdir / 'index.xhtml').read_text(encoding='utf8')
     assert ('<p id="std-setting-STATICFILES_FINDERS">'
             'blah blah blah</p>' in html)
     assert ('<span id="std-setting-STATICFILES_SECTION"></span>'
@@ -330,7 +326,7 @@
     app.builder.build_all()
 
     # epub_sytlesheets (same as html_css_files)
-    content = (app.outdir / 'index.xhtml').read_text()
+    content = (app.outdir / 'index.xhtml').read_text(encoding='utf8')
     assert ('<link rel="stylesheet" type="text/css" href="_static/css/style.css" />'
             in content)
     assert ('<link media="print" rel="stylesheet" title="title" type="text/css" '
@@ -343,7 +339,7 @@
     app.builder.build_all()
 
     # epub_css_files
-    content = (app.outdir / 'index.xhtml').read_text()
+    content = (app.outdir / 'index.xhtml').read_text(encoding='utf8')
     assert '<link rel="stylesheet" type="text/css" href="_static/css/epub.css" />' in content
 
     # files in html_css_files are not outputted
@@ -358,7 +354,7 @@
     app.build()
     assert not (app.outdir / '_downloads' / 'dummy.dat').exists()
 
-    content = (app.outdir / 'index.xhtml').read_text()
+    content = (app.outdir / 'index.xhtml').read_text(encoding='utf8')
     assert ('<li><p><code class="xref download docutils literal notranslate">'
             '<span class="pre">dummy.dat</span></code></p></li>' in content)
     assert ('<li><p><code class="xref download docutils literal notranslate">'
@@ -371,7 +367,7 @@
 
 @pytest.mark.sphinx('epub', testroot='toctree-duplicated')
 def test_duplicated_toctree_entry(app, status, warning):
-    app.build()
+    app.builder.build_all()
     assert 'WARNING: duplicated ToC entry found: foo.xhtml' in warning.getvalue()
 
 
@@ -385,8 +381,30 @@
     if runnable('java', '-version') and os.path.exists(epubcheck):
         try:
             subprocess.run('java', '-jar', epubcheck, app.outdir / 'SphinxTests.epub',
-                           stdout=PIPE, stderr=PIPE, check=True)
+                           capture_output=True, check=True)
         except CalledProcessError as exc:
             print(exc.stdout.decode('utf-8'))
             print(exc.stderr.decode('utf-8'))
-            assert False, 'epubcheck exited with return code %s' % exc.returncode
+            raise AssertionError('epubcheck exited with return code %s' % exc.returncode)
+
+
+def test_xml_name_pattern_check():
+    assert _XML_NAME_PATTERN.match('id-pub')
+    assert _XML_NAME_PATTERN.match('webpage')
+    assert not _XML_NAME_PATTERN.match('1bfda21')
+
+
+@pytest.mark.sphinx('epub', testroot='images')
+def test_copy_images(app, status, warning):
+    app.build()
+
+    images_dir = Path(app.outdir) / '_images'
+    images = {image.name for image in images_dir.rglob('*')}
+    images.discard('python-logo.png')
+    assert images == {
+        'img.png',
+        'rimg.png',
+        'rimg1.png',
+        'svgimg.svg',
+        'testimäge.png',
+    }

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_gettext.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_gettext.py Changed

@@ -1,22 +1,38 @@
-"""
-    test_build_gettext
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the build process with gettext builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with gettext builder with the test root."""
 
 import gettext
 import os
 import re
 import subprocess
-from subprocess import PIPE, CalledProcessError
+from subprocess import CalledProcessError
 
 import pytest
 
-from sphinx.util.osutil import cd
+from sphinx.builders.gettext import Catalog, MsgOrigin
+
+try:
+    from contextlib import chdir
+except ImportError:
+    from sphinx.util.osutil import _chdir as chdir
+
+
+def test_Catalog_duplicated_message():
+    catalog = Catalog()
+    catalog.add('hello', MsgOrigin('/path/to/filename', 1))
+    catalog.add('hello', MsgOrigin('/path/to/filename', 1))
+    catalog.add('hello', MsgOrigin('/path/to/filename', 2))
+    catalog.add('hello', MsgOrigin('/path/to/yetanother', 1))
+    catalog.add('world', MsgOrigin('/path/to/filename', 1))
+
+    assert len(list(catalog)) == 2
+
+    msg1, msg2 = list(catalog)
+    assert msg1.text == 'hello'
+    assert msg1.locations == ('/path/to/filename', 1),
+                              ('/path/to/filename', 2),
+                              ('/path/to/yetanother', 1)
+    assert msg2.text == 'world'
+    assert msg2.locations == ('/path/to/filename', 1)
 
 
 @pytest.mark.sphinx('gettext', srcdir='root-gettext')
@@ -31,7 +47,7 @@
     assert (app.outdir / 'subdir.pot').isfile()
 
     # regression test for issue #960
-    catalog = (app.outdir / 'markup.pot').read_text()
+    catalog = (app.outdir / 'markup.pot').read_text(encoding='utf8')
     assert 'msgid "something, something else, something more"' in catalog
 
 
@@ -39,28 +55,28 @@
 def test_msgfmt(app):
     app.builder.build_all()
     (app.outdir / 'en' / 'LC_MESSAGES').makedirs()
-    with cd(app.outdir):
+    with chdir(app.outdir):
         try:
             args = 'msginit', '--no-translator', '-i', 'markup.pot', '--locale', 'en_US'
-            subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True)
+            subprocess.run(args, capture_output=True, check=True)
         except OSError:
             pytest.skip()  # most likely msginit was not found
         except CalledProcessError as exc:
             print(exc.stdout)
             print(exc.stderr)
-            assert False, 'msginit exited with return code %s' % exc.returncode
+            raise AssertionError('msginit exited with return code %s' % exc.returncode)
 
         assert (app.outdir / 'en_US.po').isfile(), 'msginit failed'
         try:
             args = 'msgfmt', 'en_US.po',
                     '-o', os.path.join('en', 'LC_MESSAGES', 'test_root.mo')
-            subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True)
+            subprocess.run(args, capture_output=True, check=True)
         except OSError:
             pytest.skip()  # most likely msgfmt was not found
         except CalledProcessError as exc:
             print(exc.stdout)
             print(exc.stderr)
-            assert False, 'msgfmt exited with return code %s' % exc.returncode
+            raise AssertionError('msgfmt exited with return code %s' % exc.returncode)
 
         mo = app.outdir / 'en' / 'LC_MESSAGES' / 'test_root.mo'
         assert mo.isfile(), 'msgfmt failed'
@@ -84,7 +100,7 @@
             return m.groups()0
         return None
 
-    pot = (app.outdir / 'index_entries.pot').read_text()
+    pot = (app.outdir / 'index_entries.pot').read_text(encoding='utf8')
     msgids = _f for _f in map(msgid_getter, pot.splitlines()) if _f
 
     expected_msgids = 
@@ -123,6 +139,7 @@
                    'gettext_additional_targets': })
 def test_gettext_disable_index_entries(app):
     # regression test for #976
+    app.env._pickled_doctree_cache.clear()  # clear cache
     app.builder.build('index_entries')
 
     _msgid_getter = re.compile(r'msgid "(.*)"').search
@@ -133,7 +150,7 @@
             return m.groups()0
         return None
 
-    pot = (app.outdir / 'index_entries.pot').read_text()
+    pot = (app.outdir / 'index_entries.pot').read_text(encoding='utf8')
     msgids = _f for _f in map(msgid_getter, pot.splitlines()) if _f
 
     expected_msgids = 
@@ -153,10 +170,10 @@
 
 @pytest.mark.sphinx('gettext', testroot='intl', srcdir='gettext')
 def test_gettext_template(app):
-    app.builder.build_all()
+    app.build()
     assert (app.outdir / 'sphinx.pot').isfile()
 
-    result = (app.outdir / 'sphinx.pot').read_text()
+    result = (app.outdir / 'sphinx.pot').read_text(encoding='utf8')
     assert "Welcome" in result
     assert "Sphinx %(version)s" in result
 
@@ -166,7 +183,7 @@
     app.builder.build_all()
     assert (app.outdir / 'sphinx.pot').isfile()
 
-    result = (app.outdir / 'sphinx.pot').read_text()
+    result = (app.outdir / 'sphinx.pot').read_text(encoding='utf8')
     assert re.search(
         ('msgid "Template 1".*'
          'msgid "This is Template 1\\.".*'
@@ -184,7 +201,7 @@
 
     assert (app.outdir / 'documentation.pot').isfile()
 
-    result = (app.outdir / 'documentation.pot').read_text()
+    result = (app.outdir / 'documentation.pot').read_text(encoding='utf8')
     assert re.search(
         ('msgid "Todo".*'
          'msgid "Like footnotes.".*'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_html.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_html.py Changed

@@ -1,36 +1,21 @@
-"""
-    test_build_html
-    ~~~~~~~~~~~~~~~
-
-    Test the HTML builder and check output against XPath.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the HTML builder and check output against XPath."""
 
 import os
 import re
 from itertools import chain, cycle
+from pathlib import Path
 from unittest.mock import ANY, call, patch
 
-import pygments
 import pytest
 from html5lib import HTMLParser
-from packaging import version
 
 from sphinx.builders.html import validate_html_extra_path, validate_html_static_path
 from sphinx.errors import ConfigError
 from sphinx.testing.util import strip_escseq
-from sphinx.util import docutils, md5
+from sphinx.util import md5
 from sphinx.util.inventory import InventoryFile
 
-if docutils.__version_info__ < (0, 17):
-    FIGURE_CAPTION = ".//div@class='figure align-default'/p@class='caption'"
-else:
-    FIGURE_CAPTION = ".//figure/figcaption/p"
-
-
-PYGMENTS_VERSION = version.parse(pygments.__version__).release
+FIGURE_CAPTION = ".//figure/figcaption/p"
 
 
 ENV_WARNINGS = """\
@@ -46,10 +31,10 @@
 """
 
 HTML_WARNINGS = ENV_WARNINGS + """\
-%(root)s/index.rst:\\d+: WARNING: unknown option: &option
+%(root)s/index.rst:\\d+: WARNING: unknown option: '&option'
 %(root)s/index.rst:\\d+: WARNING: citation not found: missing
 %(root)s/index.rst:\\d+: WARNING: a suitable image for html builder not found: foo.\\*
-%(root)s/index.rst:\\d+: WARNING: Could not lex literal_block as "c". Highlighting skipped.
+%(root)s/index.rst:\\d+: WARNING: Could not lex literal_block .* as "c". Highlighting skipped.
 """
 
 
@@ -75,7 +60,7 @@
         
             zip(cycle(fname), values)
             for fname, values in d.items()
-        
+        ,
     )
 
 
@@ -86,7 +71,7 @@
         for node in nodes:
             if node.tail and rex.search(node.tail):
                 return True
-        assert False, '%r not found in tail of any nodes %s' % (check, nodes)
+        raise AssertionError(f'{check!r} not found in tail of any nodes {nodes}')
     return checker
 
 
@@ -121,9 +106,9 @@
             if all(not rex.search(get_text(node)) for node in nodes):
                 return
 
-        assert False, ('%r not found in any node matching '
-                       'path %s in %s: %r' % (check, path, fname,
-                                              node.text for node in nodes))
+        raise AssertionError('%r not found in any node matching '
+                             'path %s in %s: %r' % (check, path, fname,
+                                                    node.text for node in nodes))
 
 
 @pytest.mark.sphinx('html', testroot='warnings')
@@ -133,14 +118,22 @@
     html_warnings_exp = HTML_WARNINGS % {
         'root': re.escape(app.srcdir.replace(os.sep, '/'))}
     assert re.match(html_warnings_exp + '$', html_warnings), \
-        'Warnings don\'t match:\n' + \
+        "Warnings don't match:\n" + \
         '--- Expected (regex):\n' + html_warnings_exp + \
         '--- Got:\n' + html_warnings
 
 
-@pytest.mark.sphinx('html', confoverrides={'html4_writer': True})
-def test_html4_output(app, status, warning):
-    app.build()
+def test_html4_error(make_app, tempdir):
+    (tempdir / 'conf.py').write_text('', encoding='utf-8')
+    with pytest.raises(
+        ConfigError,
+        match=r'HTML 4 is no longer supported by Sphinx',
+    ):
+        make_app(
+            buildername='html',
+            srcdir=tempdir,
+            confoverrides={'html4_writer': True},
+        )
 
 
 @pytest.mark.parametrize("fname,expect", flat_dict({
@@ -220,9 +213,9 @@
         (".//li/p/code/span@class='pre'", '^a/$'),
         (".//li/p/code/em/span@class='pre'", '^varpart$'),
         (".//li/p/code/em/span@class='pre'", '^i$'),
-        (".//a@href='https://www.python.org/dev/peps/pep-0008'"
+        (".//a@href='https://peps.python.org/pep-0008/'"
          "@class='pep reference external'/strong", 'PEP 8'),
-        (".//a@href='https://www.python.org/dev/peps/pep-0008'"
+        (".//a@href='https://peps.python.org/pep-0008/'"
          "@class='pep reference external'/strong",
          'Python Enhancement Proposal #8'),
         (".//a@href='https://datatracker.ietf.org/doc/html/rfc1.html'"
@@ -361,12 +354,10 @@
     'index.html': 
         (".//meta@name='hc'@content='hcval'", ''),
         (".//meta@name='hc_co'@content='hcval_co'", ''),
-        (".//dt@class='label'/span@class='brackets'", r'Ref1'),
-        (".//dt@class='label'", ''),
         (".//li@class='toctree-l1'/a", 'Testing various markup'),
         (".//li@class='toctree-l2'/a", 'Inline markup'),
         (".//title", 'Sphinx <Tests>'),
-        (".//div@class='footer'", 'Georg Brandl & Team'),
+        (".//div@class='footer'", 'copyright text credits'),
         (".//a@href='http://python.org/'"
          "@class='reference external'", ''),
         (".//li/p/a@href='genindex.html'/span", 'Index'),
@@ -400,6 +391,25 @@
         (".//a", "entry"),
         (".//li/a", "double"),
     ,
+    'otherext.html': 
+        (".//h1", "Generated section"),
+        (".//a@href='_sources/otherext.foo.txt'", ''),
+    ,
+}))
+@pytest.mark.sphinx('html', tags='testtag',
+                    confoverrides={'html_context.hckey_co': 'hcval_co'})
+@pytest.mark.test_params(shared_result='test_build_html_output')
+def test_html5_output(app, cached_etree_parse, fname, expect):
+    app.build()
+    print(app.outdir / fname)
+    check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
+
+
+@pytest.mark.parametrize("fname,expect", flat_dict({
+    'index.html': 
+        (".//div@class='citation'/span", r'Ref1'),
+        (".//div@class='citation'/span", r'Ref_1'),
+    ,
     'footnote.html': 
         (".//a@class='footnote-reference brackets'@href='#id9'@id='id1'", r"1"),
         (".//a@class='footnote-reference brackets'@href='#id10'@id='id2'", r"2"),
@@ -408,24 +418,19 @@
         (".//a@class='reference internal'@href='#baz-qux'@id='id5'/span", r"\baz_qux\"),
         (".//a@class='footnote-reference brackets'@href='#id11'@id='id6'", r"4"),
         (".//a@class='footnote-reference brackets'@href='#id12'@id='id7'", r"5"),
-        (".//a@class='fn-backref'@href='#id1'", r"1"),
-        (".//a@class='fn-backref'@href='#id2'", r"2"),
-        (".//a@class='fn-backref'@href='#id3'", r"3"),
-        (".//a@class='fn-backref'@href='#id4'", r"bar"),
-        (".//a@class='fn-backref'@href='#id5'", r"baz_qux"),
-        (".//a@class='fn-backref'@href='#id6'", r"4"),
-        (".//a@class='fn-backref'@href='#id7'", r"5"),
-        (".//a@class='fn-backref'@href='#id8'", r"6"),
+        (".//aside@class='footnote brackets'/span/a@href='#id1'", r"1"),
+        (".//aside@class='footnote brackets'/span/a@href='#id2'", r"2"),
+        (".//aside@class='footnote brackets'/span/a@href='#id3'", r"3"),
+        (".//div@class='citation'/span/a@href='#id4'", r"bar"),
+        (".//div@class='citation'/span/a@href='#id5'", r"baz_qux"),
+        (".//aside@class='footnote brackets'/span/a@href='#id6'", r"4"),
+        (".//aside@class='footnote brackets'/span/a@href='#id7'", r"5"),
+        (".//aside@class='footnote brackets'/span/a@href='#id8'", r"6"),
     ,
-    'otherext.html': 
-        (".//h1", "Generated section"),
-        (".//a@href='_sources/otherext.foo.txt'", ''),
-    
 }))
-@pytest.mark.sphinx('html', tags='testtag',
-                    confoverrides={'html_context.hckey_co': 'hcval_co'})
-@pytest.mark.test_params(shared_result='test_build_html_output')
-def test_html5_output(app, cached_etree_parse, fname, expect):
+@pytest.mark.sphinx('html')
+@pytest.mark.test_params(shared_result='test_build_html_output_docutils18')
+def test_docutils_output(app, cached_etree_parse, fname, expect):
     app.build()
     print(app.outdir / fname)
     check_xpath(cached_etree_parse(app.outdir / fname), fname, *expect)
@@ -442,7 +447,7 @@
     app.build()
 
     # subdir/includes.html
-    result = (app.outdir / 'subdir' / 'includes.html').read_text()
+    result = (app.outdir / 'subdir' / 'includes.html').read_text(encoding='utf8')
     pattern = ('<a class="reference download internal" download="" '
                'href="../(_downloads/.*/img.png)">')
     matched = re.search(pattern, result)
@@ -451,7 +456,7 @@
     filename = matched.group(1)
 
     # includes.html
-    result = (app.outdir / 'includes.html').read_text()
+    result = (app.outdir / 'includes.html').read_text(encoding='utf8')
     pattern = ('<a class="reference download internal" download="" '
                'href="(_downloads/.*/img.png)">')
     matched = re.search(pattern, result)
@@ -474,7 +479,7 @@
     digest_another = md5(b'another/dummy.dat').hexdigest()
     assert (app.outdir / '_downloads' / digest_another / 'dummy.dat').exists()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert (('<li><p><a class="reference download internal" download="" '
              'href="_downloads/%s/dummy.dat">'
              '<code class="xref download docutils literal notranslate">'
@@ -656,10 +661,10 @@
 def test_numfig_without_numbered_toctree_warn(app, warning):
     app.build()
     # remove :numbered: option
-    index = (app.srcdir / 'index.rst').read_text()
+    index = (app.srcdir / 'index.rst').read_text(encoding='utf8')
     index = re.sub(':numbered:.*', '', index)
-    (app.srcdir / 'index.rst').write_text(index)
-    app.builder.build_all()
+    (app.srcdir / 'index.rst').write_text(index, encoding='utf8')
+    app.build()
 
     warnings = warning.getvalue()
     assert 'index.rst:47: WARNING: numfig is disabled. :numref: is ignored.' not in warnings
@@ -744,9 +749,9 @@
     confoverrides={'numfig': True})
 def test_numfig_without_numbered_toctree(app, cached_etree_parse, fname, expect):
     # remove :numbered: option
-    index = (app.srcdir / 'index.rst').read_text()
+    index = (app.srcdir / 'index.rst').read_text(encoding='utf8')
     index = re.sub(':numbered:.*', '', index)
-    (app.srcdir / 'index.rst').write_text(index)
+    (app.srcdir / 'index.rst').write_text(index, encoding='utf8')
 
     if not app.outdir.listdir():
         app.build()
@@ -1134,7 +1139,7 @@
     assert not (app.outdir / '_static' / '.htaccess').exists()
     assert not (app.outdir / '_static' / '.htpasswd').exists()
     assert (app.outdir / '_static' / 'API.html').exists()
-    assert (app.outdir / '_static' / 'API.html').read_text() == 'Sphinx-1.4.4'
+    assert (app.outdir / '_static' / 'API.html').read_text(encoding='utf8') == 'Sphinx-1.4.4'
     assert (app.outdir / '_static' / 'css' / 'style.css').exists()
     assert (app.outdir / '_static' / 'js' / 'custom.js').exists()
     assert (app.outdir / '_static' / 'rimg.png').exists()
@@ -1155,7 +1160,7 @@
     assert not (app.outdir / 'subdir' / '.htpasswd').exists()
 
     # html_css_files
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<link rel="stylesheet" type="text/css" href="_static/css/style.css" />' in content
     assert ('<link media="print" rel="stylesheet" title="title" type="text/css" '
             'href="https://example.com/custom.css" />' in content)
@@ -1178,7 +1183,7 @@
     app.add_js_file('lazy.js', priority=900)
 
     app.builder.build_all()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     # css_files
     expected = '_static/early.css', '_static/pygments.css', '_static/alabaster.css',
@@ -1188,8 +1193,9 @@
     assert re.search(pattern, content, re.S)
 
     # js_files
-    expected = '_static/early.js', '_static/jquery.js', '_static/underscore.js',
-                '_static/doctools.js', 'https://example.com/script.js', '_static/normal.js',
+    expected = '_static/early.js',
+                '_static/doctools.js', '_static/sphinx_highlight.js',
+                'https://example.com/script.js', '_static/normal.js',
                 '_static/late.js', '_static/js/custom.js', '_static/lazy.js'
     pattern = '.*'.join('src="%s"' % f for f in expected)
     assert re.search(pattern, content, re.S)
@@ -1202,7 +1208,7 @@
     app.add_js_file('late.js', loading_method='defer')
 
     app.builder.build_all()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     assert '<script src="_static/normal.js"></script>' in content
     assert '<script async="async" src="_static/early.js"></script>' in content
@@ -1237,7 +1243,7 @@
 def test_html_entity(app):
     app.builder.build_all()
     valid_entities = {'amp', 'lt', 'gt', 'quot', 'apos'}
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     for entity in re.findall(r'&(a-z+);', content, re.M):
         assert entity not in valid_entities
 
@@ -1279,21 +1285,16 @@
 @pytest.mark.sphinx('html', testroot='images', confoverrides={'html_sourcelink_suffix': ''})
 def test_html_anchor_for_figure(app):
     app.builder.build_all()
-    content = (app.outdir / 'index.html').read_text()
-    if docutils.__version_info__ < (0, 17):
-        assert ('<p class="caption"><span class="caption-text">The caption of pic</span>'
-                '<a class="headerlink" href="#id1" title="Permalink to this image">¶</a></p>'
-                in content)
-    else:
-        assert ('<figcaption>\n<p><span class="caption-text">The caption of pic</span>'
-                '<a class="headerlink" href="#id1" title="Permalink to this image">¶</a></p>\n</figcaption>'
-                in content)
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert ('<figcaption>\n<p><span class="caption-text">The caption of pic</span>'
+            '<a class="headerlink" href="#id1" title="Permalink to this image">¶</a></p>\n</figcaption>'
+            in content)
 
 
 @pytest.mark.sphinx('html', testroot='directives-raw')
 def test_html_raw_directive(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     # standard case
     assert 'standalone raw directive (HTML)' in result
@@ -1337,7 +1338,7 @@
 @pytest.mark.sphinx('html', testroot='html_style')
 def test_html_style(app, status, warning):
     app.build()
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<link rel="stylesheet" type="text/css" href="_static/default.css" />' in result
     assert ('<link rel="stylesheet" type="text/css" href="_static/alabaster.css" />'
             not in result)
@@ -1347,19 +1348,28 @@
 def test_html_remote_images(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<img alt="https://www.python.org/static/img/python-logo.png" '
             'src="https://www.python.org/static/img/python-logo.png" />' in result)
     assert not (app.outdir / 'python-logo.png').exists()
 
 
+@pytest.mark.sphinx('html', testroot='image-escape')
+def test_html_encoded_image(app, status, warning):
+    app.builder.build_all()
+
+    result = (app.outdir / 'index.html').read_text()
+    assert ('<img alt="_images/img_%231.png" src="_images/img_%231.png" />' in result)
+    assert (app.outdir / '_images/img_#1.png').exists()
+
+
 @pytest.mark.sphinx('html', testroot='remote-logo')
 def test_html_remote_logo(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<img class="logo" src="https://www.python.org/static/img/python-logo.png" alt="Logo"/>' in result)
-    assert ('<link rel="shortcut icon" href="https://www.python.org/static/favicon.ico"/>' in result)
+    assert ('<link rel="icon" href="https://www.python.org/static/favicon.ico"/>' in result)
     assert not (app.outdir / 'python-logo.png').exists()
 
 
@@ -1367,7 +1377,7 @@
 def test_html_local_logo(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<img class="logo" src="_static/img.png" alt="Logo"/>' in result)
     assert (app.outdir / '_static/img.png').exists()
 
@@ -1378,7 +1388,7 @@
 
     # default for alabaster
     app.builder.build_all()
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<div class="sphinxsidebar" role="navigation" '
             'aria-label="main navigation">' in result)
     assert '<h1 class="logo"><a href="#">Python</a></h1>' in result
@@ -1393,7 +1403,7 @@
     # only relations.html
     app.config.html_sidebars = {'**': 'relations.html'}
     app.builder.build_all()
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<div class="sphinxsidebar" role="navigation" '
             'aria-label="main navigation">' in result)
     assert '<h1 class="logo"><a href="#">Python</a></h1>' not in result
@@ -1407,7 +1417,7 @@
     # no sidebars
     app.config.html_sidebars = {'**': }
     app.builder.build_all()
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<div class="sphinxsidebar" role="navigation" '
             'aria-label="main navigation">' not in result)
     assert '<h1 class="logo"><a href="#">Python</a></h1>' not in result
@@ -1422,7 +1432,7 @@
 @pytest.mark.parametrize('fname,expect', flat_dict({
     'index.html': (".//em/a@href='https://example.com/man.1'", "", True),
                    (".//em/a@href='https://example.com/ls.1'", "", True),
-                   (".//em/a@href='https://example.com/sphinx.'", "", True)
+                   (".//em/a@href='https://example.com/sphinx.'", "", True),
 
 }))
 @pytest.mark.sphinx('html', testroot='manpage_url', confoverrides={
@@ -1438,10 +1448,10 @@
 def test_html_baseurl(app, status, warning):
     app.build()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<link rel="canonical" href="https://example.com/index.html" />' in result
 
-    result = (app.outdir / 'qux' / 'index.html').read_text()
+    result = (app.outdir / 'qux' / 'index.html').read_text(encoding='utf8')
     assert '<link rel="canonical" href="https://example.com/qux/index.html" />' in result
 
 
@@ -1451,10 +1461,10 @@
 def test_html_baseurl_and_html_file_suffix(app, status, warning):
     app.build()
 
-    result = (app.outdir / 'index.htm').read_text()
+    result = (app.outdir / 'index.htm').read_text(encoding='utf8')
     assert '<link rel="canonical" href="https://example.com/subdir/index.htm" />' in result
 
-    result = (app.outdir / 'qux' / 'index.htm').read_text()
+    result = (app.outdir / 'qux' / 'index.htm').read_text(encoding='utf8')
     assert '<link rel="canonical" href="https://example.com/subdir/qux/index.htm" />' in result
 
 
@@ -1479,13 +1489,12 @@
                     confoverrides={'extensions': 'sphinxcontrib.jsmath',
                                                   'sphinx.ext.imgmath'})
 def test_html_math_renderer_is_duplicated(make_app, app_params):
-    try:
-        args, kwargs = app_params
+    args, kwargs = app_params
+    with pytest.raises(
+        ConfigError,
+        match='Many math_renderers are registered. But no math_renderer is selected.',
+    ):
         make_app(*args, **kwargs)
-        assert False
-    except ConfigError as exc:
-        assert str(exc) == ('Many math_renderers are registered. '
-                            'But no math_renderer is selected.')
 
 
 @pytest.mark.sphinx('html', testroot='basic',
@@ -1509,12 +1518,9 @@
                                                   'sphinx.ext.mathjax',
                                    'html_math_renderer': 'imgmath'})
 def test_html_math_renderer_is_mismatched(make_app, app_params):
-    try:
-        args, kwargs = app_params
+    args, kwargs = app_params
+    with pytest.raises(ConfigError, match="Unknown math_renderer 'imgmath' is given."):
         make_app(*args, **kwargs)
-        assert False
-    except ConfigError as exc:
-        assert str(exc) == "Unknown math_renderer 'imgmath' is given."
 
 
 @pytest.mark.sphinx('html', testroot='basic')
@@ -1571,7 +1577,7 @@
 @pytest.mark.sphinx(testroot='html_scaled_image_link')
 def test_html_scaled_image_link(app):
     app.build()
-    context = (app.outdir / 'index.html').read_text()
+    context = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     # no scaled parameters
     assert re.search('\n<img alt="_images/img.png" src="_images/img.png" />', context)
@@ -1591,27 +1597,21 @@
                     confoverrides={'html_codeblock_linenos_style': 'table'})
 def test_html_codeblock_linenos_style_table(app):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
-    if PYGMENTS_VERSION >= (2, 8):
-        assert ('<div class="linenodiv"><pre><span class="normal">1</span>\n'
-                '<span class="normal">2</span>\n'
-                '<span class="normal">3</span>\n'
-                '<span class="normal">4</span></pre></div>') in content
-    else:
-        assert '<div class="linenodiv"><pre>1\n2\n3\n4</pre></div>' in content
+    assert ('<div class="linenodiv"><pre><span class="normal">1</span>\n'
+            '<span class="normal">2</span>\n'
+            '<span class="normal">3</span>\n'
+            '<span class="normal">4</span></pre></div>') in content
 
 
 @pytest.mark.sphinx('html', testroot='reST-code-block',
                     confoverrides={'html_codeblock_linenos_style': 'inline'})
 def test_html_codeblock_linenos_style_inline(app):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
-    if PYGMENTS_VERSION > (2, 7):
-        assert '<span class="linenos">1</span>' in content
-    else:
-        assert '<span class="lineno">1 </span>' in content
+    assert '<span class="linenos">1</span>' in content
 
 
 @pytest.mark.sphinx('html', testroot='highlight_options')
@@ -1651,7 +1651,7 @@
                     confoverrides={'html_permalinks': False})
 def test_html_permalink_disable(app):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     assert '<h1>The basic Sphinx documentation for testing</h1>' in content
 
@@ -1660,16 +1660,123 @@
                     confoverrides={'html_permalinks_icon': '<span>PERMALINK</span>'})
 def test_html_permalink_icon(app):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     assert ('<h1>The basic Sphinx documentation for testing<a class="headerlink" '
             'href="#the-basic-sphinx-documentation-for-testing" '
-            'title="Permalink to this headline"><span>PERMALINK</span></a></h1>' in content)
+            'title="Permalink to this heading"><span>PERMALINK</span></a></h1>' in content)
 
 
 @pytest.mark.sphinx('html', testroot='html_signaturereturn_icon')
 def test_html_signaturereturn_icon(app):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     assert ('<span class="sig-return-icon">&#x2192;</span>' in content)
+
+
+@pytest.mark.sphinx('html', testroot='reST-code-role')
+def test_html_code_role(app):
+    app.build()
+    content = (app.outdir / 'index.html').read_text()
+
+    common_content = (
+        '<span class="k">def</span> <span class="nf">foo</span>'
+        '<span class="p">(</span>'
+        '<span class="mi">1</span> '
+        '<span class="o">+</span> '
+        '<span class="mi">2</span> '
+        '<span class="o">+</span> '
+        '<span class="kc">None</span> '
+        '<span class="o">+</span> '
+        '<span class="s2">&quot;abc&quot;</span>'
+        '<span class="p">):</span> '
+        '<span class="k">pass</span>')
+    assert ('<p>Inline <code class="code highlight python docutils literal highlight-python">' +
+            common_content + '</code> code block</p>') in content
+    assert ('<div class="highlight-python notranslate">' +
+            '<div class="highlight"><pre><span></span>' +
+            common_content) in content
+
+
+@pytest.mark.sphinx('html', testroot='root',
+                    confoverrides={'option_emphasise_placeholders': True})
+def test_option_emphasise_placeholders(app, status, warning):
+    app.build()
+    content = (app.outdir / 'objects.html').read_text()
+    assert '<em><span class="pre">TYPE</span></em>' in content
+    assert '{TYPE}' not in content
+    assert ('<em><span class="pre">WHERE</span></em>'
+            '<span class="pre">-</span>'
+            '<em><span class="pre">COUNT</span></em>' in content)
+    assert '<span class="pre">{{value}}</span>' in content
+    assert ('<span class="pre">--plugin.option</span></span>'
+            '<a class="headerlink" href="#cmdoption-perl-plugin.option" title="Permalink to this definition">¶</a></dt>') in content
+
+
+@pytest.mark.sphinx('html', testroot='root')
+def test_option_emphasise_placeholders_default(app, status, warning):
+    app.build()
+    content = (app.outdir / 'objects.html').read_text()
+    assert '<span class="pre">={TYPE}</span>' in content
+    assert '<span class="pre">={WHERE}-{COUNT}</span></span>' in content
+    assert '<span class="pre">{client_name}</span>' in content
+    assert ('<span class="pre">--plugin.option</span></span>'
+            '<span class="sig-prename descclassname"></span>'
+            '<a class="headerlink" href="#cmdoption-perl-plugin.option" title="Permalink to this definition">¶</a></dt>') in content
+
+
+@pytest.mark.sphinx('html', testroot='root')
+def test_option_reference_with_value(app, status, warning):
+    app.build()
+    content = (app.outdir / 'objects.html').read_text()
+    assert ('<span class="pre">-mapi</span></span><span class="sig-prename descclassname">'
+            '</span><a class="headerlink" href="#cmdoption-git-commit-mapi"') in content
+    assert 'first option <a class="reference internal" href="#cmdoption-git-commit-mapi">' in content
+    assert ('<a class="reference internal" href="#cmdoption-git-commit-mapi">'
+            '<code class="xref std std-option docutils literal notranslate"><span class="pre">-mapi=xxx</span></code></a>') in content
+    assert '<span class="pre">-mapi</span> <span class="pre">with_space</span>' in content
+
+
+@pytest.mark.sphinx('html', testroot='theming')
+def test_theme_options(app, status, warning):
+    app.build()
+
+    result = (app.outdir / '_static' / 'documentation_options.js').read_text(encoding='utf8')
+    assert 'NAVIGATION_WITH_KEYS: false' in result
+    assert 'ENABLE_SEARCH_SHORTCUTS: true' in result
+
+
+@pytest.mark.sphinx('html', testroot='theming',
+                    confoverrides={'html_theme_options.navigation_with_keys': True,
+                                   'html_theme_options.enable_search_shortcuts': False})
+def test_theme_options_with_override(app, status, warning):
+    app.build()
+
+    result = (app.outdir / '_static' / 'documentation_options.js').read_text(encoding='utf8')
+    assert 'NAVIGATION_WITH_KEYS: true' in result
+    assert 'ENABLE_SEARCH_SHORTCUTS: false' in result
+
+
+@pytest.mark.sphinx('html', testroot='build-html-theme-having-multiple-stylesheets')
+def test_theme_having_multiple_stylesheets(app):
+    app.build()
+    content = (app.outdir / 'index.html').read_text(encoding='utf-8')
+
+    assert '<link rel="stylesheet" type="text/css" href="_static/mytheme.css" />' in content
+    assert '<link rel="stylesheet" type="text/css" href="_static/extra.css" />' in content
+
+
+@pytest.mark.sphinx('html', testroot='images')
+def test_copy_images(app, status, warning):
+    app.build()
+
+    images_dir = Path(app.outdir) / '_images'
+    images = {image.name for image in images_dir.rglob('*')}
+    assert images == {
+        'img.png',
+        'rimg.png',
+        'rimg1.png',
+        'svgimg.svg',
+        'testimäge.png',
+    }

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_latex.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_latex.py Changed

@@ -1,75 +1,79 @@
-"""
-    test_build_latex
-    ~~~~~~~~~~~~~~~~
-
-    Test the build process with LaTeX builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with LaTeX builder with the test root."""
 
 import os
 import re
 import subprocess
 from itertools import product
+from pathlib import Path
 from shutil import copyfile
-from subprocess import PIPE, CalledProcessError
+from subprocess import CalledProcessError
 
 import pytest
 
 from sphinx.builders.latex import default_latex_documents
 from sphinx.config import Config
 from sphinx.errors import SphinxError
+from sphinx.ext.intersphinx import load_mappings, normalize_intersphinx_mapping
+from sphinx.ext.intersphinx import setup as intersphinx_setup
 from sphinx.testing.util import strip_escseq
-from sphinx.util.osutil import cd, ensuredir
+from sphinx.util.osutil import ensuredir
 from sphinx.writers.latex import LaTeXTranslator
 
 from .test_build_html import ENV_WARNINGS
 
+try:
+    from contextlib import chdir
+except ImportError:
+    from sphinx.util.osutil import _chdir as chdir
+
 LATEX_ENGINES = 'pdflatex', 'lualatex', 'xelatex'
-DOCCLASSES = 'howto', 'manual'
+DOCCLASSES = 'manual', 'howto'
 STYLEFILES = 'article.cls', 'fancyhdr.sty', 'titlesec.sty', 'amsmath.sty',
               'framed.sty', 'color.sty', 'fancyvrb.sty',
-              'fncychap.sty', 'geometry.sty', 'kvoptions.sty', 'hyperref.sty'
+              'fncychap.sty', 'geometry.sty', 'kvoptions.sty', 'hyperref.sty',
+              'booktabs.sty'
 
 LATEX_WARNINGS = ENV_WARNINGS + """\
-%(root)s/index.rst:\\d+: WARNING: unknown option: &option
+%(root)s/index.rst:\\d+: WARNING: unknown option: '&option'
 %(root)s/index.rst:\\d+: WARNING: citation not found: missing
 %(root)s/index.rst:\\d+: WARNING: a suitable image for latex builder not found: foo.\\*
-%(root)s/index.rst:\\d+: WARNING: Could not lex literal_block as "c". Highlighting skipped.
+%(root)s/index.rst:\\d+: WARNING: Could not lex literal_block .* as "c". Highlighting skipped.
 """
 
 
 # only run latex if all needed packages are there
 def kpsetest(*filenames):
     try:
-        subprocess.run('kpsewhich' + list(filenames), stdout=PIPE, stderr=PIPE, check=True)
+        subprocess.run('kpsewhich' + list(filenames), capture_output=True, check=True)
         return True
     except (OSError, CalledProcessError):
         return False  # command not found or exit with non-zero
 
 
 # compile latex document with app.config.latex_engine
-def compile_latex_document(app, filename='python.tex'):
+def compile_latex_document(app, filename='python.tex', docclass='manual'):
     # now, try to run latex over it
     try:
-        with cd(app.outdir):
-            ensuredir(app.config.latex_engine)
+        with chdir(app.outdir):
+            # name latex output-directory according to both engine and docclass
+            # to avoid reuse of auxiliary files by one docclass from another
+            latex_outputdir = app.config.latex_engine + docclass
+            ensuredir(latex_outputdir)
             # keep a copy of latex file for this engine in case test fails
-            copyfile(filename, app.config.latex_engine + '/' + filename)
+            copyfile(filename, latex_outputdir + '/' + filename)
             args = app.config.latex_engine,
                     '--halt-on-error',
                     '--interaction=nonstopmode',
-                    '-output-directory=%s' % app.config.latex_engine,
+                    '-output-directory=%s' % latex_outputdir,
                     filename
-            subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True)
+            subprocess.run(args, capture_output=True, check=True)
     except OSError as exc:  # most likely the latex executable was not found
         raise pytest.skip.Exception from exc
     except CalledProcessError as exc:
-        print(exc.stdout)
-        print(exc.stderr)
-        assert False, '%s exited with return code %s' % (app.config.latex_engine,
-                                                         exc.returncode)
+        print(exc.stdout.decode('utf8'))
+        print(exc.stderr.decode('utf8'))
+        raise AssertionError(f'{app.config.latex_engine} exited with '
+                             f'return code {exc.returncode}')
 
 
 def skip_if_requested(testfunc):
@@ -96,8 +100,18 @@
 )
 @pytest.mark.sphinx('latex')
 def test_build_latex_doc(app, status, warning, engine, docclass):
+    app.config.intersphinx_mapping = {
+        'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
+    }
+    intersphinx_setup(app)
     app.config.latex_engine = engine
     app.config.latex_documents = app.config.latex_documents0:4 + (docclass,)
+    if engine == 'xelatex':
+        app.config.latex_table_style = 'booktabs'
+    elif engine == 'lualatex':
+        app.config.latex_table_style = 'colorrows'
+    normalize_intersphinx_mapping(app, app.config)
+    load_mappings(app)
     app.builder.init()
 
     LaTeXTranslator.ignore_missing_images = True
@@ -106,13 +120,13 @@
     # file from latex_additional_files
     assert (app.outdir / 'svgimg.svg').isfile()
 
-    compile_latex_document(app, 'sphinxtests.tex')
+    compile_latex_document(app, 'sphinxtests.tex', docclass)
 
 
 @pytest.mark.sphinx('latex')
 def test_writer(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'sphinxtests.tex').read_text()
+    result = (app.outdir / 'sphinxtests.tex').read_text(encoding='utf8')
 
     assert ('\\begin{sphinxfigure-in-table}\n\\centering\n\\capstart\n'
             '\\noindent\\sphinxincludegraphics{{img}.png}\n'
@@ -122,22 +136,36 @@
     assert ('\\begin{wrapfigure}{r}{0pt}\n\\centering\n'
             '\\noindent\\sphinxincludegraphics{{rimg}.png}\n'
             '\\caption{figure with align option}\\label{\\detokenize{markup:id9}}'
-            '\\end{wrapfigure}' in result)
+            '\\end{wrapfigure}\n\n'
+            '\\mbox{}\\par\\vskip-\\dimexpr\\baselineskip+\\parskip\\relax' in result)
 
     assert ('\\begin{wrapfigure}{r}{0.500\\linewidth}\n\\centering\n'
             '\\noindent\\sphinxincludegraphics{{rimg}.png}\n'
             '\\caption{figure with align \\& figwidth option}'
             '\\label{\\detokenize{markup:id10}}'
-            '\\end{wrapfigure}' in result)
+            '\\end{wrapfigure}\n\n'
+            '\\mbox{}\\par\\vskip-\\dimexpr\\baselineskip+\\parskip\\relax' in result)
 
     assert ('\\begin{wrapfigure}{r}{3cm}\n\\centering\n'
             '\\noindent\\sphinxincludegraphicswidth=3cm{{rimg}.png}\n'
             '\\caption{figure with align \\& width option}'
             '\\label{\\detokenize{markup:id11}}'
-            '\\end{wrapfigure}' in result)
+            '\\end{wrapfigure}\n\n'
+            '\\mbox{}\\par\\vskip-\\dimexpr\\baselineskip+\\parskip\\relax' in result)
 
     assert 'Footnotes' not in result
 
+    assert ('\\begin{sphinxseealso}{See also:}\n\n'
+            '\\sphinxAtStartPar\n'
+            'something, something else, something more\n'
+            '\\begin{description}\n'
+            '\\sphinxlineitem{\\sphinxhref{http://www.google.com}{Google}}\n'
+            '\\sphinxAtStartPar\n'
+            'For everything.\n'
+            '\n'
+            '\\end{description}\n'
+            '\n\n\\end{sphinxseealso}\n\n' in result)
+
 
 @pytest.mark.sphinx('latex', testroot='warnings', freshenv=True)
 def test_latex_warnings(app, status, warning):
@@ -147,7 +175,7 @@
     warnings_exp = LATEX_WARNINGS % {
         'root': re.escape(app.srcdir.replace(os.sep, '/'))}
     assert re.match(warnings_exp + '$', warnings), \
-        'Warnings don\'t match:\n' + \
+        "Warnings don't match:\n" + \
         '--- Expected (regex):\n' + warnings_exp + \
         '--- Got:\n' + warnings
 
@@ -155,7 +183,7 @@
 @pytest.mark.sphinx('latex', testroot='basic')
 def test_latex_basic(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -166,7 +194,7 @@
 
 @pytest.mark.sphinx('latex', testroot='basic',
                     confoverrides={
-                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'manual')
+                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'manual'),
                     })
 def test_latex_basic_manual(app, status, warning):
     app.builder.build_all()
@@ -178,7 +206,7 @@
 
 @pytest.mark.sphinx('latex', testroot='basic',
                     confoverrides={
-                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'howto')
+                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'howto'),
                     })
 def test_latex_basic_howto(app, status, warning):
     app.builder.build_all()
@@ -191,7 +219,7 @@
 @pytest.mark.sphinx('latex', testroot='basic',
                     confoverrides={
                         'language': 'ja',
-                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'manual')
+                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'manual'),
                     })
 def test_latex_basic_manual_ja(app, status, warning):
     app.builder.build_all()
@@ -204,7 +232,7 @@
 @pytest.mark.sphinx('latex', testroot='basic',
                     confoverrides={
                         'language': 'ja',
-                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'howto')
+                        'latex_documents': ('index', 'test.tex', 'title', 'author', 'howto'),
                     })
 def test_latex_basic_howto_ja(app, status, warning):
     app.builder.build_all()
@@ -248,7 +276,7 @@
 @pytest.mark.sphinx('latex', testroot='basic', confoverrides={'language': 'zh'})
 def test_latex_additional_settings_for_language_code(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -258,7 +286,7 @@
 @pytest.mark.sphinx('latex', testroot='basic', confoverrides={'language': 'el'})
 def test_latex_additional_settings_for_greek(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -269,7 +297,7 @@
 @pytest.mark.sphinx('latex', testroot='latex-title')
 def test_latex_title_after_admonitions(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -280,7 +308,7 @@
                     confoverrides={'release': '1.0_0'})
 def test_latex_release(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -292,7 +320,7 @@
                     confoverrides={'numfig': True})
 def test_numref(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -318,7 +346,7 @@
             '\\nameref{\\detokenize{foo:foo}}}') in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\addto\captionsenglish{\renewcommand{\figurename}{Fig.\@{} }}' in result
     assert r'\addto\captionsenglish{\renewcommand{\tablename}{Table }}' in result
@@ -334,7 +362,7 @@
                                      'section': 'SECTION-%s'}})
 def test_numref_with_prefix1(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -366,7 +394,7 @@
             '\\nameref{\\detokenize{foo:foo}}}') in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\addto\captionsenglish{\renewcommand{\figurename}{Figure:}}' in result
     assert r'\addto\captionsenglish{\renewcommand{\tablename}{Tab\_}}' in result
@@ -382,7 +410,7 @@
                                      'section': 'SECTION_%s_'}})
 def test_numref_with_prefix2(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -408,7 +436,7 @@
             '\\nameref{\\detokenize{foo:foo}}}') in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\addto\captionsenglish{\renewcommand{\figurename}{Figure:}}' in result
     assert r'\def\fnum@figure{\figurename\thefigure{}.}' in result
@@ -421,8 +449,8 @@
     'latex', testroot='numfig',
     confoverrides={'numfig': True, 'language': 'ja'})
 def test_numref_with_language_ja(app, status, warning):
-    app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    app.build()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -448,7 +476,7 @@
             '\\nameref{\\detokenize{foo:foo}}}') in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert '\\@iden{\\renewcommand{\\figurename}{図 }}' in result
     assert '\\@iden{\\renewcommand{\\tablename}{表 }}' in result
@@ -459,10 +487,10 @@
 def test_latex_obey_numfig_is_false(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'SphinxManual.tex').read_text()
+    result = (app.outdir / 'SphinxManual.tex').read_text(encoding='utf8')
     assert '\\usepackage{sphinx}' in result
 
-    result = (app.outdir / 'SphinxHowTo.tex').read_text()
+    result = (app.outdir / 'SphinxHowTo.tex').read_text(encoding='utf8')
     assert '\\usepackage{sphinx}' in result
 
 
@@ -472,10 +500,10 @@
 def test_latex_obey_numfig_secnum_depth_is_zero(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'SphinxManual.tex').read_text()
+    result = (app.outdir / 'SphinxManual.tex').read_text(encoding='utf8')
     assert '\\usepackage,nonumfigreset,mathnumfig{sphinx}' in result
 
-    result = (app.outdir / 'SphinxHowTo.tex').read_text()
+    result = (app.outdir / 'SphinxHowTo.tex').read_text(encoding='utf8')
     assert '\\usepackage,nonumfigreset,mathnumfig{sphinx}' in result
 
 
@@ -485,10 +513,10 @@
 def test_latex_obey_numfig_secnum_depth_is_two(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'SphinxManual.tex').read_text()
+    result = (app.outdir / 'SphinxManual.tex').read_text(encoding='utf8')
     assert '\\usepackage,numfigreset=2,mathnumfig{sphinx}' in result
 
-    result = (app.outdir / 'SphinxHowTo.tex').read_text()
+    result = (app.outdir / 'SphinxHowTo.tex').read_text(encoding='utf8')
     assert '\\usepackage,numfigreset=3,mathnumfig{sphinx}' in result
 
 
@@ -498,10 +526,10 @@
 def test_latex_obey_numfig_but_math_numfig_false(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'SphinxManual.tex').read_text()
+    result = (app.outdir / 'SphinxManual.tex').read_text(encoding='utf8')
     assert '\\usepackage,numfigreset=1{sphinx}' in result
 
-    result = (app.outdir / 'SphinxHowTo.tex').read_text()
+    result = (app.outdir / 'SphinxHowTo.tex').read_text(encoding='utf8')
     assert '\\usepackage,numfigreset=2{sphinx}' in result
 
 
@@ -510,7 +538,7 @@
     app.add_latex_package('foo')
     app.add_latex_package('bar', 'baz')
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     assert '\\usepackage{foo}' in result
     assert '\\usepackagebaz{bar}' in result
 
@@ -518,7 +546,7 @@
 @pytest.mark.sphinx('latex', testroot='latex-babel')
 def test_babel_with_no_language_settings(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -528,10 +556,10 @@
     assert '\\usepackageBjarne{fncychap}' in result
     assert ('\\addto\\captionsenglish{\\renewcommand{\\contentsname}{Table of content}}\n'
             in result)
-    assert '\\shorthandoff' not in result
+    assert '\\shorthandoff{"}' in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{page}' in result
     assert r'\addto\captionsenglish{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -543,7 +571,7 @@
     confoverrides={'language': 'de'})
 def test_babel_with_language_de(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -556,7 +584,7 @@
     assert '\\shorthandoff{"}' in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{Seite}' in result
     assert r'\addto\captionsngerman{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -568,7 +596,7 @@
     confoverrides={'language': 'ru'})
 def test_babel_with_language_ru(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -581,7 +609,7 @@
     assert '\\shorthandoff{"}' in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{страница}' in result
     assert r'\addto\captionsrussian{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -593,7 +621,7 @@
     confoverrides={'language': 'tr'})
 def test_babel_with_language_tr(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -606,7 +634,7 @@
     assert '\\shorthandoff{=}' in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{sayfa}' in result
     assert r'\addto\captionsturkish{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -618,7 +646,7 @@
     confoverrides={'language': 'ja'})
 def test_babel_with_language_ja(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -630,7 +658,7 @@
     assert '\\shorthandoff' not in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{ページ}' in result
     assert '\\@iden{\\renewcommand{\\figurename}{Fig.\\@{} }}' in result
@@ -642,7 +670,7 @@
     confoverrides={'language': 'unknown'})
 def test_babel_with_unknown_language(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -657,7 +685,7 @@
     assert "WARNING: no Babel option known for language 'unknown'" in warning.getvalue()
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{page}' in result
     assert r'\addto\captionsenglish{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -669,7 +697,7 @@
     confoverrides={'language': 'de', 'latex_engine': 'lualatex'})
 def test_polyglossia_with_language_de(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -683,7 +711,7 @@
     assert '\\shorthandoff' not in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{Seite}' in result
     assert r'\addto\captionsgerman{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -695,7 +723,7 @@
     confoverrides={'language': 'de-1901', 'latex_engine': 'lualatex'})
 def test_polyglossia_with_language_de_1901(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -709,7 +737,7 @@
     assert '\\shorthandoff' not in result
 
     # sphinxmessages.sty
-    result = (app.outdir / 'sphinxmessages.sty').read_text()
+    result = (app.outdir / 'sphinxmessages.sty').read_text(encoding='utf8')
     print(result)
     assert r'\def\pageautorefname{page}' in result
     assert r'\addto\captionsgerman{\renewcommand{\figurename}{Fig.\@{} }}' in result
@@ -719,40 +747,36 @@
 @pytest.mark.sphinx('latex')
 def test_footnote(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'sphinxtests.tex').read_text()
+    result = (app.outdir / 'sphinxtests.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
-    assert ('\\sphinxstepexplicit %\n\\begin{footnote}1\\phantomsection'
-            '\\label{\\thesphinxscope.1}%\n\\sphinxAtStartFootnote\nnumbered\n%\n'
-            '\\end{footnote}') in result
+    assert ('\\sphinxAtStartPar\n%\n\\begin{footnote}1\\sphinxAtStartFootnote\n'
+            'numbered\n%\n\\end{footnote}') in result
     assert ('\\begin{footnote}2\\sphinxAtStartFootnote\nauto numbered\n%\n'
             '\\end{footnote}') in result
     assert '\\begin{footnote}3\\sphinxAtStartFootnote\nnamed\n%\n\\end{footnote}' in result
     assert '\\sphinxcite{footnote:bar}' in result
     assert ('\\bibitembar{footnote:bar}\n\\sphinxAtStartPar\ncite\n') in result
     assert '\\sphinxcaption{Table caption \\sphinxfootnotemark4' in result
-    assert ('\\hline%\n\\begin{footnotetext}4'
-            '\\phantomsection\\label{\\thesphinxscope.4}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('\\sphinxmidrule\n\\sphinxtableatstartofbodyhook%\n'
+            '\\begin{footnotetext}4\\sphinxAtStartFootnote\n'
             'footnote in table caption\n%\n\\end{footnotetext}\\ignorespaces %\n'
-            '\\begin{footnotetext}5'
-            '\\phantomsection\\label{\\thesphinxscope.5}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '\\begin{footnotetext}5\\sphinxAtStartFootnote\n'
             'footnote in table header\n%\n\\end{footnotetext}\\ignorespaces '
             '\n\\sphinxAtStartPar\n'
             'VIDIOC\\_CROPCAP\n&\n\\sphinxAtStartPar\n') in result
     assert ('Information about VIDIOC\\_CROPCAP %\n'
             '\\begin{footnote}6\\sphinxAtStartFootnote\n'
-            'footnote in table not in header\n%\n\\end{footnote}\n\\\\\n\\hline\n'
-            '\\end{tabulary}\n'
-            '\\par\n\\sphinxattableend\\end{savenotes}\n') in result
+            'footnote in table not in header\n%\n\\end{footnote}\n\\\\\n'
+            '\\sphinxbottomrule\n\\end{tabulary}\n'
+            '\\sphinxtableafterendhook\\par\n\\sphinxattableend\\end{savenotes}\n') in result
 
 
 @pytest.mark.sphinx('latex', testroot='footnotes')
 def test_reference_in_caption_and_codeblock_in_footnote(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -762,90 +786,104 @@
     assert ('\\sphinxcaption{The table title with a reference'
             ' to {}AuthorYear{}}' in result)
     assert '\\subsubsection*{The rubric title with a reference to {}AuthorYear{}}' in result
-    assert ('\\chapter{The section with a reference to \\sphinxfootnotemark5}\n'
+    assert ('\\chapter{The section with a reference to \\sphinxfootnotemark6}\n'
             '\\label{\\detokenize{index:the-section-with-a-reference-to}}'
-            '%\n\\begin{footnotetext}5'
-            '\\phantomsection\\label{\\thesphinxscope.5}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '%\n\\begin{footnotetext}6\\sphinxAtStartFootnote\n'
             'Footnote in section\n%\n\\end{footnotetext}') in result
     assert ('\\caption{This is the figure caption with a footnote to '
-            '\\sphinxfootnotemark7.}\\label{\\detokenize{index:id29}}\\end{figure}\n'
-            '%\n\\begin{footnotetext}7'
-            '\\phantomsection\\label{\\thesphinxscope.7}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '\\sphinxfootnotemark8.}\\label{\\detokenize{index:id35}}\\end{figure}\n'
+            '%\n\\begin{footnotetext}8\\sphinxAtStartFootnote\n'
             'Footnote in caption\n%\n\\end{footnotetext}') in result
-    assert ('\\sphinxcaption{footnote \\sphinxfootnotemark8 in '
-            'caption of normal table}\\label{\\detokenize{index:id30}}') in result
-    assert ('\\caption{footnote \\sphinxfootnotemark9 '
-            'in caption \\sphinxfootnotemark10 of longtable\\strut}') in result
-    assert ('\\endlastfoot\n%\n\\begin{footnotetext}9'
-            '\\phantomsection\\label{\\thesphinxscope.9}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('\\sphinxcaption{footnote \\sphinxfootnotemark9 in '
+            'caption of normal table}\\label{\\detokenize{index:id36}}') in result
+    assert ('\\caption{footnote \\sphinxfootnotemark10 '
+            'in caption \\sphinxfootnotemark11 of longtable\\strut}') in result
+    assert ('\\endlastfoot\n\\sphinxtableatstartofbodyhook\n%\n'
+            '\\begin{footnotetext}10\\sphinxAtStartFootnote\n'
             'Foot note in longtable\n%\n\\end{footnotetext}\\ignorespaces %\n'
-            '\\begin{footnotetext}10'
-            '\\phantomsection\\label{\\thesphinxscope.10}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '\\begin{footnotetext}11\\sphinxAtStartFootnote\n'
             'Second footnote in caption of longtable\n') in result
     assert ('This is a reference to the code\\sphinxhyphen{}block in the footnote:\n'
             '{\\hyperref\\detokenize{index:codeblockinfootnote}'
             '{\\sphinxcrossref{\\DUrole{std,std-ref}{I am in a footnote}}}}') in result
     assert ('&\n\\sphinxAtStartPar\nThis is one more footnote with some code in it %\n'
-            '\\begin{footnote}11\\sphinxAtStartFootnote\n'
+            '\\begin{footnote}12\\sphinxAtStartFootnote\n'
             'Third footnote in longtable\n') in result
     assert ('\\end{sphinxVerbatim}\n%\n\\end{footnote}.\n') in result
     assert '\\begin{sphinxVerbatim}commandchars=\\\\\\{\\}' in result
 
 
+@pytest.mark.sphinx('latex', testroot='footnotes')
+def test_footnote_referred_multiple_times(app, status, warning):
+    app.builder.build_all()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
+    print(result)
+    print(status.getvalue())
+    print(warning.getvalue())
+
+    assert ('Explicitly numbered footnote: %\n'
+            '\\begin{footnote}100'
+            '\\sphinxAtStartFootnote\nNumbered footnote\n%\n'
+            '\\end{footnote} \\sphinxfootnotemark100\n'
+            in result)
+    assert ('Named footnote: %\n'
+            '\\begin{footnote}13'
+            '\\sphinxAtStartFootnote\nNamed footnote\n%\n'
+            '\\end{footnote} \\sphinxfootnotemark13\n'
+            in result)
+
+
 @pytest.mark.sphinx(
     'latex', testroot='footnotes',
     confoverrides={'latex_show_urls': 'inline'})
 def test_latex_show_urls_is_inline(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
-    assert ('Same footnote number \\sphinxstepexplicit %\n'
-            '\\begin{footnote}1\\phantomsection\\label{\\thesphinxscope.1}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('Same footnote number %\n'
+            '\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'footnote in bar\n%\n\\end{footnote} in bar.rst') in result
     assert ('Auto footnote number %\n\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'footnote in baz\n%\n\\end{footnote} in baz.rst') in result
-    assert ('\\phantomsection\\label{\\detokenize{index:id32}}'
+    assert ('\\phantomsection\\label{\\detokenize{index:id38}}'
             '{\\hyperref\\detokenize{index:the-section'
             '-with-a-reference-to-authoryear}'
             '{\\sphinxcrossref{The section with a reference to '
             '\\sphinxcite{index:authoryear}}}}') in result
-    assert ('\\phantomsection\\label{\\detokenize{index:id33}}'
+    assert ('\\phantomsection\\label{\\detokenize{index:id39}}'
             '{\\hyperref\\detokenize{index:the-section-with-a-reference-to}'
             '{\\sphinxcrossref{The section with a reference to }}}' in result)
     assert ('First footnote: %\n\\begin{footnote}2\\sphinxAtStartFootnote\n'
             'First\n%\n\\end{footnote}') in result
-    assert ('Second footnote: \\sphinxstepexplicit %\n'
-            '\\begin{footnote}1\\phantomsection\\label{\\thesphinxscope.1}%\n'
-            '\\sphinxAtStartFootnote\n'
-            'Second\n%\n\\end{footnote}') in result
+    assert ('Second footnote: %\n'
+            '\\begin{footnote}1\\sphinxAtStartFootnote\n'
+            'Second\n%\n\\end{footnote}\n') in result
     assert '\\sphinxhref{http://sphinx-doc.org/}{Sphinx} (http://sphinx\\sphinxhyphen{}doc.org/)' in result
     assert ('Third footnote: %\n\\begin{footnote}3\\sphinxAtStartFootnote\n'
             'Third \\sphinxfootnotemark4\n%\n\\end{footnote}%\n'
-            '\\begin{footnotetext}4'
-            '\\phantomsection\\label{\\thesphinxscope.4}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '\\begin{footnotetext}4\\sphinxAtStartFootnote\n'
             'Footnote inside footnote\n%\n\\end{footnotetext}\\ignorespaces') in result
+    assert ('Fourth footnote: %\n\\begin{footnote}5\\sphinxAtStartFootnote\n'
+            'Fourth\n%\n\\end{footnote}\n') in result
     assert ('\\sphinxhref{http://sphinx-doc.org/~test/}{URL including tilde} '
             '(http://sphinx\\sphinxhyphen{}doc.org/\\textasciitilde{}test/)') in result
-    assert ('\\item{\\sphinxhref{http://sphinx-doc.org/}{URL in term} '
-            '(http://sphinx\\sphinxhyphen{}doc.org/)} '
-            '\\leavevmode\n\\sphinxAtStartPar\nDescription' in result)
-    assert ('\\item{Footnote in term \\sphinxfootnotemark6} '
-            '\\leavevmode%\n\\begin{footnotetext}6'
-            '\\phantomsection\\label{\\thesphinxscope.6}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}{URL in term} '
+            '(http://sphinx\\sphinxhyphen{}doc.org/)}\n'
+            '\\sphinxAtStartPar\nDescription' in result)
+    assert ('\\sphinxlineitem{Footnote in term \\sphinxfootnotemark7}%\n'
+            '\\begin{footnotetext}7\\sphinxAtStartFootnote\n' in result)
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}{URL in term} '
+            '(http://sphinx\\sphinxhyphen{}doc.org/)}\n'
+            '\\sphinxAtStartPar\nDescription' in result)
+    assert ('\\sphinxlineitem{Footnote in term \\sphinxfootnotemark7}%\n'
+            '\\begin{footnotetext}7\\sphinxAtStartFootnote\n'
             'Footnote in term\n%\n\\end{footnotetext}\\ignorespaces '
             '\n\\sphinxAtStartPar\nDescription') in result
-    assert ('\\item{\\sphinxhref{http://sphinx-doc.org/}{Term in deflist} '
-            '(http://sphinx\\sphinxhyphen{}doc.org/)} '
-            '\\leavevmode\n\\sphinxAtStartPar\nDescription') in result
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}{Term in deflist} '
+            '(http://sphinx\\sphinxhyphen{}doc.org/)}'
+            '\n\\sphinxAtStartPar\nDescription') in result
     assert '\\sphinxurl{https://github.com/sphinx-doc/sphinx}\n' in result
     assert ('\\sphinxhref{mailto:sphinx-dev@googlegroups.com}'
             '{sphinx\\sphinxhyphen{}dev@googlegroups.com}') in result
@@ -857,59 +895,54 @@
     confoverrides={'latex_show_urls': 'footnote'})
 def test_latex_show_urls_is_footnote(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
-    assert ('Same footnote number \\sphinxstepexplicit %\n'
-            '\\begin{footnote}1\\phantomsection\\label{\\thesphinxscope.1}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('Same footnote number %\n'
+            '\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'footnote in bar\n%\n\\end{footnote} in bar.rst') in result
     assert ('Auto footnote number %\n\\begin{footnote}2\\sphinxAtStartFootnote\n'
             'footnote in baz\n%\n\\end{footnote} in baz.rst') in result
-    assert ('\\phantomsection\\label{\\detokenize{index:id32}}'
+    assert ('\\phantomsection\\label{\\detokenize{index:id38}}'
             '{\\hyperref\\detokenize{index:the-section-with-a-reference-to-authoryear}'
             '{\\sphinxcrossref{The section with a reference '
             'to \\sphinxcite{index:authoryear}}}}') in result
-    assert ('\\phantomsection\\label{\\detokenize{index:id33}}'
+    assert ('\\phantomsection\\label{\\detokenize{index:id39}}'
             '{\\hyperref\\detokenize{index:the-section-with-a-reference-to}'
             '{\\sphinxcrossref{The section with a reference to }}}') in result
     assert ('First footnote: %\n\\begin{footnote}3\\sphinxAtStartFootnote\n'
             'First\n%\n\\end{footnote}') in result
-    assert ('Second footnote: \\sphinxstepexplicit %\n'
-            '\\begin{footnote}1\\phantomsection\\label{\\thesphinxscope.1}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('Second footnote: %\n'
+            '\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'Second\n%\n\\end{footnote}') in result
     assert ('\\sphinxhref{http://sphinx-doc.org/}{Sphinx}'
             '%\n\\begin{footnote}4\\sphinxAtStartFootnote\n'
             '\\sphinxnolinkurl{http://sphinx-doc.org/}\n%\n\\end{footnote}') in result
     assert ('Third footnote: %\n\\begin{footnote}6\\sphinxAtStartFootnote\n'
             'Third \\sphinxfootnotemark7\n%\n\\end{footnote}%\n'
-            '\\begin{footnotetext}7'
-            '\\phantomsection\\label{\\thesphinxscope.7}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '\\begin{footnotetext}7\\sphinxAtStartFootnote\n'
             'Footnote inside footnote\n%\n'
             '\\end{footnotetext}\\ignorespaces') in result
+    assert ('Fourth footnote: %\n\\begin{footnote}8\\sphinxAtStartFootnote\n'
+            'Fourth\n%\n\\end{footnote}\n') in result
     assert ('\\sphinxhref{http://sphinx-doc.org/~test/}{URL including tilde}'
             '%\n\\begin{footnote}5\\sphinxAtStartFootnote\n'
             '\\sphinxnolinkurl{http://sphinx-doc.org/~test/}\n%\n\\end{footnote}') in result
-    assert ('\\item{\\sphinxhref{http://sphinx-doc.org/}'
-            '{URL in term}\\sphinxfootnotemark9} '
-            '\\leavevmode%\n\\begin{footnotetext}9'
-            '\\phantomsection\\label{\\thesphinxscope.9}%\n'
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}'
+            '{URL in term}\\sphinxfootnotemark10}%\n'
+            '\\begin{footnotetext}10'
             '\\sphinxAtStartFootnote\n'
             '\\sphinxnolinkurl{http://sphinx-doc.org/}\n%\n'
             '\\end{footnotetext}\\ignorespaces \n\\sphinxAtStartPar\nDescription') in result
-    assert ('\\item{Footnote in term \\sphinxfootnotemark11} '
-            '\\leavevmode%\n\\begin{footnotetext}11'
-            '\\phantomsection\\label{\\thesphinxscope.11}%\n'
+    assert ('\\sphinxlineitem{Footnote in term \\sphinxfootnotemark12}%\n'
+            '\\begin{footnotetext}12'
             '\\sphinxAtStartFootnote\n'
             'Footnote in term\n%\n\\end{footnotetext}\\ignorespaces '
             '\n\\sphinxAtStartPar\nDescription') in result
-    assert ('\\item{\\sphinxhref{http://sphinx-doc.org/}{Term in deflist}'
-            '\\sphinxfootnotemark10} '
-            '\\leavevmode%\n\\begin{footnotetext}10'
-            '\\phantomsection\\label{\\thesphinxscope.10}%\n'
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}{Term in deflist}'
+            '\\sphinxfootnotemark11}%\n'
+            '\\begin{footnotetext}11'
             '\\sphinxAtStartFootnote\n'
             '\\sphinxnolinkurl{http://sphinx-doc.org/}\n%\n'
             '\\end{footnotetext}\\ignorespaces \n\\sphinxAtStartPar\nDescription') in result
@@ -924,47 +957,43 @@
     confoverrides={'latex_show_urls': 'no'})
 def test_latex_show_urls_is_no(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
-    assert ('Same footnote number \\sphinxstepexplicit %\n'
-            '\\begin{footnote}1\\phantomsection\\label{\\thesphinxscope.1}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('Same footnote number %\n'
+            '\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'footnote in bar\n%\n\\end{footnote} in bar.rst') in result
     assert ('Auto footnote number %\n\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'footnote in baz\n%\n\\end{footnote} in baz.rst') in result
-    assert ('\\phantomsection\\label{\\detokenize{index:id32}}'
+    assert ('\\phantomsection\\label{\\detokenize{index:id38}}'
             '{\\hyperref\\detokenize{index:the-section-with-a-reference-to-authoryear}'
             '{\\sphinxcrossref{The section with a reference '
             'to \\sphinxcite{index:authoryear}}}}') in result
-    assert ('\\phantomsection\\label{\\detokenize{index:id33}}'
+    assert ('\\phantomsection\\label{\\detokenize{index:id39}}'
             '{\\hyperref\\detokenize{index:the-section-with-a-reference-to}'
             '{\\sphinxcrossref{The section with a reference to }}}' in result)
     assert ('First footnote: %\n\\begin{footnote}2\\sphinxAtStartFootnote\n'
             'First\n%\n\\end{footnote}') in result
-    assert ('Second footnote: \\sphinxstepexplicit %\n'
-            '\\begin{footnote}1\\phantomsection\\label{\\thesphinxscope.1}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('Second footnote: %\n'
+            '\\begin{footnote}1\\sphinxAtStartFootnote\n'
             'Second\n%\n\\end{footnote}') in result
     assert '\\sphinxhref{http://sphinx-doc.org/}{Sphinx}' in result
     assert ('Third footnote: %\n\\begin{footnote}3\\sphinxAtStartFootnote\n'
             'Third \\sphinxfootnotemark4\n%\n\\end{footnote}%\n'
-            '\\begin{footnotetext}4'
-            '\\phantomsection\\label{\\thesphinxscope.4}%\n'
-            '\\sphinxAtStartFootnote\n'
+            '\\begin{footnotetext}4\\sphinxAtStartFootnote\n'
             'Footnote inside footnote\n%\n\\end{footnotetext}\\ignorespaces') in result
+    assert ('Fourth footnote: %\n\\begin{footnote}5\\sphinxAtStartFootnote\n'
+            'Fourth\n%\n\\end{footnote}\n') in result
     assert '\\sphinxhref{http://sphinx-doc.org/~test/}{URL including tilde}' in result
-    assert ('\\item{\\sphinxhref{http://sphinx-doc.org/}{URL in term}} '
-            '\\leavevmode\n\\sphinxAtStartPar\nDescription') in result
-    assert ('\\item{Footnote in term \\sphinxfootnotemark6} '
-            '\\leavevmode%\n\\begin{footnotetext}6'
-            '\\phantomsection\\label{\\thesphinxscope.6}%\n'
-            '\\sphinxAtStartFootnote\n'
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}{URL in term}}\n'
+            '\\sphinxAtStartPar\nDescription') in result
+    assert ('\\sphinxlineitem{Footnote in term \\sphinxfootnotemark7}%\n'
+            '\\begin{footnotetext}7\\sphinxAtStartFootnote\n'
             'Footnote in term\n%\n\\end{footnotetext}\\ignorespaces '
             '\n\\sphinxAtStartPar\nDescription') in result
-    assert ('\\item{\\sphinxhref{http://sphinx-doc.org/}{Term in deflist}} '
-            '\\leavevmode\n\\sphinxAtStartPar\nDescription') in result
+    assert ('\\sphinxlineitem{\\sphinxhref{http://sphinx-doc.org/}{Term in deflist}}'
+            '\n\\sphinxAtStartPar\nDescription') in result
     assert ('\\sphinxurl{https://github.com/sphinx-doc/sphinx}\n' in result)
     assert ('\\sphinxhref{mailto:sphinx-dev@googlegroups.com}'
             '{sphinx\\sphinxhyphen{}dev@googlegroups.com}\n') in result
@@ -983,7 +1012,7 @@
 @pytest.mark.sphinx('latex', testroot='image-in-section')
 def test_image_in_section(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -999,17 +1028,14 @@
 @pytest.mark.sphinx('latex', testroot='basic',
                     confoverrides={'latex_logo': 'notfound.jpg'})
 def test_latex_logo_if_not_found(app, status, warning):
-    try:
+    with pytest.raises(SphinxError):
         app.builder.build_all()
-        assert False  # SphinxError not raised
-    except Exception as exc:
-        assert isinstance(exc, SphinxError)
 
 
 @pytest.mark.sphinx('latex', testroot='toctree-maxdepth')
 def test_toctree_maxdepth_manual(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1026,7 +1052,7 @@
     })
 def test_toctree_maxdepth_howto(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1040,7 +1066,7 @@
     confoverrides={'root_doc': 'foo'})
 def test_toctree_not_found(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1054,7 +1080,7 @@
     confoverrides={'root_doc': 'bar'})
 def test_toctree_without_maxdepth(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1067,7 +1093,7 @@
     confoverrides={'root_doc': 'qux'})
 def test_toctree_with_deeper_maxdepth(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1080,7 +1106,7 @@
     confoverrides={'latex_toplevel_sectioning': None})
 def test_latex_toplevel_sectioning_is_None(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1092,7 +1118,7 @@
     confoverrides={'latex_toplevel_sectioning': 'part'})
 def test_latex_toplevel_sectioning_is_part(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1106,11 +1132,11 @@
     confoverrides={'latex_toplevel_sectioning': 'part',
                    'latex_documents': 
                        ('index', 'python.tex', 'Sphinx Tests Documentation',
-                        'Georg Brandl', 'howto')
+                        'Georg Brandl', 'howto'),
                    })
 def test_latex_toplevel_sectioning_is_part_with_howto(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1124,7 +1150,7 @@
     confoverrides={'latex_toplevel_sectioning': 'chapter'})
 def test_latex_toplevel_sectioning_is_chapter(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1136,11 +1162,11 @@
     confoverrides={'latex_toplevel_sectioning': 'chapter',
                    'latex_documents': 
                        ('index', 'python.tex', 'Sphinx Tests Documentation',
-                        'Georg Brandl', 'howto')
+                        'Georg Brandl', 'howto'),
                    })
 def test_latex_toplevel_sectioning_is_chapter_with_howto(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1152,7 +1178,7 @@
     confoverrides={'latex_toplevel_sectioning': 'section'})
 def test_latex_toplevel_sectioning_is_section(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
@@ -1163,25 +1189,27 @@
 @pytest.mark.sphinx('latex', testroot='maxlistdepth')
 def test_maxlistdepth_at_ten(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     print(status.getvalue())
     print(warning.getvalue())
     compile_latex_document(app, 'python.tex')
 
 
-@pytest.mark.sphinx('latex', testroot='latex-table')
+@pytest.mark.sphinx('latex', testroot='latex-table',
+                    confoverrides={'latex_table_style': })
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_tabulars(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     tables = {}
     for chap in re.split(r'\\(?:section|chapter){', result)1::
         sectname, content = chap.split('}', 1)
+        content = re.sub(r'\\sphinxstepscope', '', content)  # filter a separator
         tablessectname = content.strip()
 
     def get_expected(name):
-        return (app.srcdir / 'expects' / (name + '.tex')).read_text().strip()
+        return (app.srcdir / 'expects' / (name + '.tex')).read_text(encoding='utf8').strip()
 
     # simple_table
     actual = tables'simple table'
@@ -1239,18 +1267,20 @@
     assert actual == expected
 
 
-@pytest.mark.sphinx('latex', testroot='latex-table')
+@pytest.mark.sphinx('latex', testroot='latex-table',
+                    confoverrides={'latex_table_style': })
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_longtable(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     tables = {}
     for chap in re.split(r'\\(?:section|chapter){', result)1::
         sectname, content = chap.split('}', 1)
+        content = re.sub(r'\\sphinxstepscope', '', content)  # filter a separator
         tablessectname = content.strip()
 
     def get_expected(name):
-        return (app.srcdir / 'expects' / (name + '.tex')).read_text().strip()
+        return (app.srcdir / 'expects' / (name + '.tex')).read_text(encoding='utf8').strip()
 
     # longtable
     actual = tables'longtable'
@@ -1298,35 +1328,58 @@
     assert actual == expected
 
 
-@pytest.mark.sphinx('latex', testroot='latex-table')
+@pytest.mark.sphinx('latex', testroot='latex-table',
+                    confoverrides={'latex_table_style': })
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_complex_tables(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     tables = {}
     for chap in re.split(r'\\(?:section|renewcommand){', result)1::
         sectname, content = chap.split('}', 1)
         tablessectname = content.strip()
 
     def get_expected(name):
-        return (app.srcdir / 'expects' / (name + '.tex')).read_text().strip()
+        return (app.srcdir / 'expects' / (name + '.tex')).read_text(encoding='utf8').strip()
 
     # grid table
     actual = tables'grid table'
     expected = get_expected('gridtable')
     assert actual == expected
 
+    # grid table with tabularcolumns
+    # MEMO: filename should end with tabularcolumns but tabularcolumn has been
+    #       used in existing other cases
+    actual = tables'grid table with tabularcolumns having no vline'
+    expected = get_expected('gridtable_with_tabularcolumn')
+    assert actual == expected
+
     # complex spanning cell
     actual = tables'complex spanning cell'
     expected = get_expected('complex_spanning_cell')
     assert actual == expected
 
 
+@pytest.mark.sphinx('latex', testroot='latex-table')
+def test_latex_table_with_booktabs_and_colorrows(app, status, warning):
+    app.builder.build_all()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
+    assert r'\PassOptionsToPackage{booktabs}{sphinx}' in result
+    assert r'\PassOptionsToPackage{colorrows}{sphinx}' in result
+    # tabularcolumns
+    assert r'\begin{longtable}{|c|c|}' in result
+    # class: standard
+    assert r'\begin{tabulary}{\linewidth}t{|T|T|T|T|T|}' in result
+    assert r'\begin{longtable}{ll}' in result
+    assert r'\begin{tabular}t{*{2}{\X{1}{2}}}' in result
+    assert r'\begin{tabular}t{\X{30}{100}\X{70}{100}}' in result
+
+
 @pytest.mark.sphinx('latex', testroot='latex-table',
                     confoverrides={'templates_path': '_mytemplates/latex'})
 def test_latex_table_custom_template_caseA(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert 'SALUT LES COPAINS' in result
 
 
@@ -1334,7 +1387,7 @@
                     confoverrides={'templates_path': '_mytemplates'})
 def test_latex_table_custom_template_caseB(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert 'SALUT LES COPAINS' not in result
 
 
@@ -1342,14 +1395,14 @@
 @pytest.mark.test_params(shared_result='latex-table')
 def test_latex_table_custom_template_caseC(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert 'SALUT LES COPAINS' not in result
 
 
 @pytest.mark.sphinx('latex', testroot='directives-raw')
 def test_latex_raw_directive(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
 
     # standard case
     assert 'standalone raw directive (HTML)' not in result
@@ -1365,7 +1418,7 @@
 def test_latex_images(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
 
     # images are copied
     assert '\\sphinxincludegraphics{{python-logo}.png}' in result
@@ -1389,7 +1442,7 @@
 def test_latex_index(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert ('A \\index{famous@\\spxentry{famous}}famous '
             '\\index{equation@\\spxentry{equation}}equation:\n' in result)
     assert ('\n\\index{Einstein@\\spxentry{Einstein}}'
@@ -1403,8 +1456,8 @@
 def test_latex_equations(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
-    expected = (app.srcdir / 'expects' / 'latex-equations.tex').read_text().strip()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
+    expected = (app.srcdir / 'expects' / 'latex-equations.tex').read_text(encoding='utf8').strip()
 
     assert expected in result
 
@@ -1413,7 +1466,7 @@
 def test_latex_image_in_parsed_literal(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert ('{\\sphinxunactivateextrasandspace \\raisebox{-0.5\\height}'
             '{\\sphinxincludegraphicsheight=2.00000cm{{pic}.png}}'
             '}AFTER') in result
@@ -1423,7 +1476,7 @@
 def test_latex_nested_enumerated_list(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert ('\\sphinxsetlistlabels{\\arabic}{enumi}{enumii}{}{.}%\n'
             '\\setcounter{enumi}{4}\n' in result)
     assert ('\\sphinxsetlistlabels{\\alph}{enumii}{enumiii}{}{.}%\n'
@@ -1440,7 +1493,7 @@
 def test_latex_thebibliography(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     assert ('\\begin{sphinxthebibliography}{AuthorYe}\n'
             '\\bibitemAuthorYear{index:authoryear}\n\\sphinxAtStartPar\n'
@@ -1453,31 +1506,31 @@
 def test_latex_glossary(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
-    assert ('\\item{änhlich\\index{änhlich@\\spxentry{änhlich}|spxpagem}'
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
+    assert (r'\sphinxlineitem{ähnlich\index{ähnlich@\spxentry{ähnlich}|spxpagem}'
             r'\phantomsection'
-            r'\label{\detokenize{index:term-anhlich}}} \leavevmode' in result)
-    assert (r'\item{boson\index{boson@\spxentry{boson}|spxpagem}\phantomsection'
-            r'\label{\detokenize{index:term-boson}}} \leavevmode' in result)
-    assert (r'\item{\sphinxstyleemphasis{fermion}'
+            r'\label{\detokenize{index:term-ahnlich}}}' in result)
+    assert (r'\sphinxlineitem{boson\index{boson@\spxentry{boson}|spxpagem}\phantomsection'
+            r'\label{\detokenize{index:term-boson}}}' in result)
+    assert (r'\sphinxlineitem{\sphinxstyleemphasis{fermion}'
             r'\index{fermion@\spxentry{fermion}|spxpagem}'
             r'\phantomsection'
-            r'\label{\detokenize{index:term-fermion}}} \leavevmode' in result)
-    assert (r'\item{tauon\index{tauon@\spxentry{tauon}|spxpagem}\phantomsection'
-            r'\label{\detokenize{index:term-tauon}}} \leavevmode'
-            r'\item{myon\index{myon@\spxentry{myon}|spxpagem}\phantomsection'
-            r'\label{\detokenize{index:term-myon}}} \leavevmode'
-            r'\item{electron\index{electron@\spxentry{electron}|spxpagem}\phantomsection'
-            r'\label{\detokenize{index:term-electron}}} \leavevmode' in result)
-    assert ('\\item{über\\index{über@\\spxentry{über}|spxpagem}\\phantomsection'
-            r'\label{\detokenize{index:term-uber}}} \leavevmode' in result)
+            r'\label{\detokenize{index:term-fermion}}}' in result)
+    assert (r'\sphinxlineitem{tauon\index{tauon@\spxentry{tauon}|spxpagem}\phantomsection'
+            r'\label{\detokenize{index:term-tauon}}}'
+            r'\sphinxlineitem{myon\index{myon@\spxentry{myon}|spxpagem}\phantomsection'
+            r'\label{\detokenize{index:term-myon}}}'
+            r'\sphinxlineitem{electron\index{electron@\spxentry{electron}|spxpagem}\phantomsection'
+            r'\label{\detokenize{index:term-electron}}}' in result)
+    assert (r'\sphinxlineitem{über\index{über@\spxentry{über}|spxpagem}\phantomsection'
+            r'\label{\detokenize{index:term-uber}}}' in result)
 
 
 @pytest.mark.sphinx('latex', testroot='latex-labels')
 def test_latex_labels(app, status, warning):
     app.builder.build_all()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
 
     # figures
     assert (r'\caption{labeled figure}'
@@ -1525,8 +1578,8 @@
 @pytest.mark.sphinx('latex', testroot='latex-figure-in-admonition')
 def test_latex_figure_in_admonition(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
-    assert(r'\begin{figure}H' in result)
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
+    assert r'\begin{figure}H' in result
 
 
 def test_default_latex_documents():
@@ -1556,7 +1609,7 @@
 @pytest.mark.sphinx('latex', testroot='index_on_title')
 def test_index_on_title(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert ('\\chapter{Test for index in top level title}\n'
             '\\label{\\detokenize{contents:test-for-index-in-top-level-title}}'
             '\\index{index@\\spxentry{index}}\n'
@@ -1567,7 +1620,7 @@
                     confoverrides={'latex_engine': 'pdflatex'})
 def test_texescape_for_non_unicode_supported_engine(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     assert 'script small e: e' in result
     assert 'double struck italic small i: i' in result
@@ -1579,7 +1632,7 @@
                     confoverrides={'latex_engine': 'xelatex'})
 def test_texescape_for_unicode_supported_engine(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(result)
     assert 'script small e: e' in result
     assert 'double struck italic small i: i' in result
@@ -1591,19 +1644,93 @@
                     confoverrides={'latex_elements': {'extrapackages': r'\usepackage{foo}'}})
 def test_latex_elements_extrapackages(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'test.tex').read_text()
+    result = (app.outdir / 'test.tex').read_text(encoding='utf8')
     assert r'\usepackage{foo}' in result
 
 
 @pytest.mark.sphinx('latex', testroot='nested-tables')
 def test_latex_nested_tables(app, status, warning):
     app.builder.build_all()
-    assert '' == warning.getvalue()
+    assert warning.getvalue() == ''
 
 
 @pytest.mark.sphinx('latex', testroot='latex-container')
 def test_latex_container(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert r'\begin{sphinxuseclass}{classname}' in result
     assert r'\end{sphinxuseclass}' in result
+
+
+@pytest.mark.sphinx('latex', testroot='reST-code-role')
+def test_latex_code_role(app):
+    app.build()
+    content = (app.outdir / 'python.tex').read_text()
+
+    common_content = (
+        r'\PYG{k}{def} '
+        r'\PYG{n+nf}{foo}'
+        r'\PYG{p}{(}'
+        r'\PYG{l+m+mi}{1} '
+        r'\PYG{o}{+} '
+        r'\PYG{l+m+mi}{2} '
+        r'\PYG{o}{+} '
+        r'\PYG{k+kc}{None} '
+        r'\PYG{o}{+} '
+        r'\PYG{l+s+s2}{\PYGZdq{}}'
+        r'\PYG{l+s+s2}{abc}'
+        r'\PYG{l+s+s2}{\PYGZdq{}}'
+        r'\PYG{p}{)}'
+        r'\PYG{p}{:} '
+        r'\PYG{k}{pass}')
+    assert (r'Inline \sphinxcode{\sphinxupquote{%' + '\n' +
+            common_content + '%\n}} code block') in content
+    assert (r'\begin{sphinxVerbatim}commandchars=\\\{\}' +
+            '\n' + common_content + '\n' + r'\end{sphinxVerbatim}') in content
+
+
+@pytest.mark.sphinx('latex', testroot='images')
+def test_copy_images(app, status, warning):
+    app.build()
+
+    test_dir = Path(app.outdir)
+    images = {
+        image.name for image in test_dir.rglob('*')
+        if image.suffix in {'.gif', '.pdf', '.png', '.svg'}
+    }
+    images.discard('python-logo.png')
+    assert images == {
+        'img.pdf',
+        'rimg.png',
+        'testimäge.png',
+    }
+
+
+@pytest.mark.sphinx('latex', testroot='latex-labels-before-module')
+def test_duplicated_labels_before_module(app, status, warning):
+    app.build()
+    content: str = (app.outdir / 'python.tex').read_text()
+
+    def count_label(name):
+        text = r'\phantomsection\label{\detokenize{%s}}' % name
+        return content.count(text)
+
+    pattern = r'\\phantomsection\\label\{\\detokenize\{index:label-(?:auto-)?\d+a-z*}}'
+    # labels found in the TeX output
+    output_labels = frozenset(match.group() for match in re.finditer(pattern, content))
+    # labels that have been tested and occurring exactly once in the output
+    tested_labels = set()
+
+    # iterate over the (explicit) labels in the corresponding index.rst
+    for rst_label_name in 
+        'label_1a', 'label_1b', 'label_2', 'label_3',
+        'label_auto_1a', 'label_auto_1b', 'label_auto_2', 'label_auto_3',
+    :
+        tex_label_name = 'index:' + rst_label_name.replace('_', '-')
+        tex_label_code = r'\phantomsection\label{\detokenize{%s}}' % tex_label_name
+        assert content.count(tex_label_code) == 1, f'duplicated label: {tex_label_name!r}'
+        tested_labels.add(tex_label_code)
+
+    # ensure that we did not forget any label to check
+    # and if so, report them nicely in case of failure
+    assert sorted(tested_labels) == sorted(output_labels)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_linkcheck.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_linkcheck.py Changed

@@ -1,13 +1,8 @@
-"""
-    test_build_linkcheck
-    ~~~~~~~~~~~~~~~~~~~~
+"""Test the build process with manpage builder with the test root."""
 
-    Test the build process with manpage builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
+import base64
 import http.server
 import json
 import re
@@ -15,12 +10,11 @@
 import time
 import wsgiref.handlers
 from datetime import datetime
+from os import path
 from queue import Queue
-from typing import Dict
 from unittest import mock
 
 import pytest
-import requests
 
 from sphinx.builders.linkcheck import HyperlinkAvailabilityCheckWorker, RateLimit
 from sphinx.testing.util import strip_escseq
@@ -29,96 +23,156 @@
 from .utils import CERT_FILE, http_server, https_server
 
 ts_re = re.compile(r".*\(?P<ts>.*)\.*")
+SPHINX_DOCS_INDEX = path.abspath(path.join(__file__, "..", "roots", "test-linkcheck", "sphinx-docs-index.html"))
+
+
+class DefaultsHandler(http.server.BaseHTTPRequestHandler):
+    def do_HEAD(self):
+        if self.path1:.rstrip() == "":
+            self.send_response(200, "OK")
+            self.end_headers()
+        elif self.path1:.rstrip() == "anchor.html":
+            self.send_response(200, "OK")
+            self.end_headers()
+        else:
+            self.send_response(404, "Not Found")
+            self.end_headers()
+
+    def do_GET(self):
+        self.do_HEAD()
+        if self.path1:.rstrip() == "":
+            self.wfile.write(b"ok\n\n")
+        elif self.path1:.rstrip() == "anchor.html":
+            doc = '<!DOCTYPE html><html><body><a id="found"></a></body></html>'
+            self.wfile.write(doc.encode('utf-8'))
 
 
 @pytest.mark.sphinx('linkcheck', testroot='linkcheck', freshenv=True)
 def test_defaults(app):
-    app.build()
+    with http_server(DefaultsHandler):
+        app.build()
 
+    # Text output
     assert (app.outdir / 'output.txt').exists()
-    content = (app.outdir / 'output.txt').read_text()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
 
-    print(content)
     # looking for '#top' and '#does-not-exist' not found should fail
     assert "Anchor 'top' not found" in content
     assert "Anchor 'does-not-exist' not found" in content
-    # looking for non-existent URL should fail
-    assert " Max retries exceeded with url: /doesnotexist" in content
     # images should fail
-    assert "Not Found for url: https://www.google.com/image.png" in content
-    assert "Not Found for url: https://www.google.com/image2.png" in content
+    assert "Not Found for url: http://localhost:7777/image.png" in content
+    assert "Not Found for url: http://localhost:7777/image2.png" in content
     # looking for local file should fail
     assert "broken path/to/notfound" in content
-    assert len(content.splitlines()) == 6
-
-
-@pytest.mark.sphinx('linkcheck', testroot='linkcheck', freshenv=True)
-def test_defaults_json(app):
-    app.build()
+    assert len(content.splitlines()) == 5
 
+    # JSON output
     assert (app.outdir / 'output.json').exists()
-    content = (app.outdir / 'output.json').read_text()
-    print(content)
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
 
     rows = json.loads(x) for x in content.splitlines()
     row = rows0
-    for attr in "filename", "lineno", "status", "code", "uri",
-                 "info":
+    for attr in ("filename", "lineno", "status", "code", "uri", "info"):
         assert attr in row
 
-    assert len(content.splitlines()) == 11
-    assert len(rows) == 11
+    assert len(content.splitlines()) == 10
+    assert len(rows) == 10
     # the output order of the rows is not stable
     # due to possible variance in network latency
     rowsby = {row"uri": row for row in rows}
-    assert rowsby"https://www.google.com#!bar" == {
-        'filename': 'links.txt',
-        'lineno': 10,
+    assert rowsby"http://localhost:7777#!bar" == {
+        'filename': 'links.rst',
+        'lineno': 5,
         'status': 'working',
         'code': 0,
-        'uri': 'https://www.google.com#!bar',
-        'info': ''
+        'uri': 'http://localhost:7777#!bar',
+        'info': '',
     }
-    # looking for non-existent URL should fail
-    dnerow = rowsby'https://localhost:7777/doesnotexist'
-    assert dnerow'filename' == 'links.txt'
-    assert dnerow'lineno' == 13
-    assert dnerow'status' == 'broken'
-    assert dnerow'code' == 0
-    assert dnerow'uri' == 'https://localhost:7777/doesnotexist'
-    assert rowsby'https://www.google.com/image2.png' == {
-        'filename': 'links.txt',
-        'lineno': 19,
+    assert rowsby'http://localhost:7777/image2.png' == {
+        'filename': 'links.rst',
+        'lineno': 13,
         'status': 'broken',
         'code': 0,
-        'uri': 'https://www.google.com/image2.png',
-        'info': '404 Client Error: Not Found for url: https://www.google.com/image2.png'
+        'uri': 'http://localhost:7777/image2.png',
+        'info': '404 Client Error: Not Found for url: http://localhost:7777/image2.png',
     }
     # looking for '#top' and '#does-not-exist' not found should fail
-    assert "Anchor 'top' not found" == \
-        rowsby"https://www.google.com/#top""info"
-    assert "Anchor 'does-not-exist' not found" == \
-        rowsby"http://www.sphinx-doc.org/en/master/index.html#does-not-exist""info"
+    assert rowsby"http://localhost:7777/#top""info" == "Anchor 'top' not found"
+    assert rowsby"http://localhost:7777#does-not-exist""info" == "Anchor 'does-not-exist' not found"
     # images should fail
-    assert "Not Found for url: https://www.google.com/image.png" in \
-        rowsby"https://www.google.com/image.png""info"
+    assert "Not Found for url: http://localhost:7777/image.png" in rowsby"http://localhost:7777/image.png""info"
+    # anchor should be found
+    assert rowsby'http://localhost:7777/anchor.html#found' == {
+        'filename': 'links.rst',
+        'lineno': 14,
+        'status': 'working',
+        'code': 0,
+        'uri': 'http://localhost:7777/anchor.html#found',
+        'info': '',
+    }
+
+
+@pytest.mark.sphinx('linkcheck', testroot='linkcheck-too-many-retries', freshenv=True)
+def test_too_many_retries(app):
+    with http_server(DefaultsHandler):
+        app.build()
+
+    # Text output
+    assert (app.outdir / 'output.txt').exists()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
+
+    # looking for non-existent URL should fail
+    assert " Max retries exceeded with url: /doesnotexist" in content
+
+    # JSON output
+    assert (app.outdir / 'output.json').exists()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
+
+    assert len(content.splitlines()) == 1
+    row = json.loads(content)
+    # the output order of the rows is not stable
+    # due to possible variance in network latency
+
+    # looking for non-existent URL should fail
+    assert row'filename' == 'index.rst'
+    assert row'lineno' == 1
+    assert row'status' == 'broken'
+    assert row'code' == 0
+    assert row'uri' == 'https://localhost:7777/doesnotexist'
+
+
+@pytest.mark.sphinx('linkcheck', testroot='linkcheck-raw-node', freshenv=True)
+def test_raw_node(app):
+    with http_server(OKHandler):
+        app.build()
+
+    # JSON output
+    assert (app.outdir / 'output.json').exists()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
+
+    assert len(content.splitlines()) == 1
+    row = json.loads(content)
+
+    # raw nodes' url should be checked too
+    assert row == {
+        'filename': 'index.rst',
+        'lineno': 1,
+        'status': 'working',
+        'code': 0,
+        'uri': 'http://localhost:7777/',
+        'info': '',
+    }
 
 
 @pytest.mark.sphinx(
-    'linkcheck', testroot='linkcheck', freshenv=True,
-    confoverrides={'linkcheck_anchors_ignore': "^!", "^top$",
-                   'linkcheck_ignore': 
-                       'https://localhost:7777/doesnotexist',
-                       'http://www.sphinx-doc.org/en/master/index.html#',
-                       'https://www.google.com/image.png',
-                       'https://www.google.com/image2.png',
-                       'path/to/notfound'
-                   })
+    'linkcheck', testroot='linkcheck-anchors-ignore', freshenv=True,
+    confoverrides={'linkcheck_anchors_ignore': "^!", "^top$"})
 def test_anchors_ignored(app):
-    app.build()
+    with http_server(OKHandler):
+        app.build()
 
     assert (app.outdir / 'output.txt').exists()
-    content = (app.outdir / 'output.txt').read_text()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
 
     # expect all ok when excluding #top
     assert not content
@@ -132,7 +186,7 @@
 
     with http_server(InternalServerErrorHandler):
         app.build()
-    content = (app.outdir / 'output.txt').read_text()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
     assert content == (
         "index.rst:1: broken http://localhost:7777/#anchor: "
         "500 Server Error: Internal Server Error "
@@ -140,14 +194,16 @@
     )
 
 
-class HeadersDumperHandler(http.server.BaseHTTPRequestHandler):
-    def do_HEAD(self):
-        self.do_GET()
+def capture_headers_handler(records):
+    class HeadersDumperHandler(http.server.BaseHTTPRequestHandler):
+        def do_HEAD(self):
+            self.do_GET()
 
-    def do_GET(self):
-        self.send_response(200, "OK")
-        self.end_headers()
-        print(self.headers.as_string())
+        def do_GET(self):
+            self.send_response(200, "OK")
+            self.end_headers()
+            records.append(self.headers.as_string())
+    return HeadersDumperHandler
 
 
 @pytest.mark.sphinx(
@@ -157,21 +213,25 @@
         (r'^http://localhost:7777/$', ('user1', 'password')),
         (r'.*local.*', ('user2', 'hunter2')),
     })
-def test_auth_header_uses_first_match(app, capsys):
-    with http_server(HeadersDumperHandler):
+def test_auth_header_uses_first_match(app):
+    records = 
+    with http_server(capture_headers_handler(records)):
         app.build()
-    stdout, stderr = capsys.readouterr()
-    auth = requests.auth._basic_auth_str('user1', 'password')
-    assert "Authorization: %s\n" % auth in stdout
+
+    stdout = "\n".join(records)
+    encoded_auth = base64.b64encode(b'user1:password').decode('ascii')
+    assert f"Authorization: Basic {encoded_auth}\n" in stdout
 
 
 @pytest.mark.sphinx(
     'linkcheck', testroot='linkcheck-localserver', freshenv=True,
     confoverrides={'linkcheck_auth': (r'^$', ('user1', 'password'))})
-def test_auth_header_no_match(app, capsys):
-    with http_server(HeadersDumperHandler):
+def test_auth_header_no_match(app):
+    records = 
+    with http_server(capture_headers_handler(records)):
         app.build()
-    stdout, stderr = capsys.readouterr()
+
+    stdout = "\n".join(records)
     assert "Authorization" not in stdout
 
 
@@ -183,13 +243,14 @@
         },
         "*": {
             "X-Secret": "open sesami",
-        }
+        },
     }})
-def test_linkcheck_request_headers(app, capsys):
-    with http_server(HeadersDumperHandler):
+def test_linkcheck_request_headers(app):
+    records = 
+    with http_server(capture_headers_handler(records)):
         app.build()
 
-    stdout, _stderr = capsys.readouterr()
+    stdout = "\n".join(records)
     assert "Accept: text/html\n" in stdout
     assert "X-Secret" not in stdout
     assert "sesami" not in stdout
@@ -199,13 +260,14 @@
     'linkcheck', testroot='linkcheck-localserver', freshenv=True,
     confoverrides={'linkcheck_request_headers': {
         "http://localhost:7777": {"Accept": "application/json"},
-        "*": {"X-Secret": "open sesami"}
+        "*": {"X-Secret": "open sesami"},
     }})
-def test_linkcheck_request_headers_no_slash(app, capsys):
-    with http_server(HeadersDumperHandler):
+def test_linkcheck_request_headers_no_slash(app):
+    records = 
+    with http_server(capture_headers_handler(records)):
         app.build()
 
-    stdout, _stderr = capsys.readouterr()
+    stdout = "\n".join(records)
     assert "Accept: application/json\n" in stdout
     assert "X-Secret" not in stdout
     assert "sesami" not in stdout
@@ -215,13 +277,14 @@
     'linkcheck', testroot='linkcheck-localserver', freshenv=True,
     confoverrides={'linkcheck_request_headers': {
         "http://do.not.match.org": {"Accept": "application/json"},
-        "*": {"X-Secret": "open sesami"}
+        "*": {"X-Secret": "open sesami"},
     }})
-def test_linkcheck_request_headers_default(app, capsys):
-    with http_server(HeadersDumperHandler):
+def test_linkcheck_request_headers_default(app):
+    records = 
+    with http_server(capture_headers_handler(records)):
         app.build()
 
-    stdout, _stderr = capsys.readouterr()
+    stdout = "\n".join(records)
     assert "Accepts: application/json\n" not in stdout
     assert "X-Secret: open sesami\n" in stdout
 
@@ -255,7 +318,7 @@
     with http_server(make_redirect_handler(support_head=True)):
         app.build()
     stdout, stderr = capsys.readouterr()
-    content = (app.outdir / 'output.txt').read_text()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
     assert content == (
         "index.rst:1: redirected with Found "
         "http://localhost:7777/ to http://localhost:7777/?redirected=1\n"
@@ -264,7 +327,7 @@
         """\
         127.0.0.1 - -  "HEAD / HTTP/1.1" 302 -
         127.0.0.1 - -  "HEAD /?redirected=1 HTTP/1.1" 204 -
-        """
+        """,
     )
     assert warning.getvalue() == ''
 
@@ -274,7 +337,7 @@
     with http_server(make_redirect_handler(support_head=False)):
         app.build()
     stdout, stderr = capsys.readouterr()
-    content = (app.outdir / 'output.txt').read_text()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
     assert content == (
         "index.rst:1: redirected with Found "
         "http://localhost:7777/ to http://localhost:7777/?redirected=1\n"
@@ -284,28 +347,35 @@
         127.0.0.1 - -  "HEAD / HTTP/1.1" 405 -
         127.0.0.1 - -  "GET / HTTP/1.1" 302 -
         127.0.0.1 - -  "GET /?redirected=1 HTTP/1.1" 204 -
-        """
+        """,
     )
     assert warning.getvalue() == ''
 
 
 @pytest.mark.sphinx('linkcheck', testroot='linkcheck-localserver-warn-redirects',
                     freshenv=True, confoverrides={
-                        'linkcheck_allowed_redirects': {'http://localhost:7777/.*1': '.*'}
+                        'linkcheck_allowed_redirects': {'http://localhost:7777/.*1': '.*'},
                     })
 def test_linkcheck_allowed_redirects(app, warning):
     with http_server(make_redirect_handler(support_head=False)):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
-        records = json.loads(l) for l in fp.readlines()
-
-    assert len(records) == 2
-    result = {r"uri": r"status" for r in records}
-    assert result"http://localhost:7777/path1" == "working"
-    assert result"http://localhost:7777/path2" == "redirected"
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
+        rows = json.loads(l) for l in fp.readlines()
+
+    assert len(rows) == 2
+    records = {row"uri": row for row in rows}
+    assert records"http://localhost:7777/path1""status" == "working"
+    assert records"http://localhost:7777/path2" == {
+        'filename': 'index.rst',
+        'lineno': 3,
+        'status': 'redirected',
+        'code': 302,
+        'uri': 'http://localhost:7777/path2',
+        'info': 'http://localhost:7777/?redirected=1',
+    }
 
-    assert ("index.rst:1: WARNING: redirect  http://localhost:7777/path2 - with Found to "
+    assert ("index.rst:3: WARNING: redirect  http://localhost:7777/path2 - with Found to "
             "http://localhost:7777/?redirected=1\n" in strip_escseq(warning.getvalue()))
     assert len(warning.getvalue().splitlines()) == 1
 
@@ -326,7 +396,7 @@
     with http_server(OKHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content"status" == "broken"
     assert content"filename" == "index.rst"
@@ -340,7 +410,7 @@
     with https_server(OKHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content"status" == "broken"
     assert content"filename" == "index.rst"
@@ -355,7 +425,7 @@
     with https_server(OKHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content == {
         "code": 0,
@@ -373,7 +443,7 @@
     with https_server(OKHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content == {
         "code": 0,
@@ -391,7 +461,7 @@
     with https_server(OKHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content == {
         "code": 0,
@@ -409,7 +479,7 @@
     with https_server(OKHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content == {
         "code": 0,
@@ -421,23 +491,28 @@
     }
 
 
+class InfiniteRedirectOnHeadHandler(http.server.BaseHTTPRequestHandler):
+    def do_HEAD(self):
+        self.send_response(302, "Found")
+        self.send_header("Location", "http://localhost:7777/")
+        self.end_headers()
+
+    def do_GET(self):
+        self.send_response(200, "OK")
+        self.end_headers()
+        self.wfile.write(b"ok\n")
+
+
 @pytest.mark.sphinx('linkcheck', testroot='linkcheck-localserver', freshenv=True)
-def test_TooManyRedirects_on_HEAD(app):
-    class InfiniteRedirectOnHeadHandler(http.server.BaseHTTPRequestHandler):
-        def do_HEAD(self):
-            self.send_response(302, "Found")
-            self.send_header("Location", "http://localhost:7777/")
-            self.end_headers()
+def test_TooManyRedirects_on_HEAD(app, monkeypatch):
+    import requests.sessions
 
-        def do_GET(self):
-            self.send_response(200, "OK")
-            self.end_headers()
-            self.wfile.write(b"ok\n")
+    monkeypatch.setattr(requests.sessions, "DEFAULT_REDIRECT_LIMIT", 5)
 
     with http_server(InfiniteRedirectOnHeadHandler):
         app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.load(fp)
     assert content == {
         "code": 0,
@@ -471,7 +546,7 @@
          mock.patch("sphinx.builders.linkcheck.DEFAULT_DELAY", 0), \
          mock.patch("sphinx.builders.linkcheck.QUEUE_POLL_SECS", 0.01):
         app.build()
-    content = (app.outdir / 'output.json').read_text()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
     assert json.loads(content) == {
         "filename": "index.rst",
         "lineno": 1,
@@ -487,7 +562,7 @@
         """\
         127.0.0.1 - -  "HEAD / HTTP/1.1" 429 -
         127.0.0.1 - -  "HEAD / HTTP/1.1" 200 -
-        """
+        """,
     )
 
 
@@ -497,7 +572,7 @@
     retry_after = wsgiref.handlers.format_date_time(time.mktime(now))
     with http_server(make_retry_after_handler((429, retry_after), (200, None))):
         app.build()
-    content = (app.outdir / 'output.json').read_text()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
     assert json.loads(content) == {
         "filename": "index.rst",
         "lineno": 1,
@@ -511,7 +586,7 @@
         """\
         127.0.0.1 - -  "HEAD / HTTP/1.1" 429 -
         127.0.0.1 - -  "HEAD / HTTP/1.1" 200 -
-        """
+        """,
     )
 
 
@@ -520,7 +595,7 @@
     with http_server(make_retry_after_handler((429, None), (200, None))),\
          mock.patch("sphinx.builders.linkcheck.DEFAULT_DELAY", 0):
         app.build()
-    content = (app.outdir / 'output.json').read_text()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
     assert json.loads(content) == {
         "filename": "index.rst",
         "lineno": 1,
@@ -534,16 +609,16 @@
         """\
         127.0.0.1 - -  "HEAD / HTTP/1.1" 429 -
         127.0.0.1 - -  "HEAD / HTTP/1.1" 200 -
-        """
+        """,
     )
 
 
 @pytest.mark.sphinx('linkcheck', testroot='linkcheck-localserver', freshenv=True)
-def test_too_many_requests_user_timeout(app, capsys):
+def test_too_many_requests_user_timeout(app):
     app.config.linkcheck_rate_limit_timeout = 0.0
     with http_server(make_retry_after_handler((429, None))):
         app.build()
-    content = (app.outdir / 'output.json').read_text()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
     assert json.loads(content) == {
         "filename": "index.rst",
         "lineno": 1,
@@ -555,7 +630,7 @@
 
 
 class FakeResponse:
-    headers = {}  # type: Dictstr, str
+    headers: dictstr, str = {}
     url = "http://localhost/"
 
 
@@ -614,9 +689,9 @@
 def test_get_after_head_raises_connection_error(app):
     with http_server(ConnectionResetHandler):
         app.build()
-    content = (app.outdir / 'output.txt').read_text()
+    content = (app.outdir / 'output.txt').read_text(encoding='utf8')
     assert not content
-    content = (app.outdir / 'output.json').read_text()
+    content = (app.outdir / 'output.json').read_text(encoding='utf8')
     assert json.loads(content) == {
         "filename": "index.rst",
         "lineno": 1,
@@ -629,9 +704,10 @@
 
 @pytest.mark.sphinx('linkcheck', testroot='linkcheck-documents_exclude', freshenv=True)
 def test_linkcheck_exclude_documents(app):
-    app.build()
+    with http_server(DefaultsHandler):
+        app.build()
 
-    with open(app.outdir / 'output.json') as fp:
+    with open(app.outdir / 'output.json', encoding='utf-8') as fp:
         content = json.loads(record) for record in fp
 
     assert content ==

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_manpage.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_manpage.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_build_manpage
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the build process with manpage builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with manpage builder with the test root."""
 
 import pytest
 
@@ -19,7 +11,7 @@
     app.builder.build_all()
     assert (app.outdir / 'sphinxtests.1').exists()
 
-    content = (app.outdir / 'sphinxtests.1').read_text()
+    content = (app.outdir / 'sphinxtests.1').read_text(encoding='utf8')
     assert r'\fBprint \fP\fIi\fP\fB\en\fP' in content
     assert r'\fBmanpage\en\fP' in content
 
@@ -43,7 +35,7 @@
 def test_man_pages_empty_description(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'title.1').read_text()
+    content = (app.outdir / 'title.1').read_text(encoding='utf8')
     assert r'title \-' not in content
 
 
@@ -57,7 +49,7 @@
 @pytest.mark.sphinx('man', testroot='directive-code')
 def test_captioned_code_block(app, status, warning):
     app.builder.build_all()
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / 'python.1').read_text(encoding='utf8')
 
     assert ('.sp\n'
             'caption \\fItest\\fP rb\n'
@@ -88,5 +80,5 @@
 @pytest.mark.sphinx('man', testroot='markup-rubric')
 def test_rubric(app, status, warning):
     app.build()
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / 'python.1').read_text(encoding='utf8')
     assert 'This is a rubric\n' in content

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_texinfo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_texinfo.py Changed

@@ -1,17 +1,10 @@
-"""
-    test_build_texinfo
-    ~~~~~~~~~~~~~~~~~~
-
-    Test the build process with Texinfo builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with Texinfo builder with the test root."""
 
 import os
 import re
 import subprocess
-from subprocess import PIPE, CalledProcessError
+from pathlib import Path
+from subprocess import CalledProcessError
 from unittest.mock import Mock
 
 import pytest
@@ -25,7 +18,7 @@
 from .test_build_html import ENV_WARNINGS
 
 TEXINFO_WARNINGS = ENV_WARNINGS + """\
-%(root)s/index.rst:\\d+: WARNING: unknown option: &option
+%(root)s/index.rst:\\d+: WARNING: unknown option: '&option'
 %(root)s/index.rst:\\d+: WARNING: citation not found: missing
 %(root)s/index.rst:\\d+: WARNING: a suitable image for texinfo builder not found: foo.\\*
 %(root)s/index.rst:\\d+: WARNING: a suitable image for texinfo builder not found: \
@@ -40,7 +33,7 @@
     warnings_exp = TEXINFO_WARNINGS % {
         'root': re.escape(app.srcdir.replace(os.sep, '/'))}
     assert re.match(warnings_exp + '$', warnings), \
-        'Warnings don\'t match:\n' + \
+        "Warnings don't match:\n" + \
         '--- Expected (regex):\n' + warnings_exp + \
         '--- Got:\n' + warnings
 
@@ -49,7 +42,7 @@
 def test_texinfo(app, status, warning):
     TexinfoTranslator.ignore_missing_images = True
     app.builder.build_all()
-    result = (app.outdir / 'sphinxtests.texi').read_text()
+    result = (app.outdir / 'sphinxtests.texi').read_text(encoding='utf8')
     assert ('@anchor{markup doc}@anchor{11}'
             '@anchor{markup id1}@anchor{12}'
             '@anchor{markup testing-various-markup}@anchor{13}' in result)
@@ -57,20 +50,20 @@
     # now, try to run makeinfo over it
     try:
         args = 'makeinfo', '--no-split', 'sphinxtests.texi'
-        subprocess.run(args, stdout=PIPE, stderr=PIPE, cwd=app.outdir, check=True)
+        subprocess.run(args, capture_output=True, cwd=app.outdir, check=True)
     except OSError as exc:
         raise pytest.skip.Exception from exc  # most likely makeinfo was not found
     except CalledProcessError as exc:
         print(exc.stdout)
         print(exc.stderr)
-        assert False, 'makeinfo exited with return code %s' % exc.retcode
+        raise AssertionError('makeinfo exited with return code %s' % exc.retcode)
 
 
 @pytest.mark.sphinx('texinfo', testroot='markup-rubric')
 def test_texinfo_rubric(app, status, warning):
     app.build()
 
-    output = (app.outdir / 'python.texi').read_text()
+    output = (app.outdir / 'python.texi').read_text(encoding='utf8')
     assert '@heading This is a rubric' in output
     assert '@heading This is a multiline rubric' in output
 
@@ -79,7 +72,7 @@
 def test_texinfo_citation(app, status, warning):
     app.builder.build_all()
 
-    output = (app.outdir / 'python.texi').read_text()
+    output = (app.outdir / 'python.texi').read_text(encoding='utf8')
     assert 'This is a citation ref; @ref{1,,CITE1} and @ref{2,,CITE2}.' in output
     assert ('@anchor{index cite1}@anchor{1}@w{(CITE1)} \n'
             'This is a citation\n') in output
@@ -118,20 +111,20 @@
 def test_texinfo_footnote(app, status, warning):
     app.builder.build_all()
 
-    output = (app.outdir / 'python.texi').read_text()
+    output = (app.outdir / 'python.texi').read_text(encoding='utf8')
     assert 'First footnote: @footnote{\nFirst\n}' in output
 
 
 @pytest.mark.sphinx('texinfo')
 def test_texinfo_xrefs(app, status, warning):
     app.builder.build_all()
-    output = (app.outdir / 'sphinxtests.texi').read_text()
+    output = (app.outdir / 'sphinxtests.texi').read_text(encoding='utf8')
     assert re.search(r'@ref{\w+,,--plugin\.option}', output)
 
     # Now rebuild it without xrefs
     app.config.texinfo_cross_references = False
     app.builder.build_all()
-    output = (app.outdir / 'sphinxtests.texi').read_text()
+    output = (app.outdir / 'sphinxtests.texi').read_text(encoding='utf8')
     assert not re.search(r'@ref{\w+,,--plugin\.option}', output)
     assert 'Link to perl +p, --ObjC++, --plugin.option, create-auth-token, arg and -j' in output
 
@@ -140,8 +133,22 @@
 def test_texinfo_samp_with_variable(app, status, warning):
     app.build()
 
-    output = (app.outdir / 'sphinxtests.texi').read_text()
+    output = (app.outdir / 'sphinxtests.texi').read_text(encoding='utf8')
 
     assert '@code{@var{variable_only}}' in output
     assert '@code{@var{variable} and text}' in output
     assert '@code{Show @var{variable} in the middle}' in output
+
+
+@pytest.mark.sphinx('texinfo', testroot='images')
+def test_copy_images(app, status, warning):
+    app.build()
+
+    images_dir = Path(app.outdir) / 'python-figures'
+    images = {image.name for image in images_dir.rglob('*')}
+    images.discard('python-logo.png')
+    assert images == {
+        'img.png',
+        'rimg.png',
+        'testimäge.png',
+    }

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_build_text.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_build_text.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_build_text
-    ~~~~~~~~~~~~~~~
-
-    Test the build process with Text builder with the test root.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the build process with Text builder with the test root."""
 
 import pytest
 from docutils.utils import column_width
@@ -26,7 +18,7 @@
 @with_text_app()
 def test_maxwitdh_with_prefix(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'maxwidth.txt').read_text()
+    result = (app.outdir / 'maxwidth.txt').read_text(encoding='utf8')
 
     lines = result.splitlines()
     line_widths = column_width(line) for line in lines
@@ -49,7 +41,7 @@
 def test_lineblock(app, status, warning):
     # regression test for #1109: need empty line after line block
     app.builder.build_update()
-    result = (app.outdir / 'lineblock.txt').read_text()
+    result = (app.outdir / 'lineblock.txt').read_text(encoding='utf8')
     expect = (
         "* one\n"
         "\n"
@@ -64,7 +56,7 @@
 @with_text_app()
 def test_nonascii_title_line(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'nonascii_title.txt').read_text()
+    result = (app.outdir / 'nonascii_title.txt').read_text(encoding='utf8')
     expect_underline = '*********'
     result_underline = result.splitlines()1.strip()
     assert expect_underline == result_underline
@@ -73,7 +65,7 @@
 @with_text_app()
 def test_nonascii_table(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'nonascii_table.txt').read_text()
+    result = (app.outdir / 'nonascii_table.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     line_widths = column_width(line) for line in lines
     assert len(set(line_widths)) == 1  # same widths
@@ -82,7 +74,7 @@
 @with_text_app()
 def test_nonascii_maxwidth(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'nonascii_maxwidth.txt').read_text()
+    result = (app.outdir / 'nonascii_maxwidth.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     line_widths = column_width(line) for line in lines
     assert max(line_widths) < MAXWIDTH
@@ -126,7 +118,7 @@
 @with_text_app()
 def test_table_with_empty_cell(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'table.txt').read_text()
+    result = (app.outdir / 'table.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     assert lines0 == "+-------+-------+"
     assert lines1 == "| XXX   | XXX   |"
@@ -140,7 +132,7 @@
 @with_text_app()
 def test_table_with_rowspan(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'table_rowspan.txt').read_text()
+    result = (app.outdir / 'table_rowspan.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     assert lines0 == "+-------+-------+"
     assert lines1 == "| XXXXXXXXX     |"
@@ -154,7 +146,7 @@
 @with_text_app()
 def test_table_with_colspan(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'table_colspan.txt').read_text()
+    result = (app.outdir / 'table_colspan.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     assert lines0 == "+-------+-------+"
     assert lines1 == "| XXX   | XXX   |"
@@ -168,7 +160,7 @@
 @with_text_app()
 def test_table_with_colspan_left(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'table_colspan_left.txt').read_text()
+    result = (app.outdir / 'table_colspan_left.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     assert lines0 == "+-------+-------+"
     assert lines1 == "| XXX   | XXX   |"
@@ -182,7 +174,7 @@
 @with_text_app()
 def test_table_with_colspan_and_rowspan(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'table_colspan_and_rowspan.txt').read_text()
+    result = (app.outdir / 'table_colspan_and_rowspan.txt').read_text(encoding='utf8')
     lines = line.strip() for line in result.splitlines() if line.strip()
     assert result
     assert lines0 == "+-------+-------+-------+"
@@ -197,7 +189,7 @@
 @with_text_app()
 def test_list_items_in_admonition(app, status, warning):
     app.builder.build_update()
-    result = (app.outdir / 'listitems.txt').read_text()
+    result = (app.outdir / 'listitems.txt').read_text(encoding='utf8')
     lines = line.rstrip() for line in result.splitlines()
     assert lines0 == "See also:"
     assert lines1 == ""
@@ -209,7 +201,7 @@
 @with_text_app()
 def test_secnums(app, status, warning):
     app.builder.build_all()
-    index = (app.outdir / 'index.txt').read_text()
+    index = (app.outdir / 'index.txt').read_text(encoding='utf8')
     lines = index.splitlines()
     assert lines0 == "* 1. Section A"
     assert lines1 == ""
@@ -218,7 +210,7 @@
     assert lines4 == "  * 2.1. Sub Ba"
     assert lines5 == ""
     assert lines6 == "  * 2.2. Sub Bb"
-    doc2 = (app.outdir / 'doc2.txt').read_text()
+    doc2 = (app.outdir / 'doc2.txt').read_text(encoding='utf8')
     expect = (
         "2. Section B\n"
         "************\n"
@@ -235,7 +227,7 @@
 
     app.config.text_secnumber_suffix = " "
     app.builder.build_all()
-    index = (app.outdir / 'index.txt').read_text()
+    index = (app.outdir / 'index.txt').read_text(encoding='utf8')
     lines = index.splitlines()
     assert lines0 == "* 1 Section A"
     assert lines1 == ""
@@ -244,7 +236,7 @@
     assert lines4 == "  * 2.1 Sub Ba"
     assert lines5 == ""
     assert lines6 == "  * 2.2 Sub Bb"
-    doc2 = (app.outdir / 'doc2.txt').read_text()
+    doc2 = (app.outdir / 'doc2.txt').read_text(encoding='utf8')
     expect = (
         "2 Section B\n"
         "***********\n"
@@ -261,7 +253,7 @@
 
     app.config.text_add_secnumbers = False
     app.builder.build_all()
-    index = (app.outdir / 'index.txt').read_text()
+    index = (app.outdir / 'index.txt').read_text(encoding='utf8')
     lines = index.splitlines()
     assert lines0 == "* Section A"
     assert lines1 == ""
@@ -270,7 +262,7 @@
     assert lines4 == "  * Sub Ba"
     assert lines5 == ""
     assert lines6 == "  * Sub Bb"
-    doc2 = (app.outdir / 'doc2.txt').read_text()
+    doc2 = (app.outdir / 'doc2.txt').read_text(encoding='utf8')
     expect = (
         "Section B\n"
         "*********\n"

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_builder.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_builder.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_catalogs.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_catalogs.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_build_base
-    ~~~~~~~~~~~~~~~
-
-    Test the base build process.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the base build process."""
 import shutil
 
 import pytest
@@ -14,8 +6,8 @@
 from sphinx.testing.util import find_files
 
 
-@pytest.fixture
-def setup_test(app_params):
+@pytest.fixture()
+def _setup_test(app_params):
     srcdir = app_params.kwargs'srcdir'
     src_locale_dir = srcdir / 'xx' / 'LC_MESSAGES'
     dest_locale_dir = srcdir / 'locale'
@@ -33,7 +25,7 @@
     (srcdir / '_build').rmtree(True)
 
 
-@pytest.mark.usefixtures('setup_test')
+@pytest.mark.usefixtures('_setup_test')
 @pytest.mark.test_params(shared_result='test-catalogs')
 @pytest.mark.sphinx(
     'html', testroot='intl',
@@ -52,7 +44,7 @@
     assert actual == expect
 
 
-@pytest.mark.usefixtures('setup_test')
+@pytest.mark.usefixtures('_setup_test')
 @pytest.mark.test_params(shared_result='test-catalogs')
 @pytest.mark.sphinx(
     'html', testroot='intl',
@@ -70,7 +62,7 @@
     assert actual == {'admonitions.mo'}
 
 
-@pytest.mark.usefixtures('setup_test')
+@pytest.mark.usefixtures('_setup_test')
 @pytest.mark.test_params(shared_result='test-catalogs')
 @pytest.mark.sphinx(
     'html', testroot='intl',

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_config.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_config.py Changed

@@ -1,13 +1,4 @@
-"""
-    test_config
-    ~~~~~~~~~~~
-
-    Test the sphinx.config.Config class and its handling in the
-    Application class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.config.Config class."""
 
 from unittest import mock
 
@@ -57,13 +48,13 @@
 
     # invalid values
     with pytest.raises(AttributeError):
-        getattr(cfg, '_value')
+        _ = cfg._value
     with pytest.raises(AttributeError):
-        getattr(cfg, 'nonexisting_value')
+        _ = cfg.nonexisting_value
 
     # non-value attributes are deleted from the namespace
     with pytest.raises(AttributeError):
-        getattr(cfg, 'sys')
+        _ = cfg.sys
 
     # setting attributes
     cfg.project = 'Foo'
@@ -147,7 +138,7 @@
     assert 'conf.py' in str(excinfo.value)
 
     # test the automatic conversion of 2.x only code in configs
-    (tempdir / 'conf.py').write_text('project = u"Jägermeister"\n')
+    (tempdir / 'conf.py').write_text('project = u"Jägermeister"\n', encoding='utf8')
     cfg = Config.read(tempdir, {}, None)
     cfg.init_values()
     assert cfg.project == 'Jägermeister'
@@ -156,15 +147,15 @@
 
 def test_errors_if_setup_is_not_callable(tempdir, make_app):
     # test the error to call setup() in the config file
-    (tempdir / 'conf.py').write_text('setup = 1')
+    (tempdir / 'conf.py').write_text('setup = 1', encoding='utf8')
     with pytest.raises(ConfigError) as excinfo:
         make_app(srcdir=tempdir)
     assert 'callable' in str(excinfo.value)
 
 
-@pytest.fixture
+@pytest.fixture()
 def make_app_with_empty_project(make_app, tempdir):
-    (tempdir / 'conf.py').write_text('')
+    (tempdir / 'conf.py').write_text('', encoding='utf8')
 
     def _make_app(*args, **kw):
         kw.setdefault('srcdir', path(tempdir))
@@ -172,20 +163,20 @@
     return _make_app
 
 
-@mock.patch.object(sphinx, '__display_version__', '1.3.4')
+@mock.patch.object(sphinx, '__display_version__', '1.6.4')
 def test_needs_sphinx(make_app_with_empty_project):
     make_app = make_app_with_empty_project
     # micro version
-    make_app(confoverrides={'needs_sphinx': '1.3.3'})  # OK: less
-    make_app(confoverrides={'needs_sphinx': '1.3.4'})  # OK: equals
+    make_app(confoverrides={'needs_sphinx': '1.6.3'})  # OK: less
+    make_app(confoverrides={'needs_sphinx': '1.6.4'})  # OK: equals
     with pytest.raises(VersionRequirementError):
-        make_app(confoverrides={'needs_sphinx': '1.3.5'})  # NG: greater
+        make_app(confoverrides={'needs_sphinx': '1.6.5'})  # NG: greater
 
     # minor version
-    make_app(confoverrides={'needs_sphinx': '1.2'})  # OK: less
-    make_app(confoverrides={'needs_sphinx': '1.3'})  # OK: equals
+    make_app(confoverrides={'needs_sphinx': '1.5'})  # OK: less
+    make_app(confoverrides={'needs_sphinx': '1.6'})  # OK: equals
     with pytest.raises(VersionRequirementError):
-        make_app(confoverrides={'needs_sphinx': '1.4'})  # NG: greater
+        make_app(confoverrides={'needs_sphinx': '1.7'})  # NG: greater
 
     # major version
     make_app(confoverrides={'needs_sphinx': '0'})  # OK: less
@@ -337,12 +328,12 @@
 
 
 @pytest.mark.sphinx(testroot='nitpicky-warnings', confoverrides={
-    'nitpick_ignore': 
+    'nitpick_ignore': {
         ('py:const', 'prefix.anything.postfix'),
         ('py:class', 'prefix.anything'),
         ('py:class', 'anything.postfix'),
         ('js:class', 'prefix.anything.postfix'),
-    ,
+    },
 })
 def test_nitpick_ignore(app, status, warning):
     app.builder.build_all()
@@ -353,7 +344,7 @@
     'nitpick_ignore_regex': 
         (r'py:.*', r'.*postfix'),
         (r'.*:class', r'prefix.*'),
-    
+    ,
 })
 def test_nitpick_ignore_regex1(app, status, warning):
     app.builder.build_all()
@@ -364,7 +355,7 @@
     'nitpick_ignore_regex': 
         (r'py:.*', r'prefix.*'),
         (r'.*:class', r'.*postfix'),
-    
+    ,
 })
 def test_nitpick_ignore_regex2(app, status, warning):
     app.builder.build_all()
@@ -381,7 +372,7 @@
         (r'.*', r'prefix'),
         (r'.*', r'postfix'),
         (r'.*', r''),
-    
+    ,
 })
 def test_nitpick_ignore_regex_fullmatch(app, status, warning):
     app.builder.build_all()
@@ -390,3 +381,64 @@
     assert len(warning) == len(nitpick_warnings)
     for actual, expected in zip(warning, nitpick_warnings):
         assert expected in actual
+
+
+def test_conf_py_language_none(tempdir):
+    """Regression test for #10474."""
+
+    # Given a conf.py file with language = None
+    (tempdir / 'conf.py').write_text("language = None", encoding='utf-8')
+
+    # When we load conf.py into a Config object
+    cfg = Config.read(tempdir, {}, None)
+    cfg.init_values()
+
+    # Then the language is coerced to English
+    assert cfg.language == "en"
+
+
+@mock.patch("sphinx.config.logger")
+def test_conf_py_language_none_warning(logger, tempdir):
+    """Regression test for #10474."""
+
+    # Given a conf.py file with language = None
+    (tempdir / 'conf.py').write_text("language = None", encoding='utf-8')
+
+    # When we load conf.py into a Config object
+    Config.read(tempdir, {}, None)
+
+    # Then a warning is raised
+    assert logger.warning.called
+    assert logger.warning.call_args00 == (
+        "Invalid configuration value found: 'language = None'. "
+        "Update your configuration to a valid language code. "
+        "Falling back to 'en' (English).")
+
+
+def test_conf_py_no_language(tempdir):
+    """Regression test for #10474."""
+
+    # Given a conf.py file with no language attribute
+    (tempdir / 'conf.py').write_text("", encoding='utf-8')
+
+    # When we load conf.py into a Config object
+    cfg = Config.read(tempdir, {}, None)
+    cfg.init_values()
+
+    # Then the language is coerced to English
+    assert cfg.language == "en"
+
+
+def test_conf_py_nitpick_ignore_list(tempdir):
+    """Regression test for #11355."""
+
+    # Given a conf.py file with no language attribute
+    (tempdir / 'conf.py').write_text("", encoding='utf-8')
+
+    # When we load conf.py into a Config object
+    cfg = Config.read(tempdir, {}, None)
+    cfg.init_values()
+
+    # Then the default nitpick_ignore_regex is an empty list
+    assert cfg.nitpick_ignore == 
+    assert cfg.nitpick_ignore_regex ==

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_correct_year.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_correct_year.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_correct_year
-    ~~~~~~~~~~~~~~~~~
-
-    Test copyright year adjustment
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test copyright year adjustment"""
 import pytest
 
 
@@ -22,15 +14,16 @@
 )
 def expect_date(request, monkeypatch):
     sde, expect = request.param
-    if sde:
-        monkeypatch.setenv('SOURCE_DATE_EPOCH', sde)
-    else:
-        monkeypatch.delenv('SOURCE_DATE_EPOCH', raising=False)
-    yield expect
+    with monkeypatch.context() as m:
+        if sde:
+            m.setenv('SOURCE_DATE_EPOCH', sde)
+        else:
+            m.delenv('SOURCE_DATE_EPOCH', raising=False)
+        yield expect
 
 
 @pytest.mark.sphinx('html', testroot='correct-year')
 def test_correct_year(expect_date, app):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert expect_date in content

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_directive_code.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_directive_code.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_directive_code
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test the code-block directive.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the code-block directive."""
 
 import os
 
@@ -36,7 +28,7 @@
     options = {'lineno-match': True}
     reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG)
     content, lines = reader.read()
-    assert content == literal_inc_path.read_text()
+    assert content == literal_inc_path.read_text(encoding='utf8')
     assert lines == 13
     assert reader.lineno_start == 1
 
@@ -46,7 +38,7 @@
     options = {'lineno-start': 4}
     reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG)
     content, lines = reader.read()
-    assert content == literal_inc_path.read_text()
+    assert content == literal_inc_path.read_text(encoding='utf8')
     assert lines == 13
     assert reader.lineno_start == 4
 
@@ -260,6 +252,19 @@
 
 
 @pytest.mark.xfail(os.name != 'posix', reason="Not working on windows")
+def test_LiteralIncludeReader_dedent_and_append_and_prepend(literal_inc_path):
+    # dedent: 2
+    options = {'lines': '9-11', 'dedent': 2, 'prepend': 'class Foo:', 'append': '# comment'}
+    reader = LiteralIncludeReader(literal_inc_path, options, DUMMY_CONFIG)
+    content, lines = reader.read()
+    assert content == ("class Foo:\n"
+                       "  def baz():\n"
+                       "      pass\n"
+                       "\n"
+                       "# comment\n")
+
+
+@pytest.mark.xfail(os.name != 'posix', reason="Not working on windows")
 def test_LiteralIncludeReader_tabwidth(testroot):
     # tab-width: 4
     options = {'tab-width': 4, 'pyobject': 'Qux'}
@@ -332,7 +337,7 @@
 @pytest.mark.sphinx('html', testroot='directive-code')
 def test_code_block_caption_html(app, status, warning):
     app.builder.build('caption')
-    html = (app.outdir / 'caption.html').read_text()
+    html = (app.outdir / 'caption.html').read_text(encoding='utf8')
     caption = ('<div class="code-block-caption">'
                '<span class="caption-number">Listing 1 </span>'
                '<span class="caption-text">caption <em>test</em> rb'
@@ -344,7 +349,7 @@
 @pytest.mark.sphinx('latex', testroot='directive-code')
 def test_code_block_caption_latex(app, status, warning):
     app.builder.build_all()
-    latex = (app.outdir / 'python.tex').read_text()
+    latex = (app.outdir / 'python.tex').read_text(encoding='utf8')
     caption = '\\sphinxSetupCaptionForVerbatim{caption \\sphinxstyleemphasis{test} rb}'
     label = '\\def\\sphinxLiteralBlockLabel{\\label{\\detokenize{caption:id1}}}'
     link = '\\hyperref\\detokenize{caption:name-test-rb}' \
@@ -357,7 +362,7 @@
 @pytest.mark.sphinx('latex', testroot='directive-code')
 def test_code_block_namedlink_latex(app, status, warning):
     app.builder.build_all()
-    latex = (app.outdir / 'python.tex').read_text()
+    latex = (app.outdir / 'python.tex').read_text(encoding='utf8')
     label1 = '\\def\\sphinxLiteralBlockLabel{\\label{\\detokenize{caption:name-test-rb}}}'
     link1 = '\\hyperref\\detokenize{caption:name-test-rb}'\
             '{\\sphinxcrossref{\\DUrole{std,std-ref}{Ruby}}'
@@ -374,7 +379,7 @@
 @pytest.mark.sphinx('latex', testroot='directive-code')
 def test_code_block_emphasize_latex(app, status, warning):
     app.builder.build('emphasize')
-    latex = (app.outdir / 'python.tex').read_text().replace('\r\n', '\n')
+    latex = (app.outdir / 'python.tex').read_text(encoding='utf8').replace('\r\n', '\n')
     includes = '\\fvset{hllines={, 5, 6, 13, 14, 15, 24, 25, 26,}}%\n'
     assert includes in latex
     includes = '\\end{sphinxVerbatim}\n\\sphinxresetverbatimhllines\n'
@@ -387,7 +392,7 @@
     et = etree_parse(app.outdir / 'index.xml')
     secs = et.findall('./section/section')
     literal_include = secs1.findall('literal_block')
-    literal_src = (app.srcdir / 'literal.inc').read_text()
+    literal_src = (app.srcdir / 'literal.inc').read_text(encoding='utf8')
     assert len(literal_include) > 0
     actual = literal_include0.text
     assert actual == literal_src
@@ -420,7 +425,7 @@
 @pytest.mark.sphinx('html', testroot='directive-code')
 def test_literal_include_linenos(app, status, warning):
     app.builder.build('linenos')
-    html = (app.outdir / 'linenos.html').read_text()
+    html = (app.outdir / 'linenos.html').read_text(encoding='utf8')
 
     # :linenos:
     assert ('<span class="linenos"> 1</span><span class="c1">'
@@ -438,7 +443,7 @@
 @pytest.mark.sphinx('latex', testroot='directive-code')
 def test_literalinclude_file_whole_of_emptyline(app, status, warning):
     app.builder.build_all()
-    latex = (app.outdir / 'python.tex').read_text().replace('\r\n', '\n')
+    latex = (app.outdir / 'python.tex').read_text(encoding='utf8').replace('\r\n', '\n')
     includes = (
         '\\begin{sphinxVerbatim}'
         'commandchars=\\\\\\{\\},numbers=left,firstnumber=1,stepnumber=1\n'
@@ -451,8 +456,8 @@
 
 @pytest.mark.sphinx('html', testroot='directive-code')
 def test_literalinclude_caption_html(app, status, warning):
-    app.builder.build('index')
-    html = (app.outdir / 'caption.html').read_text()
+    app.builder.build_all()
+    html = (app.outdir / 'caption.html').read_text(encoding='utf8')
     caption = ('<div class="code-block-caption">'
                '<span class="caption-number">Listing 2 </span>'
                '<span class="caption-text">caption <strong>test</strong> py'
@@ -464,7 +469,7 @@
 @pytest.mark.sphinx('latex', testroot='directive-code')
 def test_literalinclude_caption_latex(app, status, warning):
     app.builder.build('index')
-    latex = (app.outdir / 'python.tex').read_text()
+    latex = (app.outdir / 'python.tex').read_text(encoding='utf8')
     caption = '\\sphinxSetupCaptionForVerbatim{caption \\sphinxstylestrong{test} py}'
     label = '\\def\\sphinxLiteralBlockLabel{\\label{\\detokenize{caption:id2}}}'
     link = '\\hyperref\\detokenize{caption:name-test-py}' \
@@ -477,7 +482,7 @@
 @pytest.mark.sphinx('latex', testroot='directive-code')
 def test_literalinclude_namedlink_latex(app, status, warning):
     app.builder.build('index')
-    latex = (app.outdir / 'python.tex').read_text()
+    latex = (app.outdir / 'python.tex').read_text(encoding='utf8')
     label1 = '\\def\\sphinxLiteralBlockLabel{\\label{\\detokenize{caption:name-test-py}}}'
     link1 = '\\hyperref\\detokenize{caption:name-test-py}'\
             '{\\sphinxcrossref{\\DUrole{std,std-ref}{Python}}'
@@ -499,13 +504,13 @@
 
     code_block = secs0.findall('literal_block')
     assert len(code_block) > 0
-    assert 'foo bar' == code_block0.get('classes')
-    assert 'code_block' == code_block0.get('names')
+    assert code_block0.get('classes') == 'foo bar'
+    assert code_block0.get('names') == 'code_block'
 
     literalinclude = secs1.findall('literal_block')
     assert len(literalinclude) > 0
-    assert 'bar baz' == literalinclude0.get('classes')
-    assert 'literal_include' == literalinclude0.get('names')
+    assert literalinclude0.get('classes') == 'bar baz'
+    assert literalinclude0.get('names') == 'literal_include'
 
 
 @pytest.mark.sphinx('xml', testroot='directive-code')
@@ -564,7 +569,7 @@
 @pytest.mark.sphinx('html', testroot='directive-code')
 def test_linenothreshold(app, status, warning):
     app.builder.build('linenothreshold')
-    html = (app.outdir / 'linenothreshold.html').read_text()
+    html = (app.outdir / 'linenothreshold.html').read_text(encoding='utf8')
 
     # code-block using linenothreshold
     assert ('<span class="linenos">1</span><span class="k">class</span> '
@@ -586,7 +591,7 @@
 def test_code_block_dedent(app, status, warning):
     app.builder.build('dedent')
     doctree = app.env.get_doctree('dedent')
-    codeblocks = list(doctree.traverse(nodes.literal_block))
+    codeblocks = list(doctree.findall(nodes.literal_block))
     # Note: comparison string should not have newlines at the beginning or end
     text_0_indent = '''First line
 Second line

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_directive_object_description.py Added

@@ -0,0 +1,59 @@
+"""Test object description directives."""
+
+import docutils.utils
+import pytest
+from docutils import nodes
+
+from sphinx import addnodes
+from sphinx.io import create_publisher
+from sphinx.testing import restructuredtext
+from sphinx.util.docutils import sphinx_domains
+
+
+def _doctree_for_test(builder, docname: str) -> nodes.document:
+    builder.env.prepare_settings(docname)
+    publisher = create_publisher(builder.app, 'restructuredtext')
+    with sphinx_domains(builder.env):
+        publisher.set_source(source_path=builder.env.doc2path(docname))
+        publisher.publish()
+        return publisher.document
+
+
+@pytest.mark.sphinx('text', testroot='object-description-sections')
+def test_object_description_sections(app):
+    doctree = _doctree_for_test(app.builder, 'index')
+    # <document>
+    #     <index>
+    #     <desc>
+    #         <desc_signature>
+    #             <desc_name>
+    #                 func
+    #             <desc_parameterlist>
+    #         <desc_content>
+    #             <section>
+    #                 <title>
+    #                     Overview
+    #                 <paragraph>
+    #                     Lorem ipsum dolar sit amet
+
+    assert isinstance(doctree0, addnodes.index)
+    assert isinstance(doctree1, addnodes.desc)
+    assert isinstance(doctree10, addnodes.desc_signature)
+    assert isinstance(doctree11, addnodes.desc_content)
+    assert isinstance(doctree110, nodes.section)
+    assert isinstance(doctree1100, nodes.title)
+    assert doctree11000 == 'Overview'
+    assert isinstance(doctree1101, nodes.paragraph)
+    assert doctree11010 == 'Lorem ipsum dolar sit amet'
+
+
+def test_object_description_content_line_number(app):
+    text = (".. py:function:: foo(bar)\n" +
+            "\n" +
+            "   Some link here: :ref:`abc`\n")
+    doc = restructuredtext.parse(app, text)
+    xrefs = list(doc.findall(condition=addnodes.pending_xref))
+    assert len(xrefs) == 1
+    source, line = docutils.utils.get_source_line(xrefs0)
+    assert 'index.rst' in source
+    assert line == 3

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_directive_only.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_directive_only.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_directive_other.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_directive_other.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_directive_patch.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_directive_patch.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_docutilsconf.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_docutilsconf.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_domain_c.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_domain_c.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_domain_c
-    ~~~~~~~~~~~~~
-
-    Tests the C Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the C Domain"""
 
 import itertools
 import zlib
@@ -16,8 +8,14 @@
 
 from sphinx import addnodes
 from sphinx.addnodes import desc
-from sphinx.domains.c import (DefinitionError, DefinitionParser, Symbol, _id_prefix,
-                              _macroKeywords, _max_id)
+from sphinx.domains.c import (
+    DefinitionError,
+    DefinitionParser,
+    Symbol,
+    _id_prefix,
+    _macroKeywords,
+    _max_id,
+)
 from sphinx.ext.intersphinx import load_mappings, normalize_intersphinx_mapping
 from sphinx.testing import restructuredtext
 from sphinx.testing.util import assert_node
@@ -478,12 +476,12 @@
     cvrs = '', 'const', 'volatile', 'restrict', 'restrict volatile const'
     for cvr in cvrs:
         space = ' ' if len(cvr) != 0 else ''
-        check('function', 'void f(int arr{}*)'.format(cvr), {1: 'f'})
-        check('function', 'void f(int arr{})'.format(cvr), {1: 'f'})
-        check('function', 'void f(int arr{}{}42)'.format(cvr, space), {1: 'f'})
-        check('function', 'void f(int arrstatic{}{} 42)'.format(space, cvr), {1: 'f'})
-        check('function', 'void f(int arr{}{}static 42)'.format(cvr, space), {1: 'f'},
-              output='void f(int arrstatic{}{} 42)'.format(space, cvr))
+        check('function', f'void f(int arr{cvr}*)', {1: 'f'})
+        check('function', f'void f(int arr{cvr})', {1: 'f'})
+        check('function', f'void f(int arr{cvr}{space}42)', {1: 'f'})
+        check('function', f'void f(int arrstatic{space}{cvr} 42)', {1: 'f'})
+        check('function', f'void f(int arr{cvr}{space}static 42)', {1: 'f'},
+              output=f'void f(int arrstatic{space}{cvr} 42)')
     check('function', 'void f(int arrconst static volatile 42)', {1: 'f'},
           output='void f(int arrstatic volatile const 42)')
 
@@ -581,13 +579,17 @@
           output='__attribute__(()) static inline void f()')
     check('function', 'attr1 attr2 void f()', {1: 'f'})
     # position: declarator
-    check('member', 'int *attr i', {1: 'i'})
-    check('member', 'int *const attr volatile i', {1: 'i'},
-          output='int *attr volatile const i')
-    check('member', 'int *attr *i', {1: 'i'})
+    check('member', 'int *attr1 attr2 i', {1: 'i'})
+    check('member', 'int *const attr1 attr2 volatile i', {1: 'i'},
+          output='int *attr1 attr2 volatile const i')
+    check('member', 'int *attr1 attr2 *i', {1: 'i'})
     # position: parameters
     check('function', 'void f() attr1 attr2', {1: 'f'})
 
+    # position: enumerator
+    check('enumerator', '{key}Foo attr1 attr2', {1: 'Foo'})
+    check('enumerator', '{key}Foo attr1 attr2 = 42', {1: 'Foo'})
+
     # issue michaeljones/breathe#500
     check('function', 'LIGHTGBM_C_EXPORT int LGBM_BoosterFree(int handle)',
           {1: 'LGBM_BoosterFree'})
@@ -615,20 +617,20 @@
 
 def filter_warnings(warning, file):
     lines = split_warnigns(warning)
-    res = l for l in lines if "domain-c" in l and "{}.rst".format(file) in l and
+    res = l for l in lines if "domain-c" in l and f"{file}.rst" in l and
            "WARNING: document isn't included in any toctree" not in l
-    print("Filtered warnings for file '{}':".format(file))
+    print(f"Filtered warnings for file '{file}':")
     for w in res:
         print(w)
     return res
 
 
 def extract_role_links(app, filename):
-    t = (app.outdir / filename).read_text()
+    t = (app.outdir / filename).read_text(encoding='utf8')
     lis = l for l in t.split('\n') if l.startswith("<li")
     entries = 
     for l in lis:
-        li = ElementTree.fromstring(l)
+        li = ElementTree.fromstring(l)  # NoQA: S314  # using known data in tests
         aList = list(li.iter('a'))
         assert len(aList) == 1
         a = aList0
@@ -654,9 +656,9 @@
     app.builder.build_all()
     ws = filter_warnings(warning, "namespace")
     assert len(ws) == 0
-    t = (app.outdir / "namespace.html").read_text()
+    t = (app.outdir / "namespace.html").read_text(encoding='utf8')
     for id_ in ('NS.NSVar', 'NULLVar', 'ZeroVar', 'NS2.NS3.NS2NS3Var', 'PopVar'):
-        assert 'id="c.{}"'.format(id_) in t
+        assert f'id="c.{id_}"' in t
 
 
 @pytest.mark.sphinx(testroot='domain-c', confoverrides={'nitpicky': True})
@@ -739,7 +741,7 @@
 
 .. c:type:: _type
 .. c:function:: void _functionParam(int param)
-"""  # noqa
+"""  # noqa: F841
     inv_file = tempdir / 'inventory'
     inv_file.write_bytes(b'''\
 # Sphinx inventory version 2
@@ -759,7 +761,7 @@
 _type c:type 1 index.html#c.$ -
 _union c:union 1 index.html#c.$ -
 _var c:member 1 index.html#c.$ -
-'''))  # noqa
+'''))  # noqa: W291
     app.config.intersphinx_mapping = {
         'https://localhost/intersphinx/c/': inv_file,
     }

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_domain_cpp.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_domain_cpp.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_domain_cpp
-    ~~~~~~~~~~~~~~~
-
-    Tests the C++ Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the C++ Domain"""
 
 import itertools
 import re
@@ -17,8 +9,14 @@
 import sphinx.domains.cpp as cppDomain
 from sphinx import addnodes
 from sphinx.addnodes import desc
-from sphinx.domains.cpp import (DefinitionError, DefinitionParser, NoOldIdError, Symbol,
-                                _id_prefix, _max_id)
+from sphinx.domains.cpp import (
+    DefinitionError,
+    DefinitionParser,
+    NoOldIdError,
+    Symbol,
+    _id_prefix,
+    _max_id,
+)
 from sphinx.ext.intersphinx import load_mappings, normalize_intersphinx_mapping
 from sphinx.testing import restructuredtext
 from sphinx.testing.util import assert_node
@@ -226,7 +224,7 @@
              ('\\U0001f34c', '127820'), ('\\U0001F34C', '127820')
     for p, t in charPrefixAndIds:
         for c, val in chars:
-            exprCheck("{}'{}'".format(p, c), t + val)
+            exprCheck(f"{p}'{c}'", t + val)
     # user-defined literals
     for i in ints:
         exprCheck(i + '_udl', 'clL_Zli4_udlEL' + i.replace("'", "") + 'EE')
@@ -238,7 +236,7 @@
         exprCheck('0x' + f + '_udl', 'clL_Zli4_udlEL0x' + f.replace("'", "") + 'EE')
     for p, t in charPrefixAndIds:
         for c, val in chars:
-            exprCheck("{}'{}'_udl".format(p, c), 'clL_Zli4_udlE' + t + val + 'E')
+            exprCheck(f"{p}'{c}'_udl", 'clL_Zli4_udlE' + t + val + 'E')
     exprCheck('"abc"_udl', 'clL_Zli4_udlELA3_KcEE')
     # from issue #7294
     exprCheck('6.62607015e-34q_J', 'clL_Zli3q_JEL6.62607015e-34EE')
@@ -334,7 +332,7 @@
     exprCheck('5 .* 42', 'dsL5EL42E')
     exprCheck('5 ->* 42', 'pmL5EL42E')
     # conditional
-    # TODO
+    exprCheck('5 ? 7 : 3', 'quL5EL7EL3E')
     # assignment
     exprCheck('a = 5', 'aS1aL5E')
     exprCheck('a *= 5', 'mL1aL5E')
@@ -351,6 +349,9 @@
     exprCheck('a |= 5', 'oR1aL5E')
     exprCheck('a or_eq 5', 'oR1aL5E')
     exprCheck('a = {{1, 2, 3}}', 'aS1ailL1EL2EL3EE')
+    # complex assignment and conditional
+    exprCheck('5 = 6 = 7', 'aSL5EaSL6EL7E')
+    exprCheck('5 = 6 ? 7 = 8 : 3', 'aSL5EquL6EaSL7EL8EL3E')
     # comma operator
     exprCheck('a, 5', 'cm1aL5E')
 
@@ -628,7 +629,7 @@
 
     # exceptions from return type mangling
     check('function', 'template<typename T> C()', {2: 'I0E1Cv'})
-    check('function', 'template<typename T> operator int()', {1: None, 2: 'I0Ecviv'})
+    check('function', 'template<typename T> operator int()', {2: 'I0Ecviv'})
 
     # trailing return types
     ids = {1: 'f', 2: '1fv'}
@@ -696,7 +697,7 @@
     check('function', 'void operator>()', {1: "gt-operator", 2: "gtv"})
     check('function', 'void operator<=()', {1: "lte-operator", 2: "lev"})
     check('function', 'void operator>=()', {1: "gte-operator", 2: "gev"})
-    check('function', 'void operator<=>()', {1: None, 2: "ssv"})
+    check('function', 'void operator<=>()', {2: "ssv"})
     check('function', 'void operator!()', {1: "not-operator", 2: "ntv"})
     check('function', 'void operator not()', {2: "ntv"})
     check('function', 'void operator&&()', {1: "sand-operator", 2: "aav"})
@@ -846,9 +847,9 @@
     check('class', 'abc::ns::foo{{id_0, id_1, ...id_2}} {key}xyz::bar',
           {2: 'I00DpEXN3abc2ns3fooEI4id_04id_1sp4id_2EEN3xyz3barE'})
     check('class', 'abc::ns::foo{{id_0, id_1, id_2}} {key}xyz::bar<id_0, id_1, id_2>',
-          {2: 'I000EXN3abc2ns3fooEI4id_04id_14id_2EEN3xyz3barI4id_04id_14id_2EE'})
+          {2: 'I000EXN3abc2ns3fooEI4id_04id_14id_2EEN3xyz3barE'})
     check('class', 'abc::ns::foo{{id_0, id_1, ...id_2}} {key}xyz::bar<id_0, id_1, id_2...>',
-          {2: 'I00DpEXN3abc2ns3fooEI4id_04id_1sp4id_2EEN3xyz3barI4id_04id_1Dp4id_2EE'})
+          {2: 'I00DpEXN3abc2ns3fooEI4id_04id_1sp4id_2EEN3xyz3barE'})
 
     check('class', 'template<> Concept{{U}} {key}A<int>::B', {2: 'IEI0EX7ConceptI1UEEN1AIiE1BE'})
 
@@ -881,6 +882,9 @@
     # defaulted constrained type parameters
     check('type', 'template<C T = int&> {key}A', {2: 'I_1CE1A'}, key='using')
 
+    # pack expansion after non-type template parameter
+    check('type', 'template<int (X::*)(bool)...> {key}A', {2: 'I_DpM1XFibEE1A'}, key='using')
+
 
 def test_domain_cpp_ast_placeholder_types():
     check('function', 'void f(Sortable auto &v)', {1: 'f__SortableR', 2: '1fR8Sortable'})
@@ -896,8 +900,33 @@
           {4: 'I0EIQaa1A1BE1fvv'})
     check('function', 'template<typename T> requires A || B or C void f()',
           {4: 'I0EIQoo1Aoo1B1CE1fvv'})
+    check('function', 'void f() requires A || B || C',
+          {4: 'IQoo1Aoo1B1CE1fv'})
+    check('function', 'Foo() requires A || B || C',
+          {4: 'IQoo1Aoo1B1CE3Foov'})
     check('function', 'template<typename T> requires A && B || C and D void f()',
           {4: 'I0EIQooaa1A1Baa1C1DE1fvv'})
+    check('function',
+          'template<typename T> requires R<T> ' +
+          'template<typename U> requires S<T> ' +
+          'void A<T>::f() requires B',
+          {4: 'I0EIQ1RI1TEEI0EIQaa1SI1TE1BEN1A1fEvv'})
+    check('function',
+          'template<template<typename T> requires R<T> typename X> ' +
+          'void f()',
+          {2: 'II0EIQ1RI1TEE0E1fv', 4: 'II0EIQ1RI1TEE0E1fvv'})
+    check('type',
+          'template<typename T> requires IsValid<T> {key}T = true_type',
+          {4: 'I0EIQ7IsValidI1TEE1T'}, key='using')
+    check('class',
+          'template<typename T> requires IsValid<T> {key}T : Base',
+          {4: 'I0EIQ7IsValidI1TEE1T'}, key='class')
+    check('union',
+          'template<typename T> requires IsValid<T> {key}T',
+          {4: 'I0EIQ7IsValidI1TEE1T'}, key='union')
+    check('member',
+          'template<typename T> requires IsValid<T> int Val = 7',
+          {4: 'I0EIQ7IsValidI1TEE3Val'})
 
 
 def test_domain_cpp_ast_template_args():
@@ -988,14 +1017,22 @@
           output='__attribute__(()) static inline void f()')
     check('function', 'attr1 attr2 void f()', {1: 'f', 2: '1fv'})
     # position: declarator
-    check('member', 'int *attr i', {1: 'i__iP', 2: '1i'})
-    check('member', 'int *const attr volatile i', {1: 'i__iPVC', 2: '1i'},
-          output='int *attr volatile const i')
-    check('member', 'int &attr i', {1: 'i__iR', 2: '1i'})
-    check('member', 'int *attr *i', {1: 'i__iPP', 2: '1i'})
+    check('member', 'int *attr1 attr2 i', {1: 'i__iP', 2: '1i'})
+    check('member', 'int *const attr1 attr2 volatile i', {1: 'i__iPVC', 2: '1i'},
+          output='int *attr1 attr2 volatile const i')
+    check('member', 'int &attr1 attr2 i', {1: 'i__iR', 2: '1i'})
+    check('member', 'int *attr1 attr2 *i', {1: 'i__iPP', 2: '1i'})
     # position: parameters and qualifiers
     check('function', 'void f() attr1 attr2', {1: 'f', 2: '1fv'})
 
+    # position: class, union, enum
+    check('class', '{key}attr1 attr2 Foo', {1: 'Foo', 2: '3Foo'}, key='class')
+    check('union', '{key}attr1 attr2 Foo', {2: '3Foo'}, key='union')
+    check('enum', '{key}attr1 attr2 Foo', {2: '3Foo'}, key='enum')
+    # position: enumerator
+    check('enumerator', '{key}Foo attr1 attr2', {2: '3Foo'})
+    check('enumerator', '{key}Foo attr1 attr2 = 42', {2: '3Foo'})
+
 
 def test_domain_cpp_ast_xref_parsing():
     def check(target):
@@ -1012,6 +1049,38 @@
     check('T f()')
 
 
+@pytest.mark.parametrize(
+    'param,is_pack',
+    ('typename', False),
+     ('typename T', False),
+     ('typename...', True),
+     ('typename... T', True),
+     ('int', False),
+     ('int N', False),
+     ('int* N', False),
+     ('int& N', False),
+     ('int&... N', True),
+     ('int*... N', True),
+     ('int...', True),
+     ('int... N', True),
+     ('auto', False),
+     ('auto...', True),
+     ('int X::*', False),
+     ('int X::*...', True),
+     ('int (X::*)(bool)', False),
+     ('int (X::*x)(bool)', False),
+     ('int (X::*)(bool)...', True),
+     ('template<typename> class', False),
+     ('template<typename> class...', True),
+     )
+def test_domain_cpp_template_parameters_is_pack(param: str, is_pack: bool):
+    def parse_template_parameter(param: str):
+        ast = parse('type', 'template<' + param + '> X')
+        return ast.templatePrefix.templates0.params0
+    ast = parse_template_parameter(param)
+    assert ast.isPack == is_pack
+
+
 # def test_print():
 #     # used for getting all the ids out for checking
 #     for a in ids:
@@ -1021,9 +1090,9 @@
 
 def filter_warnings(warning, file):
     lines = warning.getvalue().split("\n")
-    res = l for l in lines if "domain-cpp" in l and "{}.rst".format(file) in l and
+    res = l for l in lines if "domain-cpp" in l and f"{file}.rst" in l and
            "WARNING: document isn't included in any toctree" not in l
-    print("Filtered warnings for file '{}':".format(file))
+    print(f"Filtered warnings for file '{file}':")
     for w in res:
         print(w)
     return res
@@ -1106,15 +1175,15 @@
         txtTargetType = "function" if targetType == "func" else targetType
         for r in allRoles:
             if r not in roles:
-                warn.append("WARNING: cpp:{} targets a {} (".format(r, txtTargetType))
+                warn.append(f"WARNING: cpp:{r} targets a {txtTargetType} (")
                 if targetType == 'templateParam':
-                    warn.append("WARNING: cpp:{} targets a {} (".format(r, txtTargetType))
-                    warn.append("WARNING: cpp:{} targets a {} (".format(r, txtTargetType))
-    warn = list(sorted(warn))
+                    warn.append(f"WARNING: cpp:{r} targets a {txtTargetType} (")
+                    warn.append(f"WARNING: cpp:{r} targets a {txtTargetType} (")
+    warn = sorted(warn)
     for w in ws:
         assert "targets a" in w
     ws = ww.index("WARNING:"): for w in ws
-    ws = list(sorted(ws))
+    ws = sorted(ws)
     print("Expected warnings:")
     for w in warn:
         print(w)
@@ -1136,14 +1205,14 @@
         pattern = '<li><p>%s<a .*?><code .*?><span .*?>%s</span></code></a></p></li>' % spec
         res = re.search(pattern, text)
         if not res:
-            print("Pattern\n\t%s\nnot found in %s" % (pattern, file))
-            assert False
+            print(f"Pattern\n\t{pattern}\nnot found in {file}")
+            raise AssertionError()
     rolePatterns = 
         ('', 'Sphinx'),
         ('', 'Sphinx::version'),
         ('', 'version'),
         ('', 'List'),
-        ('', 'MyEnum')
+        ('', 'MyEnum'),
     
     parenPatterns = 
         ('ref function without parens ', r'paren_1'),
@@ -1153,18 +1222,18 @@
         ('ref op call without parens ', r'paren_5::operator'),
         ('ref op call with parens ', r'paren_6::operator'),
         ('ref op call without parens, explicit title ', 'paren_7_title'),
-        ('ref op call with parens, explicit title ', 'paren_8_title')
+        ('ref op call with parens, explicit title ', 'paren_8_title'),
     
 
     f = 'roles.html'
-    t = (app.outdir / f).read_text()
+    t = (app.outdir / f).read_text(encoding='utf8')
     for s in rolePatterns:
         check(s, t, f)
     for s in parenPatterns:
         check(s, t, f)
 
     f = 'any-role.html'
-    t = (app.outdir / f).read_text()
+    t = (app.outdir / f).read_text(encoding='utf8')
     for s in parenPatterns:
         check(s, t, f)
 
@@ -1177,14 +1246,14 @@
         pattern = '<li><p>%s<a .*?><code .*?><span .*?>%s</span></code></a></p></li>' % spec
         res = re.search(pattern, text)
         if not res:
-            print("Pattern\n\t%s\nnot found in %s" % (pattern, file))
-            assert False
+            print(f"Pattern\n\t{pattern}\nnot found in {file}")
+            raise AssertionError()
     rolePatterns = 
         ('', 'Sphinx'),
         ('', 'Sphinx::version'),
         ('', 'version'),
         ('', 'List'),
-        ('', 'MyEnum')
+        ('', 'MyEnum'),
     
     parenPatterns = 
         ('ref function without parens ', 'paren_1'),
@@ -1194,18 +1263,18 @@
         ('ref op call without parens ', r'paren_5::operator'),
         ('ref op call with parens ', r'paren_6::operator'),
         ('ref op call without parens, explicit title ', 'paren_7_title'),
-        ('ref op call with parens, explicit title ', 'paren_8_title')
+        ('ref op call with parens, explicit title ', 'paren_8_title'),
     
 
     f = 'roles.html'
-    t = (app.outdir / f).read_text()
+    t = (app.outdir / f).read_text(encoding='utf8')
     for s in rolePatterns:
         check(s, t, f)
     for s in parenPatterns:
         check(s, t, f)
 
     f = 'any-role.html'
-    t = (app.outdir / f).read_text()
+    t = (app.outdir / f).read_text(encoding='utf8')
     for s in parenPatterns:
         check(s, t, f)
 
@@ -1215,19 +1284,19 @@
     app.builder.build_all()
 
     test = 'xref_consistency.html'
-    output = (app.outdir / test).read_text()
+    output = (app.outdir / test).read_text(encoding='utf8')
 
     def classes(role, tag):
-        pattern = (r'{role}-role:.*?'
-                   r'<(?P<tag>{tag}) .*?class="\'(?P<classes>.*?)"\'.*?>'
+        pattern = (fr'{role}-role:.*?'
+                   fr'<(?P<tag>{tag}) .*?class="\'(?P<classes>.*?)"\'.*?>'
                    r'.*'
-                   r'</(?P=tag)>').format(role=role, tag=tag)
+                   r'</(?P=tag)>')
         result = re.search(pattern, output)
-        expect = '''\
+        expect = f'''\
 Pattern for role `{role}` with tag `{tag}`
 \t{pattern}
 not found in `{test}`
-'''.format(role=role, tag=tag, pattern=pattern, test=test)
+'''
         assert result, expect
         return set(result.group('classes').split())
 
@@ -1237,7 +1306,7 @@
         def __init__(self, role, root, contents):
             self.name = role
             self.classes = classes(role, root)
-            self.content_classes = dict()
+            self.content_classes = {}
             for tag in contents:
                 self.content_classestag = classes(role, tag)
 
@@ -1263,7 +1332,7 @@
 
     for role in (expr_role, texpr_role):
         name = role.name
-        expect = '`{name}` puts the domain and role classes at its root'.format(name=name)
+        expect = f'`{name}` puts the domain and role classes at its root'
         assert {'sig', 'sig-inline', 'cpp', name} <= role.classes, expect
 
     # reference classes
@@ -1303,7 +1372,7 @@
 .. cpp:enum-class:: _enumClass
 .. cpp:function:: void _functionParam(int param)
 .. cpp:function:: template<typename TParam> void _templateParam()
-"""  # noqa
+"""  # noqa: F841
     inv_file = tempdir / 'inventory'
     inv_file.write_bytes(b'''\
 # Sphinx inventory version 2
@@ -1330,7 +1399,7 @@
 _type cpp:type 1 index.html#_CPPv45$ -
 _union cpp:union 1 index.html#_CPPv46$ -
 _var cpp:member 1 index.html#_CPPv44$ -
-'''))  # noqa
+'''))  # noqa: W291
     app.config.intersphinx_mapping = {
         'https://localhost/intersphinx/cpp/': inv_file,
     }
@@ -1367,3 +1436,53 @@
     assert "index.rst:3: WARNING: Duplicate C++ declaration, also defined at index:1." in ws2
     assert "Declaration is '.. cpp:struct:: A'." in ws3
     assert ws4 == ""
+
+
+# For some reason, using the default testroot of "root" leads to the contents of
+# `test-root/objects.txt` polluting the symbol table depending on the test
+# execution order.  Using a testroot of "config" seems to avoid that problem.
+@pytest.mark.sphinx(testroot='config')
+def test_domain_cpp_normalize_unspecialized_template_args(make_app, app_params):
+    args, kwargs = app_params
+
+    text1 = (".. cpp:class:: template <typename T> A\n")
+    text2 = (".. cpp:class:: template <typename T> template <typename U> A<T>::B\n")
+
+    app1 = make_app(*args, **kwargs)
+    restructuredtext.parse(app=app1, text=text1, docname='text1')
+    root1 = app1.env.domaindata'cpp''root_symbol'
+
+    assert root1.dump(1) == (
+        '  ::\n'
+        '    template<typename T> \n'
+        '    A: {class} template<typename T> A\t(text1)\n'
+        '      T: {templateParam} typename T\t(text1)\n'
+    )
+
+    app2 = make_app(*args, **kwargs)
+    restructuredtext.parse(app=app2, text=text2, docname='text2')
+    root2 = app2.env.domaindata'cpp''root_symbol'
+
+    assert root2.dump(1) == (
+        '  ::\n'
+        '    template<typename T> \n'
+        '    A\n'
+        '      T\n'
+        '      template<typename U> \n'
+        '      B: {class} template<typename T> template<typename U> A<T>::B\t(text2)\n'
+        '        U: {templateParam} typename U\t(text2)\n'
+    )
+
+    root2.merge_with(root1, 'text1', app2.env)
+
+    assert root2.dump(1) == (
+        '  ::\n'
+        '    template<typename T> \n'
+        '    A: {class} template<typename T> A\t(text1)\n'
+        '      T: {templateParam} typename T\t(text1)\n'
+        '      template<typename U> \n'
+        '      B: {class} template<typename T> template<typename U> A<T>::B\t(text2)\n'
+        '        U: {templateParam} typename U\t(text2)\n'
+    )
+    warning = app2._warning.getvalue()
+    assert 'Internal C++ domain error during symbol merging' not in warning

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_domain_js.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_domain_js.py Changed

@@ -1,22 +1,24 @@
-"""
-    test_domain_js
-    ~~~~~~~~~~~~~~
-
-    Tests the JavaScript Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the JavaScript Domain"""
 
 from unittest.mock import Mock
 
+import docutils.utils
 import pytest
 from docutils import nodes
 
 from sphinx import addnodes
-from sphinx.addnodes import (desc, desc_annotation, desc_content, desc_name, desc_parameter,
-                             desc_parameterlist, desc_sig_keyword, desc_sig_name,
-                             desc_sig_space, desc_signature)
+from sphinx.addnodes import (
+    desc,
+    desc_annotation,
+    desc_content,
+    desc_name,
+    desc_parameter,
+    desc_parameterlist,
+    desc_sig_keyword,
+    desc_sig_name,
+    desc_sig_space,
+    desc_signature,
+)
 from sphinx.domains.javascript import JavaScriptDomain
 from sphinx.testing import restructuredtext
 from sphinx.testing.util import assert_node
@@ -228,3 +230,15 @@
     assert_node(doctree, (addnodes.index, desc, addnodes.index, desc))
     assert_node(doctree0, addnodes.index, entries=('single', 'f() (built-in function)', 'f', '', None))
     assert_node(doctree2, addnodes.index, entries=)
+
+
+def test_module_content_line_number(app):
+    text = (".. js:module:: foo\n" +
+            "\n" +
+            "   Some link here: :ref:`abc`\n")
+    doc = restructuredtext.parse(app, text)
+    xrefs = list(doc.findall(condition=addnodes.pending_xref))
+    assert len(xrefs) == 1
+    source, line = docutils.utils.get_source_line(xrefs0)
+    assert 'index.rst' in source
+    assert line == 3

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_domain_py.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_domain_py.py Changed

@@ -1,30 +1,41 @@
-"""
-    test_domain_py
-    ~~~~~~~~~~~~~~
-
-    Tests the Python Domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the Python Domain"""
 
 import re
-import sys
 from unittest.mock import Mock
 
+import docutils.utils
 import pytest
 from docutils import nodes
 
 from sphinx import addnodes
-from sphinx.addnodes import (desc, desc_addname, desc_annotation, desc_content, desc_name,
-                             desc_optional, desc_parameter, desc_parameterlist, desc_returns,
-                             desc_sig_keyword, desc_sig_literal_number,
-                             desc_sig_literal_string, desc_sig_name, desc_sig_operator,
-                             desc_sig_punctuation, desc_sig_space, desc_signature,
-                             pending_xref)
+from sphinx.addnodes import (
+    desc,
+    desc_addname,
+    desc_annotation,
+    desc_content,
+    desc_name,
+    desc_optional,
+    desc_parameter,
+    desc_parameterlist,
+    desc_returns,
+    desc_sig_keyword,
+    desc_sig_literal_number,
+    desc_sig_literal_string,
+    desc_sig_name,
+    desc_sig_operator,
+    desc_sig_punctuation,
+    desc_sig_space,
+    desc_signature,
+    pending_xref,
+)
 from sphinx.domains import IndexEntry
-from sphinx.domains.python import (PythonDomain, PythonModuleIndex, _parse_annotation,
-                                   _pseudo_parse_arglist, py_sig_re)
+from sphinx.domains.python import (
+    PythonDomain,
+    PythonModuleIndex,
+    _parse_annotation,
+    _pseudo_parse_arglist,
+    py_sig_re,
+)
 from sphinx.testing import restructuredtext
 from sphinx.testing.util import assert_node
 
@@ -139,7 +150,7 @@
 def test_domain_py_xrefs_abbreviations(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'abbr.html').read_text()
+    content = (app.outdir / 'abbr.html').read_text(encoding='utf8')
     assert re.search(r'normal: <a .* href="module.html#module_a.submodule.ModTopLevel.'
                      r'mod_child_1" .*><.*>module_a.submodule.ModTopLevel.mod_child_1'
                      r'<.*></a>',
@@ -194,7 +205,7 @@
 def test_resolve_xref_for_properties(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'module.html').read_text()
+    content = (app.outdir / 'module.html').read_text(encoding='utf8')
     assert ('Link to <a class="reference internal" href="#module_a.submodule.ModTopLevel.prop"'
             ' title="module_a.submodule.ModTopLevel.prop">'
             '<code class="xref py py-attr docutils literal notranslate"><span class="pre">'
@@ -242,7 +253,7 @@
 def test_domain_py_canonical(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'canonical.html').read_text()
+    content = (app.outdir / 'canonical.html').read_text(encoding='utf8')
     assert ('<a class="reference internal" href="#canonical.Foo" title="canonical.Foo">'
             '<code class="xref py py-class docutils literal notranslate">'
             '<span class="pre">Foo</span></code></a>' in content)
@@ -372,7 +383,6 @@
     assert_node(doctree0, pending_xref, refdomain="py", reftype="obj", reftarget="typing.Dict")
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
 def test_parse_annotation_Literal(app):
     doctree = _parse_annotation("LiteralTrue, False", app.env)
     assert_node(doctree, (pending_xref, "Literal",
@@ -458,10 +468,6 @@
                                                         desc_sig_punctuation, ":",
                                                         desc_sig_space,
                                                         desc_sig_name, pending_xref, "str")))
-
-
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
-def test_pyfunction_signature_full_py38(app):
     # case: separator at head
     text = ".. py:function:: hello(*, a)"
     doctree = restructuredtext.parse(app, text)
@@ -496,7 +502,33 @@
                                       desc_parameter, desc_sig_operator, "/"))
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
+def test_pyfunction_with_unary_operators(app):
+    text = ".. py:function:: menu(egg=+1, bacon=-1, sausage=~1, spam=not spam)"
+    doctree = restructuredtext.parse(app, text)
+    assert_node(doctree101,
+                desc_parameterlist, (desc_parameter, (desc_sig_name, "egg",
+                                                        desc_sig_operator, "=",
+                                                        nodes.inline, "+1"),
+                                      desc_parameter, (desc_sig_name, "bacon",
+                                                        desc_sig_operator, "=",
+                                                        nodes.inline, "-1"),
+                                      desc_parameter, (desc_sig_name, "sausage",
+                                                        desc_sig_operator, "=",
+                                                        nodes.inline, "~1"),
+                                      desc_parameter, (desc_sig_name, "spam",
+                                                        desc_sig_operator, "=",
+                                                        nodes.inline, "not spam")))
+
+
+def test_pyfunction_with_binary_operators(app):
+    text = ".. py:function:: menu(spam=2**64)"
+    doctree = restructuredtext.parse(app, text)
+    assert_node(doctree101,
+                desc_parameterlist, (desc_parameter, (desc_sig_name, "spam",
+                                                        desc_sig_operator, "=",
+                                                        nodes.inline, "2**64")))
+
+
 def test_pyfunction_with_number_literals(app):
     text = ".. py:function:: hello(age=0x10, height=1_6_0)"
     doctree = restructuredtext.parse(app, text)
@@ -565,7 +597,7 @@
                                                         desc_sig_space,
                                                         desc_sig_punctuation, '=',
                                                         desc_sig_space,
-                                                        "1")
+                                                        "1"),
                                                     ),
                                   desc_content)))
     assert_node(doctree1, addnodes.desc, desctype="data",
@@ -712,10 +744,8 @@
             "   .. py:method:: meth4\n"
             "      :async:\n"
             "   .. py:method:: meth5\n"
-            "      :property:\n"
-            "   .. py:method:: meth6\n"
             "      :abstractmethod:\n"
-            "   .. py:method:: meth7\n"
+            "   .. py:method:: meth6\n"
             "      :final:\n")
     domain = app.env.get_domain('py')
     doctree = restructuredtext.parse(app, text)
@@ -733,8 +763,6 @@
                                                   addnodes.index,
                                                   desc,
                                                   addnodes.index,
-                                                  desc,
-                                                  addnodes.index,
                                                   desc))))
 
     # method
@@ -776,35 +804,26 @@
     assert 'Class.meth4' in domain.objects
     assert domain.objects'Class.meth4' == ('index', 'Class.meth4', 'method', False)
 
-    # :property:
+    # :abstractmethod:
     assert_node(doctree118, addnodes.index,
-                entries=('single', 'meth5 (Class property)', 'Class.meth5', '', None))
-    assert_node(doctree119, (desc_signature, (desc_annotation, ("property", desc_sig_space),
-                                                     desc_name, "meth5"),
+                entries=('single', 'meth5() (Class method)', 'Class.meth5', '', None))
+    assert_node(doctree119, (desc_signature, (desc_annotation, ("abstract", desc_sig_space),
+                                                     desc_name, "meth5",
+                                                     desc_parameterlist, ()),
                                    desc_content, ()))
     assert 'Class.meth5' in domain.objects
     assert domain.objects'Class.meth5' == ('index', 'Class.meth5', 'method', False)
 
-    # :abstractmethod:
+    # :final:
     assert_node(doctree1110, addnodes.index,
                 entries=('single', 'meth6() (Class method)', 'Class.meth6', '', None))
-    assert_node(doctree1111, (desc_signature, (desc_annotation, ("abstract", desc_sig_space),
+    assert_node(doctree1111, (desc_signature, (desc_annotation, ("final", desc_sig_space),
                                                       desc_name, "meth6",
                                                       desc_parameterlist, ()),
                                     desc_content, ()))
     assert 'Class.meth6' in domain.objects
     assert domain.objects'Class.meth6' == ('index', 'Class.meth6', 'method', False)
 
-    # :final:
-    assert_node(doctree1112, addnodes.index,
-                entries=('single', 'meth7() (Class method)', 'Class.meth7', '', None))
-    assert_node(doctree1113, (desc_signature, (desc_annotation, ("final", desc_sig_space),
-                                                      desc_name, "meth7",
-                                                      desc_parameterlist, ()),
-                                    desc_content, ()))
-    assert 'Class.meth7' in domain.objects
-    assert domain.objects'Class.meth7' == ('index', 'Class.meth7', 'method', False)
-
 
 def test_pyclassmethod(app):
     text = (".. py:class:: Class\n"
@@ -866,18 +885,19 @@
     assert_node(doctree111, (desc_signature, (desc_name, "attr",
                                                      desc_annotation, (desc_sig_punctuation, ':',
                                                                         desc_sig_space,
-                                                                        pending_xref, "Optional",
-                                                                        desc_sig_punctuation, "",
                                                                         pending_xref, "str",
-                                                                        desc_sig_punctuation, ""),
+                                                                        desc_sig_space,
+                                                                        desc_sig_punctuation, "|",
+                                                                        desc_sig_space,
+                                                                        pending_xref, "None"),
                                                      desc_annotation, (desc_sig_space,
                                                                         desc_sig_punctuation, '=',
                                                                         desc_sig_space,
-                                                                        "''")
+                                                                        "''"),
                                                      ),
                                    desc_content, ()))
     assert_node(doctree111012, pending_xref, **{"py:class": "Class"})
-    assert_node(doctree111014, pending_xref, **{"py:class": "Class"})
+    assert_node(doctree111016, pending_xref, **{"py:class": "Class"})
     assert 'Class.attr' in domain.objects
     assert domain.objects'Class.attr' == ('index', 'Class.attr', 'attribute', False)
 
@@ -1007,7 +1027,9 @@
     text = (".. py:module:: example\n"
             ".. py:class:: Class\n"
             "\n"
+            "   :meta blah: this meta-field must not show up in the toc-tree\n"
             "   :param str name: blah blah\n"
+            "   :meta another meta field:\n"
             "   :param age: blah blah\n"
             "   :type age: int\n"
             "   :param items: blah blah\n"
@@ -1192,6 +1214,78 @@
                 refdomain="py", reftype="class", reftarget="int", **{"py:class": "Class"})
 
 
+def test_info_field_list_napoleon_deliminator_of(app):
+    text = (".. py:module:: example\n"
+            ".. py:class:: Class\n"
+            "\n"
+            "   :param list_str_var: example description.\n"
+            "   :type list_str_var: list of str\n"
+            "   :param tuple_int_var: example description.\n"
+            "   :type tuple_int_var: tuple of tuple of int\n"
+            )
+    doctree = restructuredtext.parse(app, text)
+
+    # :param list of str list_str_var:
+    assert_node(doctree31001000,
+                (addnodes.literal_strong, "list_str_var",
+                 " (",
+                 pending_xref, addnodes.literal_emphasis, "list",
+                 addnodes.literal_emphasis, " of ",
+                 pending_xref, addnodes.literal_emphasis, "str",
+                 ")",
+                 " -- ",
+                 "example description."))
+
+    # :param tuple of tuple of int tuple_int_var:
+    assert_node(doctree31001010,
+                (addnodes.literal_strong, "tuple_int_var",
+                 " (",
+                 pending_xref, addnodes.literal_emphasis, "tuple",
+                 addnodes.literal_emphasis, " of ",
+                 pending_xref, addnodes.literal_emphasis, "tuple",
+                 addnodes.literal_emphasis, " of ",
+                 pending_xref, addnodes.literal_emphasis, "int",
+                 ")",
+                 " -- ",
+                 "example description."))
+
+
+def test_info_field_list_napoleon_deliminator_or(app):
+    text = (".. py:module:: example\n"
+            ".. py:class:: Class\n"
+            "\n"
+            "   :param bool_str_var: example description.\n"
+            "   :type bool_str_var: bool or str\n"
+            "   :param str_float_int_var: example description.\n"
+            "   :type str_float_int_var: str or float or int\n"
+            )
+    doctree = restructuredtext.parse(app, text)
+
+    # :param bool or str bool_str_var:
+    assert_node(doctree31001000,
+                (addnodes.literal_strong, "bool_str_var",
+                 " (",
+                 pending_xref, addnodes.literal_emphasis, "bool",
+                 addnodes.literal_emphasis, " or ",
+                 pending_xref, addnodes.literal_emphasis, "str",
+                 ")",
+                 " -- ",
+                 "example description."))
+
+    # :param str or float or int str_float_int_var:
+    assert_node(doctree31001010,
+                (addnodes.literal_strong, "str_float_int_var",
+                 " (",
+                 pending_xref, addnodes.literal_emphasis, "str",
+                 addnodes.literal_emphasis, " or ",
+                 pending_xref, addnodes.literal_emphasis, "float",
+                 addnodes.literal_emphasis, " or ",
+                 pending_xref, addnodes.literal_emphasis, "int",
+                 ")",
+                 " -- ",
+                 "example description."))
+
+
 def test_type_field(app):
     text = (".. py:data:: var1\n"
             "   :type: .int\n"
@@ -1248,11 +1342,11 @@
     assert index.generate() == (
         ('d', IndexEntry('docutils', 0, 'index', 'module-docutils', '', '', '')),
          ('s', IndexEntry('sphinx', 1, 'index', 'module-sphinx', '', '', ''),
-                IndexEntry('sphinx.builders', 2, 'index', 'module-sphinx.builders', '', '', ''),  # NOQA
-                IndexEntry('sphinx.builders.html', 2, 'index', 'module-sphinx.builders.html', '', '', ''),  # NOQA
+                IndexEntry('sphinx.builders', 2, 'index', 'module-sphinx.builders', '', '', ''),
+                IndexEntry('sphinx.builders.html', 2, 'index', 'module-sphinx.builders.html', '', '', ''),
                 IndexEntry('sphinx.config', 2, 'index', 'module-sphinx.config', '', '', ''),
                 IndexEntry('sphinx_intl', 0, 'index', 'module-sphinx_intl', '', '', '')),
-        False
+        False,
     )
 
 
@@ -1264,7 +1358,7 @@
     assert index.generate() == (
         ('s', IndexEntry('sphinx', 1, '', '', '', '', ''),
                 IndexEntry('sphinx.config', 2, 'index', 'module-sphinx.config', '', '', '')),
-        False
+        False,
     )
 
 
@@ -1277,7 +1371,7 @@
     assert index.generate() == (
         ('d', IndexEntry('docutils', 0, 'index', 'module-docutils', '', '', '')),
          ('s', IndexEntry('sphinx', 0, 'index', 'module-sphinx', '', '', '')),
-        True
+        True,
     )
 
 
@@ -1292,13 +1386,13 @@
     restructuredtext.parse(app, text)
     index = PythonModuleIndex(app.env.get_domain('py'))
     assert index.generate() == (
-        ('b', IndexEntry('sphinx.builders', 1, 'index', 'module-sphinx.builders', '', '', ''),  # NOQA
-                IndexEntry('sphinx.builders.html', 2, 'index', 'module-sphinx.builders.html', '', '', '')),  # NOQA
+        ('b', IndexEntry('sphinx.builders', 1, 'index', 'module-sphinx.builders', '', '', ''),
+                IndexEntry('sphinx.builders.html', 2, 'index', 'module-sphinx.builders.html', '', '', '')),
          ('c', IndexEntry('sphinx.config', 0, 'index', 'module-sphinx.config', '', '', '')),
          ('d', IndexEntry('docutils', 0, 'index', 'module-docutils', '', '', '')),
          ('s', IndexEntry('sphinx', 0, 'index', 'module-sphinx', '', '', ''),
                 IndexEntry('sphinx_intl', 0, 'index', 'module-sphinx_intl', '', '', '')),
-        True
+        True,
     )
 
 
@@ -1323,7 +1417,7 @@
 @pytest.mark.sphinx('html', testroot='domain-py-python_use_unqualified_type_names')
 def test_python_python_use_unqualified_type_names(app, status, warning):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<span class="n"><a class="reference internal" href="#foo.Name" title="foo.Name">'
             '<span class="pre">Name</span></a></span>' in content)
     assert '<span class="n"><span class="pre">foo.Age</span></span>' in content
@@ -1336,7 +1430,7 @@
                     confoverrides={'python_use_unqualified_type_names': False})
 def test_python_python_use_unqualified_type_names_disabled(app, status, warning):
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<span class="n"><a class="reference internal" href="#foo.Name" title="foo.Name">'
             '<span class="pre">foo.Name</span></a></span>' in content)
     assert '<span class="n"><span class="pre">foo.Age</span></span>' in content
@@ -1348,6 +1442,98 @@
 @pytest.mark.sphinx('dummy', testroot='domain-py-xref-warning')
 def test_warn_missing_reference(app, status, warning):
     app.build()
-    assert 'index.rst:6: WARNING: undefined label: no-label' in warning.getvalue()
-    assert ('index.rst:6: WARNING: Failed to create a cross reference. A title or caption not found: existing-label'
-            in warning.getvalue())
+    assert "index.rst:6: WARNING: undefined label: 'no-label'" in warning.getvalue()
+    assert ("index.rst:6: WARNING: Failed to create a cross reference. "
+            "A title or caption not found: 'existing-label'") in warning.getvalue()
+
+
+@pytest.mark.sphinx(confoverrides={'nitpicky': True})
+@pytest.mark.parametrize('include_options', (True, False))
+def test_signature_line_number(app, include_options):
+    text = (".. py:function:: foo(bar : string)\n" +
+            ("   :noindexentry:\n" if include_options else ""))
+    doc = restructuredtext.parse(app, text)
+    xrefs = list(doc.findall(condition=addnodes.pending_xref))
+    assert len(xrefs) == 1
+    source, line = docutils.utils.get_source_line(xrefs0)
+    assert 'index.rst' in source
+    assert line == 1
+
+
+def test_module_content_line_number(app):
+    text = (".. py:module:: foo\n" +
+            "\n" +
+            "   Some link here: :ref:`abc`\n")
+    doc = restructuredtext.parse(app, text)
+    xrefs = list(doc.findall(condition=addnodes.pending_xref))
+    assert len(xrefs) == 1
+    source, line = docutils.utils.get_source_line(xrefs0)
+    assert 'index.rst' in source
+    assert line == 3
+
+
+@pytest.mark.sphinx(freshenv=True, confoverrides={'python_display_short_literal_types': True})
+def test_short_literal_types(app):
+    text = """\
+.. py:function:: literal_ints(x: Literal1, 2, 3 = 1) -> None
+.. py:function:: literal_union(x: UnionLiteral"a", Literal"b", Literal"c") -> None
+"""
+    doctree = restructuredtext.parse(app, text)
+    assert_node(doctree, (
+        addnodes.index,
+        desc, (
+            desc_signature, (
+                desc_name, 'literal_ints',
+                desc_parameterlist, (
+                    desc_parameter, (
+                        desc_sig_name, 'x',
+                        desc_sig_punctuation, ':',
+                        desc_sig_space,
+                        desc_sig_name, (
+                            desc_sig_literal_number, '1',
+                            desc_sig_space,
+                            desc_sig_punctuation, '|',
+                            desc_sig_space,
+                            desc_sig_literal_number, '2',
+                            desc_sig_space,
+                            desc_sig_punctuation, '|',
+                            desc_sig_space,
+                            desc_sig_literal_number, '3',
+                        ),
+                        desc_sig_space,
+                        desc_sig_operator, '=',
+                        desc_sig_space,
+                        nodes.inline, '1',
+                    ),
+                ),
+                desc_returns, pending_xref, 'None',
+            ),
+            desc_content, (),
+        ),
+        addnodes.index,
+        desc, (
+            desc_signature, (
+                desc_name, 'literal_union',
+                desc_parameterlist, (
+                    desc_parameter, (
+                        desc_sig_name, 'x',
+                        desc_sig_punctuation, ':',
+                        desc_sig_space,
+                        desc_sig_name, (
+                            desc_sig_literal_string, "'a'",
+                            desc_sig_space,
+                            desc_sig_punctuation, '|',
+                            desc_sig_space,
+                            desc_sig_literal_string, "'b'",
+                            desc_sig_space,
+                            desc_sig_punctuation, '|',
+                            desc_sig_space,
+                            desc_sig_literal_string, "'c'",
+                        ),
+                    ),
+                ),
+                desc_returns, pending_xref, 'None',
+            ),
+            desc_content, (),
+        ),
+    ))

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_domain_rst.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_domain_rst.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_domain_std.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_domain_std.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_domain_std
-    ~~~~~~~~~~~~~~~
-
-    Tests the std domain
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the std domain"""
 
 from unittest import mock
 
@@ -16,8 +8,16 @@
 from html5lib import HTMLParser
 
 from sphinx import addnodes
-from sphinx.addnodes import (desc, desc_addname, desc_content, desc_name, desc_signature,
-                             glossary, index, pending_xref)
+from sphinx.addnodes import (
+    desc,
+    desc_addname,
+    desc_content,
+    desc_name,
+    desc_signature,
+    glossary,
+    index,
+    pending_xref,
+)
 from sphinx.domains.std import StandardDomain
 from sphinx.testing import restructuredtext
 from sphinx.testing.util import assert_node
@@ -416,7 +416,7 @@
         ('SecondLine', 'firstLineRule.html#grammar-token-SecondLine', 'SecondLine'),
     
 
-    text = (app.outdir / 'LineContinuation.html').read_text()
+    text = (app.outdir / 'LineContinuation.html').read_text(encoding='utf8')
     assert "A</strong> ::=  B C D    E F G" in text
 
 
@@ -455,10 +455,41 @@
     assert domain.labels'label' == ('index', 'label', 'blah blah blah')
 
 
-def test_inline_target(app):
-    text = "blah _`inline target` blah\n"
+def test_labeled_definition(app):
+    text = (".. _label1:\n"
+            "\n"
+            "Foo blah *blah* blah\n"
+            "  Definition\n"
+            "\n"
+            ".. _label2:\n"
+            "\n"
+            "Bar blah *blah* blah\n"
+            "  Definition\n"
+            "\n")
+    restructuredtext.parse(app, text)
+
+    domain = app.env.get_domain("std")
+    assert 'label1' in domain.labels
+    assert domain.labels'label1' == ('index', 'label1', 'Foo blah blah blah')
+    assert 'label2' in domain.labels
+    assert domain.labels'label2' == ('index', 'label2', 'Bar blah blah blah')
+
+
+def test_labeled_field(app):
+    text = (".. _label1:\n"
+            "\n"
+            ":Foo blah *blah* blah:\n"
+            "  Definition\n"
+            "\n"
+            ".. _label2:\n"
+            "\n"
+            ":Bar blah *blah* blah:\n"
+            "  Definition\n"
+            "\n")
     restructuredtext.parse(app, text)
 
     domain = app.env.get_domain("std")
-    assert 'inline target' in domain.labels
-    assert domain.labels'inline target' == ('index', 'inline-target', 'inline target')
+    assert 'label1' in domain.labels
+    assert domain.labels'label1' == ('index', 'label1', 'Foo blah blah blah')
+    assert 'label2' in domain.labels
+    assert domain.labels'label2' == ('index', 'label2', 'Bar blah blah blah')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_environment.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_environment.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_environment_indexentries.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_environment_indexentries.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_environment_indexentries
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the sphinx.environment.managers.indexentries.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.environment.managers.indexentries."""
 
 import pytest
 
@@ -23,7 +15,7 @@
             ".. index:: Sphinx\n"
             ".. index:: Ель\n"
             ".. index:: ёлка\n"
-            ".. index:: ‏עברית‎\n"
+            ".. index:: \N{RIGHT-TO-LEFT MARK}\u05e2\u05d1\u05e8\u05d9\u05ea\N{LEFT-TO-RIGHT MARK}\n"
             ".. index:: 9-symbol\n"
             ".. index:: &-symbol\n"
             ".. index:: £100\n")
@@ -43,7 +35,10 @@
                          ('Ель', ('', '#index-5'), , None))
     # Here the word starts with U+200F RIGHT-TO-LEFT MARK, which should be
     # ignored when getting the first letter.
-    assert index5 == ('ע', ('‏עברית‎', ('', '#index-7'), , None))
+    assert index5 == ('\u05e2', (
+        '\N{RIGHT-TO-LEFT MARK}\u05e2\u05d1\u05e8\u05d9\u05ea\N{LEFT-TO-RIGHT MARK}',
+        ('', '#index-7'), , None,
+    ))
 
 
 @pytest.mark.sphinx('dummy', freshenv=True)

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_environment_record_dependencies.py Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_environment_toctree.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_environment_toctree.py Changed

@@ -1,16 +1,8 @@
-"""
-    test_environment_toctree
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the sphinx.environment.managers.toctree.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.environment.managers.toctree."""
 
 import pytest
 from docutils import nodes
-from docutils.nodes import bullet_list, comment, list_item, reference, title
+from docutils.nodes import bullet_list, comment, list_item, literal, reference, title
 
 from sphinx import addnodes
 from sphinx.addnodes import compact_paragraph, only
@@ -134,6 +126,44 @@
     assert app.env.numbered_toctrees == set()
 
 
+@pytest.mark.sphinx('dummy', testroot='toctree-domain-objects')
+def test_domain_objects(app):
+    includefiles = 'domains'
+
+    app.build()
+
+    assert app.env.toc_num_entries'index' == 0
+    assert app.env.toc_num_entries'domains' == 9
+    assert app.env.toctree_includes'index' == includefiles
+    for file in includefiles:
+        assert 'index' in app.env.files_to_rebuildfile
+    assert app.env.glob_toctrees == set()
+    assert app.env.numbered_toctrees == {'index'}
+
+    # tocs
+    toctree = app.env.tocs'domains'
+    assert_node(toctree,
+                bullet_list, list_item, (compact_paragraph,  # 00
+                                          bullet_list, (list_item,  # 010
+                                                         list_item,  # 011
+                                                          (compact_paragraph,  # 0110
+                                                           bullet_list, (list_item,  # 01110
+                                                                          list_item,
+                                                                          list_item,
+                                                                          list_item)),  # 01113
+                                                         list_item,
+                                                         list_item)))  # 011
+
+    assert_node(toctree00,
+                compact_paragraph, reference, "test-domain-objects")
+
+    assert_node(toctree010,
+                list_item, (compact_paragraph, reference, literal, "world()"))
+
+    assert_node(toctree01113,
+                list_item, (compact_paragraph, reference, literal, "HelloWorldPrinter.print()"))
+
+
 @pytest.mark.sphinx('xml', testroot='toctree')
 @pytest.mark.test_params(shared_result='test_environment_toctree_basic')
 def test_get_toc_for(app):
@@ -164,7 +194,7 @@
 @pytest.mark.test_params(shared_result='test_environment_toctree_basic')
 def test_get_toc_for_only(app):
     app.build()
-    builder = StandaloneHTMLBuilder(app)
+    builder = StandaloneHTMLBuilder(app, app.env)
     toctree = TocTree(app.env).get_toc_for('index', builder)
 
     assert_node(toctree,
@@ -354,3 +384,17 @@
 
     assert_node(toctree2,
                 bullet_list, list_item, compact_paragraph, reference, "baz")
+
+
+@pytest.mark.sphinx('xml', testroot='toctree-index')
+def test_toctree_index(app):
+    app.build()
+    toctree = app.env.tocs'index'
+    assert_node(toctree,
+                bullet_list, (list_item, (compact_paragraph,  # 00
+                                            bullet_list, (addnodes.toctree,  # 010
+                                                           addnodes.toctree))))  # 011
+    assert_node(toctree011, addnodes.toctree,
+                caption="Indices", glob=False, hidden=False,
+                titlesonly=False, maxdepth=-1, numbered=0,
+                entries=(None, 'genindex'), (None, 'modindex'), (None, 'search'))

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_errors.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_errors.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_events.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_events.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_events
-    ~~~~~~~~~~~
-
-    Test the EventManager class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the EventManager class."""
 
 import pytest
 
@@ -19,7 +11,7 @@
     events = EventManager(object())  # pass an dummy object as an app
     events.connect('builder-inited', lambda app: result.append(1), priority = 500)
     events.connect('builder-inited', lambda app: result.append(2), priority = 500)
-    events.connect('builder-inited', lambda app: result.append(3), priority = 200)  # eariler
+    events.connect('builder-inited', lambda app: result.append(3), priority = 200)  # earlier
     events.connect('builder-inited', lambda app: result.append(4), priority = 700)  # later
     events.connect('builder-inited', lambda app: result.append(5), priority = 500)
 
@@ -27,11 +19,16 @@
     assert result == 3, 1, 2, 5, 4
 
 
+class FakeApp:
+    def __init__(self, pdb: bool = False):
+        self.pdb = pdb
+
+
 def test_event_allowed_exceptions():
     def raise_error(app):
         raise RuntimeError
 
-    events = EventManager(object())  # pass an dummy object as an app
+    events = EventManager(FakeApp())  # pass an dummy object as an app
     events.connect('builder-inited', raise_error, priority=500)
 
     # all errors are converted to ExtensionError
@@ -41,3 +38,19 @@
     # Allow RuntimeError (pass-through)
     with pytest.raises(RuntimeError):
         events.emit('builder-inited', allowed_exceptions=(RuntimeError,))
+
+
+def test_event_pdb():
+    def raise_error(app):
+        raise RuntimeError
+
+    events = EventManager(FakeApp(pdb=True))  # pass an dummy object as an app
+    events.connect('builder-inited', raise_error, priority=500)
+
+    # errors aren't converted
+    with pytest.raises(RuntimeError):
+        events.emit('builder-inited')
+
+    # Allow RuntimeError (pass-through)
+    with pytest.raises(RuntimeError):
+        events.emit('builder-inited', allowed_exceptions=(RuntimeError,))

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_apidoc.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_apidoc.py Changed

@@ -1,17 +1,10 @@
-"""
-    test_apidoc
-    ~~~~~~~~~~~
-
-    Test the sphinx.apidoc module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.apidoc module."""
 
 from collections import namedtuple
 
 import pytest
 
+import sphinx.ext.apidoc
 from sphinx.ext.apidoc import main as apidoc_main
 from sphinx.testing.path import path
 
@@ -27,20 +20,15 @@
     return namedtuple('apidoc', 'coderoot,outdir')(coderoot, outdir)
 
 
-@pytest.fixture
+@pytest.fixture()
 def apidoc_params(request):
-    if hasattr(request.node, 'iter_markers'):  # pytest-3.6.0 or newer
-        markers = request.node.iter_markers("apidoc")
-    else:
-        markers = request.node.get_marker("apidoc")
     pargs = {}
     kwargs = {}
 
-    if markers is not None:
-        for info in reversed(list(markers)):
-            for i, a in enumerate(info.args):
-                pargsi = a
-            kwargs.update(info.kwargs)
+    for info in reversed(list(request.node.iter_markers("apidoc"))):
+        for i, a in enumerate(info.args):
+            pargsi = a
+        kwargs.update(info.kwargs)
 
     args = pargsi for i in sorted(pargs.keys())
     return args, kwargs
@@ -69,16 +57,16 @@
     assert (outdir / 'a.b.e.rst').isfile()
     assert (outdir / 'a.b.x.rst').isfile()
 
-    with open(outdir / 'a.b.c.rst') as f:
+    with open(outdir / 'a.b.c.rst', encoding='utf-8') as f:
         rst = f.read()
         assert "automodule:: a.b.c.d\n" in rst
         assert "automodule:: a.b.c\n" in rst
 
-    with open(outdir / 'a.b.e.rst') as f:
+    with open(outdir / 'a.b.e.rst', encoding='utf-8') as f:
         rst = f.read()
         assert "automodule:: a.b.e.f\n" in rst
 
-    with open(outdir / 'a.b.x.rst') as f:
+    with open(outdir / 'a.b.x.rst', encoding='utf-8') as f:
         rst = f.read()
         assert "automodule:: a.b.x.y\n" in rst
         assert "automodule:: a.b.x\n" not in rst
@@ -93,15 +81,15 @@
     assert (builddir / 'a.b.e.txt').isfile()
     assert (builddir / 'a.b.x.txt').isfile()
 
-    with open(builddir / 'a.b.c.txt') as f:
+    with open(builddir / 'a.b.c.txt', encoding='utf-8') as f:
         txt = f.read()
         assert "a.b.c package\n" in txt
 
-    with open(builddir / 'a.b.e.txt') as f:
+    with open(builddir / 'a.b.e.txt', encoding='utf-8') as f:
         txt = f.read()
         assert "a.b.e.f module\n" in txt
 
-    with open(builddir / 'a.b.x.txt') as f:
+    with open(builddir / 'a.b.x.txt', encoding='utf-8') as f:
         txt = f.read()
         assert "a.b.x namespace\n" in txt
 
@@ -119,15 +107,15 @@
     assert (outdir / 'a.b.x.rst').isfile()
     assert (outdir / 'a.b.x.y.rst').isfile()
 
-    with open(outdir / 'a.b.c.rst') as f:
+    with open(outdir / 'a.b.c.rst', encoding='utf-8') as f:
         rst = f.read()
         assert ".. toctree::\n   :maxdepth: 4\n\n   a.b.c.d\n" in rst
 
-    with open(outdir / 'a.b.e.rst') as f:
+    with open(outdir / 'a.b.e.rst', encoding='utf-8') as f:
         rst = f.read()
         assert ".. toctree::\n   :maxdepth: 4\n\n   a.b.e.f\n" in rst
 
-    with open(outdir / 'a.b.x.rst') as f:
+    with open(outdir / 'a.b.x.rst', encoding='utf-8') as f:
         rst = f.read()
         assert ".. toctree::\n   :maxdepth: 4\n\n   a.b.x.y\n" in rst
 
@@ -143,15 +131,15 @@
     assert (builddir / 'a.b.x.txt').isfile()
     assert (builddir / 'a.b.x.y.txt').isfile()
 
-    with open(builddir / 'a.b.c.txt') as f:
+    with open(builddir / 'a.b.c.txt', encoding='utf-8') as f:
         txt = f.read()
         assert "a.b.c package\n" in txt
 
-    with open(builddir / 'a.b.e.f.txt') as f:
+    with open(builddir / 'a.b.e.f.txt', encoding='utf-8') as f:
         txt = f.read()
         assert "a.b.e.f module\n" in txt
 
-    with open(builddir / 'a.b.x.txt') as f:
+    with open(builddir / 'a.b.x.txt', encoding='utf-8') as f:
         txt = f.read()
         assert "a.b.x namespace\n" in txt
 
@@ -177,7 +165,7 @@
     assert (outdir / 'c.rst').isfile()
     assert not (outdir / 'x.rst').exists()
 
-    with open(outdir / 'c.rst') as f:
+    with open(outdir / 'c.rst', encoding='utf-8') as f:
         rst = f.read()
         assert "c package\n" in rst
         assert "automodule:: c.d\n" in rst
@@ -202,7 +190,7 @@
     print(app._warning.getvalue())
 
     builddir = outdir / '_build' / 'text'
-    with open(builddir / 'package_.txt') as f:
+    with open(builddir / 'package_.txt', encoding='utf-8') as f:
         rst = f.read()
         assert "package_ package\n" in rst
         assert "package_.module_ module\n" in rst
@@ -283,7 +271,7 @@
     assert (outdir / 'conf.py').isfile()
     assert (outdir / 'index.rst').isfile()
 
-    conf_py = (outdir / 'conf.py').read_text()
+    conf_py = (outdir / 'conf.py').read_text(encoding='utf8')
     assert "project = 'プロジェクト名'" in conf_py
     assert "author = '著者名'" in conf_py
     assert "version = 'バージョン'" in conf_py
@@ -303,7 +291,7 @@
     outdir = apidoc.outdir
     assert (outdir / 'conf.py').isfile()
 
-    with open(outdir / 'conf.py') as f:
+    with open(outdir / 'conf.py', encoding='utf-8') as f:
         rst = f.read()
         assert "sphinx.ext.mathjax" in rst
 
@@ -330,7 +318,7 @@
         if ref and ref0 in (':', '#'):
             continue
         found_refs.append(ref)
-        filename = "{}.rst".format(ref)
+        filename = f"{ref}.rst"
         if not (outdir / filename).isfile():
             missing_files.append(filename)
 
@@ -359,7 +347,7 @@
     for ref in refs:
         if ref and ref0 in (':', '#'):
             continue
-        filename = "{}.rst".format(ref)
+        filename = f"{ref}.rst"
         found_refs.append(ref)
         if not (outdir / filename).isfile():
             missing_files.append(filename)
@@ -371,7 +359,7 @@
 
 def extract_toc(path):
     """Helper: Extract toc section from package rst file"""
-    with open(path) as f:
+    with open(path, encoding='utf-8') as f:
         rst = f.read()
 
     # Read out the part containing the toctree
@@ -387,7 +375,7 @@
 
 @pytest.mark.apidoc(
     coderoot='test-apidoc-subpackage-in-toc',
-    options='--separate'
+    options='--separate',
 )
 def test_subpackage_in_toc(make_app, apidoc):
     """Make sure that empty subpackages with non-empty subpackages in them
@@ -397,12 +385,12 @@
     assert (outdir / 'conf.py').isfile()
 
     assert (outdir / 'parent.rst').isfile()
-    with open(outdir / 'parent.rst') as f:
+    with open(outdir / 'parent.rst', encoding='utf-8') as f:
         parent = f.read()
     assert 'parent.child' in parent
 
     assert (outdir / 'parent.child.rst').isfile()
-    with open(outdir / 'parent.child.rst') as f:
+    with open(outdir / 'parent.child.rst', encoding='utf-8') as f:
         parent_child = f.read()
     assert 'parent.child.foo' in parent_child
 
@@ -410,31 +398,31 @@
 
 
 def test_private(tempdir):
-    (tempdir / 'hello.py').write_text('')
-    (tempdir / '_world.py').write_text('')
+    (tempdir / 'hello.py').write_text('', encoding='utf8')
+    (tempdir / '_world.py').write_text('', encoding='utf8')
 
     # without --private option
     apidoc_main('-o', tempdir, tempdir)
     assert (tempdir / 'hello.rst').exists()
-    assert ':private-members:' not in (tempdir / 'hello.rst').read_text()
+    assert ':private-members:' not in (tempdir / 'hello.rst').read_text(encoding='utf8')
     assert not (tempdir / '_world.rst').exists()
 
     # with --private option
     apidoc_main('--private', '-f', '-o', tempdir, tempdir)
     assert (tempdir / 'hello.rst').exists()
-    assert ':private-members:' in (tempdir / 'hello.rst').read_text()
+    assert ':private-members:' in (tempdir / 'hello.rst').read_text(encoding='utf8')
     assert (tempdir / '_world.rst').exists()
 
 
 def test_toc_file(tempdir):
     outdir = path(tempdir)
     (outdir / 'module').makedirs()
-    (outdir / 'example.py').write_text('')
-    (outdir / 'module' / 'example.py').write_text('')
+    (outdir / 'example.py').write_text('', encoding='utf8')
+    (outdir / 'module' / 'example.py').write_text('', encoding='utf8')
     apidoc_main('-o', tempdir, tempdir)
     assert (outdir / 'modules.rst').exists()
 
-    content = (outdir / 'modules.rst').read_text()
+    content = (outdir / 'modules.rst').read_text(encoding='utf8')
     assert content == ("test_toc_file0\n"
                        "==============\n"
                        "\n"
@@ -446,11 +434,11 @@
 
 def test_module_file(tempdir):
     outdir = path(tempdir)
-    (outdir / 'example.py').write_text('')
+    (outdir / 'example.py').write_text('', encoding='utf8')
     apidoc_main('-o', tempdir, tempdir)
     assert (outdir / 'example.rst').exists()
 
-    content = (outdir / 'example.rst').read_text()
+    content = (outdir / 'example.rst').read_text(encoding='utf8')
     assert content == ("example module\n"
                        "==============\n"
                        "\n"
@@ -462,11 +450,11 @@
 
 def test_module_file_noheadings(tempdir):
     outdir = path(tempdir)
-    (outdir / 'example.py').write_text('')
+    (outdir / 'example.py').write_text('', encoding='utf8')
     apidoc_main('--no-headings', '-o', tempdir, tempdir)
     assert (outdir / 'example.rst').exists()
 
-    content = (outdir / 'example.rst').read_text()
+    content = (outdir / 'example.rst').read_text(encoding='utf8')
     assert content == (".. automodule:: example\n"
                        "   :members:\n"
                        "   :undoc-members:\n"
@@ -476,16 +464,16 @@
 def test_package_file(tempdir):
     outdir = path(tempdir)
     (outdir / 'testpkg').makedirs()
-    (outdir / 'testpkg' / '__init__.py').write_text('')
-    (outdir / 'testpkg' / 'hello.py').write_text('')
-    (outdir / 'testpkg' / 'world.py').write_text('')
+    (outdir / 'testpkg' / '__init__.py').write_text('', encoding='utf8')
+    (outdir / 'testpkg' / 'hello.py').write_text('', encoding='utf8')
+    (outdir / 'testpkg' / 'world.py').write_text('', encoding='utf8')
     (outdir / 'testpkg' / 'subpkg').makedirs()
-    (outdir / 'testpkg' / 'subpkg' / '__init__.py').write_text('')
+    (outdir / 'testpkg' / 'subpkg' / '__init__.py').write_text('', encoding='utf8')
     apidoc_main('-o', tempdir, tempdir / 'testpkg')
     assert (outdir / 'testpkg.rst').exists()
     assert (outdir / 'testpkg.subpkg.rst').exists()
 
-    content = (outdir / 'testpkg.rst').read_text()
+    content = (outdir / 'testpkg.rst').read_text(encoding='utf8')
     assert content == ("testpkg package\n"
                        "===============\n"
                        "\n"
@@ -524,7 +512,7 @@
                        "   :undoc-members:\n"
                        "   :show-inheritance:\n")
 
-    content = (outdir / 'testpkg.subpkg.rst').read_text()
+    content = (outdir / 'testpkg.subpkg.rst').read_text(encoding='utf8')
     assert content == ("testpkg.subpkg package\n"
                        "======================\n"
                        "\n"
@@ -540,13 +528,13 @@
 def test_package_file_separate(tempdir):
     outdir = path(tempdir)
     (outdir / 'testpkg').makedirs()
-    (outdir / 'testpkg' / '__init__.py').write_text('')
-    (outdir / 'testpkg' / 'example.py').write_text('')
+    (outdir / 'testpkg' / '__init__.py').write_text('', encoding='utf8')
+    (outdir / 'testpkg' / 'example.py').write_text('', encoding='utf8')
     apidoc_main('--separate', '-o', tempdir, tempdir / 'testpkg')
     assert (outdir / 'testpkg.rst').exists()
     assert (outdir / 'testpkg.example.rst').exists()
 
-    content = (outdir / 'testpkg.rst').read_text()
+    content = (outdir / 'testpkg.rst').read_text(encoding='utf8')
     assert content == ("testpkg package\n"
                        "===============\n"
                        "\n"
@@ -566,7 +554,7 @@
                        "   :undoc-members:\n"
                        "   :show-inheritance:\n")
 
-    content = (outdir / 'testpkg.example.rst').read_text()
+    content = (outdir / 'testpkg.example.rst').read_text(encoding='utf8')
     assert content == ("testpkg.example module\n"
                        "======================\n"
                        "\n"
@@ -579,11 +567,11 @@
 def test_package_file_module_first(tempdir):
     outdir = path(tempdir)
     (outdir / 'testpkg').makedirs()
-    (outdir / 'testpkg' / '__init__.py').write_text('')
-    (outdir / 'testpkg' / 'example.py').write_text('')
+    (outdir / 'testpkg' / '__init__.py').write_text('', encoding='utf8')
+    (outdir / 'testpkg' / 'example.py').write_text('', encoding='utf8')
     apidoc_main('--module-first', '-o', tempdir, tempdir)
 
-    content = (outdir / 'testpkg.rst').read_text()
+    content = (outdir / 'testpkg.rst').read_text(encoding='utf8')
     assert content == ("testpkg package\n"
                        "===============\n"
                        "\n"
@@ -607,11 +595,11 @@
 def test_package_file_without_submodules(tempdir):
     outdir = path(tempdir)
     (outdir / 'testpkg').makedirs()
-    (outdir / 'testpkg' / '__init__.py').write_text('')
+    (outdir / 'testpkg' / '__init__.py').write_text('', encoding='utf8')
     apidoc_main('-o', tempdir, tempdir / 'testpkg')
     assert (outdir / 'testpkg.rst').exists()
 
-    content = (outdir / 'testpkg.rst').read_text()
+    content = (outdir / 'testpkg.rst').read_text(encoding='utf8')
     assert content == ("testpkg package\n"
                        "===============\n"
                        "\n"
@@ -627,11 +615,11 @@
 def test_namespace_package_file(tempdir):
     outdir = path(tempdir)
     (outdir / 'testpkg').makedirs()
-    (outdir / 'testpkg' / 'example.py').write_text('')
+    (outdir / 'testpkg' / 'example.py').write_text('', encoding='utf8')
     apidoc_main('--implicit-namespace', '-o', tempdir, tempdir / 'testpkg')
     assert (outdir / 'testpkg.rst').exists()
 
-    content = (outdir / 'testpkg.rst').read_text()
+    content = (outdir / 'testpkg.rst').read_text(encoding='utf8')
     assert content == ("testpkg namespace\n"
                        "=================\n"
                        "\n"
@@ -647,3 +635,31 @@
                        "   :members:\n"
                        "   :undoc-members:\n"
                        "   :show-inheritance:\n")
+
+
+def test_no_duplicates(rootdir, tempdir):
+    """Make sure that a ".pyx" and ".so" don't cause duplicate listings.
+
+    We can't use pytest.mark.apidoc here as we use a different set of arguments
+    to apidoc_main
+    """
+
+    original_suffixes = sphinx.ext.apidoc.PY_SUFFIXES
+    try:
+        # Ensure test works on Windows
+        sphinx.ext.apidoc.PY_SUFFIXES += ('.so',)
+
+        package = rootdir / 'test-apidoc-duplicates' / 'fish_licence'
+        outdir = tempdir / 'out'
+        apidoc_main('-o', outdir, "-T", package, "--implicit-namespaces")
+
+        # Ensure the module has been documented
+        assert (outdir / 'fish_licence.rst').isfile()
+
+        # Ensure the submodule only appears once
+        text = (outdir / 'fish_licence.rst').read_text(encoding="utf-8")
+        count_submodules = text.count(r'fish\_licence.halibut module')
+        assert count_submodules == 1
+
+    finally:
+        sphinx.ext.apidoc.PY_SUFFIXES = original_suffixes

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc.py Changed

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc
-    ~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys
@@ -19,7 +14,7 @@
 from sphinx import addnodes
 from sphinx.ext.autodoc import ALL, ModuleLevelDocumenter, Options
 from sphinx.ext.autodoc.directive import DocumenterBridge, process_documenter_options
-from sphinx.testing.util import SphinxTestApp, Struct  # NOQA
+from sphinx.testing.util import SphinxTestApp, Struct  # noqa: F401
 from sphinx.util.docutils import LoggingReporter
 
 try:
@@ -83,6 +78,7 @@
     processed_signatures.append((what, name))
     if name == 'bar':
         return '42', None
+    return None
 
 
 def skip_member(app, what, name, obj, skip, options):
@@ -92,6 +88,7 @@
         return True
     if name == 'skipmeth':
         return True
+    return None
 
 
 def test_parse_name(app):
@@ -228,13 +225,13 @@
     directive.env.config.autoclass_content = 'both'
 
     class F2:
-        '''some docstring for F2.'''
+        """some docstring for F2."""
         def __init__(self, *args, **kw):
-            '''
+            """
             __init__(a1, a2, kw1=True, kw2=False)
 
             some docstring for __init__.
-            '''
+            """
     class G2(F2):
         pass
 
@@ -368,7 +365,7 @@
 
     # verify that method docstrings get extracted in both normal case
     # and in case of bound method posing as a function
-    class J:  # NOQA
+    class J:
         def foo(self):
             """Method docstring"""
     assert getdocl('method', J.foo) == 'Method docstring'
@@ -537,7 +534,7 @@
         '   :synopsis: Synopsis',
         '   :platform: Platform',
         '   :deprecated:',
-        ''
+        '',
     
 
 
@@ -554,9 +551,10 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
+        '   .. py:attribute:: Base.inheritedattr',
         '   .. py:method:: Base.inheritedclassmeth()',
         '   .. py:method:: Base.inheritedmeth()',
-        '   .. py:method:: Base.inheritedstaticmeth(cls)'
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
     
 
     # default specific-members
@@ -565,7 +563,7 @@
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
         '   .. py:method:: Base.inheritedmeth()',
-        '   .. py:method:: Base.inheritedstaticmeth(cls)'
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
     
 
     # ALL-members override autodoc_default_options
@@ -574,9 +572,10 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
+        '   .. py:attribute:: Base.inheritedattr',
         '   .. py:method:: Base.inheritedclassmeth()',
         '   .. py:method:: Base.inheritedmeth()',
-        '   .. py:method:: Base.inheritedstaticmeth(cls)'
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
     
 
     # members override autodoc_default_options
@@ -595,7 +594,7 @@
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
         '   .. py:method:: Base.inheritedmeth()',
-        '   .. py:method:: Base.inheritedstaticmeth(cls)'
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
     
 
 
@@ -606,7 +605,8 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
-        '   .. py:method:: Base.inheritedclassmeth()'
+        '   .. py:attribute:: Base.inheritedattr',
+        '   .. py:method:: Base.inheritedclassmeth()',
     
 
     # members vs exclude-members
@@ -623,7 +623,8 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
-        '   .. py:method:: Base.inheritedclassmeth()'
+        '   .. py:attribute:: Base.inheritedattr',
+        '   .. py:method:: Base.inheritedclassmeth()',
     
 
     # exclude-members overrides autodoc_default_options
@@ -633,8 +634,9 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
+        '   .. py:attribute:: Base.inheritedattr',
         '   .. py:method:: Base.inheritedclassmeth()',
-        '   .. py:method:: Base.inheritedstaticmeth(cls)'
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
     
 
     # exclude-members extends autodoc_default_options
@@ -644,6 +646,7 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
+        '   .. py:attribute:: Base.inheritedattr',
         '   .. py:method:: Base.inheritedclassmeth()',
     
 
@@ -653,6 +656,7 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
+        '   .. py:attribute:: Base.inheritedattr',
         '   .. py:method:: Base.inheritedclassmeth()',
     
 
@@ -663,9 +667,10 @@
     actual = do_autodoc(app, 'class', 'target.inheritance.Base', options)
     assert list(filter(lambda l: '::' in l, actual)) == 
         '.. py:class:: Base()',
+        '   .. py:attribute:: Base.inheritedattr',
         '   .. py:method:: Base.inheritedclassmeth()',
         '   .. py:method:: Base.inheritedmeth()',
-        '   .. py:method:: Base.inheritedstaticmeth(cls)'
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
     
 
 
@@ -689,7 +694,7 @@
         '   .. py:attribute:: Class.skipattr',
         '   .. py:method:: Class.skipmeth()',
         '   .. py:attribute:: Class.udocattr',
-        '   .. py:method:: Class.undocmeth()'
+        '   .. py:method:: Class.undocmeth()',
     
 
     # use autodoc_default_options
@@ -711,7 +716,7 @@
         '   .. py:attribute:: Class.skipattr',
         '   .. py:method:: Class.skipmeth()',
         '   .. py:attribute:: Class.udocattr',
-        '   .. py:method:: Class.undocmeth()'
+        '   .. py:method:: Class.undocmeth()',
     
 
     # options negation work check
@@ -805,7 +810,7 @@
                "imported-members": None,
                "ignore-module-all": None}
     actual = do_autodoc(app, 'module', 'target', options)
-    assert '.. py:function:: save_traceback(app: Sphinx) -> str' in actual
+    assert '.. py:function:: function_to_be_imported(app: Sphinx | None) -> str' in actual
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
@@ -860,7 +865,7 @@
         '   .. py:attribute:: Class.skipattr',
         '   .. py:method:: Class.skipmeth()',
         '   .. py:attribute:: Class.udocattr',
-        '   .. py:method:: Class.undocmeth()'
+        '   .. py:method:: Class.undocmeth()',
     
 
     # specific special methods from autodoc_default_options
@@ -916,7 +921,7 @@
         '.. py:class:: InstAttCls()',
         '.. py:class:: Outer()',
         '   .. py:class:: Outer.Inner()',
-        '.. py:class:: StrRepr'
+        '.. py:class:: StrRepr',
     
 
 
@@ -928,7 +933,7 @@
         '',
         '.. py:module:: target',
         '   :noindex:',
-        ''
+        '',
     
 
     # TODO: :noindex: should be propagated to children of target item.
@@ -939,7 +944,7 @@
         '.. py:class:: Base()',
         '   :noindex:',
         '   :module: target.inheritance',
-        ''
+        '',
     
 
 
@@ -984,7 +989,7 @@
         '   .. py:attribute:: Outer.factory',
         '      :module: target',
         '',
-        '      alias of :py:class:`dict`'
+        '      alias of :py:class:`dict`',
     
 
     actual = do_autodoc(app, 'class', 'target.Outer.Inner', options)
@@ -1009,7 +1014,7 @@
         '',
         '.. py:class:: InnerChild()',
         '   :module: target', '',
-        '   Bases: :py:class:`target.Outer.Inner`',
+        '   Bases: :py:class:`~target.Outer.Inner`',
         '',
         '   InnerChild docstring',
         '',
@@ -1065,12 +1070,10 @@
         '      :module: target.descriptor',
         '',
         '      Property.',
-        ''
+        '',
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8),
-                    reason='cached_property is available since python3.8.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodoc_cached_property(app):
     options = {"members": None,
@@ -1086,6 +1089,11 @@
         '      :module: target.cached_property',
         '      :type: int',
         '',
+        '',
+        '   .. py:property:: Foo.prop_with_type_comment',
+        '      :module: target.cached_property',
+        '      :type: int',
+        '',
     
 
 
@@ -1113,7 +1121,7 @@
         '   .. py:attribute:: Class.inst_attr_inline',
         '   .. py:attribute:: Class.inst_attr_comment',
         '   .. py:attribute:: Class.inst_attr_string',
-        '   .. py:attribute:: Class._private_inst_attr'
+        '   .. py:attribute:: Class._private_inst_attr',
     
 
     # case member-order='groupwise'
@@ -1138,7 +1146,7 @@
         '   .. py:attribute:: Class.inst_attr_string',
         '   .. py:attribute:: Class.mdocattr',
         '   .. py:attribute:: Class.skipattr',
-        '   .. py:attribute:: Class.udocattr'
+        '   .. py:attribute:: Class.udocattr',
     
 
     # case member-order=None
@@ -1162,7 +1170,7 @@
         '   .. py:attribute:: Class.skipattr',
         '   .. py:method:: Class.skipmeth()',
         '   .. py:attribute:: Class.udocattr',
-        '   .. py:method:: Class.undocmeth()'
+        '   .. py:method:: Class.undocmeth()',
     
 
 
@@ -1250,7 +1258,7 @@
         '   .. py:attribute:: AttCls.a2',
         '      :module: target',
         '      :value: None',
-        ''
+        '',
     
 
 
@@ -1298,7 +1306,7 @@
         '      :module: target',
         '',
         '      Docstring for instance attribute InstAttCls.ia2.',
-        ''
+        '',
     
 
     # pick up arbitrary attributes
@@ -1324,7 +1332,7 @@
         '      :module: target',
         '',
         '      Doc comment for instance attribute InstAttCls.ia1',
-        ''
+        '',
     
 
 
@@ -1337,7 +1345,7 @@
         '   :module: target',
         '',
         '   Doc comment for instance attribute InstAttCls.ia1',
-        ''
+        '',
     
 
 
@@ -1401,7 +1409,10 @@
     options = {"members": None}
     actual = do_autodoc(app, 'class', 'target.enums.EnumCls', options)
 
-    if sys.version_info > (3, 11):
+    if sys.version_info:2 >= (3, 12):
+        args = ('(value, names=None, *values, module=None, '
+                'qualname=None, type=None, start=1, boundary=None)')
+    elif sys.version_info:2 >= (3, 11):
         args = ('(value, names=None, *, module=None, qualname=None, '
                 'type=None, start=1, boundary=None)')
     else:
@@ -1459,7 +1470,7 @@
         '   :value: 12',
         '',
         '   doc for val1',
-        ''
+        '',
     
 
 
@@ -1606,7 +1617,7 @@
     assert list(actual) == 
         '',
         '.. py:module:: target.imported_members',
-        ''
+        '',
     
 
 
@@ -1705,7 +1716,7 @@
         '.. py:attribute:: Alias',
         '   :module: target.typed_vars',
         '',
-        '   alias of :py:class:`target.typed_vars.Derived`',
+        '   alias of :py:class:`~target.typed_vars.Derived`',
         '',
         '.. py:class:: Class()',
         '   :module: target.typed_vars',
@@ -1857,70 +1868,40 @@
     options = {"members": None,
                "undoc-members": None}
     actual = do_autodoc(app, 'module', 'target.genericalias', options)
-    if sys.version_info < (3, 7):
-        assert list(actual) == 
-            '',
-            '.. py:module:: target.genericalias',
-            '',
-            '',
-            '.. py:class:: Class()',
-            '   :module: target.genericalias',
-            '',
-            '',
-            '   .. py:attribute:: Class.T',
-            '      :module: target.genericalias',
-            '',
-            '      A list of int',
-            '',
-            '      alias of :py:class:`~typing.List`\\ :py:class:`int`',
-            '',
-            '.. py:attribute:: L',
-            '   :module: target.genericalias',
-            '',
-            '   A list of Class',
-            '',
-            '',
-            '.. py:attribute:: T',
-            '   :module: target.genericalias',
-            '',
-            '   A list of int',
-            '',
-        
-    else:
-        assert list(actual) == 
-            '',
-            '.. py:module:: target.genericalias',
-            '',
-            '',
-            '.. py:class:: Class()',
-            '   :module: target.genericalias',
-            '',
-            '',
-            '   .. py:attribute:: Class.T',
-            '      :module: target.genericalias',
-            '',
-            '      A list of int',
-            '',
-            '      alias of :py:class:`~typing.List`\\ :py:class:`int`',
-            '',
-            '',
-            '.. py:data:: L',
-            '   :module: target.genericalias',
-            '',
-            '   A list of Class',
-            '',
-            '   alias of :py:class:`~typing.List`\\ '
-            ':py:class:`target.genericalias.Class`',
-            '',
-            '',
-            '.. py:data:: T',
-            '   :module: target.genericalias',
-            '',
-            '   A list of int',
-            '',
-            '   alias of :py:class:`~typing.List`\\ :py:class:`int`',
-            '',
-        
+    assert list(actual) == 
+        '',
+        '.. py:module:: target.genericalias',
+        '',
+        '',
+        '.. py:class:: Class()',
+        '   :module: target.genericalias',
+        '',
+        '',
+        '   .. py:attribute:: Class.T',
+        '      :module: target.genericalias',
+        '',
+        '      A list of int',
+        '',
+        '      alias of :py:class:`~typing.List`\\ :py:class:`int`',
+        '',
+        '',
+        '.. py:data:: L',
+        '   :module: target.genericalias',
+        '',
+        '   A list of Class',
+        '',
+        '   alias of :py:class:`~typing.List`\\ '
+        ':py:class:`~target.genericalias.Class`',
+        '',
+        '',
+        '.. py:data:: T',
+        '   :module: target.genericalias',
+        '',
+        '   A list of int',
+        '',
+        '   alias of :py:class:`~typing.List`\\ :py:class:`int`',
+        '',
+    
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
@@ -1937,7 +1918,7 @@
         '   :module: target.typevar',
         '',
         '',
-        '   .. py:attribute:: Class.T1',
+        '   .. py:class:: Class.T1',
         '      :module: target.typevar',
         '',
         '      T1',
@@ -1945,15 +1926,15 @@
         "      alias of TypeVar('T1')",
         '',
         '',
-        '   .. py:attribute:: Class.T6',
+        '   .. py:class:: Class.T6',
         '      :module: target.typevar',
         '',
         '      T6',
         '',
-        '      alias of :py:class:`datetime.date`',
+        '      alias of :py:class:`~datetime.date`',
         '',
         '',
-        '.. py:data:: T1',
+        '.. py:class:: T1',
         '   :module: target.typevar',
         '',
         '   T1',
@@ -1961,7 +1942,7 @@
         "   alias of TypeVar('T1')",
         '',
         '',
-        '.. py:data:: T3',
+        '.. py:class:: T3',
         '   :module: target.typevar',
         '',
         '   T3',
@@ -1969,7 +1950,7 @@
         "   alias of TypeVar('T3', int, str)",
         '',
         '',
-        '.. py:data:: T4',
+        '.. py:class:: T4',
         '   :module: target.typevar',
         '',
         '   T4',
@@ -1977,7 +1958,7 @@
         "   alias of TypeVar('T4', covariant=True)",
         '',
         '',
-        '.. py:data:: T5',
+        '.. py:class:: T5',
         '   :module: target.typevar',
         '',
         '   T5',
@@ -1985,15 +1966,15 @@
         "   alias of TypeVar('T5', contravariant=True)",
         '',
         '',
-        '.. py:data:: T6',
+        '.. py:class:: T6',
         '   :module: target.typevar',
         '',
         '   T6',
         '',
-        '   alias of :py:class:`datetime.date`',
+        '   alias of :py:class:`~datetime.date`',
         '',
         '',
-        '.. py:data:: T7',
+        '.. py:class:: T7',
         '   :module: target.typevar',
         '',
         '   T7',
@@ -2003,7 +1984,7 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason='py39+ is required.')
+@pytest.mark.skipif(sys.version_info:2 <= (3, 8), reason='py39+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodoc_Annotated(app):
     options = {"members": None}
@@ -2042,29 +2023,6 @@
     
 
 
-@pytest.mark.sphinx('html', testroot='pycode-egg')
-def test_autodoc_for_egged_code(app):
-    options = {"members": None,
-               "undoc-members": None}
-    actual = do_autodoc(app, 'module', 'sample', options)
-    assert list(actual) == 
-        '',
-        '.. py:module:: sample',
-        '',
-        '',
-        '.. py:data:: CONSTANT',
-        '   :module: sample',
-        '   :value: 1',
-        '',
-        '   constant on sample.py',
-        '',
-        '',
-        '.. py:function:: hello(s)',
-        '   :module: sample',
-        ''
-    
-
-
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_singledispatch(app):
     options = {"members": None}
@@ -2078,6 +2036,7 @@
         '                 func(arg: float, kwarg=None)',
         '                 func(arg: int, kwarg=None)',
         '                 func(arg: str, kwarg=None)',
+        '                 func(arg: dict, kwarg=None)',
         '   :module: target.singledispatch',
         '',
         '   A function for general use.',
@@ -2085,8 +2044,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8),
-                    reason='singledispatchmethod is available since python3.8')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_singledispatchmethod(app):
     options = {"members": None}
@@ -2106,6 +2063,7 @@
         '                  Foo.meth(arg: float, kwarg=None)',
         '                  Foo.meth(arg: int, kwarg=None)',
         '                  Foo.meth(arg: str, kwarg=None)',
+        '                  Foo.meth(arg: dict, kwarg=None)',
         '      :module: target.singledispatchmethod',
         '',
         '      A method for general use.',
@@ -2113,8 +2071,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8),
-                    reason='singledispatchmethod is available since python3.8')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_singledispatchmethod_automethod(app):
     options = {}
@@ -2125,6 +2081,7 @@
         '               Foo.meth(arg: float, kwarg=None)',
         '               Foo.meth(arg: int, kwarg=None)',
         '               Foo.meth(arg: str, kwarg=None)',
+        '               Foo.meth(arg: dict, kwarg=None)',
         '   :module: target.singledispatchmethod',
         '',
         '   A method for general use.',
@@ -2132,7 +2089,7 @@
     
 
 
-@pytest.mark.skipif(sys.version_info > (3, 11),
+@pytest.mark.skipif(sys.version_info:2 >= (3, 11),
                     reason=('cython does not support python-3.11 yet. '
                             'see https://github.com/cython/cython/issues/4365'))
 @pytest.mark.skipif(pyximport is None, reason='cython is not installed')
@@ -2166,8 +2123,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8),
-                    reason='typing.final is available since python3.8')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_final(app):
     options = {"members": None}
@@ -2322,7 +2277,7 @@
 
 my_name
 
-alias of bug2437.autodoc_dummy_foo.Foo"""
+alias of Foo"""
     assert warning.getvalue() == ''
 
 
@@ -2394,7 +2349,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_type_union_operator(app):
     options = {'members': None}
@@ -2438,7 +2392,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_hide_value(app):
     options = {'members': None}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_autoattribute.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_autoattribute.py Changed

@@ -1,16 +1,9 @@
-"""
-    test_ext_autodoc_autoattribute
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
-import sys
-
 import pytest
 
 from .test_ext_autodoc import do_autodoc
@@ -32,7 +25,7 @@
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_novalue(app):
-    options = {'no-value': True}
+    options = {'no-value': None}
     actual = do_autodoc(app, 'attribute', 'target.Class.attr', options)
     assert list(actual) == 
         '',
@@ -44,7 +37,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_typed_variable(app):
     actual = do_autodoc(app, 'attribute', 'target.typed_vars.Class.attr2')
@@ -57,7 +49,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_typed_variable_in_alias(app):
     actual = do_autodoc(app, 'attribute', 'target.typed_vars.Alias.attr2')
@@ -70,7 +61,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_instance_variable(app):
     actual = do_autodoc(app, 'attribute', 'target.typed_vars.Class.attr4')
@@ -85,7 +75,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_instance_variable_in_alias(app):
     actual = do_autodoc(app, 'attribute', 'target.typed_vars.Alias.attr4')
@@ -150,60 +139,18 @@
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_GenericAlias(app):
     actual = do_autodoc(app, 'attribute', 'target.genericalias.Class.T')
-    if sys.version_info < (3, 7):
-        assert list(actual) == 
-            '',
-            '.. py:attribute:: Class.T',
-            '   :module: target.genericalias',
-            '   :value: typing.Listint',
-            '',
-            '   A list of int',
-            '',
-        
-    else:
-        assert list(actual) == 
-            '',
-            '.. py:attribute:: Class.T',
-            '   :module: target.genericalias',
-            '',
-            '   A list of int',
-            '',
-            '   alias of :py:class:`~typing.List`\\ :py:class:`int`',
-            '',
-        
-
-
-@pytest.mark.sphinx('html', testroot='ext-autodoc')
-def test_autoattribute_NewType(app):
-    actual = do_autodoc(app, 'attribute', 'target.typevar.Class.T6')
-    assert list(actual) == 
-        '',
-        '.. py:attribute:: Class.T6',
-        '   :module: target.typevar',
-        '',
-        '   T6',
-        '',
-        '   alias of :py:class:`datetime.date`',
-        '',
-    
-
-
-@pytest.mark.sphinx('html', testroot='ext-autodoc')
-def test_autoattribute_TypeVar(app):
-    actual = do_autodoc(app, 'attribute', 'target.typevar.Class.T1')
     assert list(actual) == 
         '',
-        '.. py:attribute:: Class.T1',
-        '   :module: target.typevar',
+        '.. py:attribute:: Class.T',
+        '   :module: target.genericalias',
         '',
-        '   T1',
+        '   A list of int',
         '',
-        "   alias of TypeVar('T1')",
+        '   alias of :py:class:`~typing.List`\\ :py:class:`int`',
         '',
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoattribute_hide_value(app):
     actual = do_autodoc(app, 'attribute', 'target.hide_value.Foo.SENTINEL1')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_autoclass.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_autoclass.py Changed

@@ -1,15 +1,11 @@
-"""
-    test_ext_autodoc_autoclass
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
-import sys
+from __future__ import annotations
+
 from typing import List, Union
 
 import pytest
@@ -107,7 +103,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='py36+ is available since python3.6.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_uninitialized_attributes(app):
     options = {"members": None,
@@ -135,7 +130,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='py36+ is available since python3.6.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_undocumented_uninitialized_attributes(app):
     options = {"members": None,
@@ -219,6 +213,13 @@
         '      docstring',
         '',
         '',
+        '   .. py:property:: Foo.prop1_with_type_comment',
+        '      :module: target.properties',
+        '      :type: int',
+        '',
+        '      docstring',
+        '',
+        '',
         '   .. py:property:: Foo.prop2',
         '      :module: target.properties',
         '      :classmethod:',
@@ -226,6 +227,14 @@
         '',
         '      docstring',
         '',
+        '',
+        '   .. py:property:: Foo.prop2_with_type_comment',
+        '      :module: target.properties',
+        '      :classmethod:',
+        '      :type: int',
+        '',
+        '      docstring',
+        '',
     
 
 
@@ -256,7 +265,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_show_inheritance_for_subclass_of_generic_type(app):
     options = {'show-inheritance': None}
@@ -274,7 +282,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_show_inheritance_for_decendants_of_generic_type(app):
     options = {'show-inheritance': None}
@@ -284,7 +291,7 @@
         '.. py:class:: Corge(iterable=(), /)',
         '   :module: target.classes',
         '',
-        '   Bases: :py:class:`target.classes.Quux`',
+        '   Bases: :py:class:`~target.classes.Quux`',
         '',
     
 
@@ -306,28 +313,16 @@
 
     options = {'show-inheritance': None}
     actual = do_autodoc(app, 'class', 'target.classes.Quux', options)
-    if sys.version_info < (3, 7):
-        assert list(actual) == 
-            '',
-            '.. py:class:: Quux(*args, **kwds)',
-            '   :module: target.classes',
-            '',
-            '   Bases: :py:class:`int`, :py:class:`str`',
-            '',
-            '   A subclass of ListUnionint, float',
-            '',
-        
-    else:
-        assert list(actual) == 
-            '',
-            '.. py:class:: Quux(iterable=(), /)',
-            '   :module: target.classes',
-            '',
-            '   Bases: :py:class:`int`, :py:class:`str`',
-            '',
-            '   A subclass of ListUnionint, float',
-            '',
-        
+    assert list(actual) == 
+        '',
+        '.. py:class:: Quux(iterable=(), /)',
+        '   :module: target.classes',
+        '',
+        '   Bases: :py:class:`int`, :py:class:`str`',
+        '',
+        '   A subclass of ListUnionint, float',
+        '',
+    
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
@@ -391,7 +386,7 @@
         '.. py:attribute:: Alias',
         '   :module: target.classes',
         '',
-        '   alias of :py:class:`target.classes.Foo`',
+        '   alias of :py:class:`~target.classes.Foo`',
     
 
 
@@ -459,3 +454,63 @@
         '      A documented coroutine staticmethod',
         '',
     
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_autodata_NewType_module_level(app):
+    actual = do_autodoc(app, 'class', 'target.typevar.T6')
+    assert list(actual) == 
+        '',
+        '.. py:class:: T6',
+        '   :module: target.typevar',
+        '',
+        '   T6',
+        '',
+        '   alias of :py:class:`~datetime.date`',
+        '',
+    
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_autoattribute_NewType_class_level(app):
+    actual = do_autodoc(app, 'class', 'target.typevar.Class.T6')
+    assert list(actual) == 
+        '',
+        '.. py:class:: Class.T6',
+        '   :module: target.typevar',
+        '',
+        '   T6',
+        '',
+        '   alias of :py:class:`~datetime.date`',
+        '',
+    
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_autodata_TypeVar_class_level(app):
+    actual = do_autodoc(app, 'class', 'target.typevar.T1')
+    assert list(actual) == 
+        '',
+        '.. py:class:: T1',
+        '   :module: target.typevar',
+        '',
+        '   T1',
+        '',
+        "   alias of TypeVar('T1')",
+        '',
+    
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_autoattribute_TypeVar_module_level(app):
+    actual = do_autodoc(app, 'class', 'target.typevar.Class.T1')
+    assert list(actual) == 
+        '',
+        '.. py:class:: Class.T1',
+        '   :module: target.typevar',
+        '',
+        '   T1',
+        '',
+        "   alias of TypeVar('T1')",
+        '',
+

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_autodata.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_autodata.py Changed

@@ -1,16 +1,9 @@
-"""
-    test_ext_autodoc_autodata
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
-import sys
-
 import pytest
 
 from .test_ext_autodoc import do_autodoc
@@ -32,7 +25,7 @@
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodata_novalue(app):
-    options = {'no-value': True}
+    options = {'no-value': None}
     actual = do_autodoc(app, 'data', 'target.integer', options)
     assert list(actual) == 
         '',
@@ -44,7 +37,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodata_typed_variable(app):
     actual = do_autodoc(app, 'data', 'target.typed_vars.attr2')
@@ -59,7 +51,6 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodata_type_comment(app):
     actual = do_autodoc(app, 'data', 'target.typed_vars.attr3')
@@ -78,60 +69,18 @@
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodata_GenericAlias(app):
     actual = do_autodoc(app, 'data', 'target.genericalias.T')
-    if sys.version_info < (3, 7):
-        assert list(actual) == 
-            '',
-            '.. py:data:: T',
-            '   :module: target.genericalias',
-            '   :value: typing.Listint',
-            '',
-            '   A list of int',
-            '',
-        
-    else:
-        assert list(actual) == 
-            '',
-            '.. py:data:: T',
-            '   :module: target.genericalias',
-            '',
-            '   A list of int',
-            '',
-            '   alias of :py:class:`~typing.List`\\ :py:class:`int`',
-            '',
-        
-
-
-@pytest.mark.sphinx('html', testroot='ext-autodoc')
-def test_autodata_NewType(app):
-    actual = do_autodoc(app, 'data', 'target.typevar.T6')
-    assert list(actual) == 
-        '',
-        '.. py:data:: T6',
-        '   :module: target.typevar',
-        '',
-        '   T6',
-        '',
-        '   alias of :py:class:`datetime.date`',
-        '',
-    
-
-
-@pytest.mark.sphinx('html', testroot='ext-autodoc')
-def test_autodata_TypeVar(app):
-    actual = do_autodoc(app, 'data', 'target.typevar.T1')
     assert list(actual) == 
         '',
-        '.. py:data:: T1',
-        '   :module: target.typevar',
+        '.. py:data:: T',
+        '   :module: target.genericalias',
         '',
-        '   T1',
+        '   A list of int',
         '',
-        "   alias of TypeVar('T1')",
+        '   alias of :py:class:`~typing.List`\\ :py:class:`int`',
         '',
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 6), reason='python 3.6+ is required.')
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autodata_hide_value(app):
     actual = do_autodoc(app, 'data', 'target.hide_value.SENTINEL1')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_autofunction.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_autofunction.py Changed

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autofunction
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import pytest
@@ -122,6 +117,7 @@
         '                 func(arg: float, kwarg=None)',
         '                 func(arg: int, kwarg=None)',
         '                 func(arg: str, kwarg=None)',
+        '                 func(arg: dict, kwarg=None)',
         '   :module: target.singledispatch',
         '',
         '   A function for general use.',
@@ -162,7 +158,7 @@
     actual = do_autodoc(app, 'function', 'target.wrappedfunction.feeling_good')
     assert list(actual) == 
         '',
-        '.. py:function:: feeling_good(x: int, y: int) -> typing.Generator',
+        '.. py:function:: feeling_good(x: int, y: int) -> ~typing.Generator',
         '   :module: target.wrappedfunction',
         '',
         "   You'll feel better in this context!",

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_automodule.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_automodule.py Changed

@@ -1,12 +1,7 @@
-"""
-    test_ext_autodoc_autocmodule
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
 import sys
@@ -24,7 +19,7 @@
         '',
         '.. py:module:: target.empty_all',
         '',
-        'docsting of empty_all module.',
+        '   docsting of empty_all module.',
         '',
     
 
@@ -118,6 +113,70 @@
     
 
 
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_automodule_inherited_members(app):
+    options = {'members': None,
+               'undoc-members': None,
+               'inherited-members': 'Base, list'}
+    actual = do_autodoc(app, 'module', 'target.inheritance', options)
+    assert list(actual) == 
+        '',
+        '.. py:module:: target.inheritance',
+        '',
+        '',
+        '.. py:class:: Base()',
+        '   :module: target.inheritance',
+        '',
+        '',
+        '   .. py:attribute:: Base.inheritedattr',
+        '      :module: target.inheritance',
+        '      :value: None',
+        '',
+        '      docstring',
+        '',
+        '',
+        '   .. py:method:: Base.inheritedclassmeth()',
+        '      :module: target.inheritance',
+        '      :classmethod:',
+        '',
+        '      Inherited class method.',
+        '',
+        '',
+        '   .. py:method:: Base.inheritedmeth()',
+        '      :module: target.inheritance',
+        '',
+        '      Inherited function.',
+        '',
+        '',
+        '   .. py:method:: Base.inheritedstaticmeth(cls)',
+        '      :module: target.inheritance',
+        '      :staticmethod:',
+        '',
+        '      Inherited static method.',
+        '',
+        '',
+        '.. py:class:: Derived()',
+        '   :module: target.inheritance',
+        '',
+        '',
+        '   .. py:method:: Derived.inheritedmeth()',
+        '      :module: target.inheritance',
+        '',
+        '      Inherited function.',
+        '',
+        '',
+        '.. py:class:: MyList(iterable=(), /)',
+        '   :module: target.inheritance',
+        '',
+        '',
+        '   .. py:method:: MyList.meth()',
+        '      :module: target.inheritance',
+        '',
+        '      docstring',
+        '',
+    
+
+
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
                     confoverrides={'autodoc_mock_imports': 'missing_module',
                                                             'missing_package1',
@@ -130,4 +189,4 @@
 
     options = {'members': None}
     actual = do_autodoc(app, 'module', 'target.need_mocks', options)
-    assert '.. py:class:: Inherited(*args: typing.Any, **kwargs: typing.Any)' in actual
+    assert '.. py:class:: Inherited(*args: ~typing.Any, **kwargs: ~typing.Any)' in actual

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_autoproperty.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_autoproperty.py Changed

@@ -1,16 +1,9 @@
-"""
-    test_ext_autodoc_autoproperty
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly the Documenters; the auto
-    directives are tested in a test source file translated by test_build.
+"""Test the autodoc extension.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+This tests mainly the Documenters; the auto directives are tested in a test
+source file translated by test_build.
 """
 
-import sys
-
 import pytest
 
 from .test_ext_autodoc import do_autodoc
@@ -45,7 +38,35 @@
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_properties_with_type_comment(app):
+    actual = do_autodoc(app, 'property', 'target.properties.Foo.prop1_with_type_comment')
+    assert list(actual) == 
+        '',
+        '.. py:property:: Foo.prop1_with_type_comment',
+        '   :module: target.properties',
+        '   :type: int',
+        '',
+        '   docstring',
+        '',
+    
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_class_properties_with_type_comment(app):
+    actual = do_autodoc(app, 'property', 'target.properties.Foo.prop2_with_type_comment')
+    assert list(actual) == 
+        '',
+        '.. py:property:: Foo.prop2_with_type_comment',
+        '   :module: target.properties',
+        '   :classmethod:',
+        '   :type: int',
+        '',
+        '   docstring',
+        '',
+    
+
+
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_cached_properties(app):
     actual = do_autodoc(app, 'property', 'target.cached_property.Foo.prop')
@@ -56,3 +77,15 @@
         '   :type: int',
         '',
     
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_cached_properties_with_type_comment(app):
+    actual = do_autodoc(app, 'property', 'target.cached_property.Foo.prop_with_type_comment')
+    assert list(actual) == 
+        '',
+        '.. py:property:: Foo.prop_with_type_comment',
+        '   :module: target.cached_property',
+        '   :type: int',
+        '',
+

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_configs.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_configs.py Changed

@@ -1,15 +1,8 @@
-"""
-    test_ext_autodoc_configs
-    ~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly for config variables
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autodoc extension.  This tests mainly for config variables"""
 
 import platform
 import sys
+from contextlib import contextmanager
 
 import pytest
 
@@ -20,6 +13,19 @@
 IS_PYPY = platform.python_implementation() == 'PyPy'
 
 
+@contextmanager
+def overwrite_file(path, content):
+    current_content = path.read_bytes() if path.exists() else None
+    try:
+        path.write_text(content, encoding='utf-8')
+        yield
+    finally:
+        if current_content is not None:
+            path.write_bytes(current_content)
+        else:
+            path.unlink()
+
+
 @pytest.mark.sphinx('html', testroot='ext-autodoc')
 def test_autoclass_content_class(app):
     app.config.autoclass_content = 'class'
@@ -281,7 +287,73 @@
         '',
         '.. py:method:: Derived.inheritedmeth()',
         '   :module: target.inheritance',
-        ''
+        '',
+    
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_autodoc_inherit_docstrings_for_inherited_members(app):
+    options = {"members": None,
+               "inherited-members": None}
+
+    assert app.config.autodoc_inherit_docstrings is True  # default
+    actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options)
+    assert list(actual) == 
+        '',
+        '.. py:class:: Derived()',
+        '   :module: target.inheritance',
+        '',
+        '',
+        '   .. py:attribute:: Derived.inheritedattr',
+        '      :module: target.inheritance',
+        '      :value: None',
+        '',
+        '      docstring',
+        '',
+        '',
+        '   .. py:method:: Derived.inheritedclassmeth()',
+        '      :module: target.inheritance',
+        '      :classmethod:',
+        '',
+        '      Inherited class method.',
+        '',
+        '',
+        '   .. py:method:: Derived.inheritedmeth()',
+        '      :module: target.inheritance',
+        '',
+        '      Inherited function.',
+        '',
+        '',
+        '   .. py:method:: Derived.inheritedstaticmeth(cls)',
+        '      :module: target.inheritance',
+        '      :staticmethod:',
+        '',
+        '      Inherited static method.',
+        '',
+    
+
+    # disable autodoc_inherit_docstrings
+    app.config.autodoc_inherit_docstrings = False
+    actual = do_autodoc(app, 'class', 'target.inheritance.Derived', options)
+    assert list(actual) == 
+        '',
+        '.. py:class:: Derived()',
+        '   :module: target.inheritance',
+        '',
+        '',
+        '   .. py:method:: Derived.inheritedclassmeth()',
+        '      :module: target.inheritance',
+        '      :classmethod:',
+        '',
+        '      Inherited class method.',
+        '',
+        '',
+        '   .. py:method:: Derived.inheritedstaticmeth(cls)',
+        '      :module: target.inheritance',
+        '      :staticmethod:',
+        '',
+        '      Inherited static method.',
+        '',
     
 
 
@@ -475,13 +547,15 @@
         '   :module: target.docstring_signature',
         '',
         '',
-        '.. py:class:: E(foo: int, bar: int, baz: int) -> None',
-        '              E(foo: str, bar: str, baz: str) -> None',
+        '.. py:class:: E(foo: int, bar: int, baz: int)',
+        '              E(foo: str, bar: str, baz: str)',
+        '              E(foo: float, bar: float, baz: float)',
         '   :module: target.docstring_signature',
         '',
         '',
-        '.. py:class:: F(foo: int, bar: int, baz: int) -> None',
-        '              F(foo: str, bar: str, baz: str) -> None',
+        '.. py:class:: F(foo: int, bar: int, baz: int)',
+        '              F(foo: str, bar: str, baz: str)',
+        '              F(foo: float, bar: float, baz: float)',
         '   :module: target.docstring_signature',
         '',
     
@@ -518,13 +592,15 @@
         '   :module: target.docstring_signature',
         '',
         '',
-        '.. py:class:: E(foo: int, bar: int, baz: int) -> None',
-        '              E(foo: str, bar: str, baz: str) -> None',
+        '.. py:class:: E(foo: int, bar: int, baz: int)',
+        '              E(foo: str, bar: str, baz: str)',
+        '              E(foo: float, bar: float, baz: float)',
         '   :module: target.docstring_signature',
         '',
         '',
-        '.. py:class:: F(foo: int, bar: int, baz: int) -> None',
-        '              F(foo: str, bar: str, baz: str) -> None',
+        '.. py:class:: F(foo: int, bar: int, baz: int)',
+        '              F(foo: str, bar: str, baz: str)',
+        '              F(foo: float, bar: float, baz: float)',
         '   :module: target.docstring_signature',
         '',
     
@@ -599,6 +675,11 @@
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
                     confoverrides={'autodoc_typehints': "signature"})
 def test_autodoc_typehints_signature(app):
+    if sys.version_info:2 <= (3, 10):
+        type_o = "~typing.Any | None"
+    else:
+        type_o = "~typing.Any"
+
     options = {"members": None,
                "undoc-members": None}
     actual = do_autodoc(app, 'module', 'target.typehints', options)
@@ -612,7 +693,23 @@
         '   :type: int',
         '',
         '',
-        '.. py:class:: Math(s: str, o: typing.Optionaltyping.Any = None)',
+        '.. py:data:: CONST2',
+        '   :module: target.typehints',
+        '   :type: int',
+        '   :value: 1',
+        '',
+        '   docstring',
+        '',
+        '',
+        '.. py:data:: CONST3',
+        '   :module: target.typehints',
+        '   :type: ~pathlib.PurePosixPath',
+        "   :value: PurePosixPath('/a/b/c')",
+        '',
+        '   docstring',
+        '',
+        '',
+        '.. py:class:: Math(s: str, o: %s = None)' % type_o,
         '   :module: target.typehints',
         '',
         '',
@@ -627,6 +724,12 @@
         '      :value: 1',
         '',
         '',
+        '   .. py:attribute:: Math.CONST3',
+        '      :module: target.typehints',
+        '      :type: ~pathlib.PurePosixPath',
+        "      :value: PurePosixPath('/a/b/c')",
+        '',
+        '',
         '   .. py:method:: Math.decr(a: int, b: int = 1) -> int',
         '      :module: target.typehints',
         '',
@@ -643,6 +746,11 @@
         '      :module: target.typehints',
         '',
         '',
+        '   .. py:property:: Math.path',
+        '      :module: target.typehints',
+        '      :type: ~pathlib.PurePosixPath',
+        '',
+        '',
         '   .. py:property:: Math.prop',
         '      :module: target.typehints',
         '      :type: int',
@@ -660,6 +768,14 @@
         '   :module: target.typehints',
         '',
         '',
+        '.. py:class:: T',
+        '   :module: target.typehints',
+        '',
+        '   docstring',
+        '',
+        "   alias of TypeVar('T', bound=\\ :py:class:`~pathlib.PurePosixPath`)",
+        '',
+        '',
         '.. py:function:: complex_func(arg1: str, arg2: Listint, arg3: Tupleint, '
         'Unionstr, Unknown = None, *args: str, **kwargs: str) -> None',
         '   :module: target.typehints',
@@ -677,8 +793,7 @@
         '   :module: target.typehints',
         '',
         '',
-        '.. py:function:: tuple_args(x: typing.Tupleint, typing.Unionint, str) '
-        '-> typing.Tupleint, int',
+        '.. py:function:: tuple_args(x: tupleint, int | str) -> tupleint, int',
         '   :module: target.typehints',
         '',
     
@@ -699,6 +814,20 @@
         '   :module: target.typehints',
         '',
         '',
+        '.. py:data:: CONST2',
+        '   :module: target.typehints',
+        '   :value: 1',
+        '',
+        '   docstring',
+        '',
+        '',
+        '.. py:data:: CONST3',
+        '   :module: target.typehints',
+        "   :value: PurePosixPath('/a/b/c')",
+        '',
+        '   docstring',
+        '',
+        '',
         '.. py:class:: Math(s, o=None)',
         '   :module: target.typehints',
         '',
@@ -712,6 +841,11 @@
         '      :value: 1',
         '',
         '',
+        '   .. py:attribute:: Math.CONST3',
+        '      :module: target.typehints',
+        "      :value: PurePosixPath('/a/b/c')",
+        '',
+        '',
         '   .. py:method:: Math.decr(a, b=1)',
         '      :module: target.typehints',
         '',
@@ -728,6 +862,10 @@
         '      :module: target.typehints',
         '',
         '',
+        '   .. py:property:: Math.path',
+        '      :module: target.typehints',
+        '',
+        '',
         '   .. py:property:: Math.prop',
         '      :module: target.typehints',
         '',
@@ -744,6 +882,14 @@
         '   :module: target.typehints',
         '',
         '',
+        '.. py:class:: T',
+        '   :module: target.typehints',
+        '',
+        '   docstring',
+        '',
+        "   alias of TypeVar('T', bound=\\ :py:class:`~pathlib.PurePosixPath`)",
+        '',
+        '',
         '.. py:function:: complex_func(arg1, arg2, arg3=None, *args, **kwargs)',
         '   :module: target.typehints',
         '',
@@ -815,10 +961,11 @@
 
 
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
-                    confoverrides={'autodoc_typehints': "description"})
+                    confoverrides={'autodoc_typehints': "description"},
+                    freshenv=True)
 def test_autodoc_typehints_description(app):
     app.build()
-    context = (app.outdir / 'index.txt').read_text()
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
     assert ('target.typehints.incr(a, b=1)\n'
             '\n'
             '   Parameters:\n'
@@ -832,10 +979,10 @@
     assert ('target.typehints.tuple_args(x)\n'
             '\n'
             '   Parameters:\n'
-            '      **x** (*Tuple****int**, **Union****int**, **str*****) --\n'
+            '      **x** (*tuple****int**, **int** | **str***) --\n'
             '\n'
             '   Return type:\n'
-            '      *Tuple*int, int\n'
+            '      tupleint, int\n'
             in context)
 
     # Overloads still get displayed in the signature
@@ -854,20 +1001,20 @@
     # No :type: or :rtype: will be injected for `incr`, which does not have
     # a description for its parameters or its return. `tuple_args` does
     # describe them, so :type: and :rtype: will be added.
-    (app.srcdir / 'index.rst').write_text(
-        '.. autofunction:: target.typehints.incr\n'
-        '\n'
-        '.. autofunction:: target.typehints.decr\n'
-        '\n'
-        '   :returns: decremented number\n'
-        '\n'
-        '.. autofunction:: target.typehints.tuple_args\n'
-        '\n'
-        '   :param x: arg\n'
-        '   :return: another tuple\n'
-    )
-    app.build()
-    context = (app.outdir / 'index.txt').read_text()
+    with overwrite_file(app.srcdir / 'index.rst',
+                        '.. autofunction:: target.typehints.incr\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.decr\n'
+                        '\n'
+                        '   :returns: decremented number\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.tuple_args\n'
+                        '\n'
+                        '   :param x: arg\n'
+                        '   :return: another tuple\n'):
+        app.build()
+    # Restore the original content of the file
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
     assert ('target.typehints.incr(a, b=1)\n'
             '\n'
             'target.typehints.decr(a, b=1)\n'
@@ -881,66 +1028,172 @@
             'target.typehints.tuple_args(x)\n'
             '\n'
             '   Parameters:\n'
-            '      **x** (*Tuple****int**, **Union****int**, **str*****) -- arg\n'
+            '      **x** (*tuple****int**, **int** | **str***) -- arg\n'
             '\n'
             '   Returns:\n'
             '      another tuple\n'
             '\n'
             '   Return type:\n'
-            '      *Tuple*int, int\n'
+            '      tupleint, int\n'
             in context)
 
 
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
+                    confoverrides={'autodoc_typehints': "description",
+                                   'autodoc_typehints_description_target': 'documented_params'})
+def test_autodoc_typehints_description_no_undoc_doc_rtype(app):
+    # No :type: will be injected for `incr`, which does not have a description
+    # for its parameters or its return, just :rtype: will be injected due to
+    # autodoc_typehints_description_target. `tuple_args` does describe both, so
+    # :type: and :rtype: will be added. `nothing` has no parameters but a return
+    # type of None, which will be added.
+    with overwrite_file(app.srcdir / 'index.rst',
+                        '.. autofunction:: target.typehints.incr\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.decr\n'
+                        '\n'
+                        '   :returns: decremented number\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.tuple_args\n'
+                        '\n'
+                        '   :param x: arg\n'
+                        '   :return: another tuple\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.Math.nothing\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.Math.horse\n'
+                        '\n'
+                        '   :return: nothing\n'):
+        app.build()
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
+    assert context == (
+        'target.typehints.incr(a, b=1)\n'
+        '\n'
+        '   Return type:\n'
+        '      int\n'
+        '\n'
+        'target.typehints.decr(a, b=1)\n'
+        '\n'
+        '   Returns:\n'
+        '      decremented number\n'
+        '\n'
+        '   Return type:\n'
+        '      int\n'
+        '\n'
+        'target.typehints.tuple_args(x)\n'
+        '\n'
+        '   Parameters:\n'
+        '      **x** (*tuple****int**, **int** | **str***) -- arg\n'
+        '\n'
+        '   Returns:\n'
+        '      another tuple\n'
+        '\n'
+        '   Return type:\n'
+        '      tupleint, int\n'
+        '\n'
+        'target.typehints.Math.nothing(self)\n'
+        '\n'
+        'target.typehints.Math.horse(self, a, b)\n'
+        '\n'
+        '   Returns:\n'
+        '      nothing\n'
+        '\n'
+        '   Return type:\n'
+        '      None\n'
+    )
+
+
+@pytest.mark.sphinx('text', testroot='ext-autodoc',
                     confoverrides={'autodoc_typehints': "description"})
 def test_autodoc_typehints_description_with_documented_init(app):
-    (app.srcdir / 'index.rst').write_text(
-        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
-        '   :special-members: __init__\n'
+    with overwrite_file(app.srcdir / 'index.rst',
+                        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
+                        '   :special-members: __init__\n'):
+        app.build()
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
+    assert context == (
+        'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n'
+        '\n'
+        '   Class docstring.\n'
+        '\n'
+        '   Parameters:\n'
+        '      * **x** (*int*) --\n'
+        '\n'
+        '      * **args** (*int*) --\n'
+        '\n'
+        '      * **kwargs** (*int*) --\n'
+        '\n'
+        '   __init__(x, *args, **kwargs)\n'
+        '\n'
+        '      Init docstring.\n'
+        '\n'
+        '      Parameters:\n'
+        '         * **x** (*int*) -- Some integer\n'
+        '\n'
+        '         * **args** (*int*) -- Some integer\n'
+        '\n'
+        '         * **kwargs** (*int*) -- Some integer\n'
+        '\n'
+        '      Return type:\n'
+        '         None\n'
     )
-    app.build()
-    context = (app.outdir / 'index.txt').read_text()
-    assert ('class target.typehints._ClassWithDocumentedInit(x)\n'
-            '\n'
-            '   Class docstring.\n'
-            '\n'
-            '   Parameters:\n'
-            '      **x** (*int*) --\n'
-            '\n'
-            '   Return type:\n'
-            '      None\n'
-            '\n'
-            '   __init__(x)\n'
-            '\n'
-            '      Init docstring.\n'
-            '\n'
-            '      Parameters:\n'
-            '         **x** (*int*) -- Some integer\n'
-            '\n'
-            '      Return type:\n'
-            '         None\n' == context)
 
 
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
                     confoverrides={'autodoc_typehints': "description",
                                    'autodoc_typehints_description_target': 'documented'})
 def test_autodoc_typehints_description_with_documented_init_no_undoc(app):
-    (app.srcdir / 'index.rst').write_text(
-        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
-        '   :special-members: __init__\n'
+    with overwrite_file(app.srcdir / 'index.rst',
+                        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
+                        '   :special-members: __init__\n'):
+        app.build()
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
+    assert context == (
+        'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n'
+        '\n'
+        '   Class docstring.\n'
+        '\n'
+        '   __init__(x, *args, **kwargs)\n'
+        '\n'
+        '      Init docstring.\n'
+        '\n'
+        '      Parameters:\n'
+        '         * **x** (*int*) -- Some integer\n'
+        '\n'
+        '         * **args** (*int*) -- Some integer\n'
+        '\n'
+        '         * **kwargs** (*int*) -- Some integer\n'
+    )
+
+
+@pytest.mark.sphinx('text', testroot='ext-autodoc',
+                    confoverrides={'autodoc_typehints': "description",
+                                   'autodoc_typehints_description_target': 'documented_params'})
+def test_autodoc_typehints_description_with_documented_init_no_undoc_doc_rtype(app):
+    # see test_autodoc_typehints_description_with_documented_init_no_undoc
+    # returnvalue_and_documented_params should not change class or method
+    # docstring.
+    with overwrite_file(app.srcdir / 'index.rst',
+                        '.. autoclass:: target.typehints._ClassWithDocumentedInit\n'
+                        '   :special-members: __init__\n'):
+        app.build()
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
+    assert context == (
+        'class target.typehints._ClassWithDocumentedInit(x, *args, **kwargs)\n'
+        '\n'
+        '   Class docstring.\n'
+        '\n'
+        '   __init__(x, *args, **kwargs)\n'
+        '\n'
+        '      Init docstring.\n'
+        '\n'
+        '      Parameters:\n'
+        '         * **x** (*int*) -- Some integer\n'
+        '\n'
+        '         * **args** (*int*) -- Some integer\n'
+        '\n'
+        '         * **kwargs** (*int*) -- Some integer\n'
     )
-    app.build()
-    context = (app.outdir / 'index.txt').read_text()
-    assert ('class target.typehints._ClassWithDocumentedInit(x)\n'
-            '\n'
-            '   Class docstring.\n'
-            '\n'
-            '   __init__(x)\n'
-            '\n'
-            '      Init docstring.\n'
-            '\n'
-            '      Parameters:\n'
-            '         **x** (*int*) -- Some integer\n' == context)
 
 
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
@@ -953,15 +1206,14 @@
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
                     confoverrides={'autodoc_typehints': "both"})
 def test_autodoc_typehints_both(app):
-    (app.srcdir / 'index.rst').write_text(
-        '.. autofunction:: target.typehints.incr\n'
-        '\n'
-        '.. autofunction:: target.typehints.tuple_args\n'
-        '\n'
-        '.. autofunction:: target.overload.sum\n'
-    )
-    app.build()
-    context = (app.outdir / 'index.txt').read_text()
+    with overwrite_file(app.srcdir / 'index.rst',
+                        '.. autofunction:: target.typehints.incr\n'
+                        '\n'
+                        '.. autofunction:: target.typehints.tuple_args\n'
+                        '\n'
+                        '.. autofunction:: target.overload.sum\n'):
+        app.build()
+    context = (app.outdir / 'index.txt').read_text(encoding='utf8')
     assert ('target.typehints.incr(a: int, b: int = 1) -> int\n'
             '\n'
             '   Parameters:\n'
@@ -972,13 +1224,13 @@
             '   Return type:\n'
             '      int\n'
             in context)
-    assert ('target.typehints.tuple_args(x: Tupleint, Unionint, str) -> Tupleint, int\n'
+    assert ('target.typehints.tuple_args(x: tupleint, int | str) -> tupleint, int\n'
             '\n'
             '   Parameters:\n'
-            '      **x** (*Tuple****int**, **Union****int**, **str*****) --\n'
+            '      **x** (*tuple****int**, **int** | **str***) --\n'
             '\n'
             '   Return type:\n'
-            '      *Tuple*int, int\n'
+            '      tupleint, int\n'
             in context)
 
     # Overloads still get displayed in the signature
@@ -990,7 +1242,6 @@
             in context)
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 @pytest.mark.sphinx('text', testroot='ext-autodoc')
 def test_autodoc_type_aliases(app):
     # default
@@ -1028,7 +1279,7 @@
         '   docstring',
         '',
         '',
-        '.. py:function:: read(r: _io.BytesIO) -> _io.StringIO',
+        '.. py:function:: read(r: ~_io.BytesIO) -> ~_io.StringIO',
         '   :module: target.autodoc_type_aliases',
         '',
         '   docstring',
@@ -1054,6 +1305,13 @@
         '',
         '   docstring',
         '',
+        '',
+        '.. py:data:: variable3',
+        '   :module: target.autodoc_type_aliases',
+        '   :type: int | None',
+        '',
+        '   docstring',
+        '',
     
 
     # define aliases
@@ -1092,7 +1350,7 @@
         '   docstring',
         '',
         '',
-        '.. py:function:: read(r: _io.BytesIO) -> my.module.StringIO',
+        '.. py:function:: read(r: ~_io.BytesIO) -> my.module.StringIO',
         '   :module: target.autodoc_type_aliases',
         '',
         '   docstring',
@@ -1118,34 +1376,48 @@
         '',
         '   docstring',
         '',
+        '',
+        '.. py:data:: variable3',
+        '   :module: target.autodoc_type_aliases',
+        '   :type: myint | None',
+        '',
+        '   docstring',
+        '',
     
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 @pytest.mark.sphinx('text', testroot='ext-autodoc',
                     srcdir='autodoc_typehints_description_and_type_aliases',
                     confoverrides={'autodoc_typehints': "description",
                                    'autodoc_type_aliases': {'myint': 'myint'}})
 def test_autodoc_typehints_description_and_type_aliases(app):
-    (app.srcdir / 'autodoc_type_aliases.rst').write_text('.. autofunction:: target.autodoc_type_aliases.sum')
-    app.build()
-    context = (app.outdir / 'autodoc_type_aliases.txt').read_text()
-    assert ('target.autodoc_type_aliases.sum(x, y)\n'
-            '\n'
-            '   docstring\n'
-            '\n'
-            '   Parameters:\n'
-            '      * **x** (*myint*) --\n'
-            '\n'
-            '      * **y** (*myint*) --\n'
-            '\n'
-            '   Return type:\n'
-            '      myint\n' == context)
+    with overwrite_file(app.srcdir / 'autodoc_type_aliases.rst',
+                        '.. autofunction:: target.autodoc_type_aliases.sum'):
+        app.build()
+    context = (app.outdir / 'autodoc_type_aliases.txt').read_text(encoding='utf8')
+    assert context == (
+        'target.autodoc_type_aliases.sum(x, y)\n'
+        '\n'
+        '   docstring\n'
+        '\n'
+        '   Parameters:\n'
+        '      * **x** (*myint*) --\n'
+        '\n'
+        '      * **y** (*myint*) --\n'
+        '\n'
+        '   Return type:\n'
+        '      myint\n'
+    )
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
-                    confoverrides={'autodoc_typehints_format': "short"})
-def test_autodoc_typehints_format_short(app):
+                    confoverrides={'autodoc_typehints_format': "fully-qualified"})
+def test_autodoc_typehints_format_fully_qualified(app):
+    if sys.version_info:2 <= (3, 10):
+        type_o = "typing.Any | None"
+    else:
+        type_o = "typing.Any"
+
     options = {"members": None,
                "undoc-members": None}
     actual = do_autodoc(app, 'module', 'target.typehints', options)
@@ -1159,7 +1431,23 @@
         '   :type: int',
         '',
         '',
-        '.. py:class:: Math(s: str, o: ~typing.Optional~typing.Any = None)',
+        '.. py:data:: CONST2',
+        '   :module: target.typehints',
+        '   :type: int',
+        '   :value: 1',
+        '',
+        '   docstring',
+        '',
+        '',
+        '.. py:data:: CONST3',
+        '   :module: target.typehints',
+        '   :type: pathlib.PurePosixPath',
+        "   :value: PurePosixPath('/a/b/c')",
+        '',
+        '   docstring',
+        '',
+        '',
+        '.. py:class:: Math(s: str, o: %s = None)' % type_o,
         '   :module: target.typehints',
         '',
         '',
@@ -1174,6 +1462,12 @@
         '      :value: 1',
         '',
         '',
+        '   .. py:attribute:: Math.CONST3',
+        '      :module: target.typehints',
+        '      :type: pathlib.PurePosixPath',
+        "      :value: PurePosixPath('/a/b/c')",
+        '',
+        '',
         '   .. py:method:: Math.decr(a: int, b: int = 1) -> int',
         '      :module: target.typehints',
         '',
@@ -1190,6 +1484,11 @@
         '      :module: target.typehints',
         '',
         '',
+        '   .. py:property:: Math.path',
+        '      :module: target.typehints',
+        '      :type: pathlib.PurePosixPath',
+        '',
+        '',
         '   .. py:property:: Math.prop',
         '      :module: target.typehints',
         '      :type: int',
@@ -1207,6 +1506,14 @@
         '   :module: target.typehints',
         '',
         '',
+        '.. py:class:: T',
+        '   :module: target.typehints',
+        '',
+        '   docstring',
+        '',
+        "   alias of TypeVar('T', bound=\\ :py:class:`pathlib.PurePosixPath`)",
+        '',
+        '',
         '.. py:function:: complex_func(arg1: str, arg2: Listint, arg3: Tupleint, '
         'Unionstr, Unknown = None, *args: str, **kwargs: str) -> None',
         '   :module: target.typehints',
@@ -1224,65 +1531,53 @@
         '   :module: target.typehints',
         '',
         '',
-        '.. py:function:: tuple_args(x: ~typing.Tupleint, ~typing.Unionint, str) '
-        '-> ~typing.Tupleint, int',
+        '.. py:function:: tuple_args(x: tupleint, int | str) -> tupleint, int',
         '   :module: target.typehints',
         '',
     
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
-                    confoverrides={'autodoc_typehints_format': "short"})
-def test_autodoc_typehints_format_short_for_class_alias(app):
+                    confoverrides={'autodoc_typehints_format': "fully-qualified"})
+def test_autodoc_typehints_format_fully_qualified_for_class_alias(app):
     actual = do_autodoc(app, 'class', 'target.classes.Alias')
     assert list(actual) == 
         '',
         '.. py:attribute:: Alias',
         '   :module: target.classes',
         '',
-        '   alias of :py:class:`~target.classes.Foo`',
+        '   alias of :py:class:`target.classes.Foo`',
     
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
-                    confoverrides={'autodoc_typehints_format': "short"})
-def test_autodoc_typehints_format_short_for_generic_alias(app):
+                    confoverrides={'autodoc_typehints_format': "fully-qualified"})
+def test_autodoc_typehints_format_fully_qualified_for_generic_alias(app):
     actual = do_autodoc(app, 'data', 'target.genericalias.L')
-    if sys.version_info < (3, 7):
-        assert list(actual) == 
-            '',
-            '.. py:data:: L',
-            '   :module: target.genericalias',
-            '   :value: typing.Listtarget.genericalias.Class',
-            '',
-            '   A list of Class',
-            '',
-        
-    else:
-        assert list(actual) == 
-            '',
-            '.. py:data:: L',
-            '   :module: target.genericalias',
-            '',
-            '   A list of Class',
-            '',
-            '   alias of :py:class:`~typing.List`\\ :py:class:`~target.genericalias.Class`',
-            '',
-        
+    assert list(actual) == 
+        '',
+        '.. py:data:: L',
+        '   :module: target.genericalias',
+        '',
+        '   A list of Class',
+        '',
+        '   alias of :py:class:`~typing.List`\\ :py:class:`target.genericalias.Class`',
+        '',
+    
 
 
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
-                    confoverrides={'autodoc_typehints_format': "short"})
-def test_autodoc_typehints_format_short_for_newtype_alias(app):
-    actual = do_autodoc(app, 'data', 'target.typevar.T6')
+                    confoverrides={'autodoc_typehints_format': "fully-qualified"})
+def test_autodoc_typehints_format_fully_qualified_for_newtype_alias(app):
+    actual = do_autodoc(app, 'class', 'target.typevar.T6')
     assert list(actual) == 
         '',
-        '.. py:data:: T6',
+        '.. py:class:: T6',
         '   :module: target.typevar',
         '',
         '   T6',
         '',
-        '   alias of :py:class:`~datetime.date`',
+        '   alias of :py:class:`datetime.date`',
         '',
     
 
@@ -1296,7 +1591,7 @@
     actual = do_autodoc(app, 'class', 'target.CustomIter')
     assert '   .. py:method:: target.CustomIter' not in actual
     actual = do_autodoc(app, 'module', 'target')
-    assert '.. py:function:: save_traceback(app)' not in actual
+    assert '.. py:function:: function_to_be_imported(app)' not in actual
 
     # with :members:
     app.config.autodoc_default_options = {'members': None}
@@ -1323,7 +1618,7 @@
     # Note that :members: must be *on* for :special-members: to work.
     app.config.autodoc_default_options = {
         'members': None,
-        'special-members': None
+        'special-members': None,
     }
     actual = do_autodoc(app, 'class', 'target.CustomIter')
     assert '   .. py:method:: CustomIter.__init__()' in actual
@@ -1408,7 +1703,7 @@
     # with :exclude-members:
     app.config.autodoc_default_options = {
         'members': None,
-        'exclude-members': 'val1'
+        'exclude-members': 'val1',
     }
     actual = do_autodoc(app, 'class', 'target.enums.EnumCls')
     assert '   .. py:attribute:: EnumCls.val1' not in actual

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_events.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_events.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_mock.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_mock.py Changed

@@ -1,12 +1,6 @@
-"""
-    test_ext_autodoc_mock
-    ~~~~~~~~~~~~~~~~~~~~~
+"""Test the autodoc extension."""
 
-    Test the autodoc extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import abc
 import sys
@@ -92,7 +86,6 @@
             import_module('sphinx.unknown')
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='Only for py37 or above')
 def test_abc_MockObject():
     mock = _MockObject()
 
@@ -122,6 +115,11 @@
         def meth(self):
             pass
 
+        @classmethod
+        @mock.method_deco
+        def class_meth(cls):
+            pass
+
     @mock.class_deco
     class Bar:
         pass
@@ -132,6 +130,7 @@
 
     assert undecorate(func).__name__ == "func"
     assert undecorate(Foo.meth).__name__ == "meth"
+    assert undecorate(Foo.class_meth).__name__ == "class_meth"
     assert undecorate(Bar).__name__ == "Bar"
     assert undecorate(Baz).__name__ == "Baz"

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_preserve_defaults.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_preserve_defaults.py Changed

@@ -1,14 +1,4 @@
-"""
-    test_ext_autodoc_preserve_defaults
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import sys
+"""Test the autodoc extension."""
 
 import pytest
 
@@ -18,10 +8,7 @@
 @pytest.mark.sphinx('html', testroot='ext-autodoc',
                     confoverrides={'autodoc_preserve_defaults': True})
 def test_preserve_defaults(app):
-    if sys.version_info < (3, 8):
-        color = "16777215"
-    else:
-        color = "0xFFFFFF"
+    color = "0xFFFFFF"
 
     options = {"members": None}
     actual = do_autodoc(app, 'module', 'target.preserve_defaults', options)
@@ -36,15 +23,26 @@
         '   docstring',
         '',
         '',
-        '   .. py:method:: Class.meth(name: str = CONSTANT, sentinel: typing.Any = '
-        'SENTINEL, now: datetime.datetime = datetime.now(), color: int = %s) -> None' % color,
+        '   .. py:method:: Class.clsmeth(name: str = CONSTANT, sentinel: ~typing.Any = '
+        'SENTINEL, now: ~datetime.datetime = datetime.now(), color: int = %s, *, '
+        'kwarg1, kwarg2=%s) -> None' % (color, color),
+        '      :module: target.preserve_defaults',
+        '      :classmethod:',
+        '',
+        '      docstring',
+        '',
+        '',
+        '   .. py:method:: Class.meth(name: str = CONSTANT, sentinel: ~typing.Any = '
+        'SENTINEL, now: ~datetime.datetime = datetime.now(), color: int = %s, *, '
+        'kwarg1, kwarg2=%s) -> None' % (color, color),
         '      :module: target.preserve_defaults',
         '',
         '      docstring',
         '',
         '',
-        '.. py:function:: foo(name: str = CONSTANT, sentinel: typing.Any = SENTINEL, '
-        'now: datetime.datetime = datetime.now(), color: int = %s) -> None' % color,
+        '.. py:function:: foo(name: str = CONSTANT, sentinel: ~typing.Any = SENTINEL, '
+        'now: ~datetime.datetime = datetime.now(), color: int = %s, *, kwarg1, '
+        'kwarg2=%s) -> None' % (color, color),
         '   :module: target.preserve_defaults',
         '',
         '   docstring',

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autodoc_private_members.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autodoc_private_members.py Changed

@@ -1,11 +1,4 @@
-"""
-    test_ext_autodoc_private_members
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test the autodoc extension.  This tests mainly for private-members option.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+"""Test the autodoc extension.  This tests mainly for private-members option.
 """
 
 import pytest
@@ -109,3 +102,57 @@
         '   :meta public:',
         '',
     
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_private_attributes(app):
+    app.config.autoclass_content = 'class'
+    options = {"members": None}
+    actual = do_autodoc(app, 'class', 'target.private.Foo', options)
+    assert list(actual) == 
+        '',
+        '.. py:class:: Foo()',
+        '   :module: target.private',
+        '',
+        '',
+        '   .. py:attribute:: Foo._public_attribute',
+        '      :module: target.private',
+        '      :value: 47',
+        '',
+        '      A public class attribute whose name starts with an underscore.',
+        '',
+        '      :meta public:',
+        '',
+    
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_private_attributes_and_private_members(app):
+    app.config.autoclass_content = 'class'
+    options = {"members": None,
+               "private-members": None}
+    actual = do_autodoc(app, 'class', 'target.private.Foo', options)
+    assert list(actual) == 
+        '',
+        '.. py:class:: Foo()',
+        '   :module: target.private',
+        '',
+        '',
+        '   .. py:attribute:: Foo._public_attribute',
+        '      :module: target.private',
+        '      :value: 47',
+        '',
+        '      A public class attribute whose name starts with an underscore.',
+        '',
+        '      :meta public:',
+        '',
+        '',
+        '   .. py:attribute:: Foo.private_attribute',
+        '      :module: target.private',
+        '      :value: 11',
+        '',
+        '      A private class attribute whose name does not start with an underscore.',
+        '',
+        '      :meta private:',
+        '',
+

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autosectionlabel.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autosectionlabel.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_ext_autosectionlabel
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.autosectionlabel extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.autosectionlabel extension."""
 
 import re
 
@@ -17,7 +9,7 @@
 def test_autosectionlabel_html(app, status, warning, skipped_labels=False):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     html = ('<li><p><a class="reference internal" href="#introduce-of-sphinx">'
             '<span class=".*?">Introduce of Sphinx</span></a></p></li>')
     assert re.search(html, content, re.S)
@@ -61,7 +53,7 @@
 def test_autosectionlabel_maxdepth(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
 
     # depth: 1
     html = ('<li><p><a class="reference internal" href="#test-ext-autosectionlabel">'
@@ -82,4 +74,4 @@
     html = '<li><p><span class="xref std std-ref">Linux</span></p></li>'
     assert re.search(html, content, re.S)
 
-    assert 'WARNING: undefined label: linux' in warning.getvalue()
+    assert "WARNING: undefined label: 'linux'" in warning.getvalue()

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_autosummary.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_autosummary.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_autosummary
-    ~~~~~~~~~~~~~~~~
-
-    Test the autosummary extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the autosummary extension."""
 
 import sys
 from io import StringIO
@@ -16,14 +8,26 @@
 from docutils import nodes
 
 from sphinx import addnodes
-from sphinx.ext.autosummary import (autosummary_table, autosummary_toc, extract_summary,
-                                    import_by_name, mangle_signature)
-from sphinx.ext.autosummary.generate import (AutosummaryEntry, generate_autosummary_content,
-                                             generate_autosummary_docs)
+from sphinx.ext.autosummary import (
+    autosummary_table,
+    autosummary_toc,
+    extract_summary,
+    import_by_name,
+    mangle_signature,
+)
+from sphinx.ext.autosummary.generate import (
+    AutosummaryEntry,
+    generate_autosummary_content,
+    generate_autosummary_docs,
+)
 from sphinx.ext.autosummary.generate import main as autogen_main
 from sphinx.testing.util import assert_node, etree_parse
 from sphinx.util.docutils import new_document
-from sphinx.util.osutil import cd
+
+try:
+    from contextlib import chdir
+except ImportError:
+    from sphinx.util.osutil import _chdir as chdir
 
 html_warnfile = StringIO()
 
@@ -34,13 +38,13 @@
         'extensions': 'sphinx.ext.autosummary',
         'autosummary_generate': True,
         'autosummary_generate_overwrite': False,
-        'source_suffix': '.rst'
-    }
+        'source_suffix': '.rst',
+    },
 }
 
 
 @pytest.fixture(scope='function', autouse=True)
-def unload_target_module():
+def _unload_target_module():
     sys.modules.pop('target', None)
 
 
@@ -70,7 +74,7 @@
             if '::' in x
     for inp, outp in TEST:
         res = mangle_signature(inp).strip().replace("\u00a0", " ")
-        assert res == outp, ("'%s' -> '%s' != '%s'" % (inp, res, outp))
+        assert res == outp, (f"'{inp}' -> '{res}' != '{outp}'")
 
 
 def test_extract_summary(capsys):
@@ -218,15 +222,15 @@
     assert context'members' == 'CONSTANT1', 'CONSTANT2', 'Exc', 'Foo', '_Baz', '_Exc',
                                   '__all__', '__builtins__', '__cached__', '__doc__',
                                   '__file__', '__name__', '__package__', '_quux', 'bar',
-                                  'quuz', 'qux'
+                                  'non_imported_member', 'quuz', 'qux'
     assert context'functions' == 'bar'
     assert context'all_functions' == '_quux', 'bar'
     assert context'classes' == 'Foo'
     assert context'all_classes' == 'Foo', '_Baz'
     assert context'exceptions' == 'Exc'
     assert context'all_exceptions' == 'Exc', '_Exc'
-    assert context'attributes' == 'CONSTANT1', 'qux', 'quuz'
-    assert context'all_attributes' == 'CONSTANT1', 'qux', 'quuz'
+    assert context'attributes' == 'CONSTANT1', 'qux', 'quuz', 'non_imported_member'
+    assert context'all_attributes' == 'CONSTANT1', 'qux', 'quuz', 'non_imported_member'
     assert context'fullname' == 'autosummary_dummy_module'
     assert context'module' == 'autosummary_dummy_module'
     assert context'objname' == ''
@@ -269,6 +273,7 @@
     def skip_member(app, what, name, obj, skip, options):
         if name in ('Foo', 'bar', 'Exc'):
             return True
+        return None
 
     app.connect('autodoc-skip-member', skip_member)
     generate_autosummary_content('autosummary_dummy_module', autosummary_dummy_module, None,
@@ -276,7 +281,8 @@
     context = template.render.call_args01
     assert context'members' == 'CONSTANT1', 'CONSTANT2', '_Baz', '_Exc', '__all__',
                                   '__builtins__', '__cached__', '__doc__', '__file__',
-                                  '__name__', '__package__', '_quux', 'quuz', 'qux'
+                                  '__name__', '__package__', '_quux', 'non_imported_member',
+                                  'quuz', 'qux'
     assert context'functions' == 
     assert context'classes' == 
     assert context'exceptions' == 
@@ -292,18 +298,20 @@
     assert template.render.call_args00 == 'module'
 
     context = template.render.call_args01
-    assert context'members' == 'CONSTANT1', 'CONSTANT2', 'Exc', 'Foo', 'Union', '_Baz',
-                                  '_Exc', '__all__', '__builtins__', '__cached__', '__doc__',
-                                  '__file__', '__loader__', '__name__', '__package__',
-                                  '__spec__', '_quux', 'bar', 'path', 'quuz', 'qux'
+    assert context'members' == 'CONSTANT1', 'CONSTANT2', 'Class', 'Exc', 'Foo', 'Union',
+                                  '_Baz', '_Exc', '__all__', '__builtins__', '__cached__',
+                                  '__doc__', '__file__', '__loader__', '__name__',
+                                  '__package__', '__spec__', '_quux', 'bar',
+                                  'considered_as_imported', 'non_imported_member', 'path',
+                                  'quuz', 'qux'
     assert context'functions' == 'bar'
     assert context'all_functions' == '_quux', 'bar'
-    assert context'classes' == 'Foo'
-    assert context'all_classes' == 'Foo', '_Baz'
+    assert context'classes' == 'Class', 'Foo'
+    assert context'all_classes' == 'Class', 'Foo', '_Baz'
     assert context'exceptions' == 'Exc'
     assert context'all_exceptions' == 'Exc', '_Exc'
-    assert context'attributes' == 'CONSTANT1', 'qux', 'quuz'
-    assert context'all_attributes' == 'CONSTANT1', 'qux', 'quuz'
+    assert context'attributes' == 'CONSTANT1', 'qux', 'quuz', 'non_imported_member'
+    assert context'all_attributes' == 'CONSTANT1', 'qux', 'quuz', 'non_imported_member'
     assert context'fullname' == 'autosummary_dummy_module'
     assert context'module' == 'autosummary_dummy_module'
     assert context'objname' == ''
@@ -311,6 +319,33 @@
     assert context'objtype' == 'module'
 
 
+@pytest.mark.sphinx(testroot='ext-autosummary')
+def test_autosummary_generate_content_for_module_imported_members_inherited_module(app):
+    import autosummary_dummy_inherited_module
+    template = Mock()
+
+    generate_autosummary_content('autosummary_dummy_inherited_module',
+                                 autosummary_dummy_inherited_module, None,
+                                 template, None, True, app, False, {})
+    assert template.render.call_args00 == 'module'
+
+    context = template.render.call_args01
+    assert context'members' == 'Foo', 'InheritedAttrClass', '__all__', '__builtins__', '__cached__',
+                                  '__doc__', '__file__', '__loader__', '__name__',
+                                  '__package__', '__spec__'
+    assert context'functions' == 
+    assert context'classes' == 'Foo', 'InheritedAttrClass'
+    assert context'exceptions' == 
+    assert context'all_exceptions' == 
+    assert context'attributes' == 
+    assert context'all_attributes' == 
+    assert context'fullname' == 'autosummary_dummy_inherited_module'
+    assert context'module' == 'autosummary_dummy_inherited_module'
+    assert context'objname' == ''
+    assert context'name' == ''
+    assert context'objtype' == 'module'
+
+
 @pytest.mark.sphinx('dummy', testroot='ext-autosummary')
 def test_autosummary_generate(app, status, warning):
     app.builder.build_all()
@@ -329,18 +364,22 @@
                                                                                nodes.row,
                                                                                nodes.row,
                                                                                nodes.row,
+                                                                               nodes.row,
+                                                                               nodes.row,
                                                                                nodes.row)))
     assert_node(doctree40, addnodes.toctree, caption="An autosummary")
 
-    assert len(doctree3002) == 6
+    assert len(doctree3002) == 8
     assert doctree30020.astext() == 'autosummary_dummy_module\n\n'
     assert doctree30021.astext() == 'autosummary_dummy_module.Foo()\n\n'
     assert doctree30022.astext() == 'autosummary_dummy_module.Foo.Bar()\n\n'
     assert doctree30023.astext() == 'autosummary_dummy_module.Foo.value\n\ndocstring'
     assert doctree30024.astext() == 'autosummary_dummy_module.bar(x, y)\n\n'
     assert doctree30025.astext() == 'autosummary_dummy_module.qux\n\na module-level attribute'
+    assert doctree30026.astext() == 'autosummary_dummy_inherited_module.InheritedAttrClass()\n\n'
+    assert doctree30027.astext() == 'autosummary_dummy_inherited_module.InheritedAttrClass.subclassattr\n\nother docstring'
 
-    module = (app.srcdir / 'generated' / 'autosummary_dummy_module.rst').read_text()
+    module = (app.srcdir / 'generated' / 'autosummary_dummy_module.rst').read_text(encoding='utf8')
 
     assert ('   .. autosummary::\n'
             '   \n'
@@ -351,9 +390,10 @@
             '      CONSTANT1\n'
             '      qux\n'
             '      quuz\n'
+            '      non_imported_member\n'
             '   \n' in module)
 
-    Foo = (app.srcdir / 'generated' / 'autosummary_dummy_module.Foo.rst').read_text()
+    Foo = (app.srcdir / 'generated' / 'autosummary_dummy_module.Foo.rst').read_text(encoding='utf8')
     assert '.. automethod:: __init__' in Foo
     assert ('   .. autosummary::\n'
             '   \n'
@@ -368,21 +408,43 @@
             '      ~Foo.value\n'
             '   \n' in Foo)
 
-    FooBar = (app.srcdir / 'generated' / 'autosummary_dummy_module.Foo.Bar.rst').read_text()
+    FooBar = (app.srcdir / 'generated' / 'autosummary_dummy_module.Foo.Bar.rst').read_text(encoding='utf8')
     assert ('.. currentmodule:: autosummary_dummy_module\n'
             '\n'
             '.. autoclass:: Foo.Bar\n' in FooBar)
 
-    Foo_value = (app.srcdir / 'generated' / 'autosummary_dummy_module.Foo.value.rst').read_text()
+    Foo_value = (app.srcdir / 'generated' / 'autosummary_dummy_module.Foo.value.rst').read_text(encoding='utf8')
     assert ('.. currentmodule:: autosummary_dummy_module\n'
             '\n'
             '.. autoattribute:: Foo.value' in Foo_value)
 
-    qux = (app.srcdir / 'generated' / 'autosummary_dummy_module.qux.rst').read_text()
+    qux = (app.srcdir / 'generated' / 'autosummary_dummy_module.qux.rst').read_text(encoding='utf8')
     assert ('.. currentmodule:: autosummary_dummy_module\n'
             '\n'
             '.. autodata:: qux' in qux)
 
+    InheritedAttrClass = (app.srcdir / 'generated' / 'autosummary_dummy_inherited_module.InheritedAttrClass.rst').read_text(encoding='utf8')
+    print(InheritedAttrClass)
+    assert '.. automethod:: __init__' in Foo
+    assert ('   .. autosummary::\n'
+            '   \n'
+            '      ~InheritedAttrClass.__init__\n'
+            '      ~InheritedAttrClass.bar\n'
+            '   \n' in InheritedAttrClass)
+    assert ('   .. autosummary::\n'
+            '   \n'
+            '      ~InheritedAttrClass.CONSTANT3\n'
+            '      ~InheritedAttrClass.CONSTANT4\n'
+            '      ~InheritedAttrClass.baz\n'
+            '      ~InheritedAttrClass.subclassattr\n'
+            '      ~InheritedAttrClass.value\n'
+            '   \n' in InheritedAttrClass)
+
+    InheritedAttrClass_subclassattr = (app.srcdir / 'generated' / 'autosummary_dummy_inherited_module.InheritedAttrClass.subclassattr.rst').read_text(encoding='utf8')
+    assert ('.. currentmodule:: autosummary_dummy_inherited_module\n'
+            '\n'
+            '.. autoattribute:: InheritedAttrClass.subclassattr' in InheritedAttrClass_subclassattr)
+
 
 @pytest.mark.sphinx('dummy', testroot='ext-autosummary',
                     confoverrides={'autosummary_generate_overwrite': False})
@@ -391,10 +453,10 @@
     srcdir = kwargs.get('srcdir')
 
     (srcdir / 'generated').makedirs(exist_ok=True)
-    (srcdir / 'generated' / 'autosummary_dummy_module.rst').write_text('')
+    (srcdir / 'generated' / 'autosummary_dummy_module.rst').write_text('', encoding='utf8')
 
     app = make_app(*args, **kwargs)
-    content = (srcdir / 'generated' / 'autosummary_dummy_module.rst').read_text()
+    content = (srcdir / 'generated' / 'autosummary_dummy_module.rst').read_text(encoding='utf8')
     assert content == ''
     assert 'autosummary_dummy_module.rst' not in app._warning.getvalue()
 
@@ -406,10 +468,10 @@
     srcdir = kwargs.get('srcdir')
 
     (srcdir / 'generated').makedirs(exist_ok=True)
-    (srcdir / 'generated' / 'autosummary_dummy_module.rst').write_text('')
+    (srcdir / 'generated' / 'autosummary_dummy_module.rst').write_text('', encoding='utf8')
 
     app = make_app(*args, **kwargs)
-    content = (srcdir / 'generated' / 'autosummary_dummy_module.rst').read_text()
+    content = (srcdir / 'generated' / 'autosummary_dummy_module.rst').read_text(encoding='utf8')
     assert content != ''
     assert 'autosummary_dummy_module.rst' not in app._warning.getvalue()
 
@@ -433,12 +495,12 @@
     assert (app.srcdir / 'generated' / 'package2.module.rst').exists() is False
 
     # Check content of recursively generated stub-files
-    content = (app.srcdir / 'generated' / 'package.rst').read_text()
+    content = (app.srcdir / 'generated' / 'package.rst').read_text(encoding='utf8')
     assert 'package.module' in content
     assert 'package.package' in content
     assert 'package.module_importfail' in content
 
-    content = (app.srcdir / 'generated' / 'package.package.rst').read_text()
+    content = (app.srcdir / 'generated' / 'package.package.rst').read_text(encoding='utf8')
     assert 'package.package.module' in content
 
 
@@ -473,10 +535,10 @@
 @pytest.mark.sphinx('latex', **default_kw)
 def test_autosummary_latex_table_colspec(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     print(status.getvalue())
     print(warning.getvalue())
-    assert r'\begin{longtable}c{\X{1}{2}\X{1}{2}}' in result
+    assert r'\begin{longtable}{\X{1}{2}\X{1}{2}}' in result
     assert r'p{0.5\linewidth}' not in result
 
 
@@ -523,7 +585,7 @@
         # generated/foo is generated successfully
         assert app.env.get_doctree('generated/autosummary_dummy_package')
 
-        module = (app.srcdir / 'generated' / 'autosummary_dummy_package.rst').read_text()
+        module = (app.srcdir / 'generated' / 'autosummary_dummy_package.rst').read_text(encoding='utf8')
         assert ('   .. autosummary::\n'
                 '   \n'
                 '      Bar\n'
@@ -536,6 +598,30 @@
         sys.modules.pop('autosummary_dummy_package', None)
 
 
+@pytest.mark.sphinx('dummy', testroot='ext-autosummary-module_all')
+def test_autosummary_module_all(app, status, warning):
+    try:
+        app.build()
+        # generated/foo is generated successfully
+        assert app.env.get_doctree('generated/autosummary_dummy_package_all')
+        module = (app.srcdir / 'generated' / 'autosummary_dummy_package_all.rst').read_text(encoding='utf8')
+        assert ('   .. autosummary::\n'
+                '   \n'
+                '      PublicBar\n'
+                '   \n' in module)
+        assert ('   .. autosummary::\n'
+                '   \n'
+                '      public_foo\n'
+                '      public_baz\n'
+                '   \n' in module)
+        assert ('.. autosummary::\n'
+                '   :toctree:\n'
+                '   :recursive:\n\n'
+                '   autosummary_dummy_package_all.extra_dummy_module\n\n' in module)
+    finally:
+        sys.modules.pop('autosummary_dummy_package_all', None)
+
+
 @pytest.mark.sphinx(testroot='ext-autodoc',
                     confoverrides={'extensions': 'sphinx.ext.autosummary'})
 def test_generate_autosummary_docs_property(app):
@@ -543,7 +629,7 @@
         mock.return_value = AutosummaryEntry('target.methods.Base.prop', 'prop', None, False)
         generate_autosummary_docs(, output_dir=app.srcdir, app=app)
 
-    content = (app.srcdir / 'target.methods.Base.prop.rst').read_text()
+    content = (app.srcdir / 'target.methods.Base.prop.rst').read_text(encoding='utf8')
     assert content == ("target.methods.Base.prop\n"
                        "========================\n"
                        "\n"
@@ -556,7 +642,7 @@
 def test_autosummary_skip_member(app):
     app.build()
 
-    content = (app.srcdir / 'generate' / 'target.Foo.rst').read_text()
+    content = (app.srcdir / 'generate' / 'target.Foo.rst').read_text(encoding='utf8')
     assert 'Foo.skipmeth' not in content
     assert 'Foo._privatemeth' in content
 
@@ -565,7 +651,7 @@
 def test_autosummary_template(app):
     app.build()
 
-    content = (app.srcdir / 'generate' / 'target.Foo.rst').read_text()
+    content = (app.srcdir / 'generate' / 'target.Foo.rst').read_text(encoding='utf8')
     assert 'EMPTY' in content
 
 
@@ -584,7 +670,7 @@
 
 
 def test_autogen(rootdir, tempdir):
-    with cd(rootdir / 'test-templating'):
+    with chdir(rootdir / 'test-templating'):
         args = '-o', tempdir, '-t', '.', 'autosummary_templating.txt'
         autogen_main(args)
         assert (tempdir / 'sphinx.application.TemplateBridge.rst').exists()

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_coverage.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_coverage.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_coverage
-    ~~~~~~~~~~~~~
-
-    Test the coverage builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the coverage builder."""
 
 import pickle
 
@@ -17,7 +9,7 @@
 def test_build(app, status, warning):
     app.builder.build_all()
 
-    py_undoc = (app.outdir / 'python.txt').read_text()
+    py_undoc = (app.outdir / 'python.txt').read_text(encoding='utf8')
     assert py_undoc.startswith('Undocumented Python objects\n'
                                '===========================\n')
     assert 'autodoc_target\n--------------\n' in py_undoc
@@ -26,11 +18,11 @@
     assert ' * function\n' not in py_undoc  # these two are documented
     assert ' * Class\n' not in py_undoc     # in autodoc.txt
 
-    assert ' * mod -- No module named mod'  # in the "failed import" section
+    assert " * mod -- No module named 'mod'" in py_undoc  # in the "failed import" section
 
     assert "undocumented  py" not in status.getvalue()
 
-    c_undoc = (app.outdir / 'c.txt').read_text()
+    c_undoc = (app.outdir / 'c.txt').read_text(encoding='utf8')
     assert c_undoc.startswith('Undocumented C API elements\n'
                               '===========================\n')
     assert 'api.h' in c_undoc
@@ -54,7 +46,7 @@
 @pytest.mark.sphinx('coverage', testroot='ext-coverage')
 def test_coverage_ignore_pyobjects(app, status, warning):
     app.builder.build_all()
-    actual = (app.outdir / 'python.txt').read_text()
+    actual = (app.outdir / 'python.txt').read_text(encoding='utf8')
     expected = '''Undocumented Python objects
 ===========================
 coverage_not_ignored

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_doctest.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_doctest.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_doctest
-    ~~~~~~~~~~~~
-
-    Test the doctest extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the doctest extension."""
 import os
 from collections import Counter
 
@@ -26,7 +18,7 @@
     cleanup_called = 0
     app.builder.build_all()
     if app.statuscode != 0:
-        assert False, 'failures in doctests:' + status.getvalue()
+        raise AssertionError('failures in doctests:' + status.getvalue())
     # in doctest.txt, there are two named groups and the default group,
     # so the cleanup function must be called three times
     assert cleanup_called == 3, 'testcleanup did not get executed enough times'
@@ -37,16 +29,16 @@
     app.build()
     doctree = app.env.get_doctree('doctest')
     for node in doctree.findall(nodes.literal_block):
-        assert node'language' in ('python3', 'pycon3', 'none')
+        assert node'language' in {'python', 'pycon', 'none'}
 
 
 @pytest.mark.sphinx('dummy', testroot='ext-doctest',
                     confoverrides={'highlight_language': 'python'})
-def test_highlight_language_python2(app, status, warning):
+def test_highlight_language_python3(app, status, warning):
     app.build()
     doctree = app.env.get_doctree('doctest')
     for node in doctree.findall(nodes.literal_block):
-        assert node'language' in ('python', 'pycon', 'none')
+        assert node'language' in {'python', 'pycon', 'none'}
 
 
 def test_is_allowed_version():
@@ -96,7 +88,7 @@
     recorded_calls = Counter()
     app.builder.build_all()
     if app.statuscode != 0:
-        assert False, 'failures in doctests:' + status.getvalue()
+        raise AssertionError('failures in doctests:' + status.getvalue())
     # The `:skipif:` expressions are always run.
     # Actual tests and setup/cleanup code is only run if the `:skipif:`
     # expression evaluates to a False value.
@@ -123,9 +115,8 @@
 
 
 def record(directive, part, should_skip):
-    global recorded_calls
     recorded_calls(directive, part, should_skip) += 1
-    return 'Recorded {} {} {}'.format(directive, part, should_skip)
+    return f'Recorded {directive} {part} {should_skip}'
 
 
 @pytest.mark.sphinx('doctest', testroot='ext-doctest-with-autodoc')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_duration.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_duration.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_extlinks.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_extlinks.py Changed

@@ -1,18 +1,26 @@
 import pytest
 
 
+@pytest.mark.sphinx('html', testroot='ext-extlinks-hardcoded-urls',
+                    confoverrides={'extlinks_detect_hardcoded_links': False})
+def test_extlinks_detect_candidates(app, warning):
+    app.build()
+    assert warning.getvalue() == ''
+
+
 @pytest.mark.sphinx('html', testroot='ext-extlinks-hardcoded-urls')
 def test_replaceable_uris_emit_extlinks_warnings(app, warning):
     app.build()
     warning_output = warning.getvalue()
+
     # there should be exactly three warnings for replaceable URLs
     message = (
-        "WARNING: hardcoded link 'https://github.com/sphinx-doc/sphinx/issues/1' "
-        "could be replaced by an extlink (try using ':issue:`1`' instead)"
+        "index.rst:%d: WARNING: hardcoded link 'https://github.com/sphinx-doc/sphinx/issues/1' "
+        "could be replaced by an extlink (try using '%s' instead)"
     )
-    assert f"index.rst:11: {message}" in warning_output
-    assert f"index.rst:13: {message}" in warning_output
-    assert f"index.rst:15: {message}" in warning_output
+    assert message % (11, ":issue:`1`") in warning_output
+    assert message % (13, ":issue:`inline replaceable link <1>`") in warning_output
+    assert message % (15, ":issue:`replaceable link <1>`") in warning_output
 
 
 @pytest.mark.sphinx('html', testroot='ext-extlinks-hardcoded-urls-multiple-replacements')
@@ -20,17 +28,18 @@
     app.build()
     warning_output = warning.getvalue()
     # there should be six warnings for replaceable URLs, three pairs per link
+    assert warning_output.count("WARNING: hardcoded link") == 6
     message = (
-        "WARNING: hardcoded link 'https://github.com/octocat' "
-        "could be replaced by an extlink (try using ':user:`octocat`' instead)"
+        "index.rst:%d: WARNING: hardcoded link 'https://github.com/octocat' "
+        "could be replaced by an extlink (try using '%s' instead)"
     )
-    assert f"index.rst:14: {message}" in warning_output
-    assert f"index.rst:16: {message}" in warning_output
-    assert f"index.rst:18: {message}" in warning_output
+    assert message % (14, ":user:`octocat`") in warning_output
+    assert message % (16, ":user:`inline replaceable link <octocat>`") in warning_output
+    assert message % (18, ":user:`replaceable link <octocat>`") in warning_output
     message = (
-        "WARNING: hardcoded link 'https://github.com/octocat' "
-        "could be replaced by an extlink (try using ':repo:`octocat`' instead)"
+        "index.rst:%d: WARNING: hardcoded link 'https://github.com/octocat' "
+        "could be replaced by an extlink (try using '%s' instead)"
     )
-    assert f"index.rst:14: {message}" in warning_output
-    assert f"index.rst:16: {message}" in warning_output
-    assert f"index.rst:18: {message}" in warning_output
+    assert message % (14, ":repo:`octocat`") in warning_output
+    assert message % (16, ":repo:`inline replaceable link <octocat>`") in warning_output
+    assert message % (18, ":repo:`replaceable link <octocat>`") in warning_output

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_githubpages.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_githubpages.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_graphviz.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_graphviz.py Changed

@@ -1,19 +1,10 @@
-"""
-    test_ext_graphviz
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.graphviz extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.graphviz extension."""
 
 import re
 
 import pytest
 
 from sphinx.ext.graphviz import ClickableMapDefinition
-from sphinx.util import docutils
 
 
 @pytest.mark.sphinx('html', testroot='ext-graphviz')
@@ -21,16 +12,11 @@
 def test_graphviz_png_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
-    if docutils.__version_info__ < (0, 17):
-        html = (r'<div class="figure align-default" .*?>\s*'
-                r'<div class="graphviz"><img .*?/></div>\s*<p class="caption">'
-                r'<span class="caption-text">caption of graph</span>.*</p>\s*</div>')
-    else:
-        html = (r'<figure class="align-default" .*?>\s*'
-                r'<div class="graphviz"><img .*?/></div>\s*<figcaption>\s*'
-                r'<p><span class="caption-text">caption of graph</span>.*</p>\s*'
-                r'</figcaption>\s*</figure>')
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    html = (r'<figure class="align-default" .*?>\s*'
+            r'<div class="graphviz"><img .*?/></div>\s*<figcaption>\s*'
+            r'<p><span class="caption-text">caption of graph</span>.*</p>\s*'
+            r'</figcaption>\s*</figure>')
     assert re.search(html, content, re.S)
 
     html = 'Hello <div class="graphviz"><img .*?/></div>\n graphviz world'
@@ -40,15 +26,10 @@
             'class="graphviz neato-graph" />')
     assert re.search(html, content, re.S)
 
-    if docutils.__version_info__ < (0, 17):
-        html = (r'<div class="figure align-right" .*?>\s*'
-                r'<div class="graphviz"><img .*?/></div>\s*<p class="caption">'
-                r'<span class="caption-text">on <em>right</em></span>.*</p>\s*</div>')
-    else:
-        html = (r'<figure class="align-right" .*?>\s*'
-                r'<div class="graphviz"><img .*?/></div>\s*<figcaption>\s*'
-                r'<p><span class="caption-text">on <em>right</em></span>.*</p>\s*'
-                r'</figcaption>\s*</figure>')
+    html = (r'<figure class="align-right" .*?>\s*'
+            r'<div class="graphviz"><img .*?/></div>\s*<figcaption>\s*'
+            r'<p><span class="caption-text">on <em>right</em></span>.*</p>\s*'
+            r'</figcaption>\s*</figure>')
     assert re.search(html, content, re.S)
 
     html = (r'<div align=\"center\" class=\"align-center\">'
@@ -64,26 +45,17 @@
 def test_graphviz_svg_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
-
-    if docutils.__version_info__ < (0, 17):
-        html = (r'<div class=\"figure align-default\" .*?>\n'
-                r'<div class="graphviz"><object data=\".*\.svg\".*>\n'
-                r'\s*<p class=\"warning\">digraph foo {\n'
-                r'bar -&gt; baz\n'
-                r'}</p></object></div>\n'
-                r'<p class=\"caption\"><span class=\"caption-text\">'
-                r'caption of graph</span>.*</p>\n</div>')
-    else:
-        html = (r'<figure class=\"align-default\" .*?>\n'
-                r'<div class="graphviz"><object data=\".*\.svg\".*>\n'
-                r'\s*<p class=\"warning\">digraph foo {\n'
-                r'bar -&gt; baz\n'
-                r'}</p></object></div>\n'
-                r'<figcaption>\n'
-                r'<p><span class=\"caption-text\">caption of graph</span>.*</p>\n'
-                r'</figcaption>\n'
-                r'</figure>')
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    html = (r'<figure class=\"align-default\" .*?>\n'
+            r'<div class="graphviz"><object data=\".*\.svg\".*>\n'
+            r'\s*<p class=\"warning\">digraph foo {\n'
+            r'bar -&gt; baz\n'
+            r'}</p></object></div>\n'
+            r'<figcaption>\n'
+            r'<p><span class=\"caption-text\">caption of graph</span>.*</p>\n'
+            r'</figcaption>\n'
+            r'</figure>')
     assert re.search(html, content, re.S)
 
     html = (r'Hello <div class="graphviz"><object.*>\n'
@@ -91,25 +63,15 @@
             r' graphviz world')
     assert re.search(html, content, re.S)
 
-    if docutils.__version_info__ < (0, 17):
-        html = (r'<div class=\"figure align-right\" .*\>\n'
-                r'<div class="graphviz"><object data=\".*\.svg\".*>\n'
-                r'\s*<p class=\"warning\">digraph bar {\n'
-                r'foo -&gt; bar\n'
-                r'}</p></object></div>\n'
-                r'<p class=\"caption\"><span class=\"caption-text\">'
-                r'on <em>right</em></span>.*</p>\n'
-                r'</div>')
-    else:
-        html = (r'<figure class=\"align-right\" .*\>\n'
-                r'<div class="graphviz"><object data=\".*\.svg\".*>\n'
-                r'\s*<p class=\"warning\">digraph bar {\n'
-                r'foo -&gt; bar\n'
-                r'}</p></object></div>\n'
-                r'<figcaption>\n'
-                r'<p><span class=\"caption-text\">on <em>right</em></span>.*</p>\n'
-                r'</figcaption>\n'
-                r'</figure>')
+    html = (r'<figure class=\"align-right\" .*\>\n'
+            r'<div class="graphviz"><object data=\".*\.svg\".*>\n'
+            r'\s*<p class=\"warning\">digraph bar {\n'
+            r'foo -&gt; bar\n'
+            r'}</p></object></div>\n'
+            r'<figcaption>\n'
+            r'<p><span class=\"caption-text\">on <em>right</em></span>.*</p>\n'
+            r'</figcaption>\n'
+            r'</figure>')
     assert re.search(html, content, re.S)
 
     html = (r'<div align=\"center\" class=\"align-center\">'
@@ -126,7 +88,7 @@
 def test_graphviz_latex(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
     macro = ('\\\\begin{figure}\\htbp\\\n\\\\centering\n\\\\capstart\n\n'
              '\\\\sphinxincludegraphics\\\\{graphviz-\\w+.pdf}\n'
              '\\\\caption{caption of graph}\\\\label{.*}\\\\end{figure}')
@@ -152,7 +114,7 @@
 def test_graphviz_i18n(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     html = '<img src=".*?" alt="digraph {\n  BAR -&gt; BAZ\n}" class="graphviz" />'
     assert re.search(html, content, re.M)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_ifconfig.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_ifconfig.py Changed

@@ -1,19 +1,28 @@
-"""
-    test_ext_ifconfig
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.ifconfig extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.ifconfig extension."""
 
+import docutils.utils
 import pytest
 
+from sphinx import addnodes
+from sphinx.testing import restructuredtext
+
 
 @pytest.mark.sphinx('text', testroot='ext-ifconfig')
 def test_ifconfig(app, status, warning):
     app.builder.build_all()
-    result = (app.outdir / 'index.txt').read_text()
+    result = (app.outdir / 'index.txt').read_text(encoding='utf8')
     assert 'spam' in result
     assert 'ham' not in result
+
+
+def test_ifconfig_content_line_number(app):
+    app.setup_extension("sphinx.ext.ifconfig")
+    text = (".. ifconfig:: confval1\n" +
+            "\n" +
+            "   Some link here: :ref:`abc`\n")
+    doc = restructuredtext.parse(app, text)
+    xrefs = list(doc.findall(condition=addnodes.pending_xref))
+    assert len(xrefs) == 1
+    source, line = docutils.utils.get_source_line(xrefs0)
+    assert 'index.rst' in source
+    assert line == 3

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_imgconverter.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_imgconverter.py Changed

@@ -1,24 +1,29 @@
-"""
-    test_ext_imgconverter
-    ~~~~~~~~~~~~~~~~~~~~~
+"""Test sphinx.ext.imgconverter extension."""
 
-    Test sphinx.ext.imgconverter extension.
+import subprocess
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+import pytest
 
-import os
 
-import pytest
+@pytest.fixture()
+def _if_converter_found(app):
+    image_converter = getattr(app.config, 'image_converter', '')
+    try:
+        if image_converter:
+            subprocess.run(image_converter, '-version', capture_output=True)  # show version
+            return
+    except OSError:  # No such file or directory
+        pass
+
+    pytest.skip('image_converter "%s" is not available' % image_converter)
 
 
+@pytest.mark.usefixtures('_if_converter_found')
 @pytest.mark.sphinx('latex', testroot='ext-imgconverter')
-@pytest.mark.xfail(os.name != 'posix', reason="Not working on windows")
 def test_ext_imgconverter(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
 
     # supported image (not converted)
     assert '\\sphinxincludegraphics{{img}.pdf}' in content

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_imgmockconverter.py Added

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_inheritance_diagram.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_inheritance_diagram.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_ext_inheritance_diagram
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.inheritance_diagram extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.inheritance_diagram extension."""
 
 import os
 import re
@@ -14,9 +6,11 @@
 
 import pytest
 
-from sphinx.ext.inheritance_diagram import (InheritanceDiagram, InheritanceException,
-                                            import_classes)
-from sphinx.util import docutils
+from sphinx.ext.inheritance_diagram import (
+    InheritanceDiagram,
+    InheritanceException,
+    import_classes,
+)
 
 
 @pytest.mark.sphinx(buildername="html", testroot="inheritance")
@@ -58,7 +52,7 @@
             ('dummy.test.C', 'dummy.test.C', 'dummy.test.A', None),
             ('dummy.test.E', 'dummy.test.E', 'dummy.test.B', None),
             ('dummy.test.D', 'dummy.test.D', 'dummy.test.B', 'dummy.test.C', None),
-            ('dummy.test.B', 'dummy.test.B', 'dummy.test.A', None)
+            ('dummy.test.B', 'dummy.test.B', 'dummy.test.A', None),
         
 
     # inheritance diagram using :parts: 1 option
@@ -69,7 +63,7 @@
             ('C', 'dummy.test.C', 'A', None),
             ('E', 'dummy.test.E', 'B', None),
             ('D', 'dummy.test.D', 'B', 'C', None),
-            ('B', 'dummy.test.B', 'A', None)
+            ('B', 'dummy.test.B', 'A', None),
         
 
     # inheritance diagram with 1 top class
@@ -88,7 +82,7 @@
             ('dummy.test.C', 'dummy.test.C', 'dummy.test.A', None),
             ('dummy.test.E', 'dummy.test.E', 'dummy.test.B', None),
             ('dummy.test.D', 'dummy.test.D', 'dummy.test.B', 'dummy.test.C', None),
-            ('dummy.test.B', 'dummy.test.B', , None)
+            ('dummy.test.B', 'dummy.test.B', , None),
         
 
     # inheritance diagram with 2 top classes
@@ -106,7 +100,7 @@
             ('dummy.test.C', 'dummy.test.C', , None),
             ('dummy.test.E', 'dummy.test.E', 'dummy.test.B', None),
             ('dummy.test.D', 'dummy.test.D', 'dummy.test.B', 'dummy.test.C', None),
-            ('dummy.test.B', 'dummy.test.B', , None)
+            ('dummy.test.B', 'dummy.test.B', , None),
         
 
     # inheritance diagram with 2 top classes and specifying the entire module
@@ -137,7 +131,7 @@
         assert cls in 
             ('dummy.test_nested.A', 'dummy.test_nested.A', , None),
             ('dummy.test_nested.C', 'dummy.test_nested.C', 'dummy.test_nested.A.B', None),
-            ('dummy.test_nested.A.B', 'dummy.test_nested.A.B', , None)
+            ('dummy.test_nested.A.B', 'dummy.test_nested.A.B', , None),
         
 
 
@@ -146,22 +140,14 @@
 def test_inheritance_diagram_png_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
-
-    if docutils.__version_info__ < (0, 17):
-        pattern = ('<div class="figure align-default" id="id1">\n'
-                   '<div class="graphviz">'
-                   '<img src="_images/inheritance-\\w+.png" alt="Inheritance diagram of test.Foo" '
-                   'class="inheritance graphviz" /></div>\n<p class="caption">'
-                   '<span class="caption-text">Test Foo!</span><a class="headerlink" href="#id1" '
-                   'title="Permalink to this image">\xb6</a></p>\n</div>\n')
-    else:
-        pattern = ('<figure class="align-default" id="id1">\n'
-                   '<div class="graphviz">'
-                   '<img src="_images/inheritance-\\w+.png" alt="Inheritance diagram of test.Foo" '
-                   'class="inheritance graphviz" /></div>\n<figcaption>\n<p>'
-                   '<span class="caption-text">Test Foo!</span><a class="headerlink" href="#id1" '
-                   'title="Permalink to this image">\xb6</a></p>\n</figcaption>\n</figure>\n')
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    pattern = ('<figure class="align-default" id="id1">\n'
+               '<div class="graphviz">'
+               '<img src="_images/inheritance-\\w+.png" alt="Inheritance diagram of test.Foo" '
+               'class="inheritance graphviz" /></div>\n<figcaption>\n<p>'
+               '<span class="caption-text">Test Foo!</span><a class="headerlink" href="#id1" '
+               'title="Permalink to this image">\xb6</a></p>\n</figcaption>\n</figure>\n')
     assert re.search(pattern, content, re.M)
 
 
@@ -171,26 +157,16 @@
 def test_inheritance_diagram_svg_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
-
-    if docutils.__version_info__ < (0, 17):
-        pattern = ('<div class="figure align-default" id="id1">\n'
-                   '<div class="graphviz">'
-                   '<object data="_images/inheritance-\\w+.svg" '
-                   'type="image/svg\\+xml" class="inheritance graphviz">\n'
-                   '<p class=\"warning\">Inheritance diagram of test.Foo</p>'
-                   '</object></div>\n<p class="caption"><span class="caption-text">'
-                   'Test Foo!</span><a class="headerlink" href="#id1" '
-                   'title="Permalink to this image">\xb6</a></p>\n</div>\n')
-    else:
-        pattern = ('<figure class="align-default" id="id1">\n'
-                   '<div class="graphviz">'
-                   '<object data="_images/inheritance-\\w+.svg" '
-                   'type="image/svg\\+xml" class="inheritance graphviz">\n'
-                   '<p class=\"warning\">Inheritance diagram of test.Foo</p>'
-                   '</object></div>\n<figcaption>\n<p><span class="caption-text">'
-                   'Test Foo!</span><a class="headerlink" href="#id1" '
-                   'title="Permalink to this image">\xb6</a></p>\n</figcaption>\n</figure>\n')
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    pattern = ('<figure class="align-default" id="id1">\n'
+               '<div class="graphviz">'
+               '<object data="_images/inheritance-\\w+.svg" '
+               'type="image/svg\\+xml" class="inheritance graphviz">\n'
+               '<p class=\"warning\">Inheritance diagram of test.Foo</p>'
+               '</object></div>\n<figcaption>\n<p><span class="caption-text">'
+               'Test Foo!</span><a class="headerlink" href="#id1" '
+               'title="Permalink to this image">\xb6</a></p>\n</figcaption>\n</figure>\n')
 
     assert re.search(pattern, content, re.M)
 
@@ -200,7 +176,7 @@
 def test_inheritance_diagram_latex(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
 
     pattern = ('\\\\begin{figure}\\htbp\n\\\\centering\n\\\\capstart\n\n'
                '\\\\sphinxincludegraphics\\\\{inheritance-\\w+.pdf}\n'
@@ -222,22 +198,14 @@
     assert ('test.Bar', 'test.Bar', 'alias.Foo', None) in aliased_graph
     assert ('alias.Foo', 'alias.Foo', , None) in aliased_graph
 
-    content = (app.outdir / 'index.html').read_text()
-
-    if docutils.__version_info__ < (0, 17):
-        pattern = ('<div class="figure align-default" id="id1">\n'
-                   '<div class="graphviz">'
-                   '<img src="_images/inheritance-\\w+.png" alt="Inheritance diagram of test.Foo" '
-                   'class="inheritance graphviz" /></div>\n<p class="caption">'
-                   '<span class="caption-text">Test Foo!</span><a class="headerlink" href="#id1" '
-                   'title="Permalink to this image">\xb6</a></p>\n</div>\n')
-    else:
-        pattern = ('<figure class="align-default" id="id1">\n'
-                   '<div class="graphviz">'
-                   '<img src="_images/inheritance-\\w+.png" alt="Inheritance diagram of test.Foo" '
-                   'class="inheritance graphviz" /></div>\n<figcaption>\n<p>'
-                   '<span class="caption-text">Test Foo!</span><a class="headerlink" href="#id1" '
-                   'title="Permalink to this image">\xb6</a></p>\n</figcaption>\n</figure>\n')
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+
+    pattern = ('<figure class="align-default" id="id1">\n'
+               '<div class="graphviz">'
+               '<img src="_images/inheritance-\\w+.png" alt="Inheritance diagram of test.Foo" '
+               'class="inheritance graphviz" /></div>\n<figcaption>\n<p>'
+               '<span class="caption-text">Test Foo!</span><a class="headerlink" href="#id1" '
+               'title="Permalink to this image">\xb6</a></p>\n</figcaption>\n</figure>\n')
     assert re.search(pattern, content, re.M)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_intersphinx.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_intersphinx.py Changed

@@ -1,25 +1,23 @@
-"""
-    test_intersphinx
-    ~~~~~~~~~~~~~~~~
-
-    Test the intersphinx extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the intersphinx extension."""
 
 import http.server
 import os
-import unittest
 from unittest import mock
 
 import pytest
 from docutils import nodes
 
 from sphinx import addnodes
-from sphinx.ext.intersphinx import (INVENTORY_FILENAME, _get_safe_url, _strip_basic_auth,
-                                    fetch_inventory, inspect_main, load_mappings,
-                                    missing_reference, normalize_intersphinx_mapping)
+from sphinx.ext.intersphinx import (
+    INVENTORY_FILENAME,
+    _get_safe_url,
+    _strip_basic_auth,
+    fetch_inventory,
+    inspect_main,
+    load_mappings,
+    missing_reference,
+    normalize_intersphinx_mapping,
+)
 from sphinx.ext.intersphinx import setup as intersphinx_setup
 
 from .test_util_inventory import inventory_v2, inventory_v2_not_having_version
@@ -50,7 +48,7 @@
 
 @mock.patch('sphinx.ext.intersphinx.InventoryFile')
 @mock.patch('sphinx.ext.intersphinx._read_from_url')
-def test_fetch_inventory_redirection(_read_from_url, InventoryFile, app, status, warning):
+def test_fetch_inventory_redirection(_read_from_url, InventoryFile, app, status, warning):  # NoQA: PT019
     intersphinx_setup(app)
     _read_from_url().readline.return_value = b'# Sphinx inventory version 2'
 
@@ -254,7 +252,7 @@
     load_mappings(app)
 
     app.build()
-    html = (app.outdir / 'index.html').read_text()
+    html = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<a class="reference external"'
             ' href="https://docs.python.org/index.html#cpp_foo_bar"'
             ' title="(in foo v2.0)">'
@@ -392,7 +390,10 @@
     # load the inventory and check if it's done correctly
     normalize_intersphinx_mapping(app, app.config)
     load_mappings(app)
-    assert warning.getvalue().count('\n') == 1
+    warnings = warning.getvalue().splitlines()
+    assert len(warnings) == 2
+    assert "The pre-Sphinx 1.0 'intersphinx_mapping' format is " in warnings0
+    assert 'intersphinx identifier 12345 is not string. Ignored' in warnings1
 
 
 def test_load_mappings_fallback(tempdir, app, status, warning):
@@ -423,27 +424,27 @@
     normalize_intersphinx_mapping(app, app.config)
     load_mappings(app)
     assert "encountered some issues with some of the inventories" in status.getvalue()
-    assert "" == warning.getvalue()
+    assert warning.getvalue() == ""
 
     rn = reference_check(app, 'py', 'func', 'module1.func', 'foo')
     assert isinstance(rn, nodes.reference)
 
 
-class TestStripBasicAuth(unittest.TestCase):
+class TestStripBasicAuth:
     """Tests for sphinx.ext.intersphinx._strip_basic_auth()"""
     def test_auth_stripped(self):
         """basic auth creds stripped from URL containing creds"""
         url = 'https://user:12345@domain.com/project/objects.inv'
         expected = 'https://domain.com/project/objects.inv'
         actual = _strip_basic_auth(url)
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_no_auth(self):
         """url unchanged if param doesn't contain basic auth creds"""
         url = 'https://domain.com/project/objects.inv'
         expected = 'https://domain.com/project/objects.inv'
         actual = _strip_basic_auth(url)
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_having_port(self):
         """basic auth creds correctly stripped from URL containing creds even if URL
@@ -451,7 +452,7 @@
         url = 'https://user:12345@domain.com:8080/project/objects.inv'
         expected = 'https://domain.com:8080/project/objects.inv'
         actual = _strip_basic_auth(url)
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
 
 def test_getsafeurl_authed():
@@ -541,7 +542,7 @@
     load_mappings(app)
 
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     wStr = warning.getvalue()
 
     html = '<a class="reference external" href="http://example.org/{}" title="(in foo v2.0)">'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_math.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_math.py Changed

@@ -1,14 +1,7 @@
-"""
-    test_ext_math
-    ~~~~~~~~~~~~~
-
-    Test math extensions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test math extensions."""
 
 import re
+import shutil
 import subprocess
 import warnings
 
@@ -40,7 +33,8 @@
     if "dvipng command 'dvipng' cannot be run" in warning.getvalue():
         raise pytest.skip.Exception('dvipng command "dvipng" is not available')
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    shutil.rmtree(app.outdir)
     html = (r'<div class="math">\s*<p>\s*<img src="_images/math/\w+.png"'
             r'\s*alt="a\^2\+b\^2=c\^2"/>\s*</p>\s*</div>')
     assert re.search(html, content, re.S)
@@ -58,19 +52,40 @@
     if "dvisvgm command 'dvisvgm' cannot be run" in warning.getvalue():
         raise pytest.skip.Exception('dvisvgm command "dvisvgm" is not available')
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    shutil.rmtree(app.outdir)
     html = (r'<div class="math">\s*<p>\s*<img src="_images/math/\w+.svg"'
             r'\s*alt="a\^2\+b\^2=c\^2"/>\s*</p>\s*</div>')
     assert re.search(html, content, re.S)
 
 
+@pytest.mark.skipif(not has_binary('dvisvgm'),
+                    reason='Requires dvisvgm" binary')
+@pytest.mark.sphinx('html', testroot='ext-math-simple',
+                    confoverrides={'extensions': 'sphinx.ext.imgmath',
+                                   'imgmath_image_format': 'svg',
+                                   'imgmath_embed': True})
+def test_imgmath_svg_embed(app, status, warning):
+    app.builder.build_all()
+    if "LaTeX command 'latex' cannot be run" in warning.getvalue():
+        pytest.skip('LaTeX command "latex" is not available')
+    if "dvisvgm command 'dvisvgm' cannot be run" in warning.getvalue():
+        pytest.skip('dvisvgm command "dvisvgm" is not available')
+
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    shutil.rmtree(app.outdir)
+    html = r'<img src="data:image/svg\+xml;base64,\w\+/=+"'
+    assert re.search(html, content, re.DOTALL)
+
+
 @pytest.mark.sphinx('html', testroot='ext-math',
                     confoverrides={'extensions': 'sphinx.ext.mathjax',
                                    'mathjax_options': {'integrity': 'sha384-0123456789'}})
 def test_mathjax_options(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    shutil.rmtree(app.outdir)
     assert ('<script async="async" integrity="sha384-0123456789" '
             'src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">'
             '</script>' in content)
@@ -81,7 +96,8 @@
 def test_mathjax_align(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
+    shutil.rmtree(app.outdir)
     html = (r'<div class="math notranslate nohighlight">\s*'
             r'\\\ \\begin\{align\}\\begin\{aligned\}S \&amp;= \\pi r\^2\\\\'
             r'V \&amp;= \\frac\{4\}\{3\} \\pi r\^3\\end\{aligned\}\\end\{align\} \\\</div>')
@@ -92,9 +108,9 @@
                     confoverrides={'math_number_all': True,
                                    'extensions': 'sphinx.ext.mathjax'})
 def test_math_number_all_mathjax(app, status, warning):
-    app.builder.build_all()
+    app.build()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     html = (r'<div class="math notranslate nohighlight" id="equation-index-0">\s*'
             r'<span class="eqno">$1$<a .*>\xb6</a></span>\\\a\^2\+b\^2=c\^2\\\</div>')
     assert re.search(html, content, re.S)
@@ -103,9 +119,9 @@
 @pytest.mark.sphinx('latex', testroot='ext-math',
                     confoverrides={'extensions': 'sphinx.ext.mathjax'})
 def test_math_number_all_latex(app, status, warning):
-    app.builder.build_all()
+    app.build()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
     macro = (r'\\begin{equation\*}\s*'
              r'\\begin{split}a\^2\+b\^2=c\^2\\end{split}\s*'
              r'\\end{equation\*}')
@@ -135,7 +151,7 @@
 def test_math_eqref_format_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'math.html').read_text()
+    content = (app.outdir / 'math.html').read_text(encoding='utf8')
     html = ('<p>Referencing equation <a class="reference internal" '
             'href="#equation-foo">Eq.1</a> and <a class="reference internal" '
             'href="#equation-foo">Eq.1</a>.</p>')
@@ -148,7 +164,7 @@
 def test_math_eqref_format_latex(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
     macro = (r'Referencing equation Eq.\\ref{equation:math:foo} and '
              r'Eq.\\ref{equation:math:foo}.')
     assert re.search(macro, content, re.S)
@@ -161,7 +177,7 @@
 def test_mathjax_numfig_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'math.html').read_text()
+    content = (app.outdir / 'math.html').read_text(encoding='utf8')
     html = ('<div class="math notranslate nohighlight" id="equation-math-0">\n'
             '<span class="eqno">(1.2)')
     assert html in content
@@ -179,7 +195,7 @@
 def test_imgmath_numfig_html(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'page.html').read_text()
+    content = (app.outdir / 'page.html').read_text(encoding='utf8')
     html = '<span class="eqno">(3)<a class="headerlink" href="#equation-bar"'
     assert html in content
     html = ('<p>Referencing equations <a class="reference internal" '
@@ -219,7 +235,7 @@
 def test_mathjax3_config(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert MATHJAX_URL in content
     assert ('<script defer="defer" src="%s">' % MATHJAX_URL in content)
     assert ('<script>window.MathJax = {"extensions": "tex2jax.js"}</script>' in content)
@@ -231,7 +247,7 @@
 def test_mathjax2_config(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<script async="async" src="%s">' % MATHJAX_URL in content)
     assert ('<script type="text/x-mathjax-config">'
             'MathJax.Hub.Config({"extensions": "tex2jax.js"})'
@@ -245,7 +261,7 @@
 def test_mathjax_options_async_for_mathjax3(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert MATHJAX_URL in content
     assert ('<script async="async" src="%s">' % MATHJAX_URL in content)
 
@@ -257,7 +273,7 @@
 def test_mathjax_options_defer_for_mathjax2(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<script defer="defer" src="%s">' % MATHJAX_URL in content)
 
 
@@ -266,10 +282,10 @@
 def test_mathjax_is_installed_only_if_document_having_math(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert MATHJAX_URL in content
 
-    content = (app.outdir / 'nomath.html').read_text()
+    content = (app.outdir / 'nomath.html').read_text(encoding='utf8')
     assert MATHJAX_URL not in content
 
 
@@ -278,7 +294,7 @@
 def test_mathjax_is_not_installed_if_no_equations(app, status, warning):
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert 'MathJax.js' not in content
 
 
@@ -288,8 +304,8 @@
     app.set_html_assets_policy('always')
     app.builder.build_all()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert MATHJAX_URL in content
 
-    content = (app.outdir / 'nomath.html').read_text()
+    content = (app.outdir / 'nomath.html').read_text(encoding='utf8')
     assert MATHJAX_URL in content

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_napoleon.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_napoleon.py Changed

@@ -1,17 +1,9 @@
-"""
-    test_napoleon
-    ~~~~~~~~~~~~~
+"""Tests for :mod:`sphinx.ext.napoleon.__init__` module."""
 
-    Tests for :mod:`sphinx.ext.napoleon.__init__` module.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import sys
 from collections import namedtuple
-from unittest import TestCase, mock
+from unittest import mock
+
+import pytest
 
 from sphinx.application import Sphinx
 from sphinx.ext.napoleon import Config, _process_docstring, _skip_member, setup
@@ -76,7 +68,7 @@
 SampleNamedTuple = namedtuple('SampleNamedTuple', 'user_id block_type def_id')
 
 
-class ProcessDocstringTest(TestCase):
+class TestProcessDocstring:
     def test_modify_in_place(self):
         lines = 'Summary line.',
                  '',
@@ -91,10 +83,10 @@
                     '',
                     ':param arg1: arg1 description',
                     ''
-        self.assertEqual(expected, lines)
+        assert expected == lines
 
 
-class SetupTest(TestCase):
+class TestSetup:
     def test_unknown_app_type(self):
         setup(object())
 
@@ -104,115 +96,113 @@
         for name in Config._config_values:
             has_config = False
             for method_name, args, _kwargs in app.method_calls:
-                if(method_name == 'add_config_value' and
-                   args0 == name):
+                if (
+                    method_name == 'add_config_value' and
+                    args0 == name
+                ):
                     has_config = True
             if not has_config:
-                self.fail('Config value was not added to app %s' % name)
+                pytest.fail('Config value was not added to app %s' % name)
 
         has_process_docstring = False
         has_skip_member = False
         for method_name, args, _kwargs in app.method_calls:
             if method_name == 'connect':
-                if(args0 == 'autodoc-process-docstring' and
-                   args1 == _process_docstring):
+                if (
+                    args0 == 'autodoc-process-docstring' and
+                    args1 == _process_docstring
+                ):
                     has_process_docstring = True
-                elif(args0 == 'autodoc-skip-member' and
-                     args1 == _skip_member):
+                elif (
+                    args0 == 'autodoc-skip-member' and
+                    args1 == _skip_member
+                ):
                     has_skip_member = True
         if not has_process_docstring:
-            self.fail('autodoc-process-docstring never connected')
+            pytest.fail('autodoc-process-docstring never connected')
         if not has_skip_member:
-            self.fail('autodoc-skip-member never connected')
+            pytest.fail('autodoc-skip-member never connected')
 
 
-class SkipMemberTest(TestCase):
-    def assertSkip(self, what, member, obj, expect_default_skip, config_name):
+class TestSkipMember:
+    def assert_skip(self, what, member, obj, expect_default_skip, config_name):
         skip = True
         app = mock.Mock()
         app.config = Config()
         setattr(app.config, config_name, True)
         if expect_default_skip:
-            self.assertEqual(None, _skip_member(app, what, member, obj, skip,
-                                                mock.Mock()))
+            assert None is _skip_member(app, what, member, obj, skip, mock.Mock())
         else:
-            self.assertIs(_skip_member(app, what, member, obj, skip,
-                                       mock.Mock()), False)
+            assert _skip_member(app, what, member, obj, skip, mock.Mock()) is False
         setattr(app.config, config_name, False)
-        self.assertEqual(None, _skip_member(app, what, member, obj, skip,
-                                            mock.Mock()))
+        assert None is _skip_member(app, what, member, obj, skip, mock.Mock())
 
     def test_namedtuple(self):
-        if sys.version_info < (3, 7):
-            self.assertSkip('class', '_asdict',
-                            SampleNamedTuple._asdict, False,
-                            'napoleon_include_private_with_doc')
-        else:
-            # Since python 3.7, namedtuple._asdict() has not been documented
-            # because there is no way to check the method is a member of the
-            # namedtuple class.  This testcase confirms only it does not
-            # raise an error on building document (refs: #1455)
-            self.assertSkip('class', '_asdict',
-                            SampleNamedTuple._asdict, True,
-                            'napoleon_include_private_with_doc')
+        # Since python 3.7, namedtuple._asdict() has not been documented
+        # because there is no way to check the method is a member of the
+        # namedtuple class.  This testcase confirms only it does not
+        # raise an error on building document (refs: #1455)
+        self.assert_skip('class', '_asdict',
+                         SampleNamedTuple._asdict, True,
+                         'napoleon_include_private_with_doc')
 
     def test_class_private_doc(self):
-        self.assertSkip('class', '_private_doc',
-                        SampleClass._private_doc, False,
-                        'napoleon_include_private_with_doc')
+        self.assert_skip('class', '_private_doc',
+                         SampleClass._private_doc, False,
+                         'napoleon_include_private_with_doc')
 
     def test_class_private_undoc(self):
-        self.assertSkip('class', '_private_undoc',
-                        SampleClass._private_undoc, True,
-                        'napoleon_include_private_with_doc')
+        self.assert_skip('class', '_private_undoc',
+                         SampleClass._private_undoc, True,
+                         'napoleon_include_private_with_doc')
 
     def test_class_special_doc(self):
-        self.assertSkip('class', '__special_doc__',
-                        SampleClass.__special_doc__, False,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('class', '__special_doc__',
+                         SampleClass.__special_doc__, False,
+                         'napoleon_include_special_with_doc')
 
     def test_class_special_undoc(self):
-        self.assertSkip('class', '__special_undoc__',
-                        SampleClass.__special_undoc__, True,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('class', '__special_undoc__',
+                         SampleClass.__special_undoc__, True,
+                         'napoleon_include_special_with_doc')
 
     def test_class_decorated_doc(self):
-        self.assertSkip('class', '__decorated_func__',
-                        SampleClass.__decorated_func__, False,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('class', '__decorated_func__',
+                         SampleClass.__decorated_func__, False,
+                         'napoleon_include_special_with_doc')
 
     def test_exception_private_doc(self):
-        self.assertSkip('exception', '_private_doc',
-                        SampleError._private_doc, False,
-                        'napoleon_include_private_with_doc')
+        self.assert_skip('exception', '_private_doc',
+                         SampleError._private_doc, False,
+                         'napoleon_include_private_with_doc')
 
     def test_exception_private_undoc(self):
-        self.assertSkip('exception', '_private_undoc',
-                        SampleError._private_undoc, True,
-                        'napoleon_include_private_with_doc')
+        self.assert_skip('exception', '_private_undoc',
+                         SampleError._private_undoc, True,
+                         'napoleon_include_private_with_doc')
 
     def test_exception_special_doc(self):
-        self.assertSkip('exception', '__special_doc__',
-                        SampleError.__special_doc__, False,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('exception', '__special_doc__',
+                         SampleError.__special_doc__, False,
+                         'napoleon_include_special_with_doc')
 
     def test_exception_special_undoc(self):
-        self.assertSkip('exception', '__special_undoc__',
-                        SampleError.__special_undoc__, True,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('exception', '__special_undoc__',
+                         SampleError.__special_undoc__, True,
+                         'napoleon_include_special_with_doc')
 
     def test_module_private_doc(self):
-        self.assertSkip('module', '_private_doc', _private_doc, False,
-                        'napoleon_include_private_with_doc')
+        self.assert_skip('module', '_private_doc', _private_doc, False,
+                         'napoleon_include_private_with_doc')
 
     def test_module_private_undoc(self):
-        self.assertSkip('module', '_private_undoc', _private_undoc, True,
-                        'napoleon_include_private_with_doc')
+        self.assert_skip('module', '_private_undoc', _private_undoc, True,
+                         'napoleon_include_private_with_doc')
 
     def test_module_special_doc(self):
-        self.assertSkip('module', '__special_doc__', __special_doc__, False,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('module', '__special_doc__', __special_doc__, False,
+                         'napoleon_include_special_with_doc')
 
     def test_module_special_undoc(self):
-        self.assertSkip('module', '__special_undoc__', __special_undoc__, True,
-                        'napoleon_include_special_with_doc')
+        self.assert_skip('module', '__special_undoc__', __special_undoc__, True,
+                         'napoleon_include_special_with_doc')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_napoleon_docstring.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_napoleon_docstring.py Changed

@@ -1,32 +1,25 @@
-"""
-    test_napoleon_docstring
-    ~~~~~~~~~~~~~~~~~~~~~~~
-
-    Tests for :mod:`sphinx.ext.napoleon.docstring` module.
-
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests for :mod:`sphinx.ext.napoleon.docstring` module."""
 
 import re
-import sys
 from collections import namedtuple
-from contextlib import contextmanager
 from inspect import cleandoc
 from textwrap import dedent
-from unittest import TestCase, mock
+from unittest import mock
 
 import pytest
 
 from sphinx.ext.napoleon import Config
-from sphinx.ext.napoleon.docstring import (GoogleDocstring, NumpyDocstring,
-                                           _convert_numpy_type_spec, _recombine_set_tokens,
-                                           _token_type, _tokenize_type_spec)
+from sphinx.ext.napoleon.docstring import (
+    GoogleDocstring,
+    NumpyDocstring,
+    _convert_numpy_type_spec,
+    _recombine_set_tokens,
+    _token_type,
+    _tokenize_type_spec,
+)
 
-if sys.version_info >= (3, 6):
-    from .ext_napoleon_pep526_data_google import PEP526GoogleClass
-    from .ext_napoleon_pep526_data_numpy import PEP526NumpyClass
+from .ext_napoleon_pep526_data_google import PEP526GoogleClass
+from .ext_napoleon_pep526_data_numpy import PEP526NumpyClass
 
 
 class NamedtupleSubclass(namedtuple('NamedtupleSubclass', ('attr1', 'attr2'))):
@@ -50,11 +43,7 @@
         return super().__new__(cls, attr1, attr2)
 
 
-class BaseDocstringTest(TestCase):
-    pass
-
-
-class NamedtupleSubclassTest(BaseDocstringTest):
+class TestNamedtupleSubclass:
     def test_attributes_docstring(self):
         config = Config()
         actual = str(NumpyDocstring(cleandoc(NamedtupleSubclass.__doc__),
@@ -82,10 +71,10 @@
    :type: Type
 """
 
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
 
-class InlineAttributeTest(BaseDocstringTest):
+class TestInlineAttribute:
 
     def test_class_data_member(self):
         config = Config()
@@ -101,7 +90,7 @@
 
         - a: b""")
 
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_class_data_member_inline(self):
         config = Config()
@@ -112,7 +101,7 @@
         data member description with :ref:`reference`
 
         :type: b""")
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_class_data_member_inline_no_type(self):
         config = Config()
@@ -121,7 +110,7 @@
                      what='attribute', name='some_data', obj=0))
         expected = """data with ``a : in code`` and :ref:`reference` and no type"""
 
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_class_data_member_inline_ref_in_type(self):
         config = Config()
@@ -132,13 +121,13 @@
         data member description
 
         :type: :class:`int`""")
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
 
-class GoogleDocstringTest(BaseDocstringTest):
+class TestGoogleDocstring:
     docstrings = (
         """Single line summary""",
-        """Single line summary"""
+        """Single line summary""",
     ), (
         """
         Single line summary
@@ -150,7 +139,7 @@
         Single line summary
 
         Extended description
-        """
+        """,
     ), (
         """
         Single line summary
@@ -164,7 +153,7 @@
 
         :Parameters: **arg1** (*str*) -- Extended
                      description of arg1
-        """
+        """,
     ), (
         """
         Single line summary
@@ -192,7 +181,7 @@
                               description of kwarg1
                             * **kwarg2** (*int*) -- Extended
                               description of kwarg2
-        """
+        """,
     ), (
         """
         Single line summary
@@ -220,7 +209,7 @@
                               description of kwarg1
                             * **kwarg2** (*int*) -- Extended
                               description of kwarg2
-        """
+        """,
     ), (
         """
         Single line summary
@@ -234,7 +223,7 @@
 
         :returns: *str* -- Extended
                   description of return value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -248,7 +237,7 @@
 
         :returns: *str* -- Extended
                   description of return value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -262,7 +251,7 @@
 
         :returns: Extended
                   description of return value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -274,7 +263,7 @@
         Single line summary
 
         :returns: Extended
-        """
+        """,
     ), (
         """
         Single line summary
@@ -292,7 +281,7 @@
                        description of arg1
                      * **\\*args** -- Variable length argument list.
                      * **\\*\\*kwargs** -- Arbitrary keyword arguments.
-        """
+        """,
     ), (
         """
         Single line summary
@@ -310,7 +299,7 @@
                      * **arg2** (*listint*) -- Description
                      * **arg3** (*dict(str, int)*) -- Description
                      * **arg4** (*dictstr, int*) -- Description
-        """
+        """,
     ), (
         """
         Single line summary
@@ -324,7 +313,7 @@
 
         :Receives: * **arg1** (*list(int)*) -- Description
                    * **arg2** (*listint*) -- Description
-        """
+        """,
     ), (
         """
         Single line summary
@@ -338,7 +327,7 @@
 
         :Receives: * **arg1** (*list(int)*) -- Description
                    * **arg2** (*listint*) -- Description
-        """
+        """,
     ), (
         """
         Single line summary
@@ -352,7 +341,7 @@
 
         :Yields: *str* -- Extended
                  description of yielded value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -366,7 +355,42 @@
 
         :Yields: Extended
                  description of yielded value
+        """,
+    ), (
+        """
+        Single line summary
+
+        Args:
+
+          arg1 (list of str): Extended
+              description of arg1.
+          arg2 (tuple of int): Extended
+              description of arg2.
+          arg3 (tuple of list of float): Extended
+              description of arg3.
+          arg4 (int, float, or list of bool): Extended
+              description of arg4.
+          arg5 (list of int, float, or bool): Extended
+              description of arg5.
+          arg6 (list of int or float): Extended
+              description of arg6.
+        """,
         """
+        Single line summary
+
+        :Parameters: * **arg1** (*list of str*) -- Extended
+                       description of arg1.
+                     * **arg2** (*tuple of int*) -- Extended
+                       description of arg2.
+                     * **arg3** (*tuple of list of float*) -- Extended
+                       description of arg3.
+                     * **arg4** (*int, float, or list of bool*) -- Extended
+                       description of arg4.
+                     * **arg5** (*list of int, float, or bool*) -- Extended
+                       description of arg5.
+                     * **arg6** (*list of int or float*) -- Extended
+                       description of arg6.
+        """,
     )
 
     def test_sphinx_admonitions(self):
@@ -386,37 +410,36 @@
         config = Config()
         for section, admonition in admonition_map.items():
             # Multiline
-            actual = str(GoogleDocstring(("{}:\n"
-                                          "    this is the first line\n"
-                                          "\n"
-                                          "    and this is the second line\n"
-                                          ).format(section), config))
-            expect = (".. {}::\n"
+            actual = str(GoogleDocstring(f"{section}:\n"
+                                         "    this is the first line\n"
+                                         "\n"
+                                         "    and this is the second line\n",
+                                         config))
+            expect = (f".. {admonition}::\n"
                       "\n"
                       "   this is the first line\n"
                       "   \n"
                       "   and this is the second line\n"
-                      ).format(admonition)
-            self.assertEqual(expect, actual)
+                      )
+            assert expect == actual
 
             # Single line
-            actual = str(GoogleDocstring(("{}:\n"
-                                          "    this is a single line\n"
-                                          ).format(section), config))
-            expect = (".. {}:: this is a single line\n"
-                      ).format(admonition)
-            self.assertEqual(expect, actual)
+            actual = str(GoogleDocstring(f"{section}:\n"
+                                         "    this is a single line\n",
+                                         config))
+            expect = f".. {admonition}:: this is a single line\n"
+            assert expect == actual
 
     def test_docstrings(self):
         config = Config(
             napoleon_use_param=False,
             napoleon_use_rtype=False,
-            napoleon_use_keyword=False
+            napoleon_use_keyword=False,
         )
         for docstring, expected in self.docstrings:
             actual = str(GoogleDocstring(dedent(docstring), config))
             expected = dedent(expected)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_parameters_with_class_reference(self):
         docstring = """\
@@ -452,7 +475,7 @@
 :param scope_ids: Identifiers needed to resolve scopes.
 :type scope_ids: :class:`ScopeIds`
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_attributes_with_class_reference(self):
         docstring = """\
@@ -468,7 +491,7 @@
 
    :type: :class:`numpy.ndarray`
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         docstring = """\
 Attributes:
@@ -483,7 +506,23 @@
 
    :type: numpy.ndarray
 """
-        self.assertEqual(expected, actual)
+
+    def test_attributes_with_use_ivar(self):
+        docstring = """\
+Attributes:
+    foo (int): blah blah
+    bar (str): blah blah
+"""
+
+        config = Config(napoleon_use_ivar=True)
+        actual = str(GoogleDocstring(docstring, config, obj=self.__class__))
+        expected = """\
+:ivar foo: blah blah
+:vartype foo: int
+:ivar bar: blah blah
+:vartype bar: str
+"""
+        assert expected == actual
 
     def test_code_block_in_returns_section(self):
         docstring = """
@@ -503,7 +542,7 @@
 :rtype: foobar
 """
         actual = str(GoogleDocstring(docstring))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_colon_in_return_type(self):
         docstring = """Example property.
@@ -519,7 +558,7 @@
 :rtype: :py:class:`~.module.submodule.SomeClass`
 """
         actual = str(GoogleDocstring(docstring))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_xrefs_in_return_type(self):
         docstring = """Example Function
@@ -535,7 +574,7 @@
 :rtype: :class:`numpy.ndarray`
 """
         actual = str(GoogleDocstring(docstring))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_raises_types(self):
         docstrings = ("""
@@ -705,7 +744,7 @@
 """)
         for docstring, expected in docstrings:
             actual = str(GoogleDocstring(docstring))
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_kwargs_in_arguments(self):
         docstring = """Allows to create attributes binded to this device.
@@ -736,7 +775,7 @@
                    example above.
 """
         actual = str(GoogleDocstring(docstring))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_section_header_formatting(self):
         docstrings = ("""
@@ -790,7 +829,7 @@
 """)
         for docstring, expected in docstrings:
             actual = str(GoogleDocstring(docstring))
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_list_in_parameter_description(self):
         docstring = """One line summary.
@@ -973,7 +1012,7 @@
 """
         config = Config(napoleon_use_param=True)
         actual = str(GoogleDocstring(docstring, config))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         expected = """One line summary.
 
@@ -1069,7 +1108,7 @@
 """
         config = Config(napoleon_use_param=False)
         actual = str(GoogleDocstring(docstring, config))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_custom_generic_sections(self):
 
@@ -1108,7 +1147,7 @@
 
         for docstring, expected in docstrings:
             actual = str(GoogleDocstring(docstring, testConfig))
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_noindex(self):
         docstring = """
@@ -1132,11 +1171,11 @@
 
    
    description
-"""  # NOQA
+"""  # noqa: W293
         config = Config()
         actual = str(GoogleDocstring(docstring, config=config, app=None, what='module',
                                      options={'noindex': True}))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_keywords_with_types(self):
         docstring = """\
@@ -1152,17 +1191,16 @@
 :keyword gotham_is_yours: shall interfere.
 :kwtype gotham_is_yours: None
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_pep526_annotations(self):
-        if sys.version_info >= (3, 6):
-            # Test class attributes annotations
-            config = Config(
-                napoleon_attr_annotations=True
-            )
-            actual = str(GoogleDocstring(cleandoc(PEP526GoogleClass.__doc__), config, app=None, what="class",
-                                         obj=PEP526GoogleClass))
-            expected = """\
+        # Test class attributes annotations
+        config = Config(
+            napoleon_attr_annotations=True,
+        )
+        actual = str(GoogleDocstring(cleandoc(PEP526GoogleClass.__doc__), config, app=None, what="class",
+                                     obj=PEP526GoogleClass))
+        expected = """\
 Sample class with PEP 526 annotations and google docstring
 
 .. attribute:: attr1
@@ -1177,7 +1215,7 @@
 
    :type: str
 """
-            self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_preprocess_types(self):
         docstring = """\
@@ -1192,7 +1230,7 @@
 
 :Yields: *str* -- Extended
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         config = Config(napoleon_preprocess_types=True)
         actual = str(GoogleDocstring(docstring, config))
@@ -1201,13 +1239,13 @@
 
 :Yields: :class:`str` -- Extended
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
 
-class NumpyDocstringTest(BaseDocstringTest):
+class TestNumpyDocstring:
     docstrings = (
         """Single line summary""",
-        """Single line summary"""
+        """Single line summary""",
     ), (
         """
         Single line summary
@@ -1219,7 +1257,7 @@
         Single line summary
 
         Extended description
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1235,7 +1273,7 @@
 
         :Parameters: **arg1** (:class:`str`) -- Extended
                      description of arg1
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1270,7 +1308,7 @@
                               description of kwarg1
                             * **kwarg2** (:class:`int`) -- Extended
                               description of kwarg2
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1286,7 +1324,7 @@
 
         :returns: :class:`str` -- Extended
                   description of return value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1302,7 +1340,7 @@
 
         :returns: :class:`str` -- Extended
                   description of return value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1322,7 +1360,7 @@
         :Parameters: * **arg1** (:class:`str`) -- Extended description of arg1
                      * **\\*args** -- Variable length argument list.
                      * **\\*\\*kwargs** -- Arbitrary keyword arguments.
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1339,7 +1377,7 @@
 
         :Parameters: * **arg1** (:class:`str`) -- Extended description of arg1
                      * **\\*args, \\*\\*kwargs** -- Variable length argument list and arbitrary keyword arguments.
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1360,7 +1398,7 @@
                      description of arg1
                    * **arg2** (:class:`int`) -- Extended
                      description of arg2
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1381,7 +1419,7 @@
                      description of arg1
                    * **arg2** (:class:`int`) -- Extended
                      description of arg2
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1397,7 +1435,7 @@
 
         :Yields: :class:`str` -- Extended
                  description of yielded value
-        """
+        """,
     ), (
         """
         Single line summary
@@ -1413,7 +1451,7 @@
 
         :Yields: :class:`str` -- Extended
                  description of yielded value
-        """
+        """,
     )
 
     def test_sphinx_admonitions(self):
@@ -1433,28 +1471,27 @@
         config = Config()
         for section, admonition in admonition_map.items():
             # Multiline
-            actual = str(NumpyDocstring(("{}\n"
-                                         "{}\n"
-                                         "    this is the first line\n"
-                                         "\n"
-                                         "    and this is the second line\n"
-                                         ).format(section, '-' * len(section)), config))
-            expect = (".. {}::\n"
+            actual = str(NumpyDocstring(f"{section}\n"
+                                        f"{'-' * len(section)}\n"
+                                        "    this is the first line\n"
+                                        "\n"
+                                        "    and this is the second line\n",
+                                        config))
+            expect = (f".. {admonition}::\n"
                       "\n"
                       "   this is the first line\n"
                       "   \n"
                       "   and this is the second line\n"
-                      ).format(admonition)
-            self.assertEqual(expect, actual)
+                      )
+            assert expect == actual
 
             # Single line
-            actual = str(NumpyDocstring(("{}\n"
-                                         "{}\n"
-                                         "    this is a single line\n"
-                                         ).format(section, '-' * len(section)), config))
-            expect = (".. {}:: this is a single line\n"
-                      ).format(admonition)
-            self.assertEqual(expect, actual)
+            actual = str(NumpyDocstring(f"{section}\n"
+                                        f"{'-' * len(section)}\n"
+                                        f"    this is a single line\n",
+                                        config))
+            expect = f".. {admonition}:: this is a single line\n"
+            assert expect == actual
 
     def test_docstrings(self):
         config = Config(
@@ -1465,7 +1502,7 @@
         for docstring, expected in self.docstrings:
             actual = str(NumpyDocstring(dedent(docstring), config))
             expected = dedent(expected)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_type_preprocessor(self):
         docstring = dedent("""
@@ -1486,7 +1523,7 @@
         :Parameters: **arg1** (*str*) -- Extended
                      description of arg1
         """)
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_parameters_with_class_reference(self):
         docstring = """\
@@ -1507,7 +1544,7 @@
 
 :Other Parameters: **param2** (:class:`MyClass <name.space.MyClass>` instance)
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         config = Config(napoleon_use_param=True)
         actual = str(NumpyDocstring(docstring, config))
@@ -1518,7 +1555,7 @@
 :param param2:
 :type param2: :class:`MyClass <name.space.MyClass>` instance
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_multiple_parameters(self):
         docstring = """\
@@ -1534,7 +1571,7 @@
         expected = """\
 :Parameters: **x1, x2** (*array_like*) -- Input arrays, description of ``x1``, ``x2``.
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         config = Config(napoleon_use_param=True)
         actual = str(NumpyDocstring(dedent(docstring), config))
@@ -1544,7 +1581,7 @@
 :param x2: Input arrays, description of ``x1``, ``x2``.
 :type x2: array_like
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_parameters_without_class_reference(self):
         docstring = """\
@@ -1559,7 +1596,7 @@
         expected = """\
 :Parameters: **param1** (*MyClass instance*)
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         config = Config(napoleon_use_param=True)
         actual = str(NumpyDocstring(dedent(docstring), config))
@@ -1567,7 +1604,7 @@
 :param param1:
 :type param1: MyClass instance
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_see_also_refs(self):
         docstring = """\
@@ -1592,7 +1629,7 @@
    :obj:`otherfunc`
        relationship
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         docstring = """\
 numpy.multivariate_normal(mean, cov, shape=None, spam=None)
@@ -1618,7 +1655,7 @@
    :obj:`otherfunc`
        relationship
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         docstring = """\
 numpy.multivariate_normal(mean, cov, shape=None, spam=None)
@@ -1647,7 +1684,7 @@
    :func:`~my_package.otherfunc`
        relationship
 """
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_colon_in_return_type(self):
         docstring = """
@@ -1670,7 +1707,7 @@
         app = mock.Mock()
         actual = str(NumpyDocstring(docstring, config, app, "method"))
 
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_underscore_in_attribute(self):
         docstring = """
@@ -1690,7 +1727,7 @@
         app = mock.Mock()
         actual = str(NumpyDocstring(docstring, config, app, "class"))
 
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_underscore_in_attribute_strip_signature_backslash(self):
         docstring = """
@@ -1711,7 +1748,7 @@
         app = mock.Mock()
         actual = str(NumpyDocstring(docstring, config, app, "class"))
 
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_return_types(self):
         docstring = dedent("""
@@ -1734,7 +1771,7 @@
             napoleon_type_aliases=translations,
         )
         actual = str(NumpyDocstring(docstring, config))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_yield_types(self):
         docstring = dedent("""
@@ -1757,7 +1794,7 @@
         config = Config(napoleon_type_aliases=translations, napoleon_preprocess_types=True)
         app = mock.Mock()
         actual = str(NumpyDocstring(docstring, config, app, "method"))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_raises_types(self):
         docstrings = ("""
@@ -1970,7 +2007,7 @@
             config = Config(napoleon_type_aliases=translations, napoleon_preprocess_types=True)
             app = mock.Mock()
             actual = str(NumpyDocstring(docstring, config, app, "method"))
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_xrefs_in_return_type(self):
         docstring = """
@@ -1992,7 +2029,7 @@
         config = Config()
         app = mock.Mock()
         actual = str(NumpyDocstring(docstring, config, app, "method"))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_section_header_underline_length(self):
         docstrings = ("""
@@ -2064,7 +2101,7 @@
 """)
         for docstring, expected in docstrings:
             actual = str(NumpyDocstring(docstring))
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_list_in_parameter_description(self):
         docstring = """One line summary.
@@ -2238,7 +2275,7 @@
 """
         config = Config(napoleon_use_param=True)
         actual = str(NumpyDocstring(docstring, config))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
         expected = """One line summary.
 
@@ -2330,7 +2367,7 @@
 """
         config = Config(napoleon_use_param=False, napoleon_preprocess_types=True)
         actual = str(NumpyDocstring(docstring, config))
-        self.assertEqual(expected, actual)
+        assert expected == actual
 
     def test_token_type(self):
         tokens = (
@@ -2355,7 +2392,7 @@
 
         for token, expected in tokens:
             actual = _token_type(token)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_tokenize_type_spec(self):
         specs = (
@@ -2363,6 +2400,8 @@
             "defaultdict",
             "int, float, or complex",
             "int or float or None, optional",
+            "list of list of int or float, optional",
+            "tuple of list of str, float, or int",
             '{"F", "C", "N"}',
             "{'F', 'C', 'N'}, default: 'F'",
             "{'F', 'C', 'N or C'}, default 'F'",
@@ -2379,6 +2418,8 @@
             "defaultdict",
             "int", ", ", "float", ", or ", "complex",
             "int", " or ", "float", " or ", "None", ", ", "optional",
+            "list", " of ", "list", " of ", "int", " or ", "float", ", ", "optional",
+            "tuple", " of ", "list", " of ", "str", ", ", "float", ", or ", "int",
             "{", '"F"', ", ", '"C"', ", ", '"N"', "}",
             "{", "'F'", ", ", "'C'", ", ", "'N'", "}", ", ", "default", ": ", "'F'",
             "{", "'F'", ", ", "'C'", ", ", "'N or C'", "}", ", ", "default", " ", "'F'",
@@ -2392,7 +2433,7 @@
 
         for spec, expected in zip(specs, tokens):
             actual = _tokenize_type_spec(spec)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_recombine_set_tokens(self):
         tokens = (
@@ -2411,7 +2452,7 @@
 
         for tokens_, expected in zip(tokens, combined_tokens):
             actual = _recombine_set_tokens(tokens_)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_recombine_set_tokens_invalid(self):
         tokens = (
@@ -2427,7 +2468,7 @@
 
         for tokens_, expected in zip(tokens, combined_tokens):
             actual = _recombine_set_tokens(tokens_)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_convert_numpy_type_spec(self):
         translations = {
@@ -2439,6 +2480,7 @@
             "optional",
             "str, optional",
             "int or float or None, default: None",
+            "list of tuple of str, optional",
             "int, default None",
             '{"F", "C", "N"}',
             "{'F', 'C', 'N'}, default: 'N'",
@@ -2451,6 +2493,7 @@
             "*optional*",
             ":class:`str`, *optional*",
             ":class:`int` or :class:`float` or :obj:`None`, *default*: :obj:`None`",
+            ":class:`list` of :class:`tuple` of :class:`str`, *optional*",
             ":class:`int`, *default* :obj:`None`",
             '``{"F", "C", "N"}``',
             "``{'F', 'C', 'N'}``, *default*: ``'N'``",
@@ -2460,7 +2503,7 @@
 
         for spec, expected in zip(specs, converted):
             actual = _convert_numpy_type_spec(spec, translations=translations)
-            self.assertEqual(expected, actual)
+            assert expected == actual
 
     def test_parameter_types(self):
         docstring = dedent("""\
@@ -2482,6 +2525,8 @@
                 a optional mapping
             param8 : ... or Ellipsis
                 ellipsis
+            param9 : tuple of list of int
+                a parameter with tuple of list of int
         """)
         expected = dedent("""\
             :param param1: the data to work on
@@ -2500,6 +2545,8 @@
             :type param7: :term:`mapping` of :term:`hashable` to :class:`str`, *optional*
             :param param8: ellipsis
             :type param8: :obj:`... <Ellipsis>` or :obj:`Ellipsis`
+            :param param9: a parameter with tuple of list of int
+            :type param9: :class:`tuple` of :class:`list` of :class:`int`
         """)
         translations = {
             "dict-like": ":term:`dict-like <mapping>`",
@@ -2513,23 +2560,8 @@
             napoleon_type_aliases=translations,
         )
         actual = str(NumpyDocstring(docstring, config))
-        self.assertEqual(expected, actual)
-
+        assert expected == actual
 
-@contextmanager
-def warns(warning, match):
-    match_re = re.compile(match)
-    try:
-        yield warning
-    finally:
-        raw_warnings = warning.getvalue()
-        warnings = w for w in raw_warnings.split("\n") if w.strip()
-
-        assert len(warnings) == 1 and all(match_re.match(w) for w in warnings)
-        warning.truncate(0)
-
-
-class TestNumpyDocstring:
     def test_token_type_invalid(self, warning):
         tokens = (
             "{1, 2",
@@ -2548,8 +2580,15 @@
             r".+: malformed string literal $missing opening quote$:",
         )
         for token, error in zip(tokens, errors):
-            with warns(warning, match=error):
+            try:
                 _token_type(token)
+            finally:
+                raw_warnings = warning.getvalue()
+                warnings = w for w in raw_warnings.split("\n") if w.strip()
+
+                assert len(warnings) == 1
+                assert re.compile(error).match(warnings0)
+                warning.truncate(0)
 
     @pytest.mark.parametrize(
         ("name", "expected"),
@@ -2566,14 +2605,13 @@
         assert actual == expected
 
     def test_pep526_annotations(self):
-        if sys.version_info >= (3, 6):
-            # test class attributes annotations
-            config = Config(
-                napoleon_attr_annotations=True
-            )
-            actual = str(NumpyDocstring(cleandoc(PEP526NumpyClass.__doc__), config, app=None, what="class",
-                                        obj=PEP526NumpyClass))
-            expected = """\
+        # test class attributes annotations
+        config = Config(
+            napoleon_attr_annotations=True,
+        )
+        actual = str(NumpyDocstring(cleandoc(PEP526NumpyClass.__doc__), config, app=None, what="class",
+                                    obj=PEP526NumpyClass))
+        expected = """\
 Sample class with PEP 526 annotations and numpy docstring
 
 .. attribute:: attr1
@@ -2588,5 +2626,50 @@
 
    :type: str
 """
-            print(actual)
-            assert expected == actual
+        print(actual)
+        assert expected == actual
+
+
+@pytest.mark.sphinx('text', testroot='ext-napoleon',
+                    confoverrides={'autodoc_typehints': 'description',
+                                   'autodoc_typehints_description_target': 'all'})
+def test_napoleon_and_autodoc_typehints_description_all(app, status, warning):
+    app.build()
+    content = (app.outdir / 'typehints.txt').read_text(encoding='utf-8')
+    assert content == (
+        'typehints\n'
+        '*********\n'
+        '\n'
+        'mypackage.typehints.hello(x, *args, **kwargs)\n'
+        '\n'
+        '   Parameters:\n'
+        '      * **x** (*int*) -- X\n'
+        '\n'
+        '      * ***args** (*int*) -- Additional arguments.\n'
+        '\n'
+        '      * ****kwargs** (*int*) -- Extra arguments.\n'
+        '\n'
+        '   Return type:\n'
+        '      None\n'
+    )
+
+
+@pytest.mark.sphinx('text', testroot='ext-napoleon',
+                    confoverrides={'autodoc_typehints': 'description',
+                                   'autodoc_typehints_description_target': 'documented_params'})
+def test_napoleon_and_autodoc_typehints_description_documented_params(app, status, warning):
+    app.build()
+    content = (app.outdir / 'typehints.txt').read_text(encoding='utf-8')
+    assert content == (
+        'typehints\n'
+        '*********\n'
+        '\n'
+        'mypackage.typehints.hello(x, *args, **kwargs)\n'
+        '\n'
+        '   Parameters:\n'
+        '      * **x** (*int*) -- X\n'
+        '\n'
+        '      * ***args** (*int*) -- Additional arguments.\n'
+        '\n'
+        '      * ****kwargs** (*int*) -- Extra arguments.\n'
+    )

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_todo.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_todo.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_ext_todo
-    ~~~~~~~~~~~~~
-
-    Test sphinx.ext.todo extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.todo extension."""
 
 import re
 
@@ -25,7 +17,7 @@
     app.builder.build_all()
 
     # check todolist
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<p class="admonition-title">Todo</p>\n'
             '<p>todo in foo</p>') in content
 
@@ -33,7 +25,7 @@
             '<p>todo in bar</p>') in content
 
     # check todo
-    content = (app.outdir / 'foo.html').read_text()
+    content = (app.outdir / 'foo.html').read_text(encoding='utf8')
     assert ('<p class="admonition-title">Todo</p>\n'
             '<p>todo in foo</p>') in content
 
@@ -63,7 +55,7 @@
     app.builder.build_all()
 
     # check todolist
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<p class="admonition-title">Todo</p>\n'
             '<p>todo in foo</p>') not in content
 
@@ -71,7 +63,7 @@
             '<p>todo in bar</p>') not in content
 
     # check todo
-    content = (app.outdir / 'foo.html').read_text()
+    content = (app.outdir / 'foo.html').read_text(encoding='utf8')
     assert ('<p class="admonition-title">Todo</p>\n'
             '<p>todo in foo</p>') not in content
 
@@ -98,7 +90,7 @@
     # Ensure the LaTeX output is built.
     app.builder.build_all()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
 
     # Look for the link to foo. Note that there are two of them because the
     # source document uses todolist twice. We could equally well look for links

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_ext_viewcode.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_ext_viewcode.py Changed

@@ -1,19 +1,13 @@
-"""
-    test_ext_viewcode
-    ~~~~~~~~~~~~~~~~~
-
-    Test sphinx.ext.viewcode extension.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test sphinx.ext.viewcode extension."""
 
 import re
+import shutil
 
+import pygments
 import pytest
 
 
-@pytest.mark.sphinx(testroot='ext-viewcode')
+@pytest.mark.sphinx(testroot='ext-viewcode', freshenv=True)
 def test_viewcode(app, status, warning):
     app.builder.build_all()
 
@@ -21,10 +15,10 @@
     assert re.findall(
         r"index.rst:\d+: WARNING: Object named 'func1' not found in include " +
         r"file .*/spam/__init__.py'",
-        warnings
+        warnings,
     )
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert result.count('href="_modules/spam/mod1.html#func1"') == 2
     assert result.count('href="_modules/spam/mod2.html#func2"') == 2
     assert result.count('href="_modules/spam/mod1.html#Class1"') == 2
@@ -37,25 +31,34 @@
     # the next assert fails, until the autodoc bug gets fixed
     assert result.count('this is the class attribute class_attr') == 2
 
-    result = (app.outdir / '_modules/spam/mod1.html').read_text()
+    result = (app.outdir / '_modules/spam/mod1.html').read_text(encoding='utf8')
     result = re.sub('<span class=".*?">', '<span>', result)  # filter pygments classes
-    assert ('<div class="viewcode-block" id="Class1"><a class="viewcode-back" '
-            'href="../../index.html#spam.Class1">docs</a>'
-            '<span>@decorator</span>\n'
-            '<span>class</span> <span>Class1</span>'
-            '<span>(</span><span>object</span><span>):</span>\n'
-            '    <span>&quot;&quot;&quot;</span>\n'
-            '<span>    this is Class1</span>\n'
-            '<span>    &quot;&quot;&quot;</span></div>\n') in result
+    if pygments.__version__ >= '2.14.0':
+        assert ('<div class="viewcode-block" id="Class1"><a class="viewcode-back" '
+                'href="../../index.html#spam.Class1">docs</a>'
+                '<span>@decorator</span>\n'
+                '<span>class</span> <span>Class1</span><span>:</span>\n'
+                '<span>    </span><span>&quot;&quot;&quot;</span>\n'
+                '<span>    this is Class1</span>\n'
+                '<span>    &quot;&quot;&quot;</span></div>\n') in result
+    else:
+        assert ('<div class="viewcode-block" id="Class1"><a class="viewcode-back" '
+                'href="../../index.html#spam.Class1">docs</a>'
+                '<span>@decorator</span>\n'
+                '<span>class</span> <span>Class1</span><span>:</span>\n'
+                '    <span>&quot;&quot;&quot;</span>\n'
+                '<span>    this is Class1</span>\n'
+                '<span>    &quot;&quot;&quot;</span></div>\n') in result
 
 
 @pytest.mark.sphinx('epub', testroot='ext-viewcode')
 def test_viewcode_epub_default(app, status, warning):
+    shutil.rmtree(app.outdir)
     app.builder.build_all()
 
     assert not (app.outdir / '_modules/spam/mod1.xhtml').exists()
 
-    result = (app.outdir / 'index.xhtml').read_text()
+    result = (app.outdir / 'index.xhtml').read_text(encoding='utf8')
     assert result.count('href="_modules/spam/mod1.xhtml#func1"') == 0
 
 
@@ -66,7 +69,7 @@
 
     assert (app.outdir / '_modules/spam/mod1.xhtml').exists()
 
-    result = (app.outdir / 'index.xhtml').read_text()
+    result = (app.outdir / 'index.xhtml').read_text(encoding='utf8')
     assert result.count('href="_modules/spam/mod1.xhtml#func1"') == 2
 
 
@@ -74,7 +77,7 @@
 def test_linkcode(app, status, warning):
     app.builder.build('objects')
 
-    stuff = (app.outdir / 'objects.html').read_text()
+    stuff = (app.outdir / 'objects.html').read_text(encoding='utf8')
 
     assert 'http://foobar/source/foolib.py' in stuff
     assert 'http://foobar/js/' in stuff
@@ -82,11 +85,11 @@
     assert 'http://foobar/cpp/' in stuff
 
 
-@pytest.mark.sphinx(testroot='ext-viewcode-find')
+@pytest.mark.sphinx(testroot='ext-viewcode-find', freshenv=True)
 def test_local_source_files(app, status, warning):
     def find_source(app, modname):
         if modname == 'not_a_package':
-            source = (app.srcdir / 'not_a_package/__init__.py').read_text()
+            source = (app.srcdir / 'not_a_package/__init__.py').read_text(encoding='utf8')
             tags = {
                 'func1': ('def', 1, 1),
                 'Class1': ('class', 1, 1),
@@ -94,7 +97,7 @@
                 'not_a_package.submodule.Class1': ('class', 1, 1),
             }
         else:
-            source = (app.srcdir / 'not_a_package/submodule.py').read_text()
+            source = (app.srcdir / 'not_a_package/submodule.py').read_text(encoding='utf8')
             tags = {
                 'not_a_package.submodule.func1': ('def', 11, 15),
                 'Class1': ('class', 19, 22),
@@ -111,10 +114,10 @@
     assert re.findall(
         r"index.rst:\d+: WARNING: Object named 'func1' not found in include " +
         r"file .*/not_a_package/__init__.py'",
-        warnings
+        warnings,
     )
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert result.count('href="_modules/not_a_package.html#func1"') == 1
     assert result.count('href="_modules/not_a_package.html#not_a_package.submodule.func1"') == 1
     assert result.count('href="_modules/not_a_package/submodule.html#Class1"') == 1

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_extension.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_extension.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_highlighting.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_highlighting.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_highlighting
-    ~~~~~~~~~~~~~~~~~
-
-    Test the Pygments highlighting bridge.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Pygments highlighting bridge."""
 
 from unittest import mock
 
@@ -89,14 +81,24 @@
     ret = bridge.highlight_block('reST ``like`` text', 'default')
     assert ret == '<div class="highlight"><pre><span></span>reST ``like`` text\n</pre></div>\n'
 
-    # python3: highlights as python3
-    ret = bridge.highlight_block('print "Hello sphinx world"', 'python3')
-    assert ret == ('<div class="highlight"><pre><span></span><span class="nb">print</span> '
-                   '<span class="s2">&quot;Hello sphinx world&quot;</span>\n</pre></div>\n')
+    # python: highlights as python3
+    ret = bridge.highlight_block('print("Hello sphinx world")', 'python')
+    assert ret == ('<div class="highlight"><pre><span></span><span class="nb">print</span>'
+                   '<span class="p">(</span>'
+                   '<span class="s2">&quot;Hello sphinx world&quot;</span>'
+                   '<span class="p">)</span>\n</pre></div>\n')
 
-    # python3: raises error if highlighting failed
-    ret = bridge.highlight_block('reST ``like`` text', 'python3')
-    logger.warning.assert_called_with('Could not lex literal_block as "%s". '
-                                      'Highlighting skipped.', 'python3',
+    # python3: highlights as python3
+    ret = bridge.highlight_block('print("Hello sphinx world")', 'python3')
+    assert ret == ('<div class="highlight"><pre><span></span><span class="nb">print</span>'
+                   '<span class="p">(</span>'
+                   '<span class="s2">&quot;Hello sphinx world&quot;</span>'
+                   '<span class="p">)</span>\n</pre></div>\n')
+
+    # python: raises error if highlighting failed
+    ret = bridge.highlight_block('reST ``like`` text', 'python')
+    logger.warning.assert_called_with('Could not lex literal_block %r as "%s". '
+                                      'Highlighting skipped.',
+                                      'reST ``like`` text', 'python',
                                       type='misc', subtype='highlighting_failure',
                                       location=None)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_intl.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_intl.py Changed

@@ -1,12 +1,6 @@
-"""
-    test_intl
-    ~~~~~~~~~
-
-    Test message patching for internationalization purposes.  Runs the text
-    builder in the test root.
+"""Test message patching for internationalization purposes.
 
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+Runs the text builder in the test root.
 """
 
 import os
@@ -19,9 +13,15 @@
 from docutils import nodes
 
 from sphinx import locale
-from sphinx.testing.util import (assert_node, assert_not_re_search, assert_re_search,
-                                 assert_startswith, etree_parse, path, strip_escseq)
-from sphinx.util import docutils
+from sphinx.testing.util import (
+    assert_node,
+    assert_not_re_search,
+    assert_re_search,
+    assert_startswith,
+    etree_parse,
+    path,
+    strip_escseq,
+)
 
 sphinx_intl = pytest.mark.sphinx(
     testroot='intl',
@@ -31,11 +31,9 @@
     },
 )
 
-pygments_version = tuple(int(v) for v in pygments.__version__.split('.'))
-
 
 def read_po(pathname):
-    with pathname.open() as f:
+    with pathname.open(encoding='utf-8') as f:
         return pofile.read_po(f)
 
 
@@ -45,7 +43,7 @@
 
 
 @pytest.fixture(autouse=True)
-def setup_intl(app_params):
+def _setup_intl(app_params):
     srcdir = path(app_params.kwargs'srcdir')
     for dirpath, _dirs, files in os.walk(srcdir):
         dirpath = path(dirpath)
@@ -111,7 +109,7 @@
 def test_text_warning_node(app):
     app.build()
     # test warnings in translation
-    result = (app.outdir / 'warnings.txt').read_text()
+    result = (app.outdir / 'warnings.txt').read_text(encoding='utf8')
     expect = ("3. I18N WITH REST WARNINGS"
               "\n**************************\n"
               "\nLINE OF >>``<<BROKEN LITERAL MARKUP.\n")
@@ -125,7 +123,7 @@
 def test_text_title_underline(app):
     app.build()
     # --- simple translation; check title underlines
-    result = (app.outdir / 'bom.txt').read_text()
+    result = (app.outdir / 'bom.txt').read_text(encoding='utf8')
     expect = ("2. Datei mit UTF-8"
               "\n******************\n"  # underline matches new translation
               "\nThis file has umlauts: äöü.\n")
@@ -138,7 +136,7 @@
 def test_text_subdirs(app):
     app.build()
     # --- check translation in subdirs
-    result = (app.outdir / 'subdir' / 'index.txt').read_text()
+    result = (app.outdir / 'subdir' / 'index.txt').read_text(encoding='utf8')
     assert_startswith(result, "1. subdir contents\n******************\n")
 
 
@@ -148,7 +146,7 @@
 def test_text_inconsistency_warnings(app, warning):
     app.build()
     # --- check warnings for inconsistency in number of references
-    result = (app.outdir / 'refs_inconsistency.txt').read_text()
+    result = (app.outdir / 'refs_inconsistency.txt').read_text(encoding='utf8')
     expect = ("8. I18N WITH REFS INCONSISTENCY"
               "\n*******************************\n"
               "\n* FOR CITATION ref3.\n"
@@ -167,22 +165,22 @@
         warning_fmt % {
             'reftype': 'footnote references',
             'original': "\\'\\#\\_'\\",
-            'translated': "\\\\"
+            'translated': "\\\\",
         } +
         warning_fmt % {
             'reftype': 'footnote references',
             'original': "\\'\\100\\_'\\",
-            'translated': "\\\\"
+            'translated': "\\\\",
         } +
         warning_fmt % {
             'reftype': 'references',
             'original': "\\'reference_'\\",
-            'translated': "\\'reference_', 'reference_'\\"
+            'translated': "\\'reference_', 'reference_'\\",
         } +
         warning_fmt % {
             'reftype': 'references',
             'original': "\\\\",
-            'translated': "\\'`I18N WITH REFS INCONSISTENCY`_'\\"
+            'translated': "\\'`I18N WITH REFS INCONSISTENCY`_'\\",
         })
     assert_re_search(expected_warning_expr, warnings)
 
@@ -195,10 +193,36 @@
 @sphinx_intl
 @pytest.mark.sphinx('text')
 @pytest.mark.test_params(shared_result='test_intl_basic')
+def test_noqa(app, warning):
+    app.build()
+    result = (app.outdir / 'noqa.txt').read_text(encoding='utf8')
+    expect = r"""FIRST SECTION
+*************
+
+TRANSLATED TEXT WITHOUT REFERENCE.
+
+TEST noqa WHITESPACE INSENSITIVITY.
+
+"#noqa" IS ESCAPED AT THE END OF THIS STRING. #noqa
+
+
+NEXT SECTION WITH PARAGRAPH TO TEST BARE noqa
+*********************************************
+
+Some text, again referring to the section: NEXT SECTION WITH PARAGRAPH
+TO TEST BARE noqa.
+"""
+    assert result == expect
+    assert "next-section" not in getwarning(warning)
+
+
+@sphinx_intl
+@pytest.mark.sphinx('text')
+@pytest.mark.test_params(shared_result='test_intl_basic')
 def test_text_literalblock_warnings(app, warning):
     app.build()
     # --- check warning for literal block
-    result = (app.outdir / 'literalblock.txt').read_text()
+    result = (app.outdir / 'literalblock.txt').read_text(encoding='utf8')
     expect = ("9. I18N WITH LITERAL BLOCK"
               "\n**************************\n"
               "\nCORRECT LITERAL BLOCK:\n"
@@ -220,7 +244,7 @@
 def test_text_definition_terms(app):
     app.build()
     # --- definition terms: regression test for #975, #2198, #2205
-    result = (app.outdir / 'definition_terms.txt').read_text()
+    result = (app.outdir / 'definition_terms.txt').read_text(encoding='utf8')
     expect = ("13. I18N WITH DEFINITION TERMS"
               "\n******************************\n"
               "\nSOME TERM"
@@ -240,7 +264,7 @@
 def test_text_glossary_term(app, warning):
     app.build()
     # --- glossary terms: regression test for #1090
-    result = (app.outdir / 'glossary_terms.txt').read_text()
+    result = (app.outdir / 'glossary_terms.txt').read_text(encoding='utf8')
     expect = (r"""18. I18N WITH GLOSSARY TERMS
 ****************************
 
@@ -275,7 +299,7 @@
 def test_text_glossary_term_inconsistencies(app, warning):
     app.build()
     # --- glossary term inconsistencies: regression test for #1090
-    result = (app.outdir / 'glossary_terms_inconsistency.txt').read_text()
+    result = (app.outdir / 'glossary_terms_inconsistency.txt').read_text(encoding='utf8')
     expect = ("19. I18N WITH GLOSSARY TERMS INCONSISTENCY"
               "\n******************************************\n"
               "\n1. LINK TO *SOME NEW TERM*.\n")
@@ -308,7 +332,7 @@
 def test_text_section(app):
     app.build()
     # --- section
-    result = (app.outdir / 'section.txt').read_text()
+    result = (app.outdir / 'section.txt').read_text(encoding='utf8')
     expect = read_po(app.srcdir / 'xx' / 'LC_MESSAGES' / 'section.po')
     for expect_msg in m for m in expect if m.id:
         assert expect_msg.string in result
@@ -320,7 +344,7 @@
 def test_text_seealso(app):
     app.build()
     # --- seealso
-    result = (app.outdir / 'seealso.txt').read_text()
+    result = (app.outdir / 'seealso.txt').read_text(encoding='utf8')
     expect = ("12. I18N WITH SEEALSO"
               "\n*********************\n"
               "\nSee also: SHORT TEXT 1\n"
@@ -337,7 +361,7 @@
 def test_text_figure_captions(app):
     app.build()
     # --- figure captions: regression test for #940
-    result = (app.outdir / 'figure.txt').read_text()
+    result = (app.outdir / 'figure.txt').read_text(encoding='utf8')
     expect = ("14. I18N WITH FIGURE CAPTION"
               "\n****************************\n"
               "\n   imageMY CAPTION OF THE FIGURE\n"
@@ -381,7 +405,7 @@
 def test_text_rubric(app):
     app.build()
     # --- rubric: regression test for pull request #190
-    result = (app.outdir / 'rubric.txt').read_text()
+    result = (app.outdir / 'rubric.txt').read_text(encoding='utf8')
     expect = ("I18N WITH RUBRIC"
               "\n****************\n"
               "\n- RUBRIC TITLE -\n"
@@ -399,7 +423,7 @@
 def test_text_docfields(app):
     app.build()
     # --- docfields
-    result = (app.outdir / 'docfields.txt').read_text()
+    result = (app.outdir / 'docfields.txt').read_text(encoding='utf8')
     expect = ("21. I18N WITH DOCFIELDS"
               "\n***********************\n"
               "\nclass Cls1\n"
@@ -430,7 +454,7 @@
     # --- admonitions
     # #1206: gettext did not translate admonition directive's title
     # seealso: https://docutils.sourceforge.io/docs/ref/rst/directives.html#admonitions
-    result = (app.outdir / 'admonitions.txt').read_text()
+    result = (app.outdir / 'admonitions.txt').read_text(encoding='utf8')
     directives = (
         "attention", "caution", "danger", "error", "hint",
         "important", "note", "tip", "warning", "admonition")
@@ -477,7 +501,7 @@
 def test_text_table(app):
     app.build()
     # --- toctree
-    result = (app.outdir / 'table.txt').read_text()
+    result = (app.outdir / 'table.txt').read_text(encoding='utf8')
     expect = read_po(app.srcdir / 'xx' / 'LC_MESSAGES' / 'table.po')
     for expect_msg in m for m in expect if m.id:
         assert expect_msg.string in result
@@ -490,11 +514,11 @@
     app.build()
     # --- toctree (index.rst)
     # Note: index.rst contains contents that is not shown in text.
-    result = (app.outdir / 'index.txt').read_text()
+    result = (app.outdir / 'index.txt').read_text(encoding='utf8')
     assert 'CONTENTS' in result
     assert 'TABLE OF CONTENTS' in result
     # --- toctree (toctree.rst)
-    result = (app.outdir / 'toctree.txt').read_text()
+    result = (app.outdir / 'toctree.txt').read_text(encoding='utf8')
     expect = read_po(app.srcdir / 'xx' / 'LC_MESSAGES' / 'toctree.po')
     for expect_msg in m for m in expect if m.id:
         assert expect_msg.string in result
@@ -518,7 +542,7 @@
 def test_text_topic(app):
     app.build()
     # --- topic
-    result = (app.outdir / 'topic.txt').read_text()
+    result = (app.outdir / 'topic.txt').read_text(encoding='utf8')
     expect = read_po(app.srcdir / 'xx' / 'LC_MESSAGES' / 'topic.po')
     for expect_msg in m for m in expect if m.id:
         assert expect_msg.string in result
@@ -572,7 +596,7 @@
     actual = read_po(app.outdir / 'literalblock.pot')
     for expect_msg in m for m in expect if m.id:
         if len(expect_msg.id.splitlines()) == 1:
-            # compare tranlsations only labels
+            # compare translations only labels
             assert expect_msg.id in m.id for m in actual if m.id
         else:
             pass  # skip code-blocks and literalblocks
@@ -636,7 +660,7 @@
 def test_html_meta(app):
     app.build()
     # --- test for meta
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     expected_expr = '<meta content="TESTDATA FOR I18N" name="description" />'
     assert expected_expr in result
     expected_expr = '<meta content="I18N, SPHINX, MARKUP" name="keywords" />'
@@ -652,7 +676,7 @@
     app.build()
     # --- test for #955 cant-build-html-with-footnotes-when-using
     # expect no error by build
-    (app.outdir / 'footnote.html').read_text()
+    (app.outdir / 'footnote.html').read_text(encoding='utf8')
 
 
 @sphinx_intl
@@ -661,7 +685,7 @@
 def test_html_undefined_refs(app):
     app.build()
     # --- links to undefined reference
-    result = (app.outdir / 'refs_inconsistency.html').read_text()
+    result = (app.outdir / 'refs_inconsistency.html').read_text(encoding='utf8')
 
     expected_expr = ('<a class="reference external" '
                      'href="http://www.example.com">reference</a>')
@@ -683,17 +707,17 @@
 def test_html_index_entries(app):
     app.build()
     # --- index entries: regression test for #976
-    result = (app.outdir / 'genindex.html').read_text()
+    result = (app.outdir / 'genindex.html').read_text(encoding='utf8')
 
     def wrap(tag, keyword):
         start_tag = "<%s^>*>" % tag
         end_tag = "</%s>" % tag
-        return r"%s\s*%s\s*%s" % (start_tag, keyword, end_tag)
+        return fr"{start_tag}\s*{keyword}\s*{end_tag}"
 
     def wrap_nest(parenttag, childtag, keyword):
         start_tag1 = "<%s^>*>" % parenttag
         start_tag2 = "<%s^>*>" % childtag
-        return r"%s\s*%s\s*%s" % (start_tag1, keyword, start_tag2)
+        return fr"{start_tag1}\s*{keyword}\s*{start_tag2}"
     expected_exprs = 
         wrap('a', 'NEWSLETTER'),
         wrap('a', 'MAILING LIST'),
@@ -721,7 +745,7 @@
 def test_html_versionchanges(app):
     app.build()
     # --- versionchanges
-    result = (app.outdir / 'versionchange.html').read_text()
+    result = (app.outdir / 'versionchange.html').read_text(encoding='utf8')
 
     def get_content(result, name):
         matched = re.search(r'<div class="%s">\n*(.*?)</div>' % name,
@@ -758,7 +782,7 @@
     app.build()
     # --- docfields
     # expect no error by build
-    (app.outdir / 'docfields.html').read_text()
+    (app.outdir / 'docfields.html').read_text(encoding='utf8')
 
 
 @sphinx_intl
@@ -767,7 +791,7 @@
 def test_html_template(app):
     app.build()
     # --- gettext template
-    result = (app.outdir / 'contents.html').read_text()
+    result = (app.outdir / 'contents.html').read_text(encoding='utf8')
     assert "WELCOME" in result
     assert "SPHINX 2013.120" in result
 
@@ -1064,7 +1088,7 @@
 def test_additional_targets_should_not_be_translated(app):
     app.build()
     # literalblock.txt
-    result = (app.outdir / 'literalblock.html').read_text()
+    result = (app.outdir / 'literalblock.html').read_text(encoding='utf8')
 
     # title should be translated
     expected_expr = 'CODE-BLOCKS'
@@ -1079,21 +1103,20 @@
     assert_count(expected_expr, result, 1)
 
     # C code block with lang should not be translated but be *C* highlighted
-    if pygments_version < (2, 10, 0):
-        expected_expr = ("""<span class="cp">#include</span> """
-                         """<span class="cpf">&lt;stdio.h&gt;</span>""")
-    else:
-        expected_expr = ("""<span class="cp">#include</span>"""
-                         """<span class="w"> </span>"""
-                         """<span class="cpf">&lt;stdio.h&gt;</span>""")
+    expected_expr = ("""<span class="cp">#include</span>"""
+                     """<span class="w"> </span>"""
+                     """<span class="cpf">&lt;stdio.h&gt;</span>""")
     assert_count(expected_expr, result, 1)
 
     # literal block in list item should not be translated
     expected_expr = ("""<span class="n">literal</span>"""
                      """<span class="o">-</span>"""
                      """<span class="n">block</span>\n"""
-                     """<span class="k">in</span> """
+                     """<span class="k">in</span>"""
+                     """<span class="w"> </span>"""
                      """<span class="n">list</span>""")
+    if pygments.__version__ < '2.14.0':
+        expected_expr = expected_expr.replace("""<span class="w"> </span>""", ' ')
     assert_count(expected_expr, result, 1)
 
     # doctest block should not be translated but be highlighted
@@ -1105,19 +1128,15 @@
 
     # raw.txt
 
-    result = (app.outdir / 'raw.html').read_text()
+    result = (app.outdir / 'raw.html').read_text(encoding='utf8')
 
     # raw block should not be translated
-    if docutils.__version_info__ < (0, 17):
-        expected_expr = """<iframe src="http://sphinx-doc.org"></iframe></div>"""
-        assert_count(expected_expr, result, 1)
-    else:
-        expected_expr = """<iframe src="http://sphinx-doc.org"></iframe></section>"""
-        assert_count(expected_expr, result, 1)
+    expected_expr = """<iframe src="http://sphinx-doc.org"></iframe></section>"""
+    assert_count(expected_expr, result, 1)
 
     # figure.txt
 
-    result = (app.outdir / 'figure.html').read_text()
+    result = (app.outdir / 'figure.html').read_text(encoding='utf8')
 
     # src for image block should not be translated (alt is translated)
     expected_expr = """<img alt="I18N -&gt; IMG" src="_images/i18n.png" />"""
@@ -1142,12 +1161,12 @@
             'raw',
             'image',
         ,
-    }
+    },
 )
 def test_additional_targets_should_be_translated(app):
     app.build()
     # literalblock.txt
-    result = (app.outdir / 'literalblock.html').read_text()
+    result = (app.outdir / 'literalblock.html').read_text(encoding='utf8')
 
     # title should be translated
     expected_expr = 'CODE-BLOCKS'
@@ -1162,21 +1181,20 @@
     assert_count(expected_expr, result, 1)
 
     # C code block with lang should be translated and be *C* highlighted
-    if pygments_version < (2, 10, 0):
-        expected_expr = ("""<span class="cp">#include</span> """
-                         """<span class="cpf">&lt;STDIO.H&gt;</span>""")
-    else:
-        expected_expr = ("""<span class="cp">#include</span>"""
-                         """<span class="w"> </span>"""
-                         """<span class="cpf">&lt;STDIO.H&gt;</span>""")
+    expected_expr = ("""<span class="cp">#include</span>"""
+                     """<span class="w"> </span>"""
+                     """<span class="cpf">&lt;STDIO.H&gt;</span>""")
     assert_count(expected_expr, result, 1)
 
     # literal block in list item should be translated
     expected_expr = ("""<span class="no">LITERAL</span>"""
                      """<span class="o">-</span>"""
                      """<span class="no">BLOCK</span>\n"""
-                     """<span class="no">IN</span> """
+                     """<span class="no">IN</span>"""
+                     """<span class="w"> </span>"""
                      """<span class="no">LIST</span>""")
+    if pygments.__version__ < '2.14.0':
+        expected_expr = expected_expr.replace("""<span class="w"> </span>""", ' ')
     assert_count(expected_expr, result, 1)
 
     # doctest block should not be translated but be highlighted
@@ -1186,21 +1204,20 @@
         """<span class="c1"># SYS IMPORTING</span>""")
     assert_count(expected_expr, result, 1)
 
+    # '#noqa' should remain in literal blocks.
+    assert_count("#noqa", result, 1)
+
     # raw.txt
 
-    result = (app.outdir / 'raw.html').read_text()
+    result = (app.outdir / 'raw.html').read_text(encoding='utf8')
 
     # raw block should be translated
-    if docutils.__version_info__ < (0, 17):
-        expected_expr = """<iframe src="HTTP://SPHINX-DOC.ORG"></iframe></div>"""
-        assert_count(expected_expr, result, 1)
-    else:
-        expected_expr = """<iframe src="HTTP://SPHINX-DOC.ORG"></iframe></section>"""
-        assert_count(expected_expr, result, 1)
+    expected_expr = """<iframe src="HTTP://SPHINX-DOC.ORG"></iframe></section>"""
+    assert_count(expected_expr, result, 1)
 
     # figure.txt
 
-    result = (app.outdir / 'figure.html').read_text()
+    result = (app.outdir / 'figure.html').read_text(encoding='utf8')
 
     # alt and src for image block should be translated
     expected_expr = """<img alt="I18N -&gt; IMG" src="_images/img.png" />"""
@@ -1225,7 +1242,7 @@
 @pytest.mark.sphinx(
     'dummy', testroot='images',
     srcdir='test_intl_images',
-    confoverrides={'language': 'xx'}
+    confoverrides={'language': 'xx'},
 )
 @pytest.mark.xfail(os.name != 'posix', reason="Not working on windows")
 def test_image_glob_intl(app):
@@ -1272,7 +1289,7 @@
     confoverrides={
         'language': 'xx',
         'figure_language_filename': '{root}{ext}.{language}',
-    }
+    },
 )
 @pytest.mark.xfail(os.name != 'posix', reason="Not working on windows")
 def test_image_glob_intl_using_figure_language_filename(app):
@@ -1321,7 +1338,7 @@
                     srcdir='gettext_allow_fuzzy_translations',
                     confoverrides={
                         'language': 'de',
-                        'gettext_allow_fuzzy_translations': True
+                        'gettext_allow_fuzzy_translations': True,
                     })
 def test_gettext_allow_fuzzy_translations(app):
     locale_dir = app.srcdir / 'locales' / 'de' / 'LC_MESSAGES'
@@ -1332,7 +1349,7 @@
         pofile.write_po(f, catalog)
 
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert 'FEATURES' in content
 
 
@@ -1340,7 +1357,7 @@
                     srcdir='gettext_disallow_fuzzy_translations',
                     confoverrides={
                         'language': 'de',
-                        'gettext_allow_fuzzy_translations': False
+                        'gettext_allow_fuzzy_translations': False,
                     })
 def test_gettext_disallow_fuzzy_translations(app):
     locale_dir = app.srcdir / 'locales' / 'de' / 'LC_MESSAGES'
@@ -1351,7 +1368,7 @@
         pofile.write_po(f, catalog)
 
     app.build()
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert 'FEATURES' not in content
 
 
@@ -1376,7 +1393,17 @@
         assert app.translator.gettext('Quick search') == 'QUICK SEARCH'
 
         app.build()
-        content = (app.outdir / 'index.html').read_text()
+        content = (app.outdir / 'index.html').read_text(encoding='utf8')
         assert 'QUICK SEARCH' in content
     finally:
         locale.translators.clear()
+
+
+@pytest.mark.sphinx('html', testroot='intl', confoverrides={'today_fmt': '%Y-%m-%d'})
+def test_customize_today_date_format(app, monkeypatch):
+    with monkeypatch.context() as m:
+        m.setenv('SOURCE_DATE_EPOCH', '1439131307')
+        app.build()
+        content = (app.outdir / 'refs.html').read_text(encoding='utf8')
+
+    assert '2015-08-09' in content

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_locale.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_locale.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_locale
-    ~~~~~~~~~~
-
-    Test locale.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test locale."""
 
 import pytest
 
@@ -14,7 +6,7 @@
 
 
 @pytest.fixture(autouse=True)
-def cleanup_translations():
+def _cleanup_translations():
     yield
     locale.translators.clear()
 
@@ -63,3 +55,22 @@
     assert _('Hello world') == 'HELLO WORLD'
     assert _('Hello sphinx') == 'Hello sphinx'
     assert _('Hello reST') == 'Hello reST'
+
+
+def _empty_language_translation(rootdir):
+    locale_dirs, catalog = rootdir / 'test-locale' / 'locale1', 'myext'
+    locale.translators.clear()
+    locale.init(locale_dirs, language=None, catalog=catalog)
+    return locale.get_translation(catalog)
+
+
+def test_init_environment_language(rootdir, monkeypatch):
+    with monkeypatch.context() as m:
+        m.setenv("LANGUAGE", "en_US:en")
+        _ = _empty_language_translation(rootdir)
+        assert _('Hello world') == 'HELLO WORLD'
+
+    with monkeypatch.context() as m:
+        m.setenv("LANGUAGE", "et_EE:et")
+        _ = _empty_language_translation(rootdir)
+        assert _('Hello world') == 'Tere maailm'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_markup.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_markup.py Changed

@@ -1,14 +1,7 @@
-"""
-    test_markup
-    ~~~~~~~~~~~
-
-    Test various Sphinx-specific markup extensions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test various Sphinx-specific markup extensions."""
 
 import re
+import warnings
 
 import pytest
 from docutils import frontend, nodes, utils
@@ -17,33 +10,38 @@
 from sphinx import addnodes
 from sphinx.builders.html.transforms import KeyboardTransform
 from sphinx.builders.latex import LaTeXBuilder
+from sphinx.environment import default_settings
 from sphinx.roles import XRefRole
 from sphinx.testing.util import Struct, assert_node
 from sphinx.transforms import SphinxSmartQuotes
-from sphinx.util import docutils, texescape
+from sphinx.util import texescape
 from sphinx.util.docutils import sphinx_domains
-from sphinx.writers.html import HTMLTranslator, HTMLWriter
+from sphinx.writers.html import HTML5Translator, HTMLWriter
 from sphinx.writers.latex import LaTeXTranslator, LaTeXWriter
 
 
-@pytest.fixture
+@pytest.fixture()
 def settings(app):
     texescape.init()  # otherwise done by the latex builder
-    optparser = frontend.OptionParser(
-        components=(RstParser, HTMLWriter, LaTeXWriter))
+    with warnings.catch_warnings():
+        warnings.filterwarnings('ignore', category=DeprecationWarning)
+        # DeprecationWarning: The frontend.OptionParser class will be replaced
+        # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+        optparser = frontend.OptionParser(
+            components=(RstParser, HTMLWriter, LaTeXWriter),
+            defaults=default_settings)
     settings = optparser.get_default_values()
     settings.smart_quotes = True
     settings.env = app.builder.env
     settings.env.temp_data'docname' = 'dummy'
     settings.contentsname = 'dummy'
-    settings.rfc_base_url = 'http://datatracker.ietf.org/doc/html/'
     domain_context = sphinx_domains(settings.env)
     domain_context.enable()
     yield settings
     domain_context.disable()
 
 
-@pytest.fixture
+@pytest.fixture()
 def new_document(settings):
     def create():
         document = utils.new_document('test data', settings)
@@ -53,14 +51,14 @@
     return create
 
 
-@pytest.fixture
+@pytest.fixture()
 def inliner(new_document):
     document = new_document()
     document.reporter.get_source_and_line = lambda line=1: ('dummy.rst', line)
     return Struct(document=document, reporter=document.reporter)
 
 
-@pytest.fixture
+@pytest.fixture()
 def parse(new_document):
     def parse_(rst):
         document = new_document()
@@ -83,7 +81,7 @@
         pass
 
 
-class ForgivingHTMLTranslator(HTMLTranslator, ForgivingTranslator):
+class ForgivingHTMLTranslator(HTML5Translator, ForgivingTranslator):
     pass
 
 
@@ -91,7 +89,7 @@
     pass
 
 
-@pytest.fixture
+@pytest.fixture()
 def verify_re_html(app, parse):
     def verify(rst, html_expected):
         document = parse(rst)
@@ -103,12 +101,11 @@
     return verify
 
 
-@pytest.fixture
+@pytest.fixture()
 def verify_re_latex(app, parse):
     def verify(rst, latex_expected):
         document = parse(rst)
-        app.builder = LaTeXBuilder(app)
-        app.builder.set_environment(app.env)
+        app.builder = LaTeXBuilder(app, app.env)
         app.builder.init()
         theme = app.builder.themes.get('manual')
         latex_translator = ForgivingLaTeXTranslator(document, app.builder, theme)
@@ -119,7 +116,7 @@
     return verify
 
 
-@pytest.fixture
+@pytest.fixture()
 def verify_re(verify_re_html, verify_re_latex):
     def verify_re_(rst, html_expected, latex_expected):
         if html_expected:
@@ -129,7 +126,7 @@
     return verify_re_
 
 
-@pytest.fixture
+@pytest.fixture()
 def verify(verify_re_html, verify_re_latex):
     def verify_(rst, html_expected, latex_expected):
         if html_expected:
@@ -139,7 +136,7 @@
     return verify_
 
 
-@pytest.fixture
+@pytest.fixture()
 def get_verifier(verify, verify_re):
     v = {
         'verify': verify,
@@ -157,47 +154,47 @@
         'verify',
         ':pep:`8`',
         ('<p><span class="target" id="index-0"></span><a class="pep reference external" '
-         'href="http://www.python.org/dev/peps/pep-0008"><strong>PEP 8</strong></a></p>'),
+         'href="https://peps.python.org/pep-0008/"><strong>PEP 8</strong></a></p>'),
         ('\\sphinxAtStartPar\n'
          '\\index{Python Enhancement Proposals@\\spxentry{Python Enhancement Proposals}'
-         '!PEP 8@\\spxentry{PEP 8}}\\sphinxhref{http://www.python.org/dev/peps/pep-0008}'
-         '{\\sphinxstylestrong{PEP 8}}')
+         '!PEP 8@\\spxentry{PEP 8}}\\sphinxhref{https://peps.python.org/pep-0008/}'
+         '{\\sphinxstylestrong{PEP 8}}'),
     ),
     (
         # pep role with anchor
         'verify',
         ':pep:`8#id1`',
         ('<p><span class="target" id="index-0"></span><a class="pep reference external" '
-         'href="http://www.python.org/dev/peps/pep-0008#id1">'
+         'href="https://peps.python.org/pep-0008/#id1">'
          '<strong>PEP 8#id1</strong></a></p>'),
         ('\\sphinxAtStartPar\n'
          '\\index{Python Enhancement Proposals@\\spxentry{Python Enhancement Proposals}'
          '!PEP 8\\#id1@\\spxentry{PEP 8\\#id1}}\\sphinxhref'
-         '{http://www.python.org/dev/peps/pep-0008\\#id1}'
-         '{\\sphinxstylestrong{PEP 8\\#id1}}')
+         '{https://peps.python.org/pep-0008/\\#id1}'
+         '{\\sphinxstylestrong{PEP 8\\#id1}}'),
     ),
     (
         # rfc role
         'verify',
         ':rfc:`2324`',
         ('<p><span class="target" id="index-0"></span><a class="rfc reference external" '
-         'href="http://datatracker.ietf.org/doc/html/rfc2324.html"><strong>RFC 2324</strong></a></p>'),
+         'href="https://datatracker.ietf.org/doc/html/rfc2324.html"><strong>RFC 2324</strong></a></p>'),
         ('\\sphinxAtStartPar\n'
          '\\index{RFC@\\spxentry{RFC}!RFC 2324@\\spxentry{RFC 2324}}'
-         '\\sphinxhref{http://datatracker.ietf.org/doc/html/rfc2324.html}'
-         '{\\sphinxstylestrong{RFC 2324}}')
+         '\\sphinxhref{https://datatracker.ietf.org/doc/html/rfc2324.html}'
+         '{\\sphinxstylestrong{RFC 2324}}'),
     ),
     (
         # rfc role with anchor
         'verify',
         ':rfc:`2324#id1`',
         ('<p><span class="target" id="index-0"></span><a class="rfc reference external" '
-         'href="http://datatracker.ietf.org/doc/html/rfc2324.html#id1">'
+         'href="https://datatracker.ietf.org/doc/html/rfc2324.html#id1">'
          '<strong>RFC 2324#id1</strong></a></p>'),
         ('\\sphinxAtStartPar\n'
          '\\index{RFC@\\spxentry{RFC}!RFC 2324\\#id1@\\spxentry{RFC 2324\\#id1}}'
-         '\\sphinxhref{http://datatracker.ietf.org/doc/html/rfc2324.html\\#id1}'
-         '{\\sphinxstylestrong{RFC 2324\\#id1}}')
+         '\\sphinxhref{https://datatracker.ietf.org/doc/html/rfc2324.html\\#id1}'
+         '{\\sphinxstylestrong{RFC 2324\\#id1}}'),
     ),
     (
         # correct interpretation of code with whitespace
@@ -303,6 +300,14 @@
          '\\sphinxkeyboard{\\sphinxupquote{Caps Lock}}'),
     ),
     (
+        # kbd role
+        'verify',
+        ':kbd:`sys   rq`',
+        '<p><kbd class="kbd docutils literal notranslate">sys   rq</kbd></p>',
+        ('\\sphinxAtStartPar\n'
+         '\\sphinxkeyboard{\\sphinxupquote{sys   rq}}'),
+    ),
+    (
         # non-interpolation of dashes in option role
         'verify_re',
         ':option:`--with-option`',
@@ -360,27 +365,27 @@
         # description list: simple
         'verify',
         'term\n    description',
-        '<dl class="docutils">\n<dt>term</dt><dd>description</dd>\n</dl>',
+        '<dl class="simple">\n<dt>term</dt><dd><p>description</p>\n</dd>\n</dl>',
         None,
     ),
     (
         # description list: with classifiers
         'verify',
         'term : class1 : class2\n    description',
-        ('<dl class="docutils">\n<dt>term<span class="classifier">class1</span>'
-         '<span class="classifier">class2</span></dt><dd>description</dd>\n</dl>'),
+        ('<dl class="simple">\n<dt>term<span class="classifier">class1</span>'
+         '<span class="classifier">class2</span></dt><dd><p>description</p>\n</dd>\n</dl>'),
         None,
     ),
     (
         # glossary (description list): multiple terms
         'verify',
         '.. glossary::\n\n   term1\n   term2\n       description',
-        ('<dl class="glossary docutils">\n'
+        ('<dl class="simple glossary">\n'
          '<dt id="term-term1">term1<a class="headerlink" href="#term-term1"'
          ' title="Permalink to this term">¶</a></dt>'
          '<dt id="term-term2">term2<a class="headerlink" href="#term-term2"'
          ' title="Permalink to this term">¶</a></dt>'
-         '<dd>description</dd>\n</dl>'),
+         '<dd><p>description</p>\n</dd>\n</dl>'),
         None,
     ),
 )
@@ -397,8 +402,6 @@
         None,
     ),
 )
-@pytest.mark.skipif(docutils.__version_info__ < (0, 16),
-                    reason='docutils-0.16 or above is required')
 def test_inline_docutils16(get_verifier, type, rst, html_expected, latex_expected):
     verifier = get_verifier(type)
     verifier(rst, html_expected, latex_expected)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_metadata.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_metadata.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_parser.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_parser.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_project.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_project.py Changed

@@ -1,14 +1,4 @@
-"""
-    test_project
-    ~~~~~~~~~~~~
-
-    Tests project module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-from collections import OrderedDict
+"""Tests project module."""
 
 import pytest
 
@@ -63,8 +53,7 @@
 
 @pytest.mark.sphinx(srcdir='project_doc2path', testroot='basic')
 def test_project_doc2path(app):
-    source_suffix = OrderedDict(('.rst', 'restructuredtext'),
-                                 ('.txt', 'restructuredtext'))
+    source_suffix = {'.rst': 'restructuredtext', '.txt': 'restructuredtext'}
 
     project = Project(app.srcdir, source_suffix)
     assert project.doc2path('index') == (app.srcdir / 'index.rst')
@@ -73,7 +62,7 @@
     assert project.doc2path('foo') == (app.srcdir / 'foo.rst')
 
     # matched source_suffix is used if exists
-    (app.srcdir / 'foo.txt').write_text('')
+    (app.srcdir / 'foo.txt').write_text('', encoding='utf8')
     assert project.doc2path('foo') == (app.srcdir / 'foo.txt')
 
     # absolute path

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_pycode.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_pycode.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_pycode
-    ~~~~~~~~~~~
-
-    Test pycode.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test pycode."""
 
 import os
 import sys
@@ -58,31 +50,6 @@
         sys.path.pop(0)
 
 
-def test_ModuleAnalyzer_for_file_in_egg(rootdir):
-    try:
-        path = rootdir / 'test-pycode-egg' / 'sample-0.0.0-py3.7.egg'
-        sys.path.insert(0, path)
-
-        import sample
-        analyzer = ModuleAnalyzer.for_file(sample.__file__, 'sample')
-        docs = analyzer.find_attr_docs()
-        assert docs == {('', 'CONSTANT'): 'constant on sample.py', ''}
-    finally:
-        sys.path.pop(0)
-
-
-def test_ModuleAnalyzer_for_module_in_egg(rootdir):
-    try:
-        path = rootdir / 'test-pycode-egg' / 'sample-0.0.0-py3.7.egg'
-        sys.path.insert(0, path)
-
-        analyzer = ModuleAnalyzer.for_module('sample')
-        docs = analyzer.find_attr_docs()
-        assert docs == {('', 'CONSTANT'): 'constant on sample.py', ''}
-    finally:
-        sys.path.pop(0)
-
-
 def test_ModuleAnalyzer_find_tags():
     code = ('class Foo(object):\n'  # line: 1
             '    """class Foo!"""\n'
@@ -193,8 +160,6 @@
                                  'Qux.attr2': 17}
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8),
-                    reason='posonlyargs are available since python3.8.')
 def test_ModuleAnalyzer_find_attr_docs_for_posonlyargs_method():
     code = ('class Foo(object):\n'
             '    def __init__(self, /):\n'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_pycode_ast.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_pycode_ast.py Changed

@@ -1,18 +1,10 @@
-"""
-    test_pycode_ast
-    ~~~~~~~~~~~~~~~
+"""Test pycode.ast"""
 
-    Test pycode.ast
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-import sys
+import ast
 
 import pytest
 
-from sphinx.pycode import ast
+from sphinx.pycode.ast import unparse as ast_unparse
 
 
 @pytest.mark.parametrize('source,expected', 
@@ -33,7 +25,7 @@
     ("...", "..."),                             # Ellipsis
     ("a // b", "a // b"),                       # FloorDiv
     ("Tupleint, int", "Tupleint, int"),     # Index, Subscript
-    ("~ 1", "~ 1"),                             # Invert
+    ("~1", "~1"),                               # Invert
     ("lambda x, y: x + y",
      "lambda x, y: ..."),                       # Lambda
     ("1, 2, 3", "1, 2, 3"),                 # List
@@ -45,34 +37,26 @@
     ("1234", "1234"),                           # Num
     ("not a", "not a"),                         # Not
     ("a or b", "a or b"),                       # Or
-    ("a ** b", "a ** b"),                       # Pow
+    ("a**b", "a**b"),                           # Pow
     ("a >> b", "a >> b"),                       # RShift
     ("{1, 2, 3}", "{1, 2, 3}"),                 # Set
     ("a - b", "a - b"),                         # Sub
     ("'str'", "'str'"),                         # Str
-    ("+ a", "+ a"),                             # UAdd
-    ("- 1", "- 1"),                             # UnaryOp
-    ("- a", "- a"),                             # USub
+    ("+a", "+a"),                               # UAdd
+    ("-1", "-1"),                               # UnaryOp
+    ("-a", "-a"),                               # USub
     ("(1, 2, 3)", "(1, 2, 3)"),                 # Tuple
     ("()", "()"),                               # Tuple (empty)
     ("(1,)", "(1,)"),                           # Tuple (single item)
+    ("lambda x=0, /, y=1, *args, z, **kwargs: x + y + z",
+     "lambda x=0, /, y=1, *args, z, **kwargs: ..."),  # posonlyargs
+    ("0x1234", "0x1234"),                       # Constant
+    ("1_000_000", "1_000_000"),                 # Constant
 )
 def test_unparse(source, expected):
     module = ast.parse(source)
-    assert ast.unparse(module.body0.value, source) == expected
+    assert ast_unparse(module.body0.value, source) == expected
 
 
 def test_unparse_None():
-    assert ast.unparse(None) is None
-
-
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
-@pytest.mark.parametrize('source,expected', 
-    ("lambda x=0, /, y=1, *args, z, **kwargs: x + y + z",
-     "lambda x=0, /, y=1, *args, z, **kwargs: ..."),    # posonlyargs
-    ("0x1234", "0x1234"),                               # Constant
-    ("1_000_000", "1_000_000"),                         # Constant
-)
-def test_unparse_py38(source, expected):
-    module = ast.parse(source)
-    assert ast.unparse(module.body0.value, source) == expected
+    assert ast_unparse(None) is None

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_pycode_parser.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_pycode_parser.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_pycode_parser
-    ~~~~~~~~~~~~~~~~~~
-
-    Test pycode.parser.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test pycode.parser."""
 
 from sphinx.pycode.parser import Parser
 from sphinx.util.inspect import signature_from_str
@@ -119,6 +111,9 @@
               'f = g = None  #: multiple assignment at once\n'
               '(theta, phi) = (0, 0.5)  #: unpack assignment via tuple\n'
               'x, y = (5, 6)  #: unpack assignment via list\n'
+              'h, *i, j = (1, 2, 3, 4)  #: unpack assignment2\n'
+              'k, *self.attr = (5, 6, 7)  #: unpack assignment3\n'
+              'l, *m0 = (8, 9, 0)  #: unpack assignment4\n'
               )
     parser = Parser(source)
     parser.parse()
@@ -132,22 +127,11 @@
                                ('', 'phi'): 'unpack assignment via tuple',
                                ('', 'x'): 'unpack assignment via list',
                                ('', 'y'): 'unpack assignment via list',
-                               }
-    assert parser.definitions == {}
-
-
-def test_complex_assignment_py3():
-    source = ('a, *b, c = (1, 2, 3, 4)  #: unpack assignment\n'
-              'd, *self.attr = (5, 6, 7)  #: unpack assignment2\n'
-              'e, *f0 = (8, 9, 0)  #: unpack assignment3\n'
-              )
-    parser = Parser(source)
-    parser.parse()
-    assert parser.comments == {('', 'a'): 'unpack assignment',
-                               ('', 'b'): 'unpack assignment',
-                               ('', 'c'): 'unpack assignment',
-                               ('', 'd'): 'unpack assignment2',
-                               ('', 'e'): 'unpack assignment3',
+                               ('', 'h'): 'unpack assignment2',
+                               ('', 'i'): 'unpack assignment2',
+                               ('', 'j'): 'unpack assignment2',
+                               ('', 'k'): 'unpack assignment3',
+                               ('', 'l'): 'unpack assignment4',
                                }
     assert parser.definitions == {}

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_quickstart.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_quickstart.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_quickstart
-    ~~~~~~~~~~~~~~~
-
-    Test the sphinx.quickstart module.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the sphinx.quickstart module."""
 
 import time
 from io import StringIO
@@ -108,7 +100,7 @@
     conffile = tempdir / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    exec(conffile.read_text(), ns)
+    exec(conffile.read_text(encoding='utf8'), ns)  # NoQA: S102
     assert ns'extensions' == 
     assert ns'templates_path' == '_templates'
     assert ns'project' == 'Sphinx Test'
@@ -130,7 +122,7 @@
         'Separate source and build': 'y',
         'Name prefix for templates': '.',
         'Project name': 'STASI™',
-        'Author name': 'Wolfgang Schäuble & G\'Beckstein',
+        'Author name': "Wolfgang Schäuble & G'Beckstein",
         'Project version': '2.0',
         'Project release': '2.0.1',
         'Project language': 'de',
@@ -158,15 +150,15 @@
     conffile = tempdir / 'source' / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    exec(conffile.read_text(), ns)
+    exec(conffile.read_text(encoding='utf8'), ns)  # NoQA: S102
     assert ns'extensions' == 
-        'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo'
+        'sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo',
     
     assert ns'templates_path' == '.templates'
     assert ns'source_suffix' == '.txt'
     assert ns'root_doc' == 'contents'
     assert ns'project' == 'STASI™'
-    assert ns'copyright' == '%s, Wolfgang Schäuble & G\'Beckstein' % \
+    assert ns'copyright' == "%s, Wolfgang Schäuble & G'Beckstein" % \
         time.strftime('%Y')
     assert ns'version' == '2.0'
     assert ns'release' == '2.0.1'
@@ -193,7 +185,7 @@
 
     def assert_eol(filename, eol):
         content = filename.read_bytes().decode()
-        assert all(l-len(eol): == eol for l in content.splitlines(True))
+        assert all(l-len(eol): == eol for l in content.splitlines(keepends=True))
 
     assert_eol(tempdir / 'make.bat', '\r\n')
     assert_eol(tempdir / 'Makefile', '\n')
@@ -239,7 +231,7 @@
     conffile = tempdir / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    exec(conffile.read_text(), ns)
+    exec(conffile.read_text(encoding='utf8'), ns)  # NoQA: S102
 
 
 def test_extensions(tempdir):
@@ -249,7 +241,7 @@
     conffile = tempdir / 'conf.py'
     assert conffile.isfile()
     ns = {}
-    exec(conffile.read_text(), ns)
+    exec(conffile.read_text(encoding='utf8'), ns)  # NoQA: S102
     assert ns'extensions' == 'foo', 'bar', 'baz'
 
 
@@ -261,7 +253,7 @@
     monkeypatch.setattr(path, 'isfile', mock_isfile)
 
     qs.term_input = mock_input({
-        'Please enter a new root path (or just Enter to exit)': ''
+        'Please enter a new root path (or just Enter to exit)': '',
     })
     d = {}
     with pytest.raises(SystemExit):

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_roles.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_roles.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_search.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_search.py Changed

@@ -1,13 +1,7 @@
-"""
-    test_search
-    ~~~~~~~~~~~
-
-    Test the search index builder.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the search index builder."""
 
+import json
+import warnings
 from collections import namedtuple
 from io import BytesIO
 
@@ -16,9 +10,13 @@
 from docutils.parsers import rst
 
 from sphinx.search import IndexBuilder
-from sphinx.util import jsdump
 
-DummyEnvironment = namedtuple('DummyEnvironment', 'version', 'domains')
+
+class DummyEnvironment(namedtuple('DummyEnvironment', 'version', 'domains')):
+    def __getattr__(self, name):
+        if name.startswith('_search_index_'):
+            setattr(self, name, {})
+        return getattr(self, name, {})
 
 
 class DummyDomain:
@@ -35,17 +33,21 @@
 
 def setup_module():
     global settings, parser
-    optparser = frontend.OptionParser(components=(rst.Parser,))
+    with warnings.catch_warnings():
+        warnings.filterwarnings('ignore', category=DeprecationWarning)
+        # DeprecationWarning: The frontend.OptionParser class will be replaced
+        # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+        optparser = frontend.OptionParser(components=(rst.Parser,))
     settings = optparser.get_default_values()
     parser = rst.Parser()
 
 
-def jsload(path):
-    searchindex = path.read_text()
+def load_searchindex(path):
+    searchindex = path.read_text(encoding='utf8')
     assert searchindex.startswith('Search.setIndex(')
     assert searchindex.endswith(')')
 
-    return jsdump.loads(searchindex16:-1)
+    return json.loads(searchindex16:-1)
 
 
 def is_registered_term(index, keyword):
@@ -63,20 +65,20 @@
 
 
 @pytest.mark.sphinx(testroot='ext-viewcode')
-def test_objects_are_escaped(app, status, warning):
+def test_objects_are_escaped(app):
     app.builder.build_all()
-    index = jsload(app.outdir / 'searchindex.js')
+    index = load_searchindex(app.outdir / 'searchindex.js')
     for item in index.get('objects').get(''):
         if item-1 == 'n::Array&lt;T, d&gt;':  # n::Array<T,d> is escaped
             break
     else:
-        assert False, index.get('objects').get('')
+        raise AssertionError(index.get('objects').get(''))
 
 
 @pytest.mark.sphinx(testroot='search')
-def test_meta_keys_are_handled_for_language_en(app, status, warning):
+def test_meta_keys_are_handled_for_language_en(app):
     app.builder.build_all()
-    searchindex = jsload(app.outdir / 'searchindex.js')
+    searchindex = load_searchindex(app.outdir / 'searchindex.js')
     assert not is_registered_term(searchindex, 'thisnoteith')
     assert is_registered_term(searchindex, 'thisonetoo')
     assert is_registered_term(searchindex, 'findthiskei')
@@ -86,10 +88,10 @@
     assert not is_registered_term(searchindex, 'onlytoogerman')
 
 
-@pytest.mark.sphinx(testroot='search', confoverrides={'html_search_language': 'de'})
-def test_meta_keys_are_handled_for_language_de(app, status, warning):
+@pytest.mark.sphinx(testroot='search', confoverrides={'html_search_language': 'de'}, freshenv=True)
+def test_meta_keys_are_handled_for_language_de(app):
     app.builder.build_all()
-    searchindex = jsload(app.outdir / 'searchindex.js')
+    searchindex = load_searchindex(app.outdir / 'searchindex.js')
     assert not is_registered_term(searchindex, 'thisnoteith')
     assert is_registered_term(searchindex, 'thisonetoo')
     assert not is_registered_term(searchindex, 'findthiskei')
@@ -100,33 +102,36 @@
 
 
 @pytest.mark.sphinx(testroot='search')
-def test_stemmer_does_not_remove_short_words(app, status, warning):
+def test_stemmer_does_not_remove_short_words(app):
     app.builder.build_all()
-    searchindex = (app.outdir / 'searchindex.js').read_text()
-    assert 'zfs' in searchindex
+    searchindex = (app.outdir / 'searchindex.js').read_text(encoding='utf8')
+    assert 'bat' in searchindex
 
 
 @pytest.mark.sphinx(testroot='search')
-def test_stemmer(app, status, warning):
-    searchindex = jsload(app.outdir / 'searchindex.js')
+def test_stemmer(app):
+    app.builder.build_all()
+    searchindex = load_searchindex(app.outdir / 'searchindex.js')
     print(searchindex)
     assert is_registered_term(searchindex, 'findthisstemmedkei')
     assert is_registered_term(searchindex, 'intern')
 
 
 @pytest.mark.sphinx(testroot='search')
-def test_term_in_heading_and_section(app, status, warning):
-    searchindex = (app.outdir / 'searchindex.js').read_text()
+def test_term_in_heading_and_section(app):
+    app.builder.build_all()
+    searchindex = (app.outdir / 'searchindex.js').read_text(encoding='utf8')
     # if search term is in the title of one doc and in the text of another
     # both documents should be a hit in the search index as a title,
     # respectively text hit
-    assert 'textinhead:2' in searchindex
-    assert 'textinhead:0' in searchindex
+    assert '"textinhead": 2' in searchindex
+    assert '"textinhead": 0' in searchindex
 
 
 @pytest.mark.sphinx(testroot='search')
-def test_term_in_raw_directive(app, status, warning):
-    searchindex = jsload(app.outdir / 'searchindex.js')
+def test_term_in_raw_directive(app):
+    app.builder.build_all()
+    searchindex = load_searchindex(app.outdir / 'searchindex.js')
     assert not is_registered_term(searchindex, 'raw')
     assert is_registered_term(searchindex, 'rawword')
     assert not is_registered_term(searchindex, 'latex_keyword')
@@ -158,7 +163,7 @@
         'comment': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'},
         'non': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'},
         'index': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'},
-        'test': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'}
+        'test': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'},
     }
     assert index._title_mapping == {'section_titl': {'docname1_1', 'docname1_2', 'docname2_1', 'docname2_2'}}
     assert index._objtypes == {}
@@ -180,12 +185,16 @@
                   'non': 0, 1, 2, 3,
                   'test': 0, 1, 2, 3},
         'titles': ('title1_1', 'title1_2', 'title2_1', 'title2_2'),
-        'titleterms': {'section_titl': 0, 1, 2, 3}
+        'titleterms': {'section_titl': 0, 1, 2, 3},
+        'alltitles': {'section_title': (0, 'section-title'), (1, 'section-title'), (2, 'section-title'), (3, 'section-title')},
+        'indexentries': {},
     }
     assert index._objtypes == {('dummy1', 'objtype1'): 0, ('dummy2', 'objtype1'): 1}
     assert index._objnames == {0: ('dummy1', 'objtype1', 'objtype1'),
                                1: ('dummy2', 'objtype1', 'objtype1')}
 
+    env = DummyEnvironment('1.0', {'dummy1': domain1, 'dummy2': domain2})
+
     # dump / load
     stream = BytesIO()
     index.dump(stream, 'pickle')
@@ -216,7 +225,7 @@
         'comment': {'docname1_2', 'docname2_2'},
         'non': {'docname1_2', 'docname2_2'},
         'index': {'docname1_2', 'docname2_2'},
-        'test': {'docname1_2', 'docname2_2'}
+        'test': {'docname1_2', 'docname2_2'},
     }
     assert index._title_mapping == {'section_titl': {'docname1_2', 'docname2_2'}}
     assert index._objtypes == {('dummy1', 'objtype1'): 0, ('dummy2', 'objtype1'): 1}
@@ -237,7 +246,9 @@
                   'non': 0, 1,
                   'test': 0, 1},
         'titles': ('title1_2', 'title2_2'),
-        'titleterms': {'section_titl': 0, 1}
+        'titleterms': {'section_titl': 0, 1},
+        'alltitles': {'section_title': (0, 'section-title'), (1, 'section-title')},
+        'indexentries': {},
     }
     assert index._objtypes == {('dummy1', 'objtype1'): 0, ('dummy2', 'objtype1'): 1}
     assert index._objnames == {0: ('dummy1', 'objtype1', 'objtype1'),
@@ -259,23 +270,31 @@
 @pytest.mark.sphinx(
     testroot='search',
     confoverrides={'html_search_language': 'zh'},
-    srcdir='search_zh'
+    srcdir='search_zh',
 )
-def test_search_index_gen_zh(app, status, warning):
+def test_search_index_gen_zh(app):
     app.builder.build_all()
-    # jsdump fails if search language is 'zh'; hence we just get the text:
-    searchindex = (app.outdir / 'searchindex.js').read_text()
-    assert 'chinesetest ' not in searchindex
-    assert 'chinesetest' in searchindex
-    assert 'chinesetesttwo' in searchindex
-    assert 'cas' in searchindex
+    index = load_searchindex(app.outdir / 'searchindex.js')
+    assert 'chinesetest ' not in index'terms'
+    assert 'chinesetest' in index'terms'
+    assert 'chinesetesttwo' in index'terms'
+    assert 'cas' in index'terms'
 
 
-@pytest.mark.sphinx(testroot='search')
+@pytest.mark.sphinx(testroot='search', freshenv=True)
 def test_nosearch(app):
     app.build()
-    index = jsload(app.outdir / 'searchindex.js')
+    index = load_searchindex(app.outdir / 'searchindex.js')
     assert index'docnames' == 'index', 'nosearch', 'tocitem'
     assert 'latex' not in index'terms'
-    assert 'zfs' in index'terms'
-    assert index'terms''zfs' ==   # zfs on nosearch.rst is not registered to index
+    assert 'bat' in index'terms'
+    # bat is indexed from 'index.rst' and 'tocitem.rst' (document IDs 0, 2), and
+    # not from 'nosearch.rst' (document ID 1)
+    assert index'terms''bat' == 0, 2
+
+
+@pytest.mark.sphinx(testroot='search', parallel=3, freshenv=True)
+def test_parallel(app):
+    app.build()
+    index = load_searchindex(app.outdir / 'searchindex.js')
+    assert index'docnames' == 'index', 'nosearch', 'tocitem'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_smartquotes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_smartquotes.py Changed

@@ -1,24 +1,14 @@
-"""
-    test_smartquotes
-    ~~~~~~~~~~~~~~~~
-
-    Test smart quotes.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test smart quotes."""
 
 import pytest
 from html5lib import HTMLParser
 
-from sphinx.util import docutils
-
 
 @pytest.mark.sphinx(buildername='html', testroot='smartquotes', freshenv=True)
 def test_basic(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<p>– “Sphinx” is a tool that makes it easy …</p>' in content
 
 
@@ -26,7 +16,7 @@
 def test_literals(app, status, warning):
     app.build()
 
-    with (app.outdir / 'literals.html').open() as html_file:
+    with (app.outdir / 'literals.html').open(encoding='utf-8') as html_file:
         etree = HTMLParser(namespaceHTMLElements=False).parse(html_file)
 
     for code_element in etree.iter('code'):
@@ -44,7 +34,7 @@
 def test_text_builder(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'index.txt').read_text()
+    content = (app.outdir / 'index.txt').read_text(encoding='utf8')
     assert '-- "Sphinx" is a tool that makes it easy ...' in content
 
 
@@ -52,18 +42,15 @@
 def test_man_builder(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'python.1').read_text()
-    if docutils.__version_info__ > (0, 18):
-        assert r'\-\- \(dqSphinx\(dq is a tool that makes it easy ...' in content
-    else:
-        assert r'\-\- "Sphinx" is a tool that makes it easy ...' in content
+    content = (app.outdir / 'python.1').read_text(encoding='utf8')
+    assert r'\-\- \(dqSphinx\(dq is a tool that makes it easy ...' in content
 
 
 @pytest.mark.sphinx(buildername='latex', testroot='smartquotes', freshenv=True)
 def test_latex_builder(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'python.tex').read_text()
+    content = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert '\\textendash{} “Sphinx” is a tool that makes it easy …' in content
 
 
@@ -72,7 +59,7 @@
 def test_ja_html_builder(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<p>-- &quot;Sphinx&quot; is a tool that makes it easy ...</p>' in content
 
 
@@ -81,7 +68,7 @@
 def test_smartquotes_disabled(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<p>-- &quot;Sphinx&quot; is a tool that makes it easy ...</p>' in content
 
 
@@ -90,7 +77,7 @@
 def test_smartquotes_action(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<p>-- “Sphinx” is a tool that makes it easy ...</p>' in content
 
 
@@ -99,7 +86,7 @@
 def test_smartquotes_excludes_language(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<p>– 「Sphinx」 is a tool that makes it easy …</p>' in content
 
 
@@ -108,5 +95,5 @@
 def test_smartquotes_excludes_builders(app, status, warning):
     app.build()
 
-    content = (app.outdir / 'python.1').read_text()
+    content = (app.outdir / 'python.1').read_text(encoding='utf8')
     assert '– “Sphinx” is a tool that makes it easy …' in content

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_templating.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_templating.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_templating
-    ~~~~~~~~~~~~~~~~
-
-    Test templating.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test templating."""
 
 import pytest
 
@@ -20,7 +12,7 @@
     setup_documenters(app)
     app.builder.build_update()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '' in result
 
 
@@ -31,7 +23,7 @@
     setup_documenters(app)
     app.builder.build_update()
 
-    result = (app.outdir / 'generated' / 'sphinx.application.TemplateBridge.html').read_text()
+    result = (app.outdir / 'generated' / 'sphinx.application.TemplateBridge.html').read_text(encoding='utf8')
     assert 'autosummary/class.rst method block overloading' in result
     assert 'foobar' not in result
 
@@ -44,6 +36,6 @@
     setup_documenters(app)
     app.builder.build_update()
 
-    result = (app.outdir / 'generated' / 'sphinx.application.TemplateBridge.html').read_text()
+    result = (app.outdir / 'generated' / 'sphinx.application.TemplateBridge.html').read_text(encoding='utf8')
     assert 'autosummary/class.rst method block overloading' in result
     assert 'foobar' in result

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_theming.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_theming.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_theming
-    ~~~~~~~~~~~~
-
-    Test the Theme class.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the Theme class."""
 
 import os
 
@@ -26,7 +18,11 @@
     themes = 'basic', 'default', 'scrolls', 'agogo', 'sphinxdoc', 'haiku',
               'traditional', 'epub', 'nature', 'pyramid', 'bizstyle', 'classic', 'nonav',
               'test-theme', 'ziptheme', 'staticfiles', 'parent', 'child'
-    if alabaster.version.__version_info__ >= (0, 7, 11):
+    try:
+        alabaster_version = alabaster.__version_info__
+    except AttributeError:
+        alabaster_version = alabaster.version.__version_info__
+    if alabaster_version >= (0, 7, 11):
         themes.append('alabaster')
 
     # test Theme class API
@@ -65,30 +61,6 @@
     assert not os.path.exists(themedir)
 
 
-@pytest.mark.sphinx(testroot='tocdepth')  # a minimal root
-def test_js_source(app, status, warning):
-    # Now sphinx provides non-minified JS files for jquery.js and underscore.js
-    # to clarify the source of the minified files. see also #1434.
-    # If you update the version of the JS file, please update the source of the
-    # JS file and version number in this test.
-
-    app.builder.build('contents')
-
-    v = '3.5.1'
-    msg = 'jquery.js version does not match to {v}'.format(v=v)
-    jquery_min = (app.outdir / '_static' / 'jquery.js').read_text()
-    assert 'jQuery v{v}'.format(v=v) in jquery_min, msg
-    jquery_src = (app.outdir / '_static' / 'jquery-{v}.js'.format(v=v)).read_text()
-    assert 'jQuery JavaScript Library v{v}'.format(v=v) in jquery_src, msg
-
-    v = '1.13.1'
-    msg = 'underscore.js version does not match to {v}'.format(v=v)
-    underscore_min = (app.outdir / '_static' / 'underscore.js').read_text()
-    assert 'Underscore.js {v}'.format(v=v) in underscore_min, msg
-    underscore_src = (app.outdir / '_static' / 'underscore-{v}.js'.format(v=v)).read_text()
-    assert 'Underscore.js {v}'.format(v=v) in underscore_src, msg
-
-
 @pytest.mark.sphinx(testroot='double-inheriting-theme')
 def test_double_inheriting_theme(app, status, warning):
     assert app.builder.theme.name == 'base_theme2'
@@ -108,12 +80,12 @@
     app.build()
     assert (app.outdir / '_static' / 'staticimg.png').exists()
     assert (app.outdir / '_static' / 'statictmpl.html').exists()
-    assert (app.outdir / '_static' / 'statictmpl.html').read_text() == (
+    assert (app.outdir / '_static' / 'statictmpl.html').read_text(encoding='utf8') == (
         '\n'
         '<html><project>Python</project></html>'
     )
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<meta name="testopt" content="optdefault" />' in result
 
 
@@ -126,7 +98,7 @@
     app.build()
     assert (app.outdir / '_static' / 'pygments_dark.css').exists()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<link rel="stylesheet" type="text/css" href="_static/pygments.css" />' in result
     assert ('<link id="pygments_dark_css" media="(prefers-color-scheme: dark)" '
             'rel="stylesheet" type="text/css" '
@@ -138,7 +110,7 @@
     app.build()
 
     # test-theme specifies globaltoc and searchbox as default sidebars
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<h3><a href="#">Table of Contents</a></h3>' in result
     assert '<h3>Related Topics</h3>' not in result
     assert '<h3>This Page</h3>' not in result

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_toctree.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_toctree.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_transforms_post_transforms.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_transforms_post_transforms.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_transforms_post_transforms
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Tests the post_transforms
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests the post_transforms"""
 
 import pytest
 from docutils import nodes
@@ -18,7 +10,7 @@
     assert ('index.rst:4: WARNING: py:class reference target '
             'not found: io.StringIO' in warning.getvalue())
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert ('<p><code class="xref py py-class docutils literal notranslate"><span class="pre">'
             'io.StringIO</span></code></p>' in content)
 
@@ -39,7 +31,7 @@
     app.build()
     assert warning.getvalue() == ''
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<p><span>missing-reference.StringIO</span></p>' in content
 
 
@@ -54,5 +46,14 @@
     app.build()
     assert warning.getvalue() == ''
 
-    content = (app.outdir / 'index.html').read_text()
+    content = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert '<span class="n"><span class="pre">Age</span></span>' in content
+
+
+@pytest.mark.sphinx('html', testroot='transforms-post_transforms-keyboard',
+                    freshenv=True)
+def test_keyboard_hyphen_spaces(app):
+    """Regression test for issue 10495, we want no crash."""
+    app.build()
+    assert "spanish" in (app.outdir / 'index.html').read_text(encoding='utf8')
+    assert "inquisition" in (app.outdir / 'index.html').read_text(encoding='utf8')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_transforms_post_transforms_code.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_transforms_post_transforms_code.py Changed

@@ -1,11 +1,3 @@
-"""
-    test_transforms_post_transforms_code
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
 import pytest
 
 
@@ -13,7 +5,7 @@
 def test_trim_doctest_flags_html(app, status, warning):
     app.build()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert 'FOO' not in result
     assert 'BAR' in result
     assert 'BAZ' not in result
@@ -28,7 +20,7 @@
 def test_trim_doctest_flags_disabled(app, status, warning):
     app.build()
 
-    result = (app.outdir / 'index.html').read_text()
+    result = (app.outdir / 'index.html').read_text(encoding='utf8')
     assert 'FOO' in result
     assert 'BAR' in result
     assert 'BAZ' in result
@@ -42,7 +34,7 @@
 def test_trim_doctest_flags_latex(app, status, warning):
     app.build()
 
-    result = (app.outdir / 'python.tex').read_text()
+    result = (app.outdir / 'python.tex').read_text(encoding='utf8')
     assert 'FOO' not in result
     assert 'BAR' in result
     assert 'BAZ' not in result

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util.py Changed

@@ -1,24 +1,12 @@
-"""
-    test_util
-    ~~~~~~~~~~~~~~~
-
-    Tests util functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests util functions."""
 
 import os
 import tempfile
-from unittest.mock import patch
 
 import pytest
 
 from sphinx.errors import ExtensionError
-from sphinx.testing.util import strip_escseq
-from sphinx.util import (SkipProgressMessage, display_chunk, encode_uri, ensuredir,
-                         import_object, logging, parselinenos, progress_message,
-                         status_iterator, xmlname_checker)
+from sphinx.util import encode_uri, ensuredir, import_object, parselinenos
 
 
 def test_encode_uri():
@@ -50,14 +38,6 @@
             ensuredir(tmp.name)
 
 
-def test_display_chunk():
-    assert display_chunk('hello') == 'hello'
-    assert display_chunk('hello') == 'hello'
-    assert display_chunk('hello', 'sphinx', 'world') == 'hello .. world'
-    assert display_chunk(('hello',)) == 'hello'
-    assert display_chunk(('hello', 'sphinx', 'world')) == 'hello .. world'
-
-
 def test_import_object():
     module = import_object('sphinx')
     assert module.__name__ == 'sphinx'
@@ -78,39 +58,6 @@
                                  '(needed for my extension)')
 
 
-@pytest.mark.sphinx('dummy')
-@patch('sphinx.util.console._tw', 40)  # terminal width = 40
-def test_status_iterator(app, status, warning):
-    logging.setup(app, status, warning)
-
-    # test for old_status_iterator
-    status.truncate(0)
-    yields = list(status_iterator('hello', 'sphinx', 'world', 'testing ... '))
-    output = strip_escseq(status.getvalue())
-    assert 'testing ... hello sphinx world \n' in output
-    assert yields == 'hello', 'sphinx', 'world'
-
-    # test for status_iterator (verbosity=0)
-    status.truncate(0)
-    yields = list(status_iterator('hello', 'sphinx', 'world', 'testing ... ',
-                                  length=3, verbosity=0))
-    output = strip_escseq(status.getvalue())
-    assert 'testing ...  33% hello                \r' in output
-    assert 'testing ...  66% sphinx               \r' in output
-    assert 'testing ... 100% world                \r\n' in output
-    assert yields == 'hello', 'sphinx', 'world'
-
-    # test for status_iterator (verbosity=1)
-    status.truncate(0)
-    yields = list(status_iterator('hello', 'sphinx', 'world', 'testing ... ',
-                                  length=3, verbosity=1))
-    output = strip_escseq(status.getvalue())
-    assert 'testing ...  33% hello\n' in output
-    assert 'testing ...  66% sphinx\n' in output
-    assert 'testing ... 100% world\n\n' in output
-    assert yields == 'hello', 'sphinx', 'world'
-
-
 def test_parselinenos():
     assert parselinenos('1,2,3', 10) == 0, 1, 2
     assert parselinenos('4, 5, 6', 10) == 3, 4, 5
@@ -128,48 +75,3 @@
         parselinenos('-', 10)
     with pytest.raises(ValueError):
         parselinenos('3-1', 10)
-
-
-def test_progress_message(app, status, warning):
-    logging.setup(app, status, warning)
-    logger = logging.getLogger(__name__)
-
-    # standard case
-    with progress_message('testing'):
-        logger.info('blah ', nonl=True)
-
-    output = strip_escseq(status.getvalue())
-    assert 'testing... blah done\n' in output
-
-    # skipping case
-    with progress_message('testing'):
-        raise SkipProgressMessage('Reason: %s', 'error')
-
-    output = strip_escseq(status.getvalue())
-    assert 'testing... skipped\nReason: error\n' in output
-
-    # error case
-    try:
-        with progress_message('testing'):
-            raise
-    except Exception:
-        pass
-
-    output = strip_escseq(status.getvalue())
-    assert 'testing... failed\n' in output
-
-    # decorator
-    @progress_message('testing')
-    def func():
-        logger.info('in func ', nonl=True)
-
-    func()
-    output = strip_escseq(status.getvalue())
-    assert 'testing... in func done\n' in output
-
-
-def test_xmlname_check():
-    checker = xmlname_checker()
-    assert checker.match('id-pub')
-    assert checker.match('webpage')
-    assert not checker.match('1bfda21')

_service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_display.py Added

@@ -0,0 +1,96 @@
+"""Tests util functions."""
+
+from unittest.mock import patch
+
+import pytest
+
+from sphinx.testing.util import strip_escseq
+from sphinx.util import logging
+from sphinx.util.display import (
+    SkipProgressMessage,
+    display_chunk,
+    progress_message,
+    status_iterator,
+)
+
+
+def test_display_chunk():
+    assert display_chunk('hello') == 'hello'
+    assert display_chunk('hello') == 'hello'
+    assert display_chunk('hello', 'sphinx', 'world') == 'hello .. world'
+    assert display_chunk(('hello',)) == 'hello'
+    assert display_chunk(('hello', 'sphinx', 'world')) == 'hello .. world'
+
+
+@pytest.mark.sphinx('dummy')
+@patch('sphinx.util.console._tw', 40)  # terminal width = 40
+def test_status_iterator(app, status, warning):
+    logging.setup(app, status, warning)
+
+    # # test for old_status_iterator
+    # status.seek(0)
+    # status.truncate(0)
+    # yields = list(status_iterator('hello', 'sphinx', 'world', 'testing ... '))
+    # output = strip_escseq(status.getvalue())
+    # assert 'testing ... hello sphinx world \n' in output
+    # assert yields == 'hello', 'sphinx', 'world'
+
+    # test for status_iterator (verbosity=0)
+    status.seek(0)
+    status.truncate(0)
+    yields = list(status_iterator('hello', 'sphinx', 'world', 'testing ... ',
+                                  length=3, verbosity=0))
+    output = strip_escseq(status.getvalue())
+    assert 'testing ...  33% hello                \r' in output
+    assert 'testing ...  66% sphinx               \r' in output
+    assert 'testing ... 100% world                \r\n' in output
+    assert yields == 'hello', 'sphinx', 'world'
+
+    # test for status_iterator (verbosity=1)
+    status.seek(0)
+    status.truncate(0)
+    yields = list(status_iterator('hello', 'sphinx', 'world', 'testing ... ',
+                                  length=3, verbosity=1))
+    output = strip_escseq(status.getvalue())
+    assert 'testing ...  33% hello\n' in output
+    assert 'testing ...  66% sphinx\n' in output
+    assert 'testing ... 100% world\n\n' in output
+    assert yields == 'hello', 'sphinx', 'world'
+
+
+def test_progress_message(app, status, warning):
+    logging.setup(app, status, warning)
+    logger = logging.getLogger(__name__)
+
+    # standard case
+    with progress_message('testing'):
+        logger.info('blah ', nonl=True)
+
+    output = strip_escseq(status.getvalue())
+    assert 'testing... blah done\n' in output
+
+    # skipping case
+    with progress_message('testing'):
+        raise SkipProgressMessage('Reason: %s', 'error')
+
+    output = strip_escseq(status.getvalue())
+    assert 'testing... skipped\nReason: error\n' in output
+
+    # error case
+    try:
+        with progress_message('testing'):
+            raise
+    except Exception:
+        pass
+
+    output = strip_escseq(status.getvalue())
+    assert 'testing... failed\n' in output
+
+    # decorator
+    @progress_message('testing')
+    def func():
+        logger.info('in func ', nonl=True)
+
+    func()
+    output = strip_escseq(status.getvalue())
+    assert 'testing... in func done\n' in output

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_docstrings.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_docstrings.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_docutils.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_docutils.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_fileutil.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_fileutil.py Changed

@@ -1,12 +1,4 @@
-"""
-    test_util_fileutil
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.fileutil functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests sphinx.util.fileutil functions."""
 
 from unittest import mock
 
@@ -33,7 +25,7 @@
 
     copy_asset_file(src, dest)
     assert dest.exists()
-    assert src.read_text() == dest.read_text()
+    assert src.read_text(encoding='utf8') == dest.read_text(encoding='utf8')
 
     # copy template file
     src = (tempdir / 'asset.txt_t')
@@ -43,7 +35,7 @@
     copy_asset_file(src, dest, {'var1': 'template'}, renderer)
     assert not dest.exists()
     assert (tempdir / 'output.txt').exists()
-    assert (tempdir / 'output.txt').read_text() == '# template data'
+    assert (tempdir / 'output.txt').read_text(encoding='utf8') == '# template data'
 
     # copy template file to subdir
     src = (tempdir / 'asset.txt_t')
@@ -53,7 +45,7 @@
 
     copy_asset_file(src, subdir1, {'var1': 'template'}, renderer)
     assert (subdir1 / 'asset.txt').exists()
-    assert (subdir1 / 'asset.txt').read_text() == '# template data'
+    assert (subdir1 / 'asset.txt').read_text(encoding='utf8') == '# template data'
 
     # copy template file without context
     src = (tempdir / 'asset.txt_t')
@@ -63,7 +55,7 @@
     copy_asset_file(src, subdir2)
     assert not (subdir2 / 'asset.txt').exists()
     assert (subdir2 / 'asset.txt_t').exists()
-    assert (subdir2 / 'asset.txt_t').read_text() == '# {{var1}} data'
+    assert (subdir2 / 'asset.txt_t').read_text(encoding='utf8') == '# {{var1}} data'
 
 
 def test_copy_asset(tempdir):
@@ -72,13 +64,13 @@
     # prepare source files
     source = (tempdir / 'source')
     source.makedirs()
-    (source / 'index.rst').write_text('index.rst')
-    (source / 'foo.rst_t').write_text('{{var1}}.rst')
+    (source / 'index.rst').write_text('index.rst', encoding='utf8')
+    (source / 'foo.rst_t').write_text('{{var1}}.rst', encoding='utf8')
     (source / '_static').makedirs()
-    (source / '_static' / 'basic.css').write_text('basic.css')
+    (source / '_static' / 'basic.css').write_text('basic.css', encoding='utf8')
     (source / '_templates').makedirs()
-    (source / '_templates' / 'layout.html').write_text('layout.html')
-    (source / '_templates' / 'sidebar.html_t').write_text('sidebar: {{var2}}')
+    (source / '_templates' / 'layout.html').write_text('layout.html', encoding='utf8')
+    (source / '_templates' / 'sidebar.html_t').write_text('sidebar: {{var2}}', encoding='utf8')
 
     # copy a single file
     assert not (tempdir / 'test1').exists()
@@ -88,14 +80,14 @@
 
     # copy directories
     destdir = tempdir / 'test2'
-    copy_asset(source, destdir, context=dict(var1='bar', var2='baz'), renderer=renderer)
+    copy_asset(source, destdir, context={'var1': 'bar', 'var2': 'baz'}, renderer=renderer)
     assert (destdir / 'index.rst').exists()
     assert (destdir / 'foo.rst').exists()
-    assert (destdir / 'foo.rst').read_text() == 'bar.rst'
+    assert (destdir / 'foo.rst').read_text(encoding='utf8') == 'bar.rst'
     assert (destdir / '_static' / 'basic.css').exists()
     assert (destdir / '_templates' / 'layout.html').exists()
     assert (destdir / '_templates' / 'sidebar.html').exists()
-    assert (destdir / '_templates' / 'sidebar.html').read_text() == 'sidebar: baz'
+    assert (destdir / '_templates' / 'sidebar.html').read_text(encoding='utf8') == 'sidebar: baz'
 
     # copy with exclusion
     def excluded(path):
@@ -103,7 +95,7 @@
 
     destdir = tempdir / 'test3'
     copy_asset(source, destdir, excluded,
-               context=dict(var1='bar', var2='baz'), renderer=renderer)
+               context={'var1': 'bar', 'var2': 'baz'}, renderer=renderer)
     assert (destdir / 'index.rst').exists()
     assert (destdir / 'foo.rst').exists()
     assert not (destdir / '_static' / 'basic.css').exists()

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_i18n.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_i18n.py Changed

@@ -1,22 +1,17 @@
-"""
-    test_util_i18n
-    ~~~~~~~~~~~~~~
-
-    Test i18n util.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test i18n util."""
 
 import datetime
 import os
 
+import babel
 import pytest
 from babel.messages.mofile import read_mo
 
 from sphinx.errors import SphinxError
 from sphinx.util import i18n
 
+BABEL_VERSION = tuple(map(int, babel.__version__.split('.')))
+
 
 def test_catalog_info_for_file_and_path():
     cat = i18n.CatalogInfo('path', 'domain', 'utf-8')
@@ -35,12 +30,12 @@
 
 
 def test_catalog_outdated(tempdir):
-    (tempdir / 'test.po').write_text('#')
+    (tempdir / 'test.po').write_text('#', encoding='utf8')
     cat = i18n.CatalogInfo(tempdir, 'test', 'utf-8')
     assert cat.is_outdated()  # if mo is not exist
 
     mo_file = (tempdir / 'test.mo')
-    mo_file.write_text('#')
+    mo_file.write_text('#', encoding='utf8')
     assert not cat.is_outdated()  # if mo is exist and newer than po
 
     os.utime(mo_file, (os.stat(mo_file).st_mtime - 10,) * 2)  # to be outdate
@@ -48,7 +43,7 @@
 
 
 def test_catalog_write_mo(tempdir):
-    (tempdir / 'test.po').write_text('#')
+    (tempdir / 'test.po').write_text('#', encoding='utf8')
     cat = i18n.CatalogInfo(tempdir, 'test', 'utf-8')
     cat.write_mo('en')
     assert os.path.exists(cat.mo_path)
@@ -61,7 +56,6 @@
 
     # strftime format
     format = '%B %d, %Y'
-    assert i18n.format_date(format, date=date) == 'February 07, 2016'
     assert i18n.format_date(format, date=date, language='') == 'February 07, 2016'
     assert i18n.format_date(format, date=date, language='unknown') == 'February 07, 2016'
     assert i18n.format_date(format, date=date, language='en') == 'February 07, 2016'
@@ -70,43 +64,40 @@
 
     # raw string
     format = 'Mon Mar 28 12:37:08 2016, commit 4367aef'
-    assert i18n.format_date(format, date=date) == format
+    assert i18n.format_date(format, date=date, language='en') == format
 
     format = '%B %d, %Y, %H:%M:%S %I %p'
     datet = datetime.datetime(2016, 2, 7, 5, 11, 17, 0)
-    assert i18n.format_date(format, date=datet) == 'February 07, 2016, 05:11:17 05 AM'
+    assert i18n.format_date(format, date=datet, language='en') == 'February 07, 2016, 05:11:17 05 AM'
 
     format = '%B %-d, %Y, %-H:%-M:%-S %-I %p'
-    assert i18n.format_date(format, date=datet) == 'February 7, 2016, 5:11:17 5 AM'
+    assert i18n.format_date(format, date=datet, language='en') == 'February 7, 2016, 5:11:17 5 AM'
     format = '%x'
-    assert i18n.format_date(format, date=datet) == 'Feb 7, 2016'
+    assert i18n.format_date(format, date=datet, language='en') == 'Feb 7, 2016'
     format = '%X'
-    assert i18n.format_date(format, date=datet) == '5:11:17 AM'
-    assert i18n.format_date(format, date=date) == 'Feb 7, 2016'
+    if BABEL_VERSION >= (2, 12):
+        assert i18n.format_date(format, date=datet, language='en') == '5:11:17\u202fAM'
+    else:
+        assert i18n.format_date(format, date=datet, language='en') == '5:11:17 AM'
+    assert i18n.format_date(format, date=date, language='en') == 'Feb 7, 2016'
     format = '%c'
-    assert i18n.format_date(format, date=datet) == 'Feb 7, 2016, 5:11:17 AM'
-    assert i18n.format_date(format, date=date) == 'Feb 7, 2016'
+    if BABEL_VERSION >= (2, 12):
+        assert i18n.format_date(format, date=datet, language='en') == 'Feb 7, 2016, 5:11:17\u202fAM'
+    else:
+        assert i18n.format_date(format, date=datet, language='en') == 'Feb 7, 2016, 5:11:17 AM'
+    assert i18n.format_date(format, date=date, language='en') == 'Feb 7, 2016'
 
     # timezone
     format = '%Z'
-    assert i18n.format_date(format, date=datet) == 'UTC'
+    assert i18n.format_date(format, date=datet, language='en') == 'UTC'
     format = '%z'
-    assert i18n.format_date(format, date=datet) == '+0000'
+    assert i18n.format_date(format, date=datet, language='en') == '+0000'
 
 
 @pytest.mark.xfail(os.name != 'posix', reason="Path separators don't match on windows")
 def test_get_filename_for_language(app):
     app.env.temp_data'docname' = 'index'
 
-    # language is None
-    app.env.config.language = None
-    assert app.env.config.language is None
-    assert i18n.get_image_filename_for_language('foo.png', app.env) == 'foo.png'
-    assert i18n.get_image_filename_for_language('foo.bar.png', app.env) == 'foo.bar.png'
-    assert i18n.get_image_filename_for_language('subdir/foo.png', app.env) == 'subdir/foo.png'
-    assert i18n.get_image_filename_for_language('../foo.png', app.env) == '../foo.png'
-    assert i18n.get_image_filename_for_language('foo', app.env) == 'foo'
-
     # language is en
     app.env.config.language = 'en'
     assert i18n.get_image_filename_for_language('foo.png', app.env) == 'foo.en.png'
@@ -115,15 +106,6 @@
     assert i18n.get_image_filename_for_language('../foo.png', app.env) == '../foo.en.png'
     assert i18n.get_image_filename_for_language('foo', app.env) == 'foo.en'
 
-    # modify figure_language_filename and language is None
-    app.env.config.language = None
-    app.env.config.figure_language_filename = 'images/{language}/{root}{ext}'
-    assert i18n.get_image_filename_for_language('foo.png', app.env) == 'foo.png'
-    assert i18n.get_image_filename_for_language('foo.bar.png', app.env) == 'foo.bar.png'
-    assert i18n.get_image_filename_for_language('subdir/foo.png', app.env) == 'subdir/foo.png'
-    assert i18n.get_image_filename_for_language('../foo.png', app.env) == '../foo.png'
-    assert i18n.get_image_filename_for_language('foo', app.env) == 'foo'
-
     # modify figure_language_filename and language is 'en'
     app.env.config.language = 'en'
     app.env.config.figure_language_filename = 'images/{language}/{root}{ext}'
@@ -167,18 +149,18 @@
 
 def test_CatalogRepository(tempdir):
     (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES').makedirs()
-    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'test1.po').write_text('#')
-    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'test2.po').write_text('#')
+    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'test1.po').write_text('#', encoding='utf8')
+    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'test2.po').write_text('#', encoding='utf8')
     (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'sub').makedirs()
-    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'sub' / 'test3.po').write_text('#')
-    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'sub' / 'test4.po').write_text('#')
+    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'sub' / 'test3.po').write_text('#', encoding='utf8')
+    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / 'sub' / 'test4.po').write_text('#', encoding='utf8')
     (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / '.dotdir').makedirs()
-    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / '.dotdir' / 'test5.po').write_text('#')
+    (tempdir / 'loc1' / 'xx' / 'LC_MESSAGES' / '.dotdir' / 'test5.po').write_text('#', encoding='utf8')
     (tempdir / 'loc1' / 'yy' / 'LC_MESSAGES').makedirs()
-    (tempdir / 'loc1' / 'yy' / 'LC_MESSAGES' / 'test6.po').write_text('#')
+    (tempdir / 'loc1' / 'yy' / 'LC_MESSAGES' / 'test6.po').write_text('#', encoding='utf8')
     (tempdir / 'loc2' / 'xx' / 'LC_MESSAGES').makedirs()
-    (tempdir / 'loc2' / 'xx' / 'LC_MESSAGES' / 'test1.po').write_text('#')
-    (tempdir / 'loc2' / 'xx' / 'LC_MESSAGES' / 'test7.po').write_text('#')
+    (tempdir / 'loc2' / 'xx' / 'LC_MESSAGES' / 'test1.po').write_text('#', encoding='utf8')
+    (tempdir / 'loc2' / 'xx' / 'LC_MESSAGES' / 'test7.po').write_text('#', encoding='utf8')
 
     # for language xx
     repo = i18n.CatalogRepository(tempdir, 'loc1', 'loc2', 'xx', 'utf-8')

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_images.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_images.py Changed

@@ -1,17 +1,13 @@
-"""
-    test_util_images
-    ~~~~~~~~~~~~~~~~
-
-    Test images util.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test images util."""
 
 import pytest
 
-from sphinx.util.images import (get_image_extension, get_image_size, guess_mimetype,
-                                parse_data_uri)
+from sphinx.util.images import (
+    get_image_extension,
+    get_image_size,
+    guess_mimetype,
+    parse_data_uri,
+)
 
 GIF_FILENAME = 'img.gif'
 PNG_FILENAME = 'img.png'
@@ -72,7 +68,7 @@
     assert image is None
 
     # invalid data URI (no properties)
+    uri = ("data:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4"
+           "//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
     with pytest.raises(ValueError):
-        uri = ("data:iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4"
-               "//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==")
         parse_data_uri(uri)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_inspect.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_inspect.py Changed

@@ -1,12 +1,6 @@
-"""
-    test_util_inspect
-    ~~~~~~~~~~~~~~~
+"""Tests util.inspect functions."""
 
-    Tests util.inspect functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+from __future__ import annotations
 
 import ast
 import datetime
@@ -15,11 +9,21 @@
 import sys
 import types
 from inspect import Parameter
+from typing import Optional
 
 import pytest
 
 from sphinx.util import inspect
-from sphinx.util.inspect import TypeAliasNamespace, stringify_signature
+from sphinx.util.inspect import TypeAliasForwardRef, TypeAliasNamespace, stringify_signature
+from sphinx.util.typing import stringify_annotation
+
+
+def test_TypeAliasForwardRef():
+    alias = TypeAliasForwardRef('example')
+    assert stringify_annotation(alias, 'fully-qualified-except-typing') == 'example'
+
+    alias = Optionalalias
+    assert stringify_annotation(alias, 'fully-qualified-except-typing') == 'example | None'
 
 
 def test_TypeAliasNamespace():
@@ -148,8 +152,35 @@
 
 
 def test_signature_annotations():
-    from .typing_test_data import (Node, f0, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12,
-                                   f13, f14, f15, f16, f17, f18, f19, f20, f21)
+    from .typing_test_data import (
+        Node,
+        f0,
+        f1,
+        f2,
+        f3,
+        f4,
+        f5,
+        f6,
+        f7,
+        f8,
+        f9,
+        f10,
+        f11,
+        f12,
+        f13,
+        f14,
+        f15,
+        f16,
+        f17,
+        f18,
+        f19,
+        f20,
+        f21,
+        f22,
+        f23,
+        f24,
+        f25,
+    )
 
     # Class annotations
     sig = inspect.signature(f0)
@@ -161,20 +192,14 @@
 
     # TypeVars and generic types with TypeVars
     sig = inspect.signature(f2)
-    if sys.version_info < (3, 7):
-        assert stringify_signature(sig) == ('(x: typing.Listtyping.T,'
-                                            ' y: typing.Listtyping.T_co,'
-                                            ' z: typing.T'
-                                            ') -> typing.Listtyping.T_contra')
-    else:
-        assert stringify_signature(sig) == ('(x: typing.Listtests.typing_test_data.T,'
-                                            ' y: typing.Listtests.typing_test_data.T_co,'
-                                            ' z: tests.typing_test_data.T'
-                                            ') -> typing.Listtests.typing_test_data.T_contra')
+    assert stringify_signature(sig) == ('(x: typing.Listtests.typing_test_data.T,'
+                                        ' y: typing.Listtests.typing_test_data.T_co,'
+                                        ' z: tests.typing_test_data.T'
+                                        ') -> typing.Listtests.typing_test_data.T_contra')
 
     # Union types
     sig = inspect.signature(f3)
-    assert stringify_signature(sig) == '(x: typing.Unionstr, numbers.Integral) -> None'
+    assert stringify_signature(sig) == '(x: str | numbers.Integral) -> None'
 
     # Quoted annotations
     sig = inspect.signature(f4)
@@ -190,7 +215,10 @@
 
     # Space around '=' for defaults
     sig = inspect.signature(f7)
-    assert stringify_signature(sig) == '(x: typing.Optionalint = None, y: dict = {}) -> None'
+    if sys.version_info:2 <= (3, 10):
+        assert stringify_signature(sig) == '(x: int | None = None, y: dict = {}) -> None'
+    else:
+        assert stringify_signature(sig) == '(x: int = None, y: dict = {}) -> None'
 
     # Callable types
     sig = inspect.signature(f8)
@@ -213,12 +241,12 @@
 
     # optional
     sig = inspect.signature(f13)
-    assert stringify_signature(sig) == '() -> typing.Optionalstr'
+    assert stringify_signature(sig) == '() -> str | None'
 
     # optional union
     sig = inspect.signature(f20)
-    assert stringify_signature(sig) in ('() -> typing.Optionaltyping.Unionint, str',
-                                        '() -> typing.Optionaltyping.Unionstr, int')
+    assert stringify_signature(sig) in ('() -> int | str | None',
+                                        '() -> str | int | None')
 
     # Any
     sig = inspect.signature(f14)
@@ -237,7 +265,7 @@
     assert stringify_signature(sig) == '(*, arg3, arg4)'
 
     sig = inspect.signature(f18)
-    assert stringify_signature(sig) == ('(self, arg1: typing.Unionint, typing.Tuple = 10) -> '
+    assert stringify_signature(sig) == ('(self, arg1: int | typing.Tuple = 10) -> '
                                         'typing.Listtyping.Dict')
 
     # annotations for variadic and keyword parameters
@@ -253,7 +281,7 @@
     assert stringify_signature(sig) == '(self) -> typing.Listtests.typing_test_data.Node'
 
     sig = inspect.signature(Node.__init__)
-    assert stringify_signature(sig) == '(self, parent: typing.Optionaltests.typing_test_data.Node) -> None'
+    assert stringify_signature(sig) == '(self, parent: tests.typing_test_data.Node | None) -> None'
 
     # show_annotation is False
     sig = inspect.signature(f7)
@@ -261,31 +289,31 @@
 
     # show_return_annotation is False
     sig = inspect.signature(f7)
-    assert stringify_signature(sig, show_return_annotation=False) == '(x: typing.Optionalint = None, y: dict = {})'
+    if sys.version_info:2 <= (3, 10):
+        assert stringify_signature(sig, show_return_annotation=False) == '(x: int | None = None, y: dict = {})'
+    else:
+        assert stringify_signature(sig, show_return_annotation=False) == '(x: int = None, y: dict = {})'
 
     # unqualified_typehints is True
     sig = inspect.signature(f7)
-    assert stringify_signature(sig, unqualified_typehints=True) == '(x: ~typing.Optionalint = None, y: dict = {}) -> None'
-
-
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
-@pytest.mark.sphinx(testroot='ext-autodoc')
-def test_signature_annotations_py38(app):
-    from target.pep570 import bar, baz, foo, qux
+    if sys.version_info:2 <= (3, 10):
+        assert stringify_signature(sig, unqualified_typehints=True) == '(x: int | None = None, y: dict = {}) -> None'
+    else:
+        assert stringify_signature(sig, unqualified_typehints=True) == '(x: int = None, y: dict = {}) -> None'
 
     # case: separator at head
-    sig = inspect.signature(foo)
+    sig = inspect.signature(f22)
     assert stringify_signature(sig) == '(*, a, b)'
 
     # case: separator in the middle
-    sig = inspect.signature(bar)
+    sig = inspect.signature(f23)
     assert stringify_signature(sig) == '(a, b, /, c, d)'
 
-    sig = inspect.signature(baz)
+    sig = inspect.signature(f24)
     assert stringify_signature(sig) == '(a, /, *, b)'
 
     # case: separator at tail
-    sig = inspect.signature(qux)
+    sig = inspect.signature(f25)
     assert stringify_signature(sig) == '(a, b, /)'
 
 
@@ -368,8 +396,6 @@
     assert sig.parameters'b'.default == Parameter.empty
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8),
-                    reason='python-3.8 or above is required')
 def test_signature_from_str_positionaly_only_args():
     sig = inspect.signature_from_str('(a, b=0, /, c=1)')
     assert list(sig.parameters.keys()) == 'a', 'b', 'c'
@@ -437,12 +463,8 @@
 
     obj = Foo()
 
-    try:
+    with pytest.raises(AttributeError, match='bar'):
         inspect.safe_getattr(obj, 'bar')
-    except AttributeError as exc:
-        assert exc.args0 == 'bar'
-    else:
-        pytest.fail('AttributeError not raised')
 
 
 def test_safe_getattr_with_property_exception():
@@ -453,12 +475,8 @@
 
     obj = Foo()
 
-    try:
+    with pytest.raises(AttributeError, match='bar'):
         inspect.safe_getattr(obj, 'bar')
-    except AttributeError as exc:
-        assert exc.args0 == 'bar'
-    else:
-        pytest.fail('AttributeError not raised')
 
 
 def test_safe_getattr_with___dict___override():
@@ -469,12 +487,8 @@
 
     obj = Foo()
 
-    try:
+    with pytest.raises(AttributeError, match='bar'):
         inspect.safe_getattr(obj, 'bar')
-    except AttributeError as exc:
-        assert exc.args0 == 'bar'
-    else:
-        pytest.fail('AttributeError not raised')
 
 
 def test_dictionary_sorting():
@@ -638,12 +652,12 @@
     assert inspect.isattributedescriptor(Base.meth) is False                   # method
     assert inspect.isattributedescriptor(Base.staticmeth) is False             # staticmethod
     assert inspect.isattributedescriptor(Base.classmeth) is False              # classmetho
-    assert inspect.isattributedescriptor(Descriptor) is False                  # custom descriptor class    # NOQA
-    assert inspect.isattributedescriptor(str.join) is False                    # MethodDescriptorType       # NOQA
-    assert inspect.isattributedescriptor(object.__init__) is False             # WrapperDescriptorType      # NOQA
-    assert inspect.isattributedescriptor(dict.__dict__'fromkeys') is False   # ClassMethodDescriptorType  # NOQA
-    assert inspect.isattributedescriptor(types.FrameType.f_locals) is True     # GetSetDescriptorType       # NOQA
-    assert inspect.isattributedescriptor(datetime.timedelta.days) is True      # MemberDescriptorType       # NOQA
+    assert inspect.isattributedescriptor(Descriptor) is False                  # custom descriptor class
+    assert inspect.isattributedescriptor(str.join) is False                    # MethodDescriptorType
+    assert inspect.isattributedescriptor(object.__init__) is False             # WrapperDescriptorType
+    assert inspect.isattributedescriptor(dict.__dict__'fromkeys') is False   # ClassMethodDescriptorType
+    assert inspect.isattributedescriptor(types.FrameType.f_locals) is True     # GetSetDescriptorType
+    assert inspect.isattributedescriptor(datetime.timedelta.days) is True      # MemberDescriptorType
 
     try:
         # _testcapi module cannot be importable in some distro
@@ -651,11 +665,12 @@
         import _testcapi
 
         testinstancemethod = _testcapi.instancemethod(str.__repr__)
-        assert inspect.isattributedescriptor(testinstancemethod) is False      # instancemethod (C-API)     # NOQA
+        assert inspect.isattributedescriptor(testinstancemethod) is False      # instancemethod (C-API)
     except ImportError:
         pass
 
 
+@pytest.mark.sphinx(testroot='ext-autodoc')
 def test_isproperty(app):
     from target.functions import func
     from target.methods import Base
@@ -667,7 +682,6 @@
     assert inspect.isproperty(func) is False            # function
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 @pytest.mark.sphinx(testroot='ext-autodoc')
 def test_isgenericalias(app):
     from target.genericalias import C, T
@@ -719,7 +733,7 @@
             """
 
     class Bar(Foo):
-        @functools.lru_cache()
+        @functools.lru_cache  # noqa: B019
         def meth(self):
             # inherited and decorated method
             pass

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_inventory.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_inventory.py Changed

@@ -1,18 +1,11 @@
-"""
-    test_util_inventory
-    ~~~~~~~~~~~~~~~~~~~
-
-    Test inventory util functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test inventory util functions."""
 
 import posixpath
 import zlib
 from io import BytesIO
 
-from sphinx.ext.intersphinx import InventoryFile
+from sphinx.testing.util import SphinxTestApp
+from sphinx.util.inventory import InventoryFile
 
 inventory_v1 = b'''\
 # Sphinx inventory version 1
@@ -91,3 +84,33 @@
     invdata = InventoryFile.load(f, '/util', posixpath.join)
     assert invdata'py:module''module1' == \
         ('foo', '', '/util/foo.html#module-module1', 'Long Module desc')
+
+
+def _write_appconfig(dir, language, prefix=None):
+    prefix = prefix or language
+    (dir / prefix).makedirs()
+    (dir / prefix / 'conf.py').write_text(f'language = "{language}"', encoding='utf8')
+    (dir / prefix / 'index.rst').write_text('index.rst', encoding='utf8')
+    assert sorted((dir / prefix).listdir()) == 'conf.py', 'index.rst'
+    assert (dir / prefix / 'index.rst').exists()
+    return (dir / prefix)
+
+
+def _build_inventory(srcdir):
+    app = SphinxTestApp(srcdir=srcdir)
+    app.build()
+    app.cleanup()
+    return (app.outdir / 'objects.inv')
+
+
+def test_inventory_localization(tempdir):
+    # Build an app using Estonian (EE) locale
+    srcdir_et = _write_appconfig(tempdir, "et")
+    inventory_et = _build_inventory(srcdir_et)
+
+    # Build the same app using English (US) locale
+    srcdir_en = _write_appconfig(tempdir, "en")
+    inventory_en = _build_inventory(srcdir_en)
+
+    # Ensure that the inventory contents differ
+    assert inventory_et.read_bytes() != inventory_en.read_bytes()

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_logging.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_logging.py Changed

@@ -1,22 +1,15 @@
-"""
-    test_util_logging
-    ~~~~~~~~~~~~~~~~~
-
-    Test logging util.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test logging util."""
 
 import codecs
 import os
+import os.path
 
 import pytest
 from docutils import nodes
 
 from sphinx.errors import SphinxWarning
 from sphinx.testing.util import strip_escseq
-from sphinx.util import logging
+from sphinx.util import logging, osutil
 from sphinx.util.console import colorize
 from sphinx.util.logging import is_suppressed_warning, prefixed_warnings
 from sphinx.util.parallel import ParallelTasks
@@ -355,8 +348,8 @@
         logger.warning('message')
 
     # if False, warning raises SphinxWarning exception
-    with pytest.raises(SphinxWarning):
-        with logging.skip_warningiserror(False):
+    with logging.skip_warningiserror(False):
+        with pytest.raises(SphinxWarning):
             logger.warning('message')
 
     # It also works during pending_warnings.
@@ -364,7 +357,7 @@
         with logging.skip_warningiserror():
             logger.warning('message')
 
-    with pytest.raises(SphinxWarning):
+    with pytest.raises(SphinxWarning):  # NoQA: PT012
         with logging.pending_warnings():
             with logging.skip_warningiserror(False):
                 logger.warning('message')
@@ -387,3 +380,18 @@
     assert 'WARNING: Another PREFIX: message3' in warning.getvalue()
     assert 'WARNING: PREFIX: message4' in warning.getvalue()
     assert 'WARNING: message5' in warning.getvalue()
+
+
+def test_get_node_location_abspath():
+    # Ensure that node locations are reported as an absolute path,
+    # even if the source attribute is a relative path.
+
+    relative_filename = os.path.join('relative', 'path.txt')
+    absolute_filename = osutil.abspath(relative_filename)
+
+    n = nodes.Node()
+    n.source = relative_filename
+
+    location = logging.get_node_location(n)
+
+    assert location == absolute_filename + ':'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_matching.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_matching.py Changed

@@ -1,13 +1,5 @@
-"""
-    test_util_matching
-    ~~~~~~~~~~~~~~~~~~
-
-    Tests sphinx.util.matching functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-from sphinx.util.matching import Matcher, compile_matchers
+"""Tests sphinx.util.matching functions."""
+from sphinx.util.matching import Matcher, compile_matchers, get_matching_files
 
 
 def test_compile_matchers():
@@ -88,3 +80,95 @@
     assert not matcher('subdir/hello.py')
     assert matcher('world.py')
     assert matcher('subdir/world.py')
+
+
+def test_get_matching_files_all(rootdir):
+    files = get_matching_files(rootdir / "test-root")
+    assert sorted(files) == 
+        'Makefile', '_templates/contentssb.html', '_templates/customsb.html',
+        '_templates/layout.html', 'autodoc.txt', 'autodoc_target.py', 'bom.txt', 'conf.py',
+        'extapi.txt', 'extensions.txt', 'file_with_special_#_chars.xyz', 'footnote.txt',
+        'images.txt', 'img.foo.png', 'img.gif', 'img.pdf', 'img.png', 'includes.txt',
+        'index.txt', 'lists.txt', 'literal.inc', 'literal_orig.inc', 'markup.txt', 'math.txt',
+        'objects.txt', 'otherext.foo', 'parsermod.py', 'quotes.inc', 'rimg.png',
+        'special/api.h', 'special/code.py', 'subdir/excluded.txt', 'subdir/images.txt',
+        'subdir/img.png', 'subdir/include.inc', 'subdir/includes.txt', 'subdir/simg.png',
+        'svgimg.pdf', 'svgimg.svg', 'tabs.inc', 'test.inc', 'wrongenc.inc',
+    
+
+
+def test_get_matching_files_all_exclude_single(rootdir):
+    files = get_matching_files(rootdir / "test-root", exclude_patterns="**.html")
+    assert sorted(files) == 
+        'Makefile', 'autodoc.txt', 'autodoc_target.py', 'bom.txt', 'conf.py',
+        'extapi.txt', 'extensions.txt', 'file_with_special_#_chars.xyz', 'footnote.txt',
+        'images.txt', 'img.foo.png', 'img.gif', 'img.pdf', 'img.png', 'includes.txt',
+        'index.txt', 'lists.txt', 'literal.inc', 'literal_orig.inc', 'markup.txt', 'math.txt',
+        'objects.txt', 'otherext.foo', 'parsermod.py', 'quotes.inc', 'rimg.png',
+        'special/api.h', 'special/code.py', 'subdir/excluded.txt', 'subdir/images.txt',
+        'subdir/img.png', 'subdir/include.inc', 'subdir/includes.txt', 'subdir/simg.png',
+        'svgimg.pdf', 'svgimg.svg', 'tabs.inc', 'test.inc', 'wrongenc.inc',
+    
+
+
+def test_get_matching_files_all_exclude_multiple(rootdir):
+    files = get_matching_files(rootdir / "test-root", exclude_patterns="**.html", "**.inc")
+    assert sorted(files) == 
+        'Makefile', 'autodoc.txt', 'autodoc_target.py', 'bom.txt', 'conf.py',
+        'extapi.txt', 'extensions.txt', 'file_with_special_#_chars.xyz', 'footnote.txt',
+        'images.txt', 'img.foo.png', 'img.gif', 'img.pdf', 'img.png', 'includes.txt',
+        'index.txt', 'lists.txt', 'markup.txt', 'math.txt', 'objects.txt', 'otherext.foo',
+        'parsermod.py', 'rimg.png', 'special/api.h', 'special/code.py', 'subdir/excluded.txt',
+        'subdir/images.txt', 'subdir/img.png', 'subdir/includes.txt', 'subdir/simg.png',
+        'svgimg.pdf', 'svgimg.svg',
+    
+
+
+def test_get_matching_files_all_exclude_nonexistent(rootdir):
+    files = get_matching_files(rootdir / "test-root", exclude_patterns="halibut/**")
+    assert sorted(files) == 
+        'Makefile', '_templates/contentssb.html', '_templates/customsb.html',
+        '_templates/layout.html', 'autodoc.txt', 'autodoc_target.py', 'bom.txt', 'conf.py',
+        'extapi.txt', 'extensions.txt', 'file_with_special_#_chars.xyz', 'footnote.txt',
+        'images.txt', 'img.foo.png', 'img.gif', 'img.pdf', 'img.png', 'includes.txt',
+        'index.txt', 'lists.txt', 'literal.inc', 'literal_orig.inc', 'markup.txt', 'math.txt',
+        'objects.txt', 'otherext.foo', 'parsermod.py', 'quotes.inc', 'rimg.png',
+        'special/api.h', 'special/code.py', 'subdir/excluded.txt', 'subdir/images.txt',
+        'subdir/img.png', 'subdir/include.inc', 'subdir/includes.txt', 'subdir/simg.png',
+        'svgimg.pdf', 'svgimg.svg', 'tabs.inc', 'test.inc', 'wrongenc.inc',
+    
+
+
+def test_get_matching_files_all_include_single(rootdir):
+    files = get_matching_files(rootdir / "test-root", include_patterns="subdir/**")
+    assert sorted(files) == 
+        'subdir/excluded.txt', 'subdir/images.txt', 'subdir/img.png', 'subdir/include.inc',
+        'subdir/includes.txt', 'subdir/simg.png',
+    
+
+
+def test_get_matching_files_all_include_multiple(rootdir):
+    files = get_matching_files(rootdir / "test-root", include_patterns="special/**", "subdir/**")
+    assert sorted(files) == 
+        'special/api.h', 'special/code.py', 'subdir/excluded.txt', 'subdir/images.txt',
+        'subdir/img.png', 'subdir/include.inc', 'subdir/includes.txt', 'subdir/simg.png',
+    
+
+
+def test_get_matching_files_all_include_nonexistent(rootdir):
+    files = get_matching_files(rootdir / "test-root", include_patterns="halibut/**")
+    assert sorted(files) == 
+
+
+def test_get_matching_files_all_include_prefix(rootdir):
+    files = get_matching_files(rootdir / "test-root", include_patterns="autodoc*")
+    assert sorted(files) == 
+        'autodoc.txt', 'autodoc_target.py',
+    
+
+
+def test_get_matching_files_all_include_question_mark(rootdir):
+    files = get_matching_files(rootdir / "test-root", include_patterns="img.???")
+    assert sorted(files) == 
+        'img.gif', 'img.pdf', 'img.png',
+

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_nodes.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_nodes.py Changed

@@ -1,12 +1,7 @@
-"""
-    test_util_nodes
-    ~~~~~~~~~~~~~~~
+"""Tests uti.nodes functions."""
+from __future__ import annotations
 
-    Tests uti.nodes functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+import warnings
 from textwrap import dedent
 from typing import Any
 
@@ -16,8 +11,14 @@
 from docutils.utils import new_document
 
 from sphinx.transforms import ApplySourceWorkaround
-from sphinx.util.nodes import (NodeMatcher, clean_astext, extract_messages, make_id,
-                               split_explicit_title)
+from sphinx.util.nodes import (
+    NodeMatcher,
+    apply_source_workaround,
+    clean_astext,
+    extract_messages,
+    make_id,
+    split_explicit_title,
+)
 
 
 def _transform(doctree):
@@ -25,8 +26,12 @@
 
 
 def create_new_document():
-    settings = frontend.OptionParser(
-        components=(rst.Parser,)).get_default_values()
+    with warnings.catch_warnings():
+        warnings.filterwarnings('ignore', category=DeprecationWarning)
+        # DeprecationWarning: The frontend.OptionParser class will be replaced
+        # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
+        settings = frontend.OptionParser(
+            components=(rst.Parser,)).get_default_values()
     settings.id_prefix = 'id'
     document = new_document('dummy.txt', settings)
     return document
@@ -96,7 +101,7 @@
 
               admonition body
            """,
-            nodes.title, 1
+            nodes.title, 1,
         ),
         (
             """
@@ -139,7 +144,7 @@
             nodes.line, 2,
 
         ),
-    
+    ,
 )
 def test_extract_messages(rst, node_cls, count):
     msg = extract_messages(_get_doctree(dedent(rst)))
@@ -171,14 +176,14 @@
 
 def test_clean_astext():
     node = nodes.paragraph(text='hello world')
-    assert 'hello world' == clean_astext(node)
+    assert clean_astext(node) == 'hello world'
 
     node = nodes.image(alt='hello world')
-    assert '' == clean_astext(node)
+    assert clean_astext(node) == ''
 
     node = nodes.paragraph(text='hello world')
     node += nodes.raw('', 'raw text', format='html')
-    assert 'hello world' == clean_astext(node)
+    assert clean_astext(node) == 'hello world'
 
 
 @pytest.mark.parametrize(
@@ -223,7 +228,27 @@
         ('hello <world>', (True, 'hello', 'world')),
         # explicit (title having angle brackets)
         ('hello <world> <sphinx>', (True, 'hello <world>', 'sphinx')),
-    
+    ,
 )
 def test_split_explicit_target(title, expected):
     assert expected == split_explicit_title(title)
+
+
+def test_apply_source_workaround_literal_block_no_source():
+    """Regression test for #11091.
+
+     Test that apply_source_workaround doesn't raise.
+     """
+    literal_block = nodes.literal_block('', '')
+    list_item = nodes.list_item('', literal_block)
+    bullet_list = nodes.bullet_list('', list_item)
+
+    assert literal_block.source is None
+    assert list_item.source is None
+    assert bullet_list.source is None
+
+    apply_source_workaround(literal_block)
+
+    assert literal_block.source is None
+    assert list_item.source is None
+    assert bullet_list.source is None

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_rst.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_rst.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_template.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_template.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_util_typing.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_util_typing.py Changed

@@ -1,24 +1,26 @@
-"""
-    test_util_typing
-    ~~~~~~~~~~~~~~~~
-
-    Tests util.typing functions.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Tests util.typing functions."""
 
 import sys
 from numbers import Integral
 from struct import Struct
 from types import TracebackType
-from typing import (Any, Callable, Dict, Generator, List, NewType, Optional, Tuple, TypeVar,
-                    Union)
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generator,
+    List,
+    NewType,
+    Optional,
+    Tuple,
+    TypeVar,
+    Union,
+)
 
 import pytest
 
 from sphinx.ext.autodoc import mock
-from sphinx.util.typing import restify, stringify
+from sphinx.util.typing import restify, stringify_annotation
 
 
 class MyClass1:
@@ -78,7 +80,12 @@
                                              ":py:class:`str`, :py:class:`str`, "
                                              ":py:class:`str`")
     assert restify(Tuplestr, ...) == ":py:class:`~typing.Tuple`\\ :py:class:`str`, ..."
-    assert restify(Tuple()) == ":py:class:`~typing.Tuple`\\ ()"
+
+    if sys.version_info:2 <= (3, 10):
+        assert restify(Tuple()) == ":py:class:`~typing.Tuple`\\ ()"
+    else:
+        assert restify(Tuple()) == ":py:class:`~typing.Tuple`"
+
     assert restify(ListDictstr, Tuple) == (":py:class:`~typing.List`\\ "
                                                ":py:class:`~typing.Dict`\\ "
                                                ":py:class:`str`, :py:class:`~typing.Tuple`")
@@ -93,16 +100,10 @@
 def test_restify_type_hints_Callable():
     assert restify(Callable) == ":py:class:`~typing.Callable`"
 
-    if sys.version_info >= (3, 7):
-        assert restify(Callablestr, int) == (":py:class:`~typing.Callable`\\ "
-                                                 ":py:class:`str`, :py:class:`int`")
-        assert restify(Callable..., int) == (":py:class:`~typing.Callable`\\ "
-                                               "..., :py:class:`int`")
-    else:
-        assert restify(Callablestr, int) == (":py:class:`~typing.Callable`\\ "
-                                                 ":py:class:`str`, :py:class:`int`")
-        assert restify(Callable..., int) == (":py:class:`~typing.Callable`\\ "
-                                               "..., :py:class:`int`")
+    assert restify(Callablestr, int) == (":py:class:`~typing.Callable`\\ "
+                                             ":py:class:`str`, :py:class:`int`")
+    assert restify(Callable..., int) == (":py:class:`~typing.Callable`\\ "
+                                           "..., :py:class:`int`")
 
 
 def test_restify_type_hints_Union():
@@ -110,31 +111,22 @@
     assert restify(Unionstr, None) == ":py:obj:`~typing.Optional`\\ :py:class:`str`"
     assert restify(Unionint, str) == (":py:obj:`~typing.Union`\\ "
                                         ":py:class:`int`, :py:class:`str`")
-
-    if sys.version_info >= (3, 7):
-        assert restify(Unionint, Integral) == (":py:obj:`~typing.Union`\\ "
-                                                 ":py:class:`int`, :py:class:`numbers.Integral`")
-        assert restify(Unionint, Integral, "smart") == (":py:obj:`~typing.Union`\\ "
-                                                          ":py:class:`int`,"
-                                                          " :py:class:`~numbers.Integral`")
-
-        assert (restify(UnionMyClass1, MyClass2) ==
-                (":py:obj:`~typing.Union`\\ "
-                 ":py:class:`tests.test_util_typing.MyClass1`, "
-                 ":py:class:`tests.test_util_typing.<MyClass2>`"))
-        assert (restify(UnionMyClass1, MyClass2, "smart") ==
-                (":py:obj:`~typing.Union`\\ "
-                 ":py:class:`~tests.test_util_typing.MyClass1`,"
-                 " :py:class:`~tests.test_util_typing.<MyClass2>`"))
-    else:
-        assert restify(Unionint, Integral) == ":py:class:`numbers.Integral`"
-        assert restify(Unionint, Integral, "smart") == ":py:class:`~numbers.Integral`"
-
-        assert restify(UnionMyClass1, MyClass2) == ":py:class:`tests.test_util_typing.MyClass1`"
-        assert restify(UnionMyClass1, MyClass2, "smart") == ":py:class:`~tests.test_util_typing.MyClass1`"
+    assert restify(Unionint, Integral) == (":py:obj:`~typing.Union`\\ "
+                                             ":py:class:`int`, :py:class:`numbers.Integral`")
+    assert restify(Unionint, Integral, "smart") == (":py:obj:`~typing.Union`\\ "
+                                                      ":py:class:`int`,"
+                                                      " :py:class:`~numbers.Integral`")
+
+    assert (restify(UnionMyClass1, MyClass2) ==
+            (":py:obj:`~typing.Union`\\ "
+             ":py:class:`tests.test_util_typing.MyClass1`, "
+             ":py:class:`tests.test_util_typing.<MyClass2>`"))
+    assert (restify(UnionMyClass1, MyClass2, "smart") ==
+            (":py:obj:`~typing.Union`\\ "
+             ":py:class:`~tests.test_util_typing.MyClass1`,"
+             " :py:class:`~tests.test_util_typing.<MyClass2>`"))
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 def test_restify_type_hints_typevars():
     T = TypeVar('T')
     T_co = TypeVar('T_co', covariant=True)
@@ -152,7 +144,7 @@
     assert restify(ListT) == ":py:class:`~typing.List`\\ :py:obj:`tests.test_util_typing.T`"
     assert restify(ListT, "smart") == ":py:class:`~typing.List`\\ :py:obj:`~tests.test_util_typing.T`"
 
-    if sys.version_info >= (3, 10):
+    if sys.version_info:2 >= (3, 10):
         assert restify(MyInt) == ":py:class:`tests.test_util_typing.MyInt`"
         assert restify(MyInt, "smart") == ":py:class:`~tests.test_util_typing.MyInt`"
     else:
@@ -175,19 +167,17 @@
     assert restify(MyTuple) == ":py:class:`~typing.Tuple`\\ :py:class:`str`, :py:class:`str`"
 
 
-@pytest.mark.skipif(sys.version_info < (3, 7), reason='python 3.7+ is required.')
 def test_restify_type_ForwardRef():
     from typing import ForwardRef  # type: ignore
     assert restify(ForwardRef("myint")) == ":py:class:`myint`"
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
 def test_restify_type_Literal():
     from typing import Literal  # type: ignore
     assert restify(Literal1, "2", "\r") == ":py:obj:`~typing.Literal`\\ 1, '2', '\\r'"
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason='python 3.9+ is required.')
+@pytest.mark.skipif(sys.version_info:2 <= (3, 8), reason='python 3.9+ is required.')
 def test_restify_pep_585():
     assert restify(liststr) == ":py:class:`list`\\ :py:class:`str`"  # type: ignore
     assert restify(dictstr, str) == (":py:class:`dict`\\ "  # type: ignore
@@ -197,7 +187,7 @@
                                                    ":py:class:`int`, ...")
 
 
-@pytest.mark.skipif(sys.version_info < (3, 10), reason='python 3.10+ is required.')
+@pytest.mark.skipif(sys.version_info:2 <= (3, 9), reason='python 3.10+ is required.')
 def test_restify_type_union_operator():
     assert restify(int | None) == ":py:class:`int` | :py:obj:`None`"  # type: ignore
     assert restify(int | str) == ":py:class:`int` | :py:class:`str`"  # type: ignore
@@ -213,186 +203,179 @@
 def test_restify_mock():
     with mock('unknown'):
         import unknown
+        assert restify(unknown) == ':py:class:`unknown`'
         assert restify(unknown.secret.Class) == ':py:class:`unknown.secret.Class`'
         assert restify(unknown.secret.Class, "smart") == ':py:class:`~unknown.secret.Class`'
 
 
-def test_stringify():
-    assert stringify(int) == "int"
-    assert stringify(int, "smart") == "int"
+def test_stringify_annotation():
+    assert stringify_annotation(int, 'fully-qualified-except-typing') == "int"
+    assert stringify_annotation(int, "smart") == "int"
 
-    assert stringify(str) == "str"
-    assert stringify(str, "smart") == "str"
+    assert stringify_annotation(str, 'fully-qualified-except-typing') == "str"
+    assert stringify_annotation(str, "smart") == "str"
 
-    assert stringify(None) == "None"
-    assert stringify(None, "smart") == "None"
+    assert stringify_annotation(None, 'fully-qualified-except-typing') == "None"
+    assert stringify_annotation(None, "smart") == "None"
 
-    assert stringify(Integral) == "numbers.Integral"
-    assert stringify(Integral, "smart") == "~numbers.Integral"
+    assert stringify_annotation(Integral, 'fully-qualified-except-typing') == "numbers.Integral"
+    assert stringify_annotation(Integral, "smart") == "~numbers.Integral"
 
-    assert stringify(Struct) == "struct.Struct"
-    assert stringify(Struct, "smart") == "~struct.Struct"
+    assert stringify_annotation(Struct, 'fully-qualified-except-typing') == "struct.Struct"
+    assert stringify_annotation(Struct, "smart") == "~struct.Struct"
 
-    assert stringify(TracebackType) == "types.TracebackType"
-    assert stringify(TracebackType, "smart") == "~types.TracebackType"
+    assert stringify_annotation(TracebackType, 'fully-qualified-except-typing') == "types.TracebackType"
+    assert stringify_annotation(TracebackType, "smart") == "~types.TracebackType"
 
-    assert stringify(Any) == "Any"
-    assert stringify(Any, "fully-qualified") == "typing.Any"
-    assert stringify(Any, "smart") == "~typing.Any"
+    assert stringify_annotation(Any, 'fully-qualified-except-typing') == "Any"
+    assert stringify_annotation(Any, "fully-qualified") == "typing.Any"
+    assert stringify_annotation(Any, "smart") == "~typing.Any"
 
 
 def test_stringify_type_hints_containers():
-    assert stringify(List) == "List"
-    assert stringify(List, "fully-qualified") == "typing.List"
-    assert stringify(List, "smart") == "~typing.List"
-
-    assert stringify(Dict) == "Dict"
-    assert stringify(Dict, "fully-qualified") == "typing.Dict"
-    assert stringify(Dict, "smart") == "~typing.Dict"
-
-    assert stringify(Listint) == "Listint"
-    assert stringify(Listint, "fully-qualified") == "typing.Listint"
-    assert stringify(Listint, "smart") == "~typing.Listint"
-
-    assert stringify(Liststr) == "Liststr"
-    assert stringify(Liststr, "fully-qualified") == "typing.Liststr"
-    assert stringify(Liststr, "smart") == "~typing.Liststr"
-
-    assert stringify(Dictstr, float) == "Dictstr, float"
-    assert stringify(Dictstr, float, "fully-qualified") == "typing.Dictstr, float"
-    assert stringify(Dictstr, float, "smart") == "~typing.Dictstr, float"
-
-    assert stringify(Tuplestr, str, str) == "Tuplestr, str, str"
-    assert stringify(Tuplestr, str, str, "fully-qualified") == "typing.Tuplestr, str, str"
-    assert stringify(Tuplestr, str, str, "smart") == "~typing.Tuplestr, str, str"
-
-    assert stringify(Tuplestr, ...) == "Tuplestr, ..."
-    assert stringify(Tuplestr, ..., "fully-qualified") == "typing.Tuplestr, ..."
-    assert stringify(Tuplestr, ..., "smart") == "~typing.Tuplestr, ..."
-
-    assert stringify(Tuple()) == "Tuple()"
-    assert stringify(Tuple(), "fully-qualified") == "typing.Tuple()"
-    assert stringify(Tuple(), "smart") == "~typing.Tuple()"
+    assert stringify_annotation(List, 'fully-qualified-except-typing') == "List"
+    assert stringify_annotation(List, "fully-qualified") == "typing.List"
+    assert stringify_annotation(List, "smart") == "~typing.List"
+
+    assert stringify_annotation(Dict, 'fully-qualified-except-typing') == "Dict"
+    assert stringify_annotation(Dict, "fully-qualified") == "typing.Dict"
+    assert stringify_annotation(Dict, "smart") == "~typing.Dict"
+
+    assert stringify_annotation(Listint, 'fully-qualified-except-typing') == "Listint"
+    assert stringify_annotation(Listint, "fully-qualified") == "typing.Listint"
+    assert stringify_annotation(Listint, "smart") == "~typing.Listint"
+
+    assert stringify_annotation(Liststr, 'fully-qualified-except-typing') == "Liststr"
+    assert stringify_annotation(Liststr, "fully-qualified") == "typing.Liststr"
+    assert stringify_annotation(Liststr, "smart") == "~typing.Liststr"
+
+    assert stringify_annotation(Dictstr, float, 'fully-qualified-except-typing') == "Dictstr, float"
+    assert stringify_annotation(Dictstr, float, "fully-qualified") == "typing.Dictstr, float"
+    assert stringify_annotation(Dictstr, float, "smart") == "~typing.Dictstr, float"
+
+    assert stringify_annotation(Tuplestr, str, str, 'fully-qualified-except-typing') == "Tuplestr, str, str"
+    assert stringify_annotation(Tuplestr, str, str, "fully-qualified") == "typing.Tuplestr, str, str"
+    assert stringify_annotation(Tuplestr, str, str, "smart") == "~typing.Tuplestr, str, str"
+
+    assert stringify_annotation(Tuplestr, ..., 'fully-qualified-except-typing') == "Tuplestr, ..."
+    assert stringify_annotation(Tuplestr, ..., "fully-qualified") == "typing.Tuplestr, ..."
+    assert stringify_annotation(Tuplestr, ..., "smart") == "~typing.Tuplestr, ..."
+
+    if sys.version_info:2 <= (3, 10):
+        assert stringify_annotation(Tuple(), 'fully-qualified-except-typing') == "Tuple()"
+        assert stringify_annotation(Tuple(), "fully-qualified") == "typing.Tuple()"
+        assert stringify_annotation(Tuple(), "smart") == "~typing.Tuple()"
+    else:
+        assert stringify_annotation(Tuple(), 'fully-qualified-except-typing') == "Tuple"
+        assert stringify_annotation(Tuple(), "fully-qualified") == "typing.Tuple"
+        assert stringify_annotation(Tuple(), "smart") == "~typing.Tuple"
 
-    assert stringify(ListDictstr, Tuple) == "ListDictstr, Tuple"
-    assert stringify(ListDictstr, Tuple, "fully-qualified") == "typing.Listtyping.Dictstr, typing.Tuple"
-    assert stringify(ListDictstr, Tuple, "smart") == "~typing.List~typing.Dictstr, ~typing.Tuple"
+    assert stringify_annotation(ListDictstr, Tuple, 'fully-qualified-except-typing') == "ListDictstr, Tuple"
+    assert stringify_annotation(ListDictstr, Tuple, "fully-qualified") == "typing.Listtyping.Dictstr, typing.Tuple"
+    assert stringify_annotation(ListDictstr, Tuple, "smart") == "~typing.List~typing.Dictstr, ~typing.Tuple"
 
-    assert stringify(MyListTupleint, int) == "tests.test_util_typing.MyListTupleint, int"
-    assert stringify(MyListTupleint, int, "fully-qualified") == "tests.test_util_typing.MyListtyping.Tupleint, int"
-    assert stringify(MyListTupleint, int, "smart") == "~tests.test_util_typing.MyList~typing.Tupleint, int"
+    assert stringify_annotation(MyListTupleint, int, 'fully-qualified-except-typing') == "tests.test_util_typing.MyListTupleint, int"
+    assert stringify_annotation(MyListTupleint, int, "fully-qualified") == "tests.test_util_typing.MyListtyping.Tupleint, int"
+    assert stringify_annotation(MyListTupleint, int, "smart") == "~tests.test_util_typing.MyList~typing.Tupleint, int"
 
-    assert stringify(GeneratorNone, None, None) == "GeneratorNone, None, None"
-    assert stringify(GeneratorNone, None, None, "fully-qualified") == "typing.GeneratorNone, None, None"
-    assert stringify(GeneratorNone, None, None, "smart") == "~typing.GeneratorNone, None, None"
+    assert stringify_annotation(GeneratorNone, None, None, 'fully-qualified-except-typing') == "GeneratorNone, None, None"
+    assert stringify_annotation(GeneratorNone, None, None, "fully-qualified") == "typing.GeneratorNone, None, None"
+    assert stringify_annotation(GeneratorNone, None, None, "smart") == "~typing.GeneratorNone, None, None"
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason='python 3.9+ is required.')
+@pytest.mark.skipif(sys.version_info:2 <= (3, 8), reason='python 3.9+ is required.')
 def test_stringify_type_hints_pep_585():
-    assert stringify(listint) == "listint"
-    assert stringify(listint, "smart") == "listint"
+    assert stringify_annotation(listint, 'fully-qualified-except-typing') == "listint"
+    assert stringify_annotation(listint, "smart") == "listint"
 
-    assert stringify(liststr) == "liststr"
-    assert stringify(liststr, "smart") == "liststr"
+    assert stringify_annotation(liststr, 'fully-qualified-except-typing') == "liststr"
+    assert stringify_annotation(liststr, "smart") == "liststr"
 
-    assert stringify(dictstr, float) == "dictstr, float"
-    assert stringify(dictstr, float, "smart") == "dictstr, float"
+    assert stringify_annotation(dictstr, float, 'fully-qualified-except-typing') == "dictstr, float"
+    assert stringify_annotation(dictstr, float, "smart") == "dictstr, float"
 
-    assert stringify(tuplestr, str, str) == "tuplestr, str, str"
-    assert stringify(tuplestr, str, str, "smart") == "tuplestr, str, str"
+    assert stringify_annotation(tuplestr, str, str, 'fully-qualified-except-typing') == "tuplestr, str, str"
+    assert stringify_annotation(tuplestr, str, str, "smart") == "tuplestr, str, str"
 
-    assert stringify(tuplestr, ...) == "tuplestr, ..."
-    assert stringify(tuplestr, ..., "smart") == "tuplestr, ..."
+    assert stringify_annotation(tuplestr, ..., 'fully-qualified-except-typing') == "tuplestr, ..."
+    assert stringify_annotation(tuplestr, ..., "smart") == "tuplestr, ..."
 
-    assert stringify(tuple()) == "tuple()"
-    assert stringify(tuple(), "smart") == "tuple()"
+    assert stringify_annotation(tuple(), 'fully-qualified-except-typing') == "tuple()"
+    assert stringify_annotation(tuple(), "smart") == "tuple()"
 
-    assert stringify(listdictstr, tuple) == "listdictstr, tuple"
-    assert stringify(listdictstr, tuple, "smart") == "listdictstr, tuple"
+    assert stringify_annotation(listdictstr, tuple, 'fully-qualified-except-typing') == "listdictstr, tuple"
+    assert stringify_annotation(listdictstr, tuple, "smart") == "listdictstr, tuple"
 
-    assert stringify(typeint) == "typeint"
-    assert stringify(typeint, "smart") == "typeint"
+    assert stringify_annotation(typeint, 'fully-qualified-except-typing') == "typeint"
+    assert stringify_annotation(typeint, "smart") == "typeint"
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason='python 3.9+ is required.')
+@pytest.mark.skipif(sys.version_info:2 <= (3, 8), reason='python 3.9+ is required.')
 def test_stringify_Annotated():
     from typing import Annotated  # type: ignore
-    assert stringify(Annotatedstr, "foo", "bar") == "str"  # NOQA
-    assert stringify(Annotatedstr, "foo", "bar", "smart") == "str"  # NOQA
+    assert stringify_annotation(Annotatedstr, "foo", "bar", 'fully-qualified-except-typing') == "str"
+    assert stringify_annotation(Annotatedstr, "foo", "bar", "smart") == "str"
 
 
 def test_stringify_type_hints_string():
-    assert stringify("int") == "int"
-    assert stringify("int", "smart") == "int"
+    assert stringify_annotation("int", 'fully-qualified-except-typing') == "int"
+    assert stringify_annotation("int", 'fully-qualified') == "int"
+    assert stringify_annotation("int", "smart") == "int"
 
-    assert stringify("str") == "str"
-    assert stringify("str", "smart") == "str"
+    assert stringify_annotation("str", 'fully-qualified-except-typing') == "str"
+    assert stringify_annotation("str", 'fully-qualified') == "str"
+    assert stringify_annotation("str", "smart") == "str"
 
-    assert stringify(List"int") == "Listint"
-    assert stringify(List"int", "smart") == "~typing.Listint"
+    assert stringify_annotation(List"int", 'fully-qualified-except-typing') == "Listint"
+    assert stringify_annotation(List"int", 'fully-qualified') == "typing.Listint"
+    assert stringify_annotation(List"int", "smart") == "~typing.Listint"
 
-    assert stringify("Tuplestr") == "Tuplestr"
-    assert stringify("Tuplestr", "smart") == "Tuplestr"
+    assert stringify_annotation("Tuplestr", 'fully-qualified-except-typing') == "Tuplestr"
+    assert stringify_annotation("Tuplestr", 'fully-qualified') == "Tuplestr"
+    assert stringify_annotation("Tuplestr", "smart") == "Tuplestr"
 
-    assert stringify("unknown") == "unknown"
-    assert stringify("unknown", "smart") == "unknown"
+    assert stringify_annotation("unknown", 'fully-qualified-except-typing') == "unknown"
+    assert stringify_annotation("unknown", 'fully-qualified') == "unknown"
+    assert stringify_annotation("unknown", "smart") == "unknown"
 
 
 def test_stringify_type_hints_Callable():
-    assert stringify(Callable) == "Callable"
-    assert stringify(Callable, "fully-qualified") == "typing.Callable"
-    assert stringify(Callable, "smart") == "~typing.Callable"
-
-    if sys.version_info >= (3, 7):
-        assert stringify(Callablestr, int) == "Callablestr, int"
-        assert stringify(Callablestr, int, "fully-qualified") == "typing.Callablestr, int"
-        assert stringify(Callablestr, int, "smart") == "~typing.Callablestr, int"
-
-        assert stringify(Callable..., int) == "Callable..., int"
-        assert stringify(Callable..., int, "fully-qualified") == "typing.Callable..., int"
-        assert stringify(Callable..., int, "smart") == "~typing.Callable..., int"
-    else:
-        assert stringify(Callablestr, int) == "Callablestr, int"
-        assert stringify(Callablestr, int, "fully-qualified") == "typing.Callablestr, int"
-        assert stringify(Callablestr, int, "smart") == "~typing.Callablestr, int"
+    assert stringify_annotation(Callable, 'fully-qualified-except-typing') == "Callable"
+    assert stringify_annotation(Callable, "fully-qualified") == "typing.Callable"
+    assert stringify_annotation(Callable, "smart") == "~typing.Callable"
 
-        assert stringify(Callable..., int) == "Callable..., int"
-        assert stringify(Callable..., int, "fully-qualified") == "typing.Callable..., int"
-        assert stringify(Callable..., int, "smart") == "~typing.Callable..., int"
+    assert stringify_annotation(Callablestr, int, 'fully-qualified-except-typing') == "Callablestr, int"
+    assert stringify_annotation(Callablestr, int, "fully-qualified") == "typing.Callablestr, int"
+    assert stringify_annotation(Callablestr, int, "smart") == "~typing.Callablestr, int"
+
+    assert stringify_annotation(Callable..., int, 'fully-qualified-except-typing') == "Callable..., int"
+    assert stringify_annotation(Callable..., int, "fully-qualified") == "typing.Callable..., int"
+    assert stringify_annotation(Callable..., int, "smart") == "~typing.Callable..., int"
 
 
 def test_stringify_type_hints_Union():
-    assert stringify(Optionalint) == "Optionalint"
-    assert stringify(Optionalint, "fully-qualified") == "typing.Optionalint"
-    assert stringify(Optionalint, "smart") == "~typing.Optionalint"
-
-    assert stringify(Unionstr, None) == "Optionalstr"
-    assert stringify(Unionstr, None, "fully-qualified") == "typing.Optionalstr"
-    assert stringify(Unionstr, None, "smart") == "~typing.Optionalstr"
-
-    assert stringify(Unionint, str) == "Unionint, str"
-    assert stringify(Unionint, str, "fully-qualified") == "typing.Unionint, str"
-    assert stringify(Unionint, str, "smart") == "~typing.Unionint, str"
-
-    if sys.version_info >= (3, 7):
-        assert stringify(Unionint, Integral) == "Unionint, numbers.Integral"
-        assert stringify(Unionint, Integral, "fully-qualified") == "typing.Unionint, numbers.Integral"
-        assert stringify(Unionint, Integral, "smart") == "~typing.Unionint, ~numbers.Integral"
-
-        assert (stringify(UnionMyClass1, MyClass2) ==
-                "Uniontests.test_util_typing.MyClass1, tests.test_util_typing.<MyClass2>")
-        assert (stringify(UnionMyClass1, MyClass2, "fully-qualified") ==
-                "typing.Uniontests.test_util_typing.MyClass1, tests.test_util_typing.<MyClass2>")
-        assert (stringify(UnionMyClass1, MyClass2, "smart") ==
-                "~typing.Union~tests.test_util_typing.MyClass1, ~tests.test_util_typing.<MyClass2>")
-    else:
-        assert stringify(Unionint, Integral) == "numbers.Integral"
-        assert stringify(Unionint, Integral, "fully-qualified") == "numbers.Integral"
-        assert stringify(Unionint, Integral, "smart") == "~numbers.Integral"
+    assert stringify_annotation(Optionalint, 'fully-qualified-except-typing') == "int | None"
+    assert stringify_annotation(Optionalint, "fully-qualified") == "int | None"
+    assert stringify_annotation(Optionalint, "smart") == "int | None"
+
+    assert stringify_annotation(Unionstr, None, 'fully-qualified-except-typing') == "str | None"
+    assert stringify_annotation(Unionstr, None, "fully-qualified") == "str | None"
+    assert stringify_annotation(Unionstr, None, "smart") == "str | None"
 
-        assert stringify(UnionMyClass1, MyClass2) == "tests.test_util_typing.MyClass1"
-        assert stringify(UnionMyClass1, MyClass2, "fully-qualified") == "tests.test_util_typing.MyClass1"
-        assert stringify(UnionMyClass1, MyClass2, "smart") == "~tests.test_util_typing.MyClass1"
+    assert stringify_annotation(Unionint, str, 'fully-qualified-except-typing') == "int | str"
+    assert stringify_annotation(Unionint, str, "fully-qualified") == "int | str"
+    assert stringify_annotation(Unionint, str, "smart") == "int | str"
+
+    assert stringify_annotation(Unionint, Integral, 'fully-qualified-except-typing') == "int | numbers.Integral"
+    assert stringify_annotation(Unionint, Integral, "fully-qualified") == "int | numbers.Integral"
+    assert stringify_annotation(Unionint, Integral, "smart") == "int | ~numbers.Integral"
+
+    assert (stringify_annotation(UnionMyClass1, MyClass2, 'fully-qualified-except-typing') ==
+            "tests.test_util_typing.MyClass1 | tests.test_util_typing.<MyClass2>")
+    assert (stringify_annotation(UnionMyClass1, MyClass2, "fully-qualified") ==
+            "tests.test_util_typing.MyClass1 | tests.test_util_typing.<MyClass2>")
+    assert (stringify_annotation(UnionMyClass1, MyClass2, "smart") ==
+            "~tests.test_util_typing.MyClass1 | ~tests.test_util_typing.<MyClass2>")
 
 
 def test_stringify_type_hints_typevars():
@@ -400,85 +383,72 @@
     T_co = TypeVar('T_co', covariant=True)
     T_contra = TypeVar('T_contra', contravariant=True)
 
-    if sys.version_info < (3, 7):
-        assert stringify(T) == "T"
-        assert stringify(T, "smart") == "T"
-
-        assert stringify(T_co) == "T_co"
-        assert stringify(T_co, "smart") == "T_co"
-
-        assert stringify(T_contra) == "T_contra"
-        assert stringify(T_contra, "smart") == "T_contra"
-
-        assert stringify(ListT) == "ListT"
-        assert stringify(ListT, "smart") == "~typing.ListT"
-    else:
-        assert stringify(T) == "tests.test_util_typing.T"
-        assert stringify(T, "smart") == "~tests.test_util_typing.T"
+    assert stringify_annotation(T, 'fully-qualified-except-typing') == "tests.test_util_typing.T"
+    assert stringify_annotation(T, "smart") == "~tests.test_util_typing.T"
 
-        assert stringify(T_co) == "tests.test_util_typing.T_co"
-        assert stringify(T_co, "smart") == "~tests.test_util_typing.T_co"
+    assert stringify_annotation(T_co, 'fully-qualified-except-typing') == "tests.test_util_typing.T_co"
+    assert stringify_annotation(T_co, "smart") == "~tests.test_util_typing.T_co"
 
-        assert stringify(T_contra) == "tests.test_util_typing.T_contra"
-        assert stringify(T_contra, "smart") == "~tests.test_util_typing.T_contra"
+    assert stringify_annotation(T_contra, 'fully-qualified-except-typing') == "tests.test_util_typing.T_contra"
+    assert stringify_annotation(T_contra, "smart") == "~tests.test_util_typing.T_contra"
 
-        assert stringify(ListT) == "Listtests.test_util_typing.T"
-        assert stringify(ListT, "smart") == "~typing.List~tests.test_util_typing.T"
+    assert stringify_annotation(ListT, 'fully-qualified-except-typing') == "Listtests.test_util_typing.T"
+    assert stringify_annotation(ListT, "smart") == "~typing.List~tests.test_util_typing.T"
 
-    if sys.version_info >= (3, 10):
-        assert stringify(MyInt) == "tests.test_util_typing.MyInt"
-        assert stringify(MyInt, "smart") == "~tests.test_util_typing.MyInt"
+    if sys.version_info:2 >= (3, 10):
+        assert stringify_annotation(MyInt, 'fully-qualified-except-typing') == "tests.test_util_typing.MyInt"
+        assert stringify_annotation(MyInt, "smart") == "~tests.test_util_typing.MyInt"
     else:
-        assert stringify(MyInt) == "MyInt"
-        assert stringify(MyInt, "smart") == "MyInt"
+        assert stringify_annotation(MyInt, 'fully-qualified-except-typing') == "MyInt"
+        assert stringify_annotation(MyInt, "smart") == "MyInt"
 
 
 def test_stringify_type_hints_custom_class():
-    assert stringify(MyClass1) == "tests.test_util_typing.MyClass1"
-    assert stringify(MyClass1, "smart") == "~tests.test_util_typing.MyClass1"
+    assert stringify_annotation(MyClass1, 'fully-qualified-except-typing') == "tests.test_util_typing.MyClass1"
+    assert stringify_annotation(MyClass1, "smart") == "~tests.test_util_typing.MyClass1"
 
-    assert stringify(MyClass2) == "tests.test_util_typing.<MyClass2>"
-    assert stringify(MyClass2, "smart") == "~tests.test_util_typing.<MyClass2>"
+    assert stringify_annotation(MyClass2, 'fully-qualified-except-typing') == "tests.test_util_typing.<MyClass2>"
+    assert stringify_annotation(MyClass2, "smart") == "~tests.test_util_typing.<MyClass2>"
 
 
 def test_stringify_type_hints_alias():
     MyStr = str
     MyTuple = Tuplestr, str
 
-    assert stringify(MyStr) == "str"
-    assert stringify(MyStr, "smart") == "str"
+    assert stringify_annotation(MyStr, 'fully-qualified-except-typing') == "str"
+    assert stringify_annotation(MyStr, "smart") == "str"
 
-    assert stringify(MyTuple) == "Tuplestr, str"  # type: ignore
-    assert stringify(MyTuple, "smart") == "~typing.Tuplestr, str"  # type: ignore
+    assert stringify_annotation(MyTuple) == "Tuplestr, str"  # type: ignore
+    assert stringify_annotation(MyTuple, "smart") == "~typing.Tuplestr, str"  # type: ignore
 
 
-@pytest.mark.skipif(sys.version_info < (3, 8), reason='python 3.8+ is required.')
 def test_stringify_type_Literal():
     from typing import Literal  # type: ignore
-    assert stringify(Literal1, "2", "\r") == "Literal1, '2', '\\r'"
-    assert stringify(Literal1, "2", "\r", "fully-qualified") == "typing.Literal1, '2', '\\r'"
-    assert stringify(Literal1, "2", "\r", "smart") == "~typing.Literal1, '2', '\\r'"
+    assert stringify_annotation(Literal1, "2", "\r", 'fully-qualified-except-typing') == "Literal1, '2', '\\r'"
+    assert stringify_annotation(Literal1, "2", "\r", "fully-qualified") == "typing.Literal1, '2', '\\r'"
+    assert stringify_annotation(Literal1, "2", "\r", "smart") == "~typing.Literal1, '2', '\\r'"
 
 
-@pytest.mark.skipif(sys.version_info < (3, 10), reason='python 3.10+ is required.')
+@pytest.mark.skipif(sys.version_info:2 <= (3, 9), reason='python 3.10+ is required.')
 def test_stringify_type_union_operator():
-    assert stringify(int | None) == "int | None"  # type: ignore
-    assert stringify(int | None, "smart") == "int | None"  # type: ignore
+    assert stringify_annotation(int | None) == "int | None"  # type: ignore
+    assert stringify_annotation(int | None, "smart") == "int | None"  # type: ignore
 
-    assert stringify(int | str) == "int | str"  # type: ignore
-    assert stringify(int | str, "smart") == "int | str"  # type: ignore
+    assert stringify_annotation(int | str) == "int | str"  # type: ignore
+    assert stringify_annotation(int | str, "smart") == "int | str"  # type: ignore
 
-    assert stringify(int | str | None) == "int | str | None"  # type: ignore
-    assert stringify(int | str | None, "smart") == "int | str | None"  # type: ignore
+    assert stringify_annotation(int | str | None) == "int | str | None"  # type: ignore
+    assert stringify_annotation(int | str | None, "smart") == "int | str | None"  # type: ignore
 
 
 def test_stringify_broken_type_hints():
-    assert stringify(BrokenType) == 'tests.test_util_typing.BrokenType'
-    assert stringify(BrokenType, "smart") == '~tests.test_util_typing.BrokenType'
+    assert stringify_annotation(BrokenType, 'fully-qualified-except-typing') == 'tests.test_util_typing.BrokenType'
+    assert stringify_annotation(BrokenType, "smart") == '~tests.test_util_typing.BrokenType'
 
 
 def test_stringify_mock():
     with mock('unknown'):
         import unknown
-        assert stringify(unknown.secret.Class) == 'unknown.secret.Class'
-        assert stringify(unknown.secret.Class, "smart") == 'unknown.secret.Class'
+        assert stringify_annotation(unknown, 'fully-qualified-except-typing') == 'unknown'
+        assert stringify_annotation(unknown.secret.Class, 'fully-qualified-except-typing') == 'unknown.secret.Class'
+        assert stringify_annotation(unknown.secret.Class, "smart") == 'unknown.secret.Class'

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_versioning.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_versioning.py Changed

@@ -1,33 +1,17 @@
-"""
-    test_versioning
-    ~~~~~~~~~~~~~~~
-
-    Test the versioning implementation.
-
-    :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
+"""Test the versioning implementation."""
 
 import pickle
 
 import pytest
 
-from sphinx import addnodes
 from sphinx.testing.util import SphinxTestApp
 from sphinx.versioning import add_uids, get_ratio, merge_doctrees
 
-try:
-    from docutils.nodes import meta
-except ImportError:
-    # docutils-0.18.0 or older
-    from docutils.parsers.rst.directives.html import MetaBody
-    meta = MetaBody.meta
-
 app = original = original_uids = None
 
 
 @pytest.fixture(scope='module', autouse=True)
-def setup_module(rootdir, sphinx_test_tempdir):
+def _setup_module(rootdir, sphinx_test_tempdir):
     global app, original, original_uids
     srcdir = sphinx_test_tempdir / 'test-versioning'
     if not srcdir.exists():
@@ -70,8 +54,6 @@
     copy.settings.warning_stream = None
     copy.settings.env = None
     copy.settings.record_dependencies = None
-    for metanode in copy.findall(meta):
-        metanode.__class__ = addnodes.meta
     loaded = pickle.loads(pickle.dumps(copy, pickle.HIGHEST_PROTOCOL))
     assert all(getattr(n, 'uid', False) for n in loaded.findall(is_paragraph))

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/test_writer_latex.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/test_writer_latex.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/typing_test_data.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/typing_test_data.py Changed

_service:tar_scm:Sphinx-4.4.0.tar.gz/tests/utils.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tests/utils.py Changed

@@ -4,10 +4,16 @@
 import threading
 from ssl import PROTOCOL_TLS_SERVER, SSLContext
 
+import filelock
+
 # Generated with:
 # $ openssl req -new -x509 -days 3650 -nodes -out cert.pem \
 #     -keyout cert.pem -addext "subjectAltName = DNS:localhost"
-CERT_FILE = str(pathlib.Path(__file__).parent / "certs" / "cert.pem")
+TESTS_ROOT = pathlib.Path(__file__).parent
+CERT_FILE = str(TESTS_ROOT / "certs" / "cert.pem")
+
+# File lock for tests
+LOCK_PATH = str(TESTS_ROOT / 'test-server.lock')
 
 
 class HttpServerThread(threading.Thread):
@@ -16,7 +22,7 @@
         self.server = http.server.HTTPServer(("localhost", 7777), handler)
 
     def run(self):
-        self.server.serve_forever(poll_interval=0.01)
+        self.server.serve_forever(poll_interval=0.001)
 
     def terminate(self):
         self.server.shutdown()
@@ -34,12 +40,14 @@
 
 def create_server(thread_class):
     def server(handler):
-        server_thread = thread_class(handler, daemon=True)
-        server_thread.start()
-        try:
-            yield server_thread
-        finally:
-            server_thread.terminate()
+        lock = filelock.FileLock(LOCK_PATH)
+        with lock:
+            server_thread = thread_class(handler, daemon=True)
+            server_thread.start()
+            try:
+                yield server_thread
+            finally:
+                server_thread.terminate()
     return contextlib.contextmanager(server)

_service:tar_scm:Sphinx-4.4.0.tar.gz/tox.ini -> _service:tar_scm:Sphinx-7.0.1.tar.gz/tox.ini Changed

@@ -1,6 +1,7 @@
 tox
 minversion = 2.4.0
-envlist = docs,flake8,mypy,twine,coverage,py{36,37,38,39,310},du{14,15,16,17}
+envlist = py{38,39,310,311,312}
+isolated_build = True
 
 testenv
 usedevelop = True
@@ -12,69 +13,18 @@
     PERL
     PERL5LIB
     PYTEST_ADDOPTS
+    DO_EPUBCHECK
     EPUBCHECK_PATH
     TERM
 description =
-    py{36,37,38,39,310}: Run unit tests against {envname}.
-    du{12,13,14}: Run unit tests with the given version of docutils.
-deps =
-    du14: docutils==0.14.*
-    du15: docutils==0.15.*
-    du16: docutils==0.16.*
-    du17: docutils==0.17.*
+    py{38,39,310,311,312}: Run unit tests against {envname}.
 extras =
     test
 setenv =
-    PYTHONWARNINGS = all
+    PYTHONWARNINGS = error
     PYTEST_ADDOPTS = {env:PYTEST_ADDOPTS:} --color yes
 commands=
-    python -X dev -m pytest --durations 25 {posargs}
-
-testenv:du-latest
-commands =
-    python -m pip install "git+https://repo.or.cz/docutils.git#subdirectory=docutils"
-    {testenvcommands}
-
-testenv:flake8
-basepython = python3
-description =
-    Run style checks.
-whitelist_externals =
-    flake8
-extras =
-    lint
-commands =
-    flake8 {posargs}
-
-testenv:isort
-basepython = python3
-description =
-    Run import sorting checks.
-whitelist_externals =
-    isort
-extras =
-    lint
-commands =
-    isort --check-only --diff .
-
-testenv:coverage
-basepython = python3
-description =
-    Run code coverage checks.
-setenv =
-    PYTEST_ADDOPTS = --cov sphinx --cov-config "{toxinidir}/setup.cfg"
-commands =
-    {testenvcommands}
-    coverage report
-
-testenv:mypy
-basepython = python3
-description =
-    Run type checks.
-extras =
-    lint
-commands=
-    mypy sphinx/
+    python -X dev -X warn_default_encoding -m pytest --durations 25 {posargs}
 
 testenv:docs
 basepython = python3
@@ -83,26 +33,18 @@
 extras =
     docs
 commands =
-    python setup.py build_sphinx {posargs}
+    sphinx-build -M html ./doc ./build/sphinx -W --keep-going
 
-testenv:docslint
+testenv:docs-live
 basepython = python3
 description =
-    Lint documentation.
+    Build documentation.
 extras =
     docs
-commands =
-    python utils/doclinter.py CHANGES CONTRIBUTING.rst README.rst doc/
-
-testenv:twine
-basepython = python3
-description =
-    Lint package.
 deps =
-    twine
+    sphinx-autobuild
 commands =
-    python setup.py release bdist_wheel sdist
-    twine check dist/*
+    sphinx-autobuild ./doc ./build/sphinx/
 
 testenv:bindep
 description =

_service:tar_scm:Sphinx-7.0.1.tar.gz/utils/babel_runner.py Added

@@ -0,0 +1,249 @@
+"""Run babel for translations.
+
+Usage:
+
+babel_runner.py extract
+    Extract messages from the source code and update the ".pot" template file.
+
+babel_runner.py update
+    Update all language catalogues in "sphinx/locale/<language>/LC_MESSAGES"
+    with the current messages in the template file.
+
+babel_runner.py compile
+    Compile the ".po" catalogue files to ".mo" and ".js" files.
+"""
+
+import json
+import logging
+import os
+import sys
+import tempfile
+
+from babel.messages.catalog import Catalog
+from babel.messages.extract import (
+    DEFAULT_KEYWORDS,
+    extract,
+    extract_javascript,
+    extract_python,
+)
+from babel.messages.mofile import write_mo
+from babel.messages.pofile import read_po, write_po
+from babel.util import pathmatch
+from jinja2.ext import babel_extract as extract_jinja2
+
+ROOT = os.path.realpath(os.path.join(os.path.abspath(__file__), "..", ".."))
+TEX_DELIMITERS = {
+    'variable_start_string': '<%=',
+    'variable_end_string': '%>',
+    'block_start_string': '<%',
+    'block_end_string': '%>',
+}
+METHOD_MAP = 
+    # Extraction from Python source files
+    ('**.py', extract_python),
+    # Extraction from Jinja2 template files
+    ('**/templates/latex/**.tex_t', extract_jinja2),
+    ('**/templates/latex/**.sty_t', extract_jinja2),
+    # Extraction from Jinja2 HTML templates
+    ('**/themes/**.html', extract_jinja2),
+    # Extraction from Jinja2 XML templates
+    ('**/themes/**.xml', extract_jinja2),
+    # Extraction from JavaScript files
+    ('**.js', extract_javascript),
+    ('**.js_t', extract_javascript),
+
+OPTIONS_MAP = {
+    # Extraction from Python source files
+    '**.py': {
+        'encoding': 'utf-8',
+    },
+    # Extraction from Jinja2 template files
+    '**/templates/latex/**.tex_t': TEX_DELIMITERS.copy(),
+    '**/templates/latex/**.sty_t': TEX_DELIMITERS.copy(),
+    # Extraction from Jinja2 HTML templates
+    '**/themes/**.html': {
+        'encoding': 'utf-8',
+        'ignore_tags': 'script,style',
+        'include_attrs': 'alt title summary',
+    },
+}
+KEYWORDS = {**DEFAULT_KEYWORDS, '_': None, '__': None}
+
+
+def run_extract():
+    """Message extraction function."""
+    log = _get_logger()
+
+    with open('sphinx/__init__.py', encoding='utf-8') as f:
+        for line in f.read().splitlines():
+            if line.startswith('__version__ = '):
+                # remove prefix; strip whitespace; remove quotation marks
+                sphinx_version = line14:.strip()1:-1
+                break
+
+    input_path = 'sphinx'
+    catalogue = Catalog(project='Sphinx', version=sphinx_version, charset='utf-8')
+
+    base = os.path.abspath(input_path)
+    for root, dirnames, filenames in os.walk(base):
+        relative_root = os.path.relpath(root, base) if root != base else ''
+        dirnames.sort()
+        for filename in sorted(filenames):
+            relative_name = os.path.join(relative_root, filename)
+            for pattern, method in METHOD_MAP:
+                if not pathmatch(pattern, relative_name):
+                    continue
+
+                options = {}
+                for opt_pattern, opt_dict in OPTIONS_MAP.items():
+                    if pathmatch(opt_pattern, relative_name):
+                        options = opt_dict
+                with open(os.path.join(root, filename), 'rb') as fileobj:
+                    for lineno, message, comments, context in extract(
+                        method, fileobj, KEYWORDS, options=options,
+                    ):
+                        filepath = os.path.join(input_path, relative_name)
+                        catalogue.add(
+                            message, None, (filepath, lineno),
+                            auto_comments=comments, context=context,
+                        )
+                break
+
+    output_file = os.path.join('sphinx', 'locale', 'sphinx.pot')
+    log.info('writing PO template file to %s', output_file)
+    with open(output_file, 'wb') as outfile:
+        write_po(outfile, catalogue)
+
+
+def run_update():
+    """Catalog merging command."""
+
+    log = _get_logger()
+
+    domain = 'sphinx'
+    locale_dir = os.path.join('sphinx', 'locale')
+    template_file = os.path.join(locale_dir, 'sphinx.pot')
+
+    with open(template_file, encoding='utf-8') as infile:
+        template = read_po(infile)
+
+    for locale in os.listdir(locale_dir):
+        filename = os.path.join(locale_dir, locale, 'LC_MESSAGES', f'{domain}.po')
+        if not os.path.exists(filename):
+            continue
+
+        log.info('updating catalog %s based on %s', filename, template_file)
+        with open(filename, encoding='utf-8') as infile:
+            catalog = read_po(infile, locale=locale, domain=domain)
+
+        catalog.update(template)
+        tmp_name = os.path.join(
+            os.path.dirname(filename), tempfile.gettempprefix() + os.path.basename(filename),
+        )
+        try:
+            with open(tmp_name, 'wb') as tmpfile:
+                write_po(tmpfile, catalog)
+        except Exception:
+            os.remove(tmp_name)
+            raise
+
+        os.replace(tmp_name, filename)
+
+
+def run_compile():
+    """
+    Catalog compilation command.
+
+    An extended command that writes all message strings that occur in
+    JavaScript files to a JavaScript file along with the .mo file.
+
+    Unfortunately, babel's setup command isn't built very extensible, so
+    most of the run() code is duplicated here.
+    """
+
+    log = _get_logger()
+
+    directory = os.path.join('sphinx', 'locale')
+    total_errors = 0
+
+    for locale in os.listdir(directory):
+        po_file = os.path.join(directory, locale, 'LC_MESSAGES', 'sphinx.po')
+        if not os.path.exists(po_file):
+            continue
+
+        with open(po_file, encoding='utf-8') as infile:
+            catalog = read_po(infile, locale)
+
+        if catalog.fuzzy:
+            log.info('catalog %s is marked as fuzzy, skipping', po_file)
+            continue
+
+        for message, errors in catalog.check():
+            for error in errors:
+                total_errors += 1
+                log.error('error: %s:%d: %s', po_file, message.lineno, error)
+
+        mo_file = os.path.join(directory, locale, 'LC_MESSAGES', 'sphinx.mo')
+        log.info('compiling catalog %s to %s', po_file, mo_file)
+        with open(mo_file, 'wb') as outfile:
+            write_mo(outfile, catalog, use_fuzzy=False)
+
+        js_file = os.path.join(directory, locale, 'LC_MESSAGES', 'sphinx.js')
+        log.info('writing JavaScript strings in catalog %s to %s', po_file, js_file)
+        js_catalogue = {}
+        for message in catalog:
+            if any(
+                    x0.endswith(('.js', '.js.jinja', '.js_t', '.html'))
+                    for x in message.locations
+            ):
+                msgid = message.id
+                if isinstance(msgid, (list, tuple)):
+                    msgid = msgid0
+                js_cataloguemsgid = message.string
+
+        obj = json.dumps({
+            'messages': js_catalogue,
+            'plural_expr': catalog.plural_expr,
+            'locale': str(catalog.locale),
+        }, sort_keys=True, indent=4)
+        with open(js_file, 'wb') as outfile:
+            # to ensure lines end with ``\n`` rather than ``\r\n``:
+            outfile.write(f'Documentation.addTranslations({obj});'.encode())
+
+    if total_errors > 0:
+        log.error('%d errors encountered.', total_errors)
+        print("Compiling failed.", file=sys.stderr)
+        raise SystemExit(2)
+
+
+def _get_logger():
+    log = logging.getLogger('babel')
+    log.setLevel(logging.INFO)
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter('%(message)s'))
+    log.addHandler(handler)
+    return log
+
+
+if __name__ == '__main__':
+    try:
+        action = sys.argv1.lower()
+    except IndexError:
+        print(__doc__, file=sys.stderr)
+        raise SystemExit(2)
+
+    os.chdir(ROOT)
+    if action == "extract":
+        raise SystemExit(run_extract())
+    if action == "update":
+        raise SystemExit(run_update())
+    if action == "compile":
+        raise SystemExit(run_compile())
+    if action == "all":
+        exit_code = run_extract()
+        if exit_code:
+            raise SystemExit(exit_code)
+        exit_code = run_update()
+        if exit_code:
+            raise SystemExit(exit_code)
+        raise SystemExit(run_compile())

_service:tar_scm:Sphinx-4.4.0.tar.gz/utils/bump_version.py -> _service:tar_scm:Sphinx-7.0.1.tar.gz/utils/bump_version.py Changed

@@ -23,19 +23,23 @@
 
 def bump_version(path, version_info, in_develop=True):
     version = stringify_version(version_info, in_develop)
-    release = version
-    if in_develop:
-        version += '+'
 
-    with open(path, 'r+') as f:
-        body = f.read()
-        body = re.sub(r"(?<=__version__ = ')^'+", version, body)
-        body = re.sub(r"(?<=__released__ = ')^'+", release, body)
-        body = re.sub(r"(?<=version_info = )$.*$", str(version_info), body)
+    with open(path, encoding='utf-8') as f:
+        lines = f.read().splitlines()
 
-        f.seek(0)
-        f.truncate(0)
-        f.write(body)
+    for i, line in enumerate(lines):
+        if line.startswith('__version__ = '):
+            linesi = f"__version__ = '{version}'"
+            continue
+        if line.startswith('version_info = '):
+            linesi = f'version_info = {version_info}'
+            continue
+        if line.startswith('_in_development = '):
+            linesi = f'_in_development = {in_develop}'
+            continue
+
+    with open(path, 'w', encoding='utf-8') as f:
+        f.write('\n'.join(lines) + '\n')
 
 
 def parse_version(version):
@@ -88,7 +92,7 @@
         self.fetch_version()
 
     def fetch_version(self):
-        with open(self.path) as f:
+        with open(self.path, encoding='utf-8') as f:
             version = f.readline().strip()
             matched = re.search(r'^Release (.*) $(.*)$$', version)
             if matched is None:
@@ -103,9 +107,9 @@
 
     def finalize_release_date(self):
         release_date = datetime.now().strftime('%b %d, %Y')
-        heading = 'Release %s (released %s)' % (self.version, release_date)
+        heading = f'Release {self.version} (released {release_date})'
 
-        with open(self.path, 'r+') as f:
+        with open(self.path, 'r+', encoding='utf-8') as f:
             f.readline()  # skip first two lines
             f.readline()
             body = f.read()
@@ -121,17 +125,16 @@
             version = stringify_version(version_info)
         else:
             reltype = version_info3
-            version = '%s %s%s' % (stringify_version(version_info),
-                                   RELEASE_TYPE.get(reltype, reltype),
-                                   version_info4 or '')
+            version = (f'{stringify_version(version_info)} '
+                       f'{RELEASE_TYPE.get(reltype, reltype)}{version_info4 or ""}')
         heading = 'Release %s (in development)' % version
 
-        with open(os.path.join(script_dir, 'CHANGES_template')) as f:
+        with open(os.path.join(script_dir, 'CHANGES_template'), encoding='utf-8') as f:
             f.readline()  # skip first two lines
             f.readline()
             tmpl = f.read()
 
-        with open(self.path, 'r+') as f:
+        with open(self.path, 'r+', encoding='utf-8') as f:
             body = f.read()
 
             f.seek(0)

_service:tar_scm:Sphinx-4.4.0.tar.gz/utils/release-checklist -> _service:tar_scm:Sphinx-7.0.1.tar.gz/utils/release-checklist Changed

@@ -1,108 +1,70 @@
 Release checklist
 =================
 
-for stable releases
--------------------
-
-* open "https://github.com/sphinx-doc/sphinx/actions?query=branch:X.Y.x" and all tests has passed
-* Run ``git fetch; git status`` and check nothing changed
-* ``python utils/bump_version.py X.Y.Z``
-* Check diff by ``git diff``
-* ``git commit -am 'Bump to X.Y.Z final'``
-* ``make clean``
-* ``python setup.py release bdist_wheel sdist``
-* ``twine upload dist/Sphinx-* --sign --identity your GPG key``
-* open https://pypi.org/project/Sphinx/ and check there are no obvious errors
-* ``sh utils/bump_docker.sh X.Y.Z``
-* ``git tag vX.Y.Z``
-* ``python utils/bump_version.py --in-develop X.Y.Zb0`` (ex. 1.5.3b0)
-* Check diff by ``git diff``
-* ``git commit -am 'Bump version'``
-* ``git push origin X.Y.x --tags``
-* ``git checkout X.x``
-* ``git merge X.Y.x``
-* ``git push origin X.x``
-* Add new version/milestone to tracker categories
-* Write announcement and send to sphinx-dev, sphinx-users and python-announce
+A stable release is a release where the minor or micro version parts are
+incremented.
+A major release is a release where the major version part is incremented.
 
-for first beta releases
------------------------
+Checks
+------
 
 * open "https://github.com/sphinx-doc/sphinx/actions?query=branch:master" and all tests has passed
-* Run ``git fetch; git status`` and check nothing changed
-* ``python utils/bump_version.py X.Y.0b1``
-* Check diff by ``git diff``
-* ``git commit -am 'Bump to X.Y.0 beta1'``
-* ``make clean``
-* ``python setup.py release bdist_wheel sdist``
-* ``twine upload dist/Sphinx-* --sign --identity your GPG key``
-* open https://pypi.org/project/Sphinx/ and check there are no obvious errors
-* ``git tag vX.Y.0b1``
-* ``python utils/bump_version.py --in-develop X.Y.0b2`` (ex. 1.6.0b2)
-* Check diff by ``git diff``
-* ``git commit -am 'Bump version'``
-* ``git checkout -b X.x``
-* ``git push origin X.x --tags``
-* ``git checkout master``
-* ``git merge X.x``
-* ``python utils/bump_version.py --in-develop A.B.0b0`` (ex. 1.7.0b0)
+* Run ``git fetch; git status`` and check that nothing has changed
+
+Bump version
+------------
+
+for stable and major releases
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ``python utils/bump_version.py X.Y.Z``
 * Check diff by ``git diff``
-* ``git commit -am 'Bump version'``
-* ``git push origin master``
-* open https://github.com/sphinx-doc/sphinx/settings/branches and make ``X.Y`` branch protected
-* Add new version/milestone to tracker categories
-* Write announcement and send to sphinx-dev, sphinx-users and python-announce
+* ``git commit -am 'Bump to X.Y.Z final'``
+* ``git tag vX.Y.Z -m "Sphinx X.Y.Z"``
 
-for other beta releases
------------------------
+for beta releases
+~~~~~~~~~~~~~~~~~
 
-* open "https://github.com/sphinx-doc/sphinx/actions?query=branch:X.x" and all tests has passed
-* Run ``git fetch; git status`` and check nothing changed
 * ``python utils/bump_version.py X.Y.0bN``
 * Check diff by ``git diff``
 * ``git commit -am 'Bump to X.Y.0 betaN'``
-* ``make clean``
-* ``python setup.py release bdist_wheel sdist``
-* ``twine upload dist/Sphinx-* --sign --identity your GPG key``
-* open https://pypi.org/project/Sphinx/ and check there are no obvious errors
-* ``git tag vX.Y.0bN``
-* ``python utils/bump_version.py --in-develop X.Y.0bM`` (ex. 1.6.0b3)
-* Check diff by `git diff``
-* ``git commit -am 'Bump version'``
-* ``git push origin X.x --tags``
-* ``git checkout master``
-* ``git merge X.x``
-* ``git push origin master``
-* Add new version/milestone to tracker categories
-* Write announcement and send to sphinx-dev, sphinx-users and python-announce
+* ``git tag vX.Y.0b1 -m "Sphinx X.Y.0bN"``
 
-for major releases
-------------------
+Build Sphinx
+------------
 
-* open "https://github.com/sphinx-doc/sphinx/actions?query=branch:X.x" and all tests has passed
-* Run ``git fetch; git status`` and check nothing changed
-* Run ``git add sphinx``
-* Run ``git commit -am 'Update message catalogs'``
-* ``python utils/bump_version.py X.Y.0``
-* Check diff by ``git diff``
-* ``git commit -am 'Bump to X.Y.0 final'``
 * ``make clean``
-* ``python setup.py release bdist_wheel sdist``
+* ``python -m build .``
 * ``twine upload dist/Sphinx-* --sign --identity your GPG key``
-* open https://pypi.org/project/Sphinx/ and check there are no obvious errors
+* open https://pypi.org/project/Sphinx/ and check for any obvious errors
+
+for stable and major releases
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 * ``sh utils/bump_docker.sh X.Y.Z``
-* ``git tag vX.Y.0``
-* ``python utils/bump_version.py --in-develop X.Y.1b0`` (ex. 1.6.1b0)
+
+Bump to next development version
+--------------------------------
+
+for stable and major releases
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ``python utils/bump_version.py --in-develop X.Y.Z+1b0`` (ex. 1.5.3b0)
+
+for beta releases
+~~~~~~~~~~~~~~~~~
+
+* ``python utils/bump_version.py --in-develop X.Y.0bN+1`` (ex. 1.6.0b2)
+
+Commit version bump
+-------------------
+
 * Check diff by ``git diff``
 * ``git commit -am 'Bump version'``
-* ``git push origin X.x --tags``
-* ``git checkout master``
-* ``git merge X.x``
-* ``git push origin master``
-* open https://github.com/sphinx-doc/sphinx/settings/branches and make ``A.B`` branch *not* protected
-* ``git checkout A.B`` (checkout old stable)
-* Run ``git tag A.B`` to paste a tag instead branch
-* Run ``git push origin :A.B --tags`` to remove old stable branch
-* open https://readthedocs.org/dashboard/sphinx/versions/ and enable the released version
+* ``git push origin master --tags``
+
+Final steps
+-----------
+
 * Add new version/milestone to tracker categories
 * Write announcement and send to sphinx-dev, sphinx-users and python-announce

Changes of Revision 10